Classe ControlCollection (System.Web.UI)

Cambia visualizzazione:
Classica
Lightweight
ScriptFree
Riferimento a .NET Framework
Classe ControlCollection
Il presente articolo è stato tradotto manualmente. Per visualizzare questa pagina e contemporaneamente visualizzarne il contenuto in lingua inglese, passare alla visualizzazione semplificata.

Fornisce un contenitore di insiemi che consente ai controlli server ASP.NET di conservare un elenco dei controlli figlio.

Gerarchia di ereditarietà
System.Object
  System.Web.UI.ControlCollection
    System.Web.UI.EmptyControlCollection
    System.Web.UI.HtmlControls.HtmlTable.HtmlTableRowControlCollection
    System.Web.UI.HtmlControls.HtmlTableRow.HtmlTableCellControlCollection
    System.Web.UI.WebControls.Table.RowControlCollection
    System.Web.UI.WebControls.TableRow.CellControlCollection
    System.Web.UI.WebControls.ViewCollection

Spazio dei nomi:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)
Sintassi
Visual Basic
Public Class ControlCollection _
	Implements ICollection, IEnumerable
C#
public class ControlCollection : ICollection, 
	IEnumerable
Visual C++
public ref class ControlCollection : ICollection, 
	IEnumerable
F#
type ControlCollection =  
    class
        interface ICollection
        interface IEnumerable
    end

Il tipo ControlCollection espone i seguenti membri.

Costruttori
  Nome Descrizione
Metodo pubblico ControlCollection Inizializza una nuova istanza della classe ControlCollection per il controllo server padre specificato.
In alto
Proprietà
  Nome Descrizione
Proprietà pubblica Count Ottiene il numero di controlli server nell'oggetto ControlCollection per il controllo server ASP.NET specificato.
Proprietà pubblica IsReadOnly Ottiene un valore che indica se l'oggetto ControlCollection è di sola lettura.
Proprietà pubblica IsSynchronized Ottiene un valore che indica se l'oggetto ControlCollection è sincronizzato.
Proprietà pubblica Item Ottiene un riferimento al controllo server nella posizione di indice specificata nell'oggetto ControlCollection.
Proprietà protetta. Owner Ottiene il controllo server ASP.NET cui l'oggetto ControlCollection appartiene.
Proprietà pubblica SyncRoot Ottiene un oggetto che può essere utilizzato per sincronizzare l'accesso all'insieme dei controlli.
In alto
Metodi
  Nome Descrizione
Metodo pubblico Add Aggiunge l'oggetto Control specificato all'insieme.
Metodo pubblico AddAt Aggiunge l'oggetto Control specificato all'insieme nella posizione di indice specificata.
Metodo pubblico Clear Rimuove tutti i controlli dall'oggetto ControlCollection del controllo server corrente.
Metodo pubblico Contains Stabilisce se il controllo server specificato è presente nell'oggetto ControlCollection del controllo server padre.
Metodo pubblico CopyTo Copia i controlli figlio memorizzati nell'oggetto ControlCollection in un oggetto System.Array, a cominciare dalla posizione di indice specificata in System.Array.
Metodo pubblico Equals(Object) Determina se l'oggetto Object specificato è uguale all'oggetto Object corrente. (Ereditato da Object)
Metodo protetto Finalize Consente a un oggetto di provare a liberare risorse ed eseguire altre operazioni di pulitura prima che l'oggetto stesso venga recuperato dalla procedura di Garbage Collection. (Ereditato da Object)
Metodo pubblico GetEnumerator Recupera un enumeratore in grado di scorrere l'oggetto ControlCollection.
Metodo pubblico GetHashCode Funge da funzione hash per un determinato tipo. (Ereditato da Object)
Metodo pubblico GetType Ottiene l'oggetto Type dell'istanza corrente. (Ereditato da Object)
Metodo pubblico IndexOf Recupera l'indice di un oggetto Control specificato nell'insieme.
Metodo protetto MemberwiseClone Consente di creare una copia dei riferimenti dell'oggetto Object corrente. (Ereditato da Object)
Metodo pubblico Remove Rimuove il controllo server specificato dall'oggetto ControlCollection del controllo server padre.
Metodo pubblico RemoveAt Rimuove un controllo figlio, nella posizione di indice specificata, dall'oggetto ControlCollection.
Metodo pubblico ToString Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)
In alto
Metodi di estensione
  Nome Descrizione
Metodo di estensione pubblico AsParallel Consente la parallelizzazione di una query. (Definito da ParallelEnumerable).
Metodo di estensione pubblico AsQueryable Converte un oggetto IEnumerable in un oggetto IQueryable. (Definito da Queryable).
Metodo di estensione pubblico Cast<TResult> Converte gli elementi di un oggetto IEnumerable nel tipo specificato. (Definito da Enumerable).
Metodo di estensione pubblico OfType<TResult> Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato. (Definito da Enumerable).
In alto
Note

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

Per ulteriori informazioni sugli insiemi, vedere Insiemi e strutture di dati.

Esempi

Nell'esempio di codice riportato di seguito viene eseguito l'override del metodo Control.CreateChildControls per creare due controlli, che sono entrambi istanze della classe personalizzata denominata ChildControl dotata di una proprietà stringa denominata Message. Quando vengono creati, i due controlli vengono aggiunti all'oggetto ControlCollection. Per ognuno di questi due controlli viene chiamato il metodo Add, che consente di aggiungerli alla classe contenente questa versione del metodo Control.CreateChildControls. La proprietà ChildControlsCreated viene impostata su true in modo che questi controlli vengano ricreati solo in caso di necessità.

Visual Basic

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 'CreateChildControls
C#


      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;
      }
Informazioni sulla versione

.NET Framework

Supportato in: 4, 3.5, 3.0, 2.0, 1.1, 1.0
Piattaforme

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.
Codice thread safe
Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.
Vedere anche

Riferimenti

Spazio dei nomi System.Web.UI
Control
Page
Controls

Altre risorse

Insiemi e strutture di dati