ControlCollection Třída

Definice

Poskytuje kontejner kolekce, který umožňuje serverovým ovládacím prvkům ASP.NET udržovat seznam svých podřízených ovládacích prvků.Provides a collection container that enables ASP.NET server controls to maintain a list of their child controls.

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 Control.CreateChildControls metodu 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 .The following code example overrides the Control.CreateChildControls method to create two controls, both instances of the custom class named ChildControl, which has a string property named Message. Při vytvoření se dva ovládací prvky přidají do ControlCollection .When created, the two controls are added to the ControlCollection. AddMetoda je volána u každého z těchto ovládacích prvků pro jejich přidání do třídy, která obsahuje tuto verzi Control.CreateChildControls .The Add method is called on each of these controls to add them to the class that contains this version of Control.CreateChildControls. ChildControlsCreatedVlastnost je nastavena na hodnotu true tak, aby se tyto ovládací prvky znovu nevytvořily zbytečně.The ChildControlsCreated property is set to true so that these controls will not be created again unnecessarily.


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

Ke všem vlastnostem a metodám třídy můžete přistupovat ControlCollection prostřednictvím Control.Controls Vlastnosti.You can access any of the properties and methods of the ControlCollection class through the Control.Controls property. Vzhledem k Control tomu, že třída je základní třídou pro všechny serverové ovládací prvky ASP.NET, zdědí Tato vlastnost všechny serverové ovládací prvky.Since the Control class is the base class for all ASP.NET server controls, all server controls inherit this property.

Další informace o kolekcích najdete v tématu kolekce a datové struktury.For more information about collections, see Collections and Data Structures.

Konstruktory

ControlCollection(Control)

Inicializuje novou instanci ControlCollection třídy pro zadaný nadřazený ovládací prvek serveru.Initializes a new instance of the ControlCollection class for the specified parent server control.

Vlastnosti

Count

Získá počet ovládacích prvků serveru v ControlCollection objektu pro zadaný serverový ovládací prvek ASP.NET.Gets the number of server controls in the ControlCollection object for the specified ASP.NET server control.

IsReadOnly

Načte hodnotu, která označuje, zda ControlCollection je objekt určen jen pro čtení.Gets a value indicating whether the ControlCollection object is read-only.

IsSynchronized

Načte hodnotu, která označuje, jestli ControlCollection je objekt synchronizovaný.Gets a value indicating whether the ControlCollection object is synchronized.

Item[Int32]

Získá odkaz na serverový ovládací prvek v zadaném umístění indexu v ControlCollection objektu.Gets a reference to the server control at the specified index location in the ControlCollection object.

Owner

Získá ovládací prvek serveru ASP.NET, ke kterému ControlCollection objekt patří.Gets the ASP.NET server control to which the ControlCollection object belongs.

SyncRoot

Získává objekt, který lze použít k synchronizaci přístupu ke kolekci ovládacích prvků.Gets an object that can be used to synchronize access to the collection of controls.

Metody

Add(Control)

Přidá zadaný Control objekt do kolekce.Adds the specified Control object to the collection.

AddAt(Int32, Control)

Přidá zadaný Control objekt do kolekce v zadaném umístění indexu.Adds the specified Control object to the collection at the specified index location.

Clear()

Odebere všechny ovládací prvky z aktuálního objektu serverového ovládacího prvku ControlCollection .Removes all controls from the current server control's ControlCollection object.

Contains(Control)

Určuje, zda je zadaný serverový ovládací prvek v objektu nadřazeného serverového ovládacího prvku ControlCollection .Determines whether the specified server control is in the parent server control's ControlCollection object.

CopyTo(Array, Int32)

Zkopíruje podřízené ovládací prvky uložené v ControlCollection objektu do Array objektu, počínaje zadaným indexovým umístěním v Array .Copies the child controls stored in the ControlCollection object to an Array object, beginning at the specified index location in the Array.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.Determines whether the specified object is equal to the current object.

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

Načte enumerátor, který může iterovat prostřednictvím ControlCollection objektu.Retrieves an enumerator that can iterate through the ControlCollection object.

GetHashCode()

Slouží jako výchozí funkce hash.Serves as the default hash function.

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

Získá Type aktuální instanci.Gets the Type of the current instance.

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

Načte index zadaného Control objektu v kolekci.Retrieves the index of a specified Control object in the collection.

MemberwiseClone()

Vytvoří kopii aktuálního seznamu Object .Creates a shallow copy of the current Object.

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

Odebere zadaný serverový ovládací prvek z objektu nadřazeného serverového ovládacího prvku ControlCollection .Removes the specified server control from the parent server control's ControlCollection object.

RemoveAt(Int32)

Odebere podřízený ovládací prvek v zadaném umístění indexu z ControlCollection objektu.Removes a child control, at the specified index location, from the ControlCollection object.

ToString()

Vrátí řetězec, který představuje aktuální objekt.Returns a string that represents the current object.

(Zděděno od Object)

Metody rozšíření

Cast<TResult>(IEnumerable)

Přetypování prvky IEnumerable na zadaný typ.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje prvky IEnumerable založené na zadaném typu.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Povoluje paralelní zpracování dotazu.Enables parallelization of a query.

AsQueryable(IEnumerable)

Převede IEnumerable na IQueryable .Converts an IEnumerable to an IQueryable.

Platí pro

Viz také