EmptyControlCollection Clase

Definición

Espacio de nombres:

System.Web.UI

Ensamblado:

System.Web.dll

Proporciona compatibilidad estándar para una colección ControlCollection que está siempre vacía.

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

Herencia

Object

ControlCollection

EmptyControlCollection

Ejemplos

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

Comentarios

Esta clase se usa cuando desea definir un control personalizado que no permita controles secundarios.

Constructores

EmptyControlCollection(Control)

Inicializa una nueva instancia de la clase EmptyControlCollection.

Propiedades

Count	Obtiene el número de controles de servidor que hay en el objeto ControlCollection para el control de servidor ASP.NET especificado. (Heredado de ControlCollection)
IsReadOnly	Obtiene un valor que indica si el objeto ControlCollection es de solo lectura. (Heredado de ControlCollection)
IsSynchronized	Obtiene un valor que indica si el objeto ControlCollection está sincronizado. (Heredado de ControlCollection)
Item[Int32]	Obtiene una referencia al control de servidor en la ubicación de índice especificada en el objeto ControlCollection. (Heredado de ControlCollection)
Owner	Obtiene el control de servidor ASP.NET al que pertenece el objeto ControlCollection. (Heredado de ControlCollection)
SyncRoot	Obtiene un objeto que puede utilizarse para sincronizar el acceso a la colección de controles. (Heredado de ControlCollection)

Métodos

Add(Control)	Deniega la adición del objeto Control especificado a la colección.
AddAt(Int32, Control)	Deniega la adición del objeto Control especificado a la colección, en la posición de índice especificada.
Clear()	Quita todos los controles del objeto ControlCollection del control de servidor actual. (Heredado de ControlCollection)
Contains(Control)	Determina si el control de servidor especificado está en el objeto ControlCollection del control de servidor principal. (Heredado de ControlCollection)
CopyTo(Array, Int32)	Copia los controles secundarios almacenados en el objeto ControlCollection en un objeto Array, comenzando por la ubicación de índice especificada en Array. (Heredado de ControlCollection)
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetEnumerator()	Recupera un enumerador que puede iterar por el objeto ControlCollection. (Heredado de ControlCollection)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IndexOf(Control)	Recupera el índice de un objeto Control especificado en la colección. (Heredado de ControlCollection)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
Remove(Control)	Quita el control de servidor especificado del objeto ControlCollection del control de servidor principal. (Heredado de ControlCollection)
RemoveAt(Int32)	Quita un control secundario, situado en la ubicación de índice especificada, del objeto ControlCollection. (Heredado de ControlCollection)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Métodos de extensión

Cast<TResult>(IEnumerable)	Convierte los elementos de IEnumerable en el tipo especificado.
OfType<TResult>(IEnumerable)	Filtra los elementos de IEnumerable en función de un tipo especificado.
AsParallel(IEnumerable)	Habilita la paralelización de una consulta.
AsQueryable(IEnumerable)	Convierte una interfaz IEnumerable en IQueryable.