EmptyControlCollection Clase

Definición

Proporciona compatibilidad estándar para una colección ControlCollection que está siempre vacía.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
Herencia
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 utiliza cuando se desea definir un control personalizado que no permite controles secundarios.This class is used when you want to define a custom control that does not allow child controls.

Constructores

EmptyControlCollection(Control)

Inicializa una nueva instancia de la clase EmptyControlCollection.Initializes a new instance of the EmptyControlCollection class.

Propiedades

Count

Obtiene el número de controles de servidor que hay en el objeto ControlCollection para el control de servidor ASP.NET especificado.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

(Heredado de ControlCollection)
IsReadOnly

Obtiene un valor que indica si el objeto ControlCollection es de solo lectura.Gets a value indicating whether the ControlCollection object is read-only.

(Heredado de ControlCollection)
IsSynchronized

Obtiene un valor que indica si el objeto ControlCollection está sincronizado.Gets a value indicating whether the ControlCollection object is synchronized.

(Heredado de ControlCollection)
Item[Int32]

Obtiene una referencia al control de servidor en la ubicación de índice especificada en el objeto ControlCollection.Gets a reference to the server control at the specified index location in the ControlCollection object.

(Heredado de ControlCollection)
Owner

Obtiene el control de servidor ASP.NET al que pertenece el objeto ControlCollection.Gets the ASP.NET server control to which the ControlCollection object belongs.

(Heredado de ControlCollection)
SyncRoot

Obtiene un objeto que puede utilizarse para sincronizar el acceso a la colección de controles.Gets an object that can be used to synchronize access to the collection of controls.

(Heredado de ControlCollection)

Métodos

Add(Control)

Deniega la adición del objeto Control especificado a la colección.Denies the addition of the specified Control object to the collection.

AddAt(Int32, Control)

Deniega la adición del objeto Control especificado a la colección, en la posición de índice especificada.Denies the addition of the specified Control object to the collection, at the specified index position.

Clear()

Quita todos los controles del objeto ControlCollection del control de servidor actual.Removes all controls from the current server control's ControlCollection object.

(Heredado de ControlCollection)
Contains(Control)

Determina si el control de servidor especificado está en el objeto ControlCollection del control de servidor principal.Determines whether the specified server control is in the parent server control's ControlCollection object.

(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.Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

(Heredado de ControlCollection)
Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.Determines whether the specified object is equal to the current object.

(Heredado de Object)
GetEnumerator()

Recupera un enumerador que puede iterar por el objeto ControlCollection.Retrieves an enumerator that can iterate through the ControlCollection object.

(Heredado de ControlCollection)
GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Heredado de Object)
IndexOf(Control)

Recupera el índice de un objeto Control especificado en la colección.Retrieves the index of a specified Control object in the collection.

(Heredado de ControlCollection)
MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Heredado de Object)
Remove(Control)

Quita el control de servidor especificado del objeto ControlCollection del control de servidor principal.Removes the specified server control from the parent server control's ControlCollection object.

(Heredado de ControlCollection)
RemoveAt(Int32)

Quita un control secundario, situado en la ubicación de índice especificada, del objeto ControlCollection.Removes a child control, at the specified index location, from the ControlCollection object.

(Heredado de ControlCollection)
ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Heredado de Object)

Métodos de extensión

Cast<TResult>(IEnumerable)

Convierte los elementos de IEnumerable en el tipo especificado.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra los elementos de IEnumerable en función de un tipo especificado.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Habilita la paralelización de una consulta.Enables parallelization of a query.

AsQueryable(IEnumerable)

Convierte una interfaz IEnumerable en IQueryable.Converts an IEnumerable to an IQueryable.

Se aplica a