EmptyControlCollection Класс

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Предоставляет стандартную 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

Наследование

Object

ControlCollection

EmptyControlCollection

Примеры

/* 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)

Методы расширения

Имя	Описание
AsParallel(IEnumerable)	Включает параллелизацию запроса.
AsQueryable(IEnumerable)	Преобразует IEnumerable в IQueryable.
Cast<TResult>(IEnumerable)	Приведение элементов IEnumerable к указанному типу.
OfType<TResult>(IEnumerable)	Фильтрует элементы IEnumerable на основе указанного типа.