ControlCollection Klasa
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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 ChildControl
Message
. 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 |