ControlCollection Třída

Definice

Poskytuje kontejner kolekce, který umožňuje ASP.NET serverové ovládací prvky udržovat seznam podřízených ovládacích prvků.

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
Dědičnost
ControlCollection
Odvozené
Implementuje

Příklady

Následující příklad kódu přepíše metodu Control.CreateChildControls pro vytvoření dvou ovládacích prvků, obou instancí vlastní třídy s názvem ChildControl, která má řetězcovou vlastnost s názvem Message. Po vytvoření se tyto dva ovládací prvky přidají do objektu ControlCollection. Metoda Add je volána u každého z těchto ovládacích prvků, aby se přidaly do třídy, která obsahuje tuto verzi nástroje Control.CreateChildControls. Vlastnost ChildControlsCreated je nastavená na true , aby se tyto ovládací prvky znovu zbytečně nevytvářely.


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


Poznámky

Prostřednictvím vlastnosti můžete přistupovat k libovolným vlastnostem a metodám ControlCollection třídy Control.Controls . Vzhledem k tomu, že Control třída je základní třídou pro všechny ASP.NET serverové ovládací prvky, všechny serverové ovládací prvky dědí tuto vlastnost.

Další informace o kolekcích najdete v tématu Kolekce a datové struktury.

Konstruktory

ControlCollection(Control)

Inicializuje novou instanci ControlCollection třídy pro zadaný nadřazený server ovládací prvek.

Vlastnosti

Count

Získá počet ovládacích prvků serveru v objektu ControlCollection pro zadaný ASP.NET server ovládacího prvku.

IsReadOnly

Získá hodnotu označující, zda ControlCollection objekt je jen pro čtení.

IsSynchronized

Získá hodnotu označující, zda ControlCollection je objekt synchronizován.

Item[Int32]

Získá odkaz na serverový ovládací prvek v zadaném umístění indexu v objektu ControlCollection .

Owner

Získá ASP.NET server ovládacího prvku, do kterého ControlCollection objekt patří.

SyncRoot

Získá objekt, který lze použít k synchronizaci přístupu ke kolekci ovládacích prvků.

Metody

Add(Control)

Přidá zadaný Control objekt do kolekce.

AddAt(Int32, Control)

Přidá zadaný Control objekt do kolekce v zadaném umístění indexu.

Clear()

Odebere všechny ovládací prvky z objektu aktuálního serverového ControlCollection ovládacího prvku.

Contains(Control)

Určuje, zda je zadaný serverový ovládací prvek v objektu nadřazeného serverového ControlCollection ovládacího prvku.

CopyTo(Array, Int32)

Zkopíruje podřízené ovládací prvky uložené v objektu ControlCollection do objektu Array počínaje zadaným umístěním indexu v objektu Array.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetEnumerator()

Načte enumerátor, který může iterovat objektem ControlCollection .

GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Získá aktuální Type instanci.

(Zděděno od Object)
IndexOf(Control)

Načte index zadaného Control objektu v kolekci.

MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
Remove(Control)

Odebere zadaný serverový ovládací prvek z objektu nadřazeného serverového ControlCollection ovládacího prvku.

RemoveAt(Int32)

Odebere podřízený ovládací prvek v zadaném umístění indexu z objektu ControlCollection .

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Metody rozšíření

Cast<TResult>(IEnumerable)

Přetypuje prvky objektu na IEnumerable zadaný typ.

OfType<TResult>(IEnumerable)

Filtruje prvky objektu IEnumerable na základě zadaného typu.

AsParallel(IEnumerable)

Umožňuje paralelizaci dotazu.

AsQueryable(IEnumerable)

Převede objekt na IEnumerableIQueryable.

Platí pro

Viz také