ControlCollection Classe

  • Riferimento

Definizione

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

Fornisce un contenitore di insiemi che consente ai controlli server ASP.NET di conservare 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 , con una proprietà stringa denominata ChildControlMessage. Al momento della creazione, i due controlli vengono aggiunti a ControlCollection. Il Add metodo viene chiamato su ognuno di questi controlli per aggiungerli alla classe contenente 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 una delle proprietà e dei metodi della classe tramite la ControlCollectionControl.Controls proprietà . Poiché la classe è la Control classe di base per tutti i controlli server ASP.NET, tutti i controlli server ereditano questa proprietà.

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

Costruttori

ControlCollection(Control)

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

Proprietà

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 nella posizione di indice specificata nell'oggetto ControlCollection.
Owner

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

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

Metodi

Add(Control)

Aggiunge l'oggetto Control specificato alla raccolta.
AddAt(Int32, Control)

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

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

Stabilisce se il controllo server specificato è presente nell'oggetto ControlCollection del controllo server padre.
CopyTo(Array, Int32)

Copia i controlli figlio memorizzati nell'oggetto ControlCollection in un oggetto Array, a cominciare 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 che consente di scorrere l'oggetto ControlCollection.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
IndexOf(Control)

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

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
Remove(Control)

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

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

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Metodi di estensione

Cast<TResult>(IEnumerable)

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

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.
AsParallel(IEnumerable)

Consente la parallelizzazione di una query.
AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.

Si applica a

Vedi anche