EmptyControlCollection Класс

Определение

Предоставляет стандартную поддержку для коллекции ControlCollection, которая всегда остается пустой.Provides standard support for a ControlCollection collection that is always empty.

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
Наследование
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 

Комментарии

Этот класс используется, если требуется определить пользовательский элемент управления, который не допускает дочерние элементы управления.This class is used when you want to define a custom control that does not allow child controls.

Конструкторы

EmptyControlCollection(Control)

Инициализирует новый экземпляр класса EmptyControlCollection.Initializes a new instance of the EmptyControlCollection class.

Свойства

Count

Возвращает количество серверных элементов управления в объекте ControlCollection указанного ASP.NET серверного элемента управления.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

(Унаследовано от ControlCollection)
IsReadOnly

Получает значение, показывающее, является ли объект ControlCollection доступным только для чтения.Gets a value indicating whether the ControlCollection object is read-only.

(Унаследовано от ControlCollection)
IsSynchronized

Возвращает значение, указывающее, является ли объект ControlCollection синхронизированным.Gets a value indicating whether the ControlCollection object is synchronized.

(Унаследовано от ControlCollection)
Item[Int32]

Возвращает ссылку на серверный элемент управления в указанном расположении индекса в объекте ControlCollection.Gets a reference to the server control at the specified index location in the ControlCollection object.

(Унаследовано от ControlCollection)
Owner

Возвращает ASP.NET серверный элемент управления, которому принадлежит объект ControlCollection.Gets the ASP.NET server control to which the ControlCollection object belongs.

(Унаследовано от ControlCollection)
SyncRoot

Возвращает объект, который может быть использован для синхронизации доступа к коллекции элементов управления.Gets an object that can be used to synchronize access to the collection of controls.

(Унаследовано от ControlCollection)

Методы

Add(Control)

Отменяет добавление указанного объекта Control в коллекцию.Denies the addition of the specified Control object to the collection.

AddAt(Int32, Control)

Отменяет добавление указанного объекта Control в коллекцию по указанной позиции индекса.Denies the addition of the specified Control object to the collection, at the specified index position.

Clear()

Удаляет все элементы управления из объекта ControlCollection текущего серверного элемента управления.Removes all controls from the current server control's ControlCollection object.

(Унаследовано от ControlCollection)
Contains(Control)

Определяет наличие указанных серверных элементов управления в объекте ControlCollection родительского серверного элемента управления.Determines whether the specified server control is in the parent server control's ControlCollection object.

(Унаследовано от ControlCollection)
CopyTo(Array, Int32)

Копирует дочерние элементы управления, хранимые в объекте ControlCollection, в объект Array, начиная с индекса, указанного в Array.Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

(Унаследовано от ControlCollection)
Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetEnumerator()

Извлекает перечислитель, который используется для выполнения итерации в объекте ControlCollection.Retrieves an enumerator that can iterate through the ControlCollection object.

(Унаследовано от ControlCollection)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
IndexOf(Control)

Извлекает индекс указанного объекта Control в коллекции.Retrieves the index of a specified Control object in the collection.

(Унаследовано от ControlCollection)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
Remove(Control)

Удаляет указанный серверный элемент управления из объекта ControlCollection родительского серверного элемента управления.Removes the specified server control from the parent server control's ControlCollection object.

(Унаследовано от ControlCollection)
RemoveAt(Int32)

Удаляет дочерний элемент управления из объекта ControlCollection по указанному индексу.Removes a child control, at the specified index location, from the ControlCollection object.

(Унаследовано от ControlCollection)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

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

Cast<TResult>(IEnumerable)

Приводит элементы объекта IEnumerable к заданному типу.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Выполняет фильтрацию элементов объекта IEnumerable по заданному типу.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Позволяет осуществлять параллельный запрос.Enables parallelization of a query.

AsQueryable(IEnumerable)

Преобразовывает коллекцию IEnumerable в объект IQueryable.Converts an IEnumerable to an IQueryable.

Применяется к