Condividi tramite

ControlCollection Classe

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Fornisce un contenitore di raccolta che consente ai controlli server di ASP.NET di mantenere un elenco dei controlli figlio.

public ref class ControlCollection : System::Collections::ICollection
public class ControlCollection : System.Collections.ICollection
type ControlCollection = class
    interface ICollection
    interface IEnumerable
Public Class ControlCollection
Implements ICollection
Ereditarietà
Object
ControlCollection
Derivato
Implementazioni
ICollection IEnumerable

Esempio

Nell'esempio di codice seguente viene eseguito l'override del Control.CreateChildControls metodo per creare due controlli, entrambe le istanze della classe personalizzata denominata ChildControl, che ha una proprietà stringa denominata Message. Al momento della creazione, i due controlli vengono aggiunti all'oggetto ControlCollection. Il Add metodo viene chiamato su ognuno di questi controlli per aggiungerli alla classe che contiene questa versione di Control.CreateChildControls. La ChildControlsCreated proprietà è impostata su true in modo che questi controlli non vengano creati di nuovo inutilmente.


protected override void CreateChildControls()
{               
   // Creates a new ControlCollection. 
   this.CreateControlCollection();

   // Create child controls.
    ChildControl firstControl = new ChildControl();
   firstControl.Message = "FirstChildControl";

   ChildControl secondControl = new ChildControl();
   secondControl.Message = "SecondChildControl";
   
   Controls.Add(firstControl);
   Controls.Add(secondControl);

   // Prevent child controls from being created again.
   ChildControlsCreated = true;
}


Protected Overrides Sub CreateChildControls()
   ' Creates a new ControlCollection. 
   Me.CreateControlCollection()
   
   ' Create child controls.
   Dim firstControl As New ChildControl()
   firstControl.Message = "FirstChildControl"
   
   Dim secondControl As New ChildControl()
   secondControl.Message = "SecondChildControl"
   
   Controls.Add(firstControl)
   Controls.Add(secondControl)
   
   ' Prevent child controls from being created again.
   ChildControlsCreated = True
End Sub

Commenti

È possibile accedere a qualsiasi proprietà e metodo della ControlCollection classe tramite la Control.Controls proprietà . Poiché la Control classe è la classe base per tutti i controlli server ASP.NET, tutti i controlli server ereditano questa proprietà.

Per altre informazioni sulle raccolte, vedere Raccolte e strutture di dati.

Costruttori

Nome Descrizione
ControlCollection(Control)

Inizializza una nuova istanza della ControlCollection classe per il controllo server padre specificato.

Proprietà

Nome Descrizione
Count

Ottiene il numero di controlli server nell'oggetto ControlCollection per il controllo server ASP.NET specificato.
IsReadOnly

Ottiene un valore che indica se l'oggetto ControlCollection è di sola lettura.
IsSynchronized

Ottiene un valore che indica se l'oggetto ControlCollection è sincronizzato.
Item[Int32]

Ottiene un riferimento al controllo server in corrispondenza della posizione di indice specificata nell'oggetto ControlCollection .
Owner

Ottiene l'ASP.NET controllo server a cui appartiene l'oggetto ControlCollection .
SyncRoot

Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'insieme di controlli.

Metodi

Nome Descrizione
Add(Control)

Aggiunge l'oggetto specificato Control all'insieme.
AddAt(Int32, Control)

Aggiunge l'oggetto specificato Control all'insieme in corrispondenza della posizione di indice specificata.
Clear()

Rimuove tutti i controlli dall'oggetto del ControlCollection controllo server corrente.
Contains(Control)

Determina se il controllo server specificato si trova nell'oggetto del ControlCollection controllo server padre.
CopyTo(Array, Int32)

Copia i controlli figlio archiviati nell'oggetto ControlCollection in un Array oggetto, a partire dalla posizione di indice specificata in Array.
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetEnumerator()

Recupera un enumeratore in grado di scorrere l'oggetto ControlCollection .
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
IndexOf(Control)

Recupera l'indice di un oggetto specificato Control nell'insieme.
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
Remove(Control)

Rimuove il controllo server specificato dall'oggetto del ControlCollection controllo server padre.
RemoveAt(Int32)

Rimuove un controllo figlio, in corrispondenza della posizione di indice specificata, dall'oggetto ControlCollection .
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Metodi di estensione

Nome Descrizione
AsParallel(IEnumerable)

Abilita la parallelizzazione di una query.
AsQueryable(IEnumerable)

Converte un IEnumerable in un IQueryable.
Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un IEnumerable al tipo specificato.
OfType<TResult>(IEnumerable)

Filtra gli elementi di un IEnumerable in base a un tipo specificato.

Si applica a

Vedi anche