ControlCollection Klasa

Definicja

Udostępnia kontener kolekcji, który umożliwia ASP.NET kontrolek serwera w celu zachowania listy kontrolek podrzędnych.

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 zastępuje metodęControl.CreateChildControls, aby utworzyć dwie kontrolki, oba wystąpienia klasy niestandardowej o nazwie , która ma właściwość string o nazwie ChildControlMessage. Po utworzeniu te dwie kontrolki są dodawane do elementu ControlCollection. Metoda jest wywoływana Add na każdym z tych kontrolek, aby dodać je do klasy zawierającej tę wersję .Control.CreateChildControls Właściwość jest ustawiona ChildControlsCreated tak true , aby te kontrolki nie były ponownie tworzone niepotrzebnie.


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

Dostęp do dowolnej właściwości i metod ControlCollection klasy można uzyskać za pośrednictwem Control.Controls właściwości . Control Ponieważ klasa jest klasą bazową dla wszystkich kontrolek serwera ASP.NET, wszystkie kontrolki serwera dziedziczą tę właściwość.

Aby uzyskać więcej informacji na temat kolekcji, zobacz Kolekcje i struktury danych.

Konstruktory

ControlCollection(Control)

Inicjuje ControlCollection nowe wystąpienie klasy dla określonej nadrzędnej kontrolki serwera.

Właściwości

Count

Pobiera liczbę kontrolek serwera w ControlCollection obiekcie dla określonej kontroli serwera ASP.NET.

IsReadOnly

Pobiera wartość wskazującą, czy ControlCollection obiekt jest tylko do odczytu.

IsSynchronized

Pobiera wartość wskazującą, czy ControlCollection obiekt jest synchronizowany.

Item[Int32]

Pobiera odwołanie do kontrolki serwera w określonej lokalizacji indeksu ControlCollection w obiekcie.

Owner

Pobiera ASP.NET kontrolę serwera, do której ControlCollection należy obiekt.

SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do kolekcji kontrolek.

Metody

Add(Control)

Dodaje określony Control obiekt do kolekcji.

AddAt(Int32, Control)

Dodaje określony Control obiekt do kolekcji w określonej lokalizacji indeksu.

Clear()

Usuwa wszystkie kontrolki z obiektu bieżącego formantu ControlCollection serwera.

Contains(Control)

Określa, czy określona kontrolka serwera znajduje się w obiekcie nadrzędnej kontrolki ControlCollection serwera.

CopyTo(Array, Int32)

Kopiuje kontrolki podrzędne przechowywane w ControlCollection obiekcie do Array obiektu, począwszy od określonej lokalizacji indeksu w obiekcie Array.

Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.

(Odziedziczone po Object)
GetEnumerator()

Pobiera moduł wyliczający, który może iterować przez ControlCollection obiekt.

GetHashCode()

Służy jako domyślna funkcja skrótu.

(Odziedziczone po Object)
GetType()

Type Pobiera bieżące wystąpienie.

(Odziedziczone po Object)
IndexOf(Control)

Pobiera indeks określonego Control obiektu w kolekcji.

MemberwiseClone()

Tworzy płytkią kopię bieżącego Objectelementu .

(Odziedziczone po Object)
Remove(Control)

Usuwa określoną kontrolkę serwera z obiektu nadrzędnego formantu ControlCollection serwera.

RemoveAt(Int32)

Usuwa kontrolkę podrzędną w określonej lokalizacji indeksu ControlCollection z obiektu.

ToString()

Zwraca ciąg reprezentujący bieżący obiekt.

(Odziedziczone po Object)

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy elementu IEnumerable na określony typ.

OfType<TResult>(IEnumerable)

Filtruje elementy elementu IEnumerable na podstawie określonego typu.

AsParallel(IEnumerable)

Umożliwia równoległość zapytania.

AsQueryable(IEnumerable)

Konwertuje element IEnumerable na .IQueryable

Dotyczy

Zobacz też