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)

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

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