DataControlFieldCollection Třída

Reference

Definice

Obor názvů:: System.Web.UI.WebControls

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Představuje kolekci DataControlField objektů, které používají ovládací prvky vázané na data, například GridView a DetailsView.

public ref class DataControlFieldCollection sealed : System::Web::UI::StateManagedCollection

public sealed class DataControlFieldCollection : System.Web.UI.StateManagedCollection

type DataControlFieldCollection = class
    inherit StateManagedCollection

Public NotInheritable Class DataControlFieldCollection
Inherits StateManagedCollection

Dědičnost: Object

StateManagedCollection
DataControlFieldCollection

Poznámky

Třída DataControlFieldCollection představuje kolekci objektů používaných ovládacími prvky vázané na data k určení způsobu zobrazení podřízených DataControlField ovládacích prvků. Třída DataControlFieldCollection je odvozena od StateManagedCollectionabstraktní základní kolekce třídy použité speciálně k ukládání IStateManager objektů.

Objekt StateManagedCollection ovlivňuje chování objektu DataControlFieldCollection . DataControlField objekty, které se dynamicky přidají do kolekce, se při obnovení stavu znovu přidají do ovládacího prvku. To znamená, že pole musí být přidáno, odebráno nebo změněno jen jednou místo každého postbacku, protože většina typů kolekcí v ASP.NET vyžaduje.

(Třída DataControlField implementuje IStateManager rozhraní, které umožňuje uložit jeho stav do ASP.NET stavu zobrazení. )

DataControlFieldCollection Pomocí třídy můžete programově spravovat sadu DataControlField objektů. Všimněte si, že je běžnější definovat tato pole deklarativním způsobem.

Objekty můžete přidávat, vkládat a odebírat DataControlField pomocí příslušných metod DataControlFieldCollection třídy. K programovému načtení DataControlField objektů z kolekce použijte jednu z následujících metod:

Indexer slouží k získání jednoho DataControlField objektu z kolekce pomocí zápisu pole.
GetEnumerator Pomocí metody vytvořte -implementovaný System.Collections.IEnumeratorobjekt, který lze použít k získání položek z kolekce.

Vlastnost Count určuje celkový počet položek v kolekci a běžně se používá k určení horní hranice kolekce. Položky můžete do kolekce přidávat a odebírat pomocí Addmetody , Insert, Removea RemoveAt metody.

Pokud používáte nebo používáte GridView ovládací prvek, objekty, DataControlField které jsou automaticky vytvořeny (například když AutoGenerateColumns je truevlastnost ) nejsou uloženy v kolekci veřejně přístupných DetailsView polí. K objektům, které se negenerují automaticky, můžete přistupovat a manipulovat DataControlField s nimi.

Následující tabulka uvádí různé třídy polí ovládacího prvku dat a způsob jejich použití.

Třída parametru	Description
DataControlField	Abstraktní základní třída pro všechna pole.
BoundField	Pole ovládacího prvku vázaného na data, které se používá k vytvoření vazby na text nebo data načtená z ASP.NET ovládacího prvku zdroje dat.
ButtonFieldBase	Pole ovládacího prvku vázaného na data, které zapouzdřuje obecné funkce tlačítka. ButtonField a CheckBoxField jsou odvozeny od něj.
ButtonField	Pole ovládacího prvku vázaného na data, které zobrazuje alespoň jedno tlačítko.
CheckBoxField	Pole ovládacího prvku vázaného CheckBox na data, které zobrazuje ovládací prvek.
CommandField	Pole ovládacího prvku vázaného na data, které zobrazuje akce, které lze provést u dat zobrazených řádkem (nebo sloupcem), jako jsou úpravy, aktualizace nebo odstranění.
HyperLinkField	Pole ovládacího prvku vázaného HyperLink na data, které zobrazuje ovládací prvek.
ImageField	Pole ovládacího prvku vázaného Image na data, které zobrazuje ovládací prvek.
TemplateField	Pole ovládacího prvku vázaného na data, které zobrazuje vlastní obsah v ovládacím prvku vázaném na data.

Konstruktory

DataControlFieldCollection()

Inicializuje novou instanci DataControlFieldCollection třídy.

Vlastnosti

Count	Získá počet prvků obsažených v kolekci StateManagedCollection . (Zděděno od StateManagedCollection)
Item[Int32]	Získá nebo nastaví DataControlField objekt na zadaném indexu v kolekci.

Metody

Add(DataControlField)	Připojí zadaný DataControlField objekt na konec kolekce.
Clear()	Odebere všechny položky z StateManagedCollection kolekce. (Zděděno od StateManagedCollection)
CloneFields()	Vytvoří kopii aktuální kolekce.
Contains(DataControlField)	Určuje, zda DataControlFieldCollection kolekce obsahuje konkrétní DataControlField objekt.
CopyTo(Array, Int32)	Zkopíruje prvky StateManagedCollection kolekce do pole počínaje konkrétním indexem pole. (Zděděno od StateManagedCollection)
CopyTo(DataControlField[], Int32)	Zkopíruje celou DataControlFieldCollection kolekci do kompatibilního jednorozměrného Array, počínaje zadaným indexem cílového pole.
CreateKnownType(Int32)	Při přepsání v odvozené třídě vytvoří instanci třídy, která implementuje IStateManager. Typ vytvořeného objektu je založen na zadaném členu kolekce vrácené metodou GetKnownTypes() . (Zděděno od StateManagedCollection)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetEnumerator()	Vrátí iterátor, který prochází kolekcí StateManagedCollection . (Zděděno od StateManagedCollection)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetKnownTypes()	Při přepsání v odvozené třídě získá pole IStateManager typů, které StateManagedCollection kolekce může obsahovat. (Zděděno od StateManagedCollection)
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
IndexOf(DataControlField)	Určuje index konkrétního DataControlField objektu v kolekci.
Insert(Int32, DataControlField)	Vloží zadaný DataControlField objekt do kolekce v zadaném DataControlFieldCollection indexu.
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (Zděděno od Object)
OnClear()	Při přepsání v odvozené třídě provede další práci před Clear() odebráním všech položek z kolekce. (Zděděno od StateManagedCollection)
OnClearComplete()	Při přepsání v odvozené třídě provede další práci po Clear() dokončení metody odebrání všech položek z kolekce. (Zděděno od StateManagedCollection)
OnInsert(Int32, Object)	Při přepsání v odvozené třídě provede další práci před tím, než IList.Insert(Int32, Object) metoda IList.Add(Object) přidá položku do kolekce. (Zděděno od StateManagedCollection)
OnInsertComplete(Int32, Object)	Při přepsání v odvozené třídě provede další práci po IList.Insert(Int32, Object) IList.Add(Object) přidání položky do kolekce. (Zděděno od StateManagedCollection)
OnRemove(Int32, Object)	Při přepsání v odvozené třídě provede další práci před IList.Remove(Object) IList.RemoveAt(Int32) odebráním zadané položky z kolekce. (Zděděno od StateManagedCollection)
OnRemoveComplete(Int32, Object)	Při přepsání v odvozené třídě provede další práci po IList.Remove(Object) IList.RemoveAt(Int32) odebrání zadané položky z kolekce. (Zděděno od StateManagedCollection)
OnValidate(Object)	Při přepsání v odvozené třídě ověří prvek StateManagedCollection kolekce. (Zděděno od StateManagedCollection)
Remove(DataControlField)	Odebere zadaný DataControlField objekt z DataControlFieldCollection kolekce.
RemoveAt(Int32)	Odebere DataControlField objekt v zadaném indexu DataControlFieldCollection z kolekce.
SetDirty()	Vynutí, aby se celá StateManagedCollection kolekce serializovala do stavu zobrazení. (Zděděno od StateManagedCollection)
SetDirtyObject(Object)	Při přepsání v odvozené třídě dává kolekci pokyn `object` , aby zaznamenával celý stav, aby zobrazoval stav, a ne zaznamenávat pouze informace o změnách. (Zděděno od StateManagedCollection)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

událost

FieldsChanged

Nastane, když se pole v kolekci změní, obvykle jako výsledek Clear()volání , Insert(Int32, DataControlField)Remove(DataControlField) nebo Add(DataControlField) metody. Tato událost je také vyvolána kdykoli DataControlField v kolekci vyvolá svou FieldChanged událost.

Explicitní implementace rozhraní

ICollection.Count	Získá počet prvků obsažených v kolekci StateManagedCollection . (Zděděno od StateManagedCollection)
ICollection.IsSynchronized	Získá hodnotu označující, jestli StateManagedCollection je kolekce synchronizována (bezpečné vlákno). Tato metoda vrátí `false` ve všech případech. (Zděděno od StateManagedCollection)
ICollection.SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k kolekci StateManagedCollection . Tato metoda vrátí `null` ve všech případech. (Zděděno od StateManagedCollection)
IEnumerable.GetEnumerator()	Vrátí iterátor, který prochází kolekcí StateManagedCollection . (Zděděno od StateManagedCollection)
IList.Add(Object)	Přidá položku do StateManagedCollection kolekce. (Zděděno od StateManagedCollection)
IList.Clear()	Odebere všechny položky z StateManagedCollection kolekce. (Zděděno od StateManagedCollection)
IList.Contains(Object)	Určuje, zda StateManagedCollection kolekce obsahuje konkrétní hodnotu. (Zděděno od StateManagedCollection)
IList.IndexOf(Object)	Určuje index zadané položky v kolekci StateManagedCollection . (Zděděno od StateManagedCollection)
IList.Insert(Int32, Object)	Vloží položku do StateManagedCollection kolekce v zadaném indexu. (Zděděno od StateManagedCollection)
IList.IsFixedSize	Získá hodnotu určující, zda StateManagedCollection kolekce má pevnou velikost. Tato metoda vrátí ve `false` všech případech. (Zděděno od StateManagedCollection)
IList.IsReadOnly	Získá hodnotu označující, zda StateManagedCollection je kolekce jen pro čtení. (Zděděno od StateManagedCollection)
IList.Item[Int32]	IStateManager Získá prvek v zadaném indexu. (Zděděno od StateManagedCollection)
IList.Remove(Object)	Odebere první výskyt zadaného objektu StateManagedCollection z kolekce. (Zděděno od StateManagedCollection)
IList.RemoveAt(Int32)	Odebere IStateManager prvek v zadaném indexu. (Zděděno od StateManagedCollection)
IStateManager.IsTrackingViewState	Získá hodnotu určující, zda StateManagedCollection kolekce ukládá změny do stavu zobrazení. (Zděděno od StateManagedCollection)
IStateManager.LoadViewState(Object)	Obnoví dříve uložený stav StateManagedCollection zobrazení kolekce a IStateManager položky, které obsahuje. (Zděděno od StateManagedCollection)
IStateManager.SaveViewState()	Uloží změny StateManagedCollection kolekce a každý IStateManager objekt, který obsahuje od doby, kdy byla stránka publikována zpět na server. (Zděděno od StateManagedCollection)
IStateManager.TrackViewState()	StateManagedCollection Způsobí, že kolekce a každý z IStateManager objektů, které obsahuje, budou sledovat změny jejich stavu zobrazení, aby je bylo možné uchovávat napříč požadavky na stejnou stránku. (Zděděno od StateManagedCollection)

Metody rozšíření

Cast<TResult>(IEnumerable)	Přetypuje prvky zadaného IEnumerable typu.
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable založené na zadaném typu.
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede na IEnumerable IQueryable.

Platí pro