ControlCollection Třída

  • Reference

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

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
Object
ControlCollection
Odvozené
Implementuje
ICollection IEnumerable

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é