Sdílet prostřednictvím

ControlCollection Třída

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 vytvoření dvou ovládacích prvků, obě instance vlastní třídy pojmenované ChildControl, která má řetězcovou vlastnost s názvem Message. Po vytvoření se dva ovládací prvky přidají do ControlCollectionsouboru . Metoda Add je volána na každý z těchto ovládacích prvků přidat je do třídy, která obsahuje tuto verzi Control.CreateChildControls. Vlastnost je nastavená ChildControlsCreated tak true , aby se tyto ovládací prvky zbytečně nevytvořily.


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 ke všem vlastnostem a metodám ControlCollection třídy Control.Controls . Vzhledem k tomu, že Control třída je základní třídou pro všechny ovládací prvky serveru ASP.NET, všechny ovládací prvky serveru dědí tuto vlastnost.

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

Konstruktory

Name Description
ControlCollection(Control)

Inicializuje novou instanci ControlCollection třídy pro zadaný nadřazený server řízení.

Vlastnosti

Name Description
Count

Získá počet server ovládacích prvků v objektu ControlCollection pro zadaný ASP.NET server řízení.
IsReadOnly

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

Získá hodnotu určující, zda ControlCollection objekt je synchronizován.
Item[Int32]

Získá odkaz na server řízení v zadaném umístění indexu v objektu ControlCollection .
Owner

Získá ASP.NET serverový ovládací prvek, do kterého ControlCollection objekt patří.
SyncRoot

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

Metody

Name Description
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 ControlCollection ovládacího prvku serveru.
Contains(Control)

Určuje, zda je zadaný ovládací prvek serveru v objektu nadřazeného ControlCollection ovládacího prvku serveru.
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čuje, zda je zadaný objekt roven 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í funkce hash.

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

Získá Type aktuální instance.

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

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

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

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

Odebere zadaný serverový ovládací prvek z objektu nadřazeného ControlCollection ovládacího prvku serveru.
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í

Name Description
AsParallel(IEnumerable)

Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)

Převede IEnumerable na IQueryable.
Cast<TResult>(IEnumerable)

Přetypuje prvky IEnumerable na zadaný typ.
OfType<TResult>(IEnumerable)

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

Platí pro

Viz také