ControlCollection Klasa

Definicja

Dostarcza kontener kolekcji, który umożliwia kontrolki serwera ASP.NET, aby zachować listę ich formantów podrzędnych.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
Dziedziczenie
ControlCollection
Pochodne
Implementuje

Przykłady

Poniższy przykład kodu przesłania Control.CreateChildControls metodę, aby utworzyć dwie kontrolki, oba wystąpienia klasy niestandardowej o nazwie ChildControl, która ma właściwość String o nazwie 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. Po utworzeniu te dwa kontrolki są dodawane do ControlCollection.When created, the two controls are added to the ControlCollection. Metoda jest wywoływana dla każdej z tych kontrolek, aby dodać do klasy, która zawiera tę wersję programu Control.CreateChildControls. AddThe Add method is called on each of these controls to add them to the class that contains this version of Control.CreateChildControls. Właściwość jest ustawiona na true tak, aby te kontrolki nie były tworzone ponownie. ChildControlsCreatedThe 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


Uwagi

Można uzyskać dostęp do dowolnych właściwości i metod ControlCollection klasy Control.Controls za pomocą właściwości.You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Control Ponieważ Klasa jest klasą bazową dla wszystkich kontrolek serwera ASP.NET, wszystkie kontrolki serwera dziedziczą tę właściwość.Since the Control class is the base class for all ASP.NET server controls, all server controls inherit this property.

Aby uzyskać więcej informacji na temat kolekcji, zobacz kolekcje i struktury danych.For more information about collections, see Collections and Data Structures.

Konstruktory

ControlCollection(Control)

Inicjuje nowe wystąpienie ControlCollection klasy dla określonej kontrolki nadrzędnego serwera.Initializes a new instance of the ControlCollection class for the specified parent server control.

Właściwości

Count

Pobiera liczbę kontrolek serwera w ControlCollection obiekcie dla określonej kontrolki serwera ASP.NET.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

IsReadOnly

Pobiera wartość wskazującą, ControlCollection czy obiekt jest tylko do odczytu.Gets a value indicating whether the ControlCollection object is read-only.

IsSynchronized

Pobiera wartość wskazującą, ControlCollection czy obiekt jest zsynchronizowany.Gets a value indicating whether the ControlCollection object is synchronized.

Item[Int32]

Pobiera odwołanie do kontrolki serwera w określonej lokalizacji indeksu w ControlCollection obiekcie.Gets a reference to the server control at the specified index location in the ControlCollection object.

Owner

Pobiera formant serwera ASP.NET, do którego ControlCollection należy obiekt.Gets the ASP.NET server control to which the ControlCollection object belongs.

SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do kolekcji kontrolek.Gets an object that can be used to synchronize access to the collection of controls.

Metody

Add(Control)

Dodaje określony Control obiekt do kolekcji.Adds the specified Control object to the collection.

AddAt(Int32, Control)

Dodaje określony Control obiekt do kolekcji w określonej lokalizacji indeksu.Adds the specified Control object to the collection at the specified index location.

Clear()

Usuwa wszystkie kontrolki z ControlCollection obiektu bieżącego formantu serwera.Removes all controls from the current server control's ControlCollection object.

Contains(Control)

Określa, czy określony formant serwera znajduje się w ControlCollection obiekcie nadrzędnego formantu serwera.Determines whether the specified server control is in the parent server control's ControlCollection object.

CopyTo(Array, Int32)

Kopiuje kontrolki podrzędne przechowywane w ControlCollection obiekcie Array do obiektu, rozpoczynając od Arrayokreślonej lokalizacji indeksu w.Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetEnumerator()

Pobiera moduł wyliczający, który może wykonywać ControlCollection iterację obiektu.Retrieves an enumerator that can iterate through the ControlCollection object.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
IndexOf(Control)

Pobiera indeks określonego Control obiektu w kolekcji.Retrieves the index of a specified Control object in the collection.

MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
Remove(Control)

Usuwa określony formant serwera z ControlCollection obiektu nadrzędnego formantu serwera.Removes the specified server control from the parent server control's ControlCollection object.

RemoveAt(Int32)

Usuwa formant podrzędny w określonej lokalizacji indeksu z ControlCollection obiektu.Removes a child control, at the specified index location, from the ControlCollection object.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy IEnumerable określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

IEnumerable KonwertujeIQueryabledo.Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też