DataControlFieldCollection Třída

Definice

Obor názvů:

System.Web.UI.WebControls

Sestavení:

System.Web.dll

Představuje kolekci DataControlField objektů, které jsou používány ovládacími prvky vázanémi 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 svázanými daty k určení způsobu zobrazení podřízených DataControlField ovládacích prvků. Třída DataControlFieldCollection je odvozena z 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é jsou dynamicky přidány do kolekce budou znovu přidány do ovládacího prvku při obnovení stavu. 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 svůj stav v ASP.NET zobrazení stavu. )

DataControlFieldCollection Pomocí třídy můžete programově spravovat sadu DataControlField objektů. Všimněte si, že deklarativní definování těchto polí je častější.

Objekty můžete přidávat, vkládat a odebírat DataControlField pomocí vhodných DataControlFieldCollection metod 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.

• Použijte metodu GetEnumerator k vytvoření -implementovaného objektu System.Collections.IEnumerator, který lze použít k získání položek z kolekce.

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

Pokud používáte GridView nebo DetailsView používáte 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 polí. K objektům, které se negenerují automaticky, můžete přistupovat a manipulovat s DataControlField 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 z ní.
ButtonField	Pole ovládacího prvku vázaného na data, které zobrazuje aspoň 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é se dají provádět s daty zobrazenými řá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

Name	Description
DataControlFieldCollection()	Inicializuje novou instanci DataControlFieldCollection třídy.

Vlastnosti

Name	Description
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 v zadaném indexu v kolekci.

Metody

Name	Description
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čuje, zda je zadaný objekt roven 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 typů IStateManager , které StateManagedCollection kolekce může obsahovat. (Zděděno od StateManagedCollection)
GetType()	Získá Type aktuální instance. (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 DataControlFieldCollection kolekce v zadaném indexu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
OnClear()	Při přepsání v odvozené třídě provede další práci předtím, než Clear() metoda odebere všechny položky 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 IList.Insert(Int32, Object) přidáním položky do kolekce.IList.Add(Object) (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) přidání položky IList.Add(Object) 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) odebráním IList.RemoveAt(Int32) 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) odebrání IList.RemoveAt(Int32) 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í serializaci celé StateManagedCollection kolekce 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ával 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

Name	Description
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 vyvolána také kdykoliv DataControlField v kolekci vyvolá událost FieldChanged .

Explicitní implementace rozhraní

Name	Description
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í, zda 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í false ve všech případech. (Zděděno od StateManagedCollection)
IList.IsReadOnly	Získá hodnotu určující, zda StateManagedCollection kolekce je 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 jeho 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 v kolekci a každý IStateManager objekt, který obsahuje od doby, kdy byla stránka odeslána zpět na server. (Zděděno od StateManagedCollection)
IStateManager.TrackViewState()	Způsobí, že StateManagedCollection kolekce a každý z IStateManager objektů, které obsahuje, bude sledovat změny jejich stavu zobrazení, aby bylo možné je zachovat napříč požadavky na stejnou stránku. (Zděděno od StateManagedCollection)

Metody rozšíření

Name	Description
AsParallel(IEnumerable)	Umožňuje paralelizaci dotazu.
AsQueryable(IEnumerable)	Převede na IEnumerable .IQueryable
Cast<TResult>(IEnumerable)	Přetypuje prvky zadaného IEnumerable typu.
OfType<TResult>(IEnumerable)	Filtruje prvky IEnumerable na základě zadaného typu.

Viz také

• DataControlField
• GridView
• DetailsView