EmptyControlCollection Class

Definition

Fornisce il supporto standard per un insieme ControlCollection che è sempre vuoto.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
Inheritance
EmptyControlCollection

Examples


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

Remarks

Questa classe viene utilizzata quando si desidera definire un controllo personalizzato che non consente i controlli figlio.This class is used when you want to define a custom control that does not allow child controls.

Constructors

EmptyControlCollection(Control)

Inizializza una nuova istanza della classe EmptyControlCollection.Initializes a new instance of the EmptyControlCollection class.

Properties

Count

Ottiene il numero di controlli server nell'oggetto ControlCollection per il controllo server ASP.NET specificato.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

(Inherited from ControlCollection)
IsReadOnly

Ottiene un valore che indica se l'oggetto ControlCollection è di sola lettura.Gets a value indicating whether the ControlCollection object is read-only.

(Inherited from ControlCollection)
IsSynchronized

Ottiene un valore che indica se l'oggetto ControlCollection è sincronizzato.Gets a value indicating whether the ControlCollection object is synchronized.

(Inherited from ControlCollection)
Item[Int32]

Ottiene un riferimento al controllo server nella posizione di indice specificata nell'oggetto ControlCollection.Gets a reference to the server control at the specified index location in the ControlCollection object.

(Inherited from ControlCollection)
Owner

Ottiene il controllo server ASP.NET cui l'oggetto ControlCollection appartiene.Gets the ASP.NET server control to which the ControlCollection object belongs.

(Inherited from ControlCollection)
SyncRoot

Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso alla raccolta di controlli.Gets an object that can be used to synchronize access to the collection of controls.

(Inherited from ControlCollection)

Methods

Add(Control)

Non consente di aggiungere all'insieme l'oggetto Control specificato.Denies the addition of the specified Control object to the collection.

AddAt(Int32, Control)

Non consente di aggiungere l'oggetto Control specificato all'insieme nel percorso di indice indicata.Denies the addition of the specified Control object to the collection, at the specified index position.

Clear()

Rimuove tutti i controlli dall'oggetto ControlCollection del controllo server corrente.Removes all controls from the current server control's ControlCollection object.

(Inherited from ControlCollection)
Contains(Control)

Stabilisce se il controllo server specificato è presente nell'oggetto ControlCollection del controllo server padre.Determines whether the specified server control is in the parent server control's ControlCollection object.

(Inherited from ControlCollection)
CopyTo(Array, Int32)

Copia i controlli figlio memorizzati nell'oggetto ControlCollection in un oggetto Array, a cominciare dalla posizione di indice specificata in Array.Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

(Inherited from ControlCollection)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator()

Recupera un enumeratore che consente di scorrere l'oggetto ControlCollection.Retrieves an enumerator that can iterate through the ControlCollection object.

(Inherited from ControlCollection)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Inherited from Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(Control)

Recupera l'indice di un oggetto Control specificato nell'insieme.Retrieves the index of a specified Control object in the collection.

(Inherited from ControlCollection)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Inherited from Object)
Remove(Control)

Rimuove il controllo server specificato dall'oggetto ControlCollection del controllo server padre.Removes the specified server control from the parent server control's ControlCollection object.

(Inherited from ControlCollection)
RemoveAt(Int32)

Rimuove un controllo figlio, nella posizione di indice specificata, dall'oggetto ControlCollection.Removes a child control, at the specified index location, from the ControlCollection object.

(Inherited from ControlCollection)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Inherited from Object)

Extension Methods

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Applies to