EmptyControlCollection(Control) Конструктор
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Инициализирует новый экземпляр класса EmptyControlCollection.
public:
EmptyControlCollection(System::Web::UI::Control ^ owner);public EmptyControlCollection (System.Web.UI.Control owner);new System.Web.UI.EmptyControlCollection : System.Web.UI.Control -> System.Web.UI.EmptyControlCollectionPublic Sub New (owner As Control)- owner
- Control
Объект Control, которому данная коллекция принадлежит в качестве коллекции дочерних элементов управления.
В следующем примере кода пытается заполнить элемент управления дочерними элементами управления, вызывая исключение. Это связано с тем, что элемент управления "Контейнер" не разрешает дочерние элементы управления. Ниже приведена командная строка, используемая для сборки исполняемого файла.
vbc /r:System.dll /r:System.Web.dll /t:library
/out:myWebAppPath/bin/vb_myEmptyControlCollection.dll
myEmptyControlCollection.vb
csc /t:library /out:myWebAppPath/bin/cs_myEmptyControlCollection.dll
myEmptyControlCollection.cs
/* File name: emptyControlCollection.cs. */
using System;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Collections;
namespace CustomControls
{
// Defines a simple custom control.
public class MyCS_EmptyControl : Control
{
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override ControlCollection CreateControlCollection()
/*
* Function Name: CreateControlCollection.
* Denies the creation of any child control by creating an empty collection.
* Generates an exception if an attempt to create a child control is made.
*/
{
return new EmptyControlCollection(this);
}
[System.Security.Permissions.PermissionSet(System.Security.Permissions.SecurityAction.Demand, Name="FullTrust")]
protected override void CreateChildControls()
/*
* Function Name: CreateChildControls.
* Populates the child control collection (Controls).
* Note: This function will cause an exception because the control does not allow
* child controls.
*/
{
// Create a literal control to contain the header and add it to the collection.
LiteralControl text;
text = new LiteralControl("<h5>Composite Controls</h5>");
Controls.Add(text);
}
}
}
' File name: emptyControlCollection.vb.
Imports System.Web
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Collections
Namespace CustomControls
Public Class MyVB_EmptyControl
Inherits Control
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Function CreateControlCollection() As ControlCollection
' Function Name: CreateControlCollection.
' Denies the creation of any child control by creating an empty collection.
' Generates an exception if an attempt to create a child control is made.
Return New EmptyControlCollection(Me)
End Function
<System.Security.Permissions.PermissionSetAttribute(System.Security.Permissions.SecurityAction.Demand, Name:="FullTrust")> _
Protected Overrides Sub CreateChildControls()
' Sub Name: CreateChildControls.
' Populates the child control collection (Controls).
' Note: This function will cause an exception because the control does not allow
' child controls.
Dim text As LiteralControl
text = New LiteralControl("<h5>Composite Controls</h5>")
Controls.Add(text)
End Sub
End Class
End Namespace
В следующем примере кода используется пустой пользовательский элемент управления, определенный выше. При выполнении этого примера вы получите исключение. Обратите внимание, что значения, показанные в директиве , Register отражают предыдущую командную строку.
<%@ Register TagPrefix="custom" Assembly="vb_myEmptyControlCollection" Namespace="CustomControls" %>
<html>
<body>
<h1>Using an Empty Control</h1>
<custom:MyVB_EmptyControl id="vbEmptyControlId" runat="server"/>
</body>
</html>
<%@ Register TagPrefix="custom" Assembly="cs_myEmptyControlCollection" Namespace="CustomControls" %>
<html>
<body>
<h1>Using an Empty Control </h1>
<custom:MyCS_EmptyControl id="csEmptyControlId" runat="server"/>
</body>
</html>
| Продукт | Версии |
|---|---|
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
