EmptyControlCollection Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет стандартную поддержку для коллекции ControlCollection, которая всегда остается пустой.
public ref class EmptyControlCollection : System::Web::UI::ControlCollection
public class EmptyControlCollection : System.Web.UI.ControlCollection
type EmptyControlCollection = class
inherit ControlCollection
Public Class EmptyControlCollection
Inherits ControlCollection
- Наследование
Примеры
/* 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
Комментарии
Этот класс используется, если требуется определить пользовательский элемент управления, который не разрешает дочерние элементы управления.
Конструкторы
EmptyControlCollection(Control) |
Инициализирует новый экземпляр класса EmptyControlCollection. |
Свойства
Count |
Возвращает количество серверных элементов управления в объекте ControlCollection указанного ASP.NET серверного элемента управления. (Унаследовано от ControlCollection) |
IsReadOnly |
Получает значение, показывающее, является ли объект ControlCollection доступным только для чтения. (Унаследовано от ControlCollection) |
IsSynchronized |
Возвращает значение, обозначающее, является ли объект ControlCollection синхронизированным. (Унаследовано от ControlCollection) |
Item[Int32] |
Возвращает ссылку на серверный элемент управления в указанном расположении индекса в объекте ControlCollection. (Унаследовано от ControlCollection) |
Owner |
Возвращает ASP.NET серверный элемент управления, которому принадлежит объект ControlCollection. (Унаследовано от ControlCollection) |
SyncRoot |
Возвращает объект, который может быть использован для синхронизации доступа к коллекции элементов управления. (Унаследовано от ControlCollection) |
Методы
Add(Control) |
Отменяет добавление указанного объекта Control в коллекцию. |
AddAt(Int32, Control) |
Отменяет добавление указанного объекта Control в коллекцию по указанной позиции индекса. |
Clear() |
Удаляет все элементы управления из объекта ControlCollection текущего серверного элемента управления. (Унаследовано от ControlCollection) |
Contains(Control) |
Определяет наличие указанных серверных элементов управления в объекте ControlCollection родительского серверного элемента управления. (Унаследовано от ControlCollection) |
CopyTo(Array, Int32) |
Копирует дочерние элементы управления, хранимые в объекте ControlCollection, в объект Array, начиная с индекса, указанного в Array. (Унаследовано от ControlCollection) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
GetEnumerator() |
Получает перечислитель, который может выполнять проход по объекту ControlCollection. (Унаследовано от ControlCollection) |
GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
GetType() |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
IndexOf(Control) |
Извлекает индекс указанного объекта Control в коллекции. (Унаследовано от ControlCollection) |
MemberwiseClone() |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
Remove(Control) |
Удаляет указанный серверный элемент управления из объекта ControlCollection родительского серверного элемента управления. (Унаследовано от ControlCollection) |
RemoveAt(Int32) |
Удаляет дочерний элемент управления из объекта ControlCollection по указанному индексу. (Унаследовано от ControlCollection) |
ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
Методы расширения
Cast<TResult>(IEnumerable) |
Приводит элементы объекта IEnumerable к заданному типу. |
OfType<TResult>(IEnumerable) |
Выполняет фильтрацию элементов объекта IEnumerable по заданному типу. |
AsParallel(IEnumerable) |
Позволяет осуществлять параллельный запрос. |
AsQueryable(IEnumerable) |
Преобразовывает коллекцию IEnumerable в объект IQueryable. |