ControlCollection ControlCollection ControlCollection ControlCollection Class

Definizione

Fornisce un contenitore di insiemi che consente ai controlli server ASP.NET di conservare un elenco dei controlli figlio.Provides a collection container that enables ASP.NET server controls to maintain a list of their child controls.

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à
ControlCollectionControlCollectionControlCollectionControlCollection
Derivato
Implementazioni

Esempi

Nell'esempio di codice viene eseguito l'override di Control.CreateChildControls metodo per creare due controlli, entrambe le istanze della classe personalizzata denominata ChildControl, che include una proprietà stringa denominata Message.The following code example overrides the Control.CreateChildControls method to create two controls, both instances of the custom class named ChildControl, which has a string property named Message. Quando si crea, i due controlli vengono aggiunti per il ControlCollection.When created, the two controls are added to the ControlCollection. Il Add metodo viene chiamato su ognuno di questi controlli per aggiungerli alla classe che contiene questa versione di Control.CreateChildControls.The Add method is called on each of these controls to add them to the class that contains this version of Control.CreateChildControls. Il ChildControlsCreated è impostata su true in modo che questi controlli non verranno creati nuovamente inutilmente.The ChildControlsCreated property is set to true so that these controls will not be created again unnecessarily.


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


Commenti

È possibile accedere a qualsiasi proprietà e metodi del ControlCollection classe tramite la Control.Controls proprietà.You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Poiché il Control classe è la classe base per tutti i controlli server ASP.NET, tutti i controlli server ereditano questa proprietà.Since the Control class is the base class for all ASP.NET server controls, all server controls inherit this property.

Per altre informazioni sulle raccolte, vedere raccolte e strutture di dati.For more information about collections, see Collections and Data Structures.

Costruttori

ControlCollection(Control) ControlCollection(Control) ControlCollection(Control) ControlCollection(Control)

Inizializza una nuova istanza della classe ControlCollection per il controllo server padre specificato.Initializes a new instance of the ControlCollection class for the specified parent server control.

Proprietà

Count Count Count 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.

IsReadOnly IsReadOnly IsReadOnly IsReadOnly

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

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

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

Item[Int32] Item[Int32] Item[Int32] 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.

Owner Owner Owner Owner

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

SyncRoot SyncRoot SyncRoot SyncRoot

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

Metodi

Add(Control) Add(Control) Add(Control) Add(Control)

Aggiunge l'oggetto Control specificato alla raccolta.Adds the specified Control object to the collection.

AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control) AddAt(Int32, Control)

Aggiunge l'oggetto Control specificato all'insieme nella posizione di indice specificata.Adds the specified Control object to the collection at the specified index location.

Clear() Clear() Clear() Clear()

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

Contains(Control) Contains(Control) Contains(Control) 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.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) 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.

Equals(Object) Equals(Object) Equals(Object) 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() GetEnumerator() GetEnumerator() GetEnumerator()

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

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

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

(Inherited from Object)
GetType() GetType() GetType() GetType()

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

(Inherited from Object)
IndexOf(Control) IndexOf(Control) IndexOf(Control) IndexOf(Control)

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

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

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

(Inherited from Object)
Remove(Control) Remove(Control) Remove(Control) 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.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) 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.

ToString() ToString() ToString() 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) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

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

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtra gli elementi di un IEnumerable basato su un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

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

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converte un' IEnumerable a un IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche