DataControlFieldCollection Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.UI.WebControls

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Reprezentuje kolekcję DataControlField obiektów, które są używane przez kontrolki powiązane z danymi, takie jak GridView i 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

Dziedziczenie: Object

StateManagedCollection
DataControlFieldCollection

Uwagi

Klasa DataControlFieldCollection reprezentuje kolekcję obiektów używanych DataControlField przez kontrolki powiązane z danymi w celu określenia sposobu prezentowania kontrolek podrzędnych. Klasa DataControlFieldCollection pochodzi z StateManagedCollectionklasy , abstrakcyjnej klasy kolekcji bazowej używanej specjalnie do przechowywania IStateManager obiektów.

Obiekt StateManagedCollection wpływa na zachowanie DataControlFieldCollection obiektu. DataControlField obiekty, które są dynamicznie dodawane do kolekcji, zostaną ponownie dodane do kontrolki po przywróceniu stanu. Oznacza to, że pole musi zostać dodane, usunięte lub zmienione tylko raz, a nie na każdym poście zwrotnym, ponieważ większość typów kolekcji w ASP.NET wymaga.

(Klasa DataControlField implementuje IStateManager interfejs, który umożliwia przechowywanie stanu w ASP.NET stanie widoku. )

DataControlFieldCollection Użyj klasy , aby programowo zarządzać zestawem DataControlField obiektów. Należy pamiętać, że częściej definiuje się te pola deklaratywnie.

Obiekty można dodawać, wstawiać i usuwać DataControlField przy użyciu odpowiednich metod DataControlFieldCollection klasy. Aby programowo pobrać DataControlField obiekty z kolekcji, użyj jednej z następujących metod:

Użyj indeksatora, aby uzyskać pojedynczy DataControlField obiekt z kolekcji przy użyciu notacji tablicy.
GetEnumerator Użyj metody , aby utworzyć System.Collections.IEnumeratorobiekt implementowany, który następnie może służyć do pobierania elementów z kolekcji.

Właściwość Count określa całkowitą liczbę elementów w kolekcji i jest często używana do określenia górnej granicy kolekcji. Elementy można dodawać i usuwać z kolekcji przy użyciu Addmetod , Insert, Removei RemoveAt .

Jeśli używasz kontrolki GridView lub DetailsView , DataControlField obiekty, które są tworzone automatycznie (na przykład gdy AutoGenerateColumns właściwość to true) nie są przechowywane w kolekcji pól publicznie dostępnych. Można uzyskiwać dostęp tylko do obiektów, które nie są generowane automatycznie i manipulować DataControlField nimi.

W poniższej tabeli wymieniono różne klasy pól kontroli danych i sposób ich użycia.

Parametr, klasa	Opis
DataControlField	Abstrakcyjna klasa bazowa dla wszystkich pól.
BoundField	Pole kontrolki powiązane z danymi używane do powiązania z tekstem lub danymi pobranymi z kontroli źródła danych ASP.NET.
ButtonFieldBase	Pole kontrolki powiązane z danymi, które hermetyzuje ogólną funkcjonalność przycisku. ButtonField i CheckBoxField pochodzą z niego.
ButtonField	Pole kontrolki powiązane z danymi, które wyświetla co najmniej jeden przycisk.
CheckBoxField	Pole kontrolki powiązane z danymi, które wyświetla kontrolkę CheckBox .
CommandField	Pole kontrolki powiązane z danymi, które wyświetla akcje, które można wykonać na danych wyświetlanych przez wiersz (lub kolumnę), takie jak edytowanie, aktualizowanie lub usuwanie.
HyperLinkField	Pole kontrolki powiązane z danymi, które wyświetla kontrolkę HyperLink .
ImageField	Pole kontrolki powiązane z danymi, które wyświetla kontrolkę Image .
TemplateField	Pole kontrolki powiązane z danymi, które wyświetla zawartość niestandardową w kontrolce powiązanej z danymi.

Konstruktory

DataControlFieldCollection()

Inicjuje nowe wystąpienie klasy DataControlFieldCollection.

Właściwości

Count	Pobiera liczbę elementów zawartych w kolekcji StateManagedCollection . (Odziedziczone po StateManagedCollection)
Item[Int32]	Pobiera lub ustawia DataControlField obiekt w określonym indeksie w kolekcji.

Metody

Add(DataControlField)	Dołącza określony DataControlField obiekt na końcu kolekcji.
Clear()	Usuwa wszystkie elementy z kolekcji StateManagedCollection . (Odziedziczone po StateManagedCollection)
CloneFields()	Tworzy kopię bieżącej kolekcji.
Contains(DataControlField)	Określa, czy DataControlFieldCollection kolekcja zawiera określony DataControlField obiekt.
CopyTo(Array, Int32)	Kopiuje elementy StateManagedCollection kolekcji do tablicy, zaczynając od określonego indeksu tablicy. (Odziedziczone po StateManagedCollection)
CopyTo(DataControlField[], Int32)	Kopiuje całą DataControlFieldCollection kolekcję do zgodnej jednowymiarowej Array, zaczynając od określonego indeksu tablicy docelowej.
CreateKnownType(Int32)	Po przesłonięciu w klasie pochodnej tworzy wystąpienie klasy implementujące IStateManagermetodę . Typ utworzonego obiektu jest oparty na określonym elemencie członkowskim kolekcji zwróconej przez metodę GetKnownTypes() . (Odziedziczone po StateManagedCollection)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetEnumerator()	Zwraca iterator iterujący przez StateManagedCollection kolekcję. (Odziedziczone po StateManagedCollection)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetKnownTypes()	Po zastąpieniu w klasie pochodnej pobiera tablicę IStateManager typów, które StateManagedCollection może zawierać kolekcja. (Odziedziczone po StateManagedCollection)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
IndexOf(DataControlField)	Określa indeks określonego DataControlField obiektu w kolekcji.
Insert(Int32, DataControlField)	Wstawia określony DataControlField obiekt do kolekcji DataControlFieldCollection w określonym indeksie.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
OnClear()	Po zastąpieniu w klasie pochodnej wykonuje dodatkową pracę, zanim Clear() metoda usunie wszystkie elementy z kolekcji. (Odziedziczone po StateManagedCollection)
OnClearComplete()	Po przesłonięciu w klasie pochodnej wykonuje dodatkową pracę po zakończeniu Clear() usuwania wszystkich elementów z kolekcji. (Odziedziczone po StateManagedCollection)
OnInsert(Int32, Object)	Po zastąpieniu klasy pochodnej wykonuje dodatkową pracę przed IList.Insert(Int32, Object) dodaniu elementu do kolekcji przez metodę or IList.Add(Object) . (Odziedziczone po StateManagedCollection)
OnInsertComplete(Int32, Object)	Po zastąpieniu w klasie pochodnej wykonuje dodatkową pracę po IList.Insert(Int32, Object) dodaniu elementu do kolekcji przez metodę or IList.Add(Object) . (Odziedziczone po StateManagedCollection)
OnRemove(Int32, Object)	Po zastąpieniu w klasie pochodnej wykonuje dodatkową pracę przed IList.Remove(Object) usunięciem określonego elementu z kolekcji przez metodę or IList.RemoveAt(Int32) . (Odziedziczone po StateManagedCollection)
OnRemoveComplete(Int32, Object)	W przypadku zastąpienia w klasie pochodnej wykonuje dodatkową pracę po IList.Remove(Object) usunięciu określonego elementu z kolekcji przez metodę or IList.RemoveAt(Int32) . (Odziedziczone po StateManagedCollection)
OnValidate(Object)	Po przesłonięciu w klasie pochodnej weryfikuje element kolekcji StateManagedCollection . (Odziedziczone po StateManagedCollection)
Remove(DataControlField)	Usuwa określony DataControlField obiekt z kolekcji DataControlFieldCollection .
RemoveAt(Int32)	DataControlField Usuwa obiekt w określonym indeksie z kolekcjiDataControlFieldCollection.
SetDirty()	Wymusza serializacji całej StateManagedCollection kolekcji w stan widoku. (Odziedziczone po StateManagedCollection)
SetDirtyObject(Object)	Po przesłonięciu w klasie pochodnej instruuje `object` element zawarty przez kolekcję w celu zarejestrowania całego stanu w celu wyświetlenia stanu, a nie rejestrowania tylko informacji o zmianie. (Odziedziczone po StateManagedCollection)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zdarzenia

FieldsChanged

Występuje, gdy pola w kolekcji zmieniają się, zwykle jako wynik Clear()wywołania metody , Insert(Int32, DataControlField)lub Add(DataControlField) Remove(DataControlField) . To zdarzenie jest również zgłaszane w dowolnym momencie DataControlField w kolekcji zgłasza swoje FieldChanged zdarzenie.

Jawne implementacje interfejsu

ICollection.Count	Pobiera liczbę elementów zawartych w kolekcji StateManagedCollection . (Odziedziczone po StateManagedCollection)
ICollection.IsSynchronized	Pobiera wartość wskazującą, czy StateManagedCollection kolekcja jest synchronizowana (bezpieczne wątki). Ta metoda zwraca wszystkie `false` przypadki. (Odziedziczone po StateManagedCollection)
ICollection.SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do StateManagedCollection kolekcji. Ta metoda zwraca wszystkie `null` przypadki. (Odziedziczone po StateManagedCollection)
IEnumerable.GetEnumerator()	Zwraca iterator iterujący przez StateManagedCollection kolekcję. (Odziedziczone po StateManagedCollection)
IList.Add(Object)	Dodaje element do kolekcji StateManagedCollection . (Odziedziczone po StateManagedCollection)
IList.Clear()	Usuwa wszystkie elementy z kolekcji StateManagedCollection . (Odziedziczone po StateManagedCollection)
IList.Contains(Object)	Określa, czy StateManagedCollection kolekcja zawiera określoną wartość. (Odziedziczone po StateManagedCollection)
IList.IndexOf(Object)	Określa indeks określonego elementu w kolekcji StateManagedCollection . (Odziedziczone po StateManagedCollection)
IList.Insert(Int32, Object)	Wstawia element do kolekcji StateManagedCollection w określonym indeksie. (Odziedziczone po StateManagedCollection)
IList.IsFixedSize	Pobiera wartość wskazującą, czy StateManagedCollection kolekcja ma stały rozmiar. Ta metoda zwraca wszystkie `false` przypadki. (Odziedziczone po StateManagedCollection)
IList.IsReadOnly	Pobiera wartość wskazującą, czy StateManagedCollection kolekcja jest tylko do odczytu. (Odziedziczone po StateManagedCollection)
IList.Item[Int32]	IStateManager Pobiera element w określonym indeksie. (Odziedziczone po StateManagedCollection)
IList.Remove(Object)	Usuwa pierwsze wystąpienie określonego obiektu z kolekcji StateManagedCollection . (Odziedziczone po StateManagedCollection)
IList.RemoveAt(Int32)	IStateManager Usuwa element w określonym indeksie. (Odziedziczone po StateManagedCollection)
IStateManager.IsTrackingViewState	Pobiera wartość wskazującą, czy StateManagedCollection kolekcja zapisuje zmiany w stanie widoku. (Odziedziczone po StateManagedCollection)
IStateManager.LoadViewState(Object)	Przywraca wcześniej zapisany stan StateManagedCollection widoku kolekcji i IStateManager zawarte w nim elementy. (Odziedziczone po StateManagedCollection)
IStateManager.SaveViewState()	Zapisuje zmiany w StateManagedCollection kolekcji i każdy IStateManager obiekt, który zawiera od czasu opublikowania strony z powrotem na serwerze. (Odziedziczone po StateManagedCollection)
IStateManager.TrackViewState()	Powoduje, że StateManagedCollection kolekcja i każdy z IStateManager obiektów, które zawiera, aby śledzić zmiany w ich stanie wyświetlania, dzięki czemu mogą być utrwalane między żądaniami dla tej samej strony. (Odziedziczone po StateManagedCollection)

Metody rozszerzania

Cast<TResult>(IEnumerable)	Rzutuje elementy elementu IEnumerable na określony typ.
OfType<TResult>(IEnumerable)	Filtruje elementy IEnumerable elementu na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje element IEnumerable na .IQueryable

Dotyczy