DataControlFieldCollection Klasa

Definicja

Reprezentuje kolekcję DataControlField obiektów, które są używane przez kontrolki powiązane z danymi, takie jak GridView i DetailsView .Represents a collection of DataControlField objects that are used by data-bound controls such as GridView and 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
DataControlFieldCollection

Uwagi

DataControlFieldCollectionKlasa reprezentuje kolekcję DataControlField obiektów używaną przez kontrolki powiązane z danymi, aby określić sposób wyświetlania ich formantów podrzędnych.The DataControlFieldCollection class represents a collection of DataControlField objects used by data-bound controls to specify how their child controls are presented. DataControlFieldCollectionKlasa pochodzi od StateManagedCollection klasy abstrakcyjnej podstawowej kolekcji używanej do przechowywania IStateManager obiektów.The DataControlFieldCollection class derives from StateManagedCollection, an abstract base collection class used specifically to store IStateManager objects.

StateManagedCollectionObiekt ma wpływ na zachowanie DataControlFieldCollection obiektu.A StateManagedCollection object influences the behavior of a DataControlFieldCollection object. DataControlFieldobiekty, które są dynamicznie dodawane do kolekcji zostaną dodane do kontrolki po przywróceniu stanu.DataControlField objects that are dynamically added to the collection will be re-added to the control when state is restored. Oznacza to, że pole należy dodać, usunąć lub zmienić tylko raz zamiast każdego ogłaszania zwrotnego, ponieważ większość typów kolekcji w ASP.NET wymaga.This means that a field needs to be added, removed, or changed just once instead of on each postback, as most collection types in ASP.NET require.

( DataControlField Klasa implementuje IStateManager interfejs, który umożliwia przechowywanie jego stanu w stanie widoku ASP.NET.(The DataControlField class implements the IStateManager interface, which enables it to store its state in ASP.NET view state. ))

Użyj DataControlFieldCollection klasy, aby programowo zarządzać zestawem DataControlField obiektów.Use the DataControlFieldCollection class to programmatically manage a set of DataControlField objects. Należy pamiętać, że bardziej często definiujemy te pola w sposób deklaratywny.Note that it is more common to define these fields declaratively.

Można dodawać, wstawiać i usuwać DataControlField obiekty przy użyciu odpowiednich metod DataControlFieldCollection klasy.You can add, insert, and remove DataControlField objects using the appropriate methods of the DataControlFieldCollection class. Aby programowo pobrać DataControlField obiekty z kolekcji, należy użyć jednej z następujących metod:To programmatically retrieve DataControlField objects from a collection, use one of following methods:

CountWłaściwość określa łączną liczbę elementów w kolekcji i jest często używana do określenia górnej granicy kolekcji.The Count property specifies the total number of items in the collection, and is commonly used to determine the upper bound of the collection. Elementy z kolekcji można dodawać i usuwać za pomocą Add Insert metod,, Remove i RemoveAt .You can add items to and remove items from the collection using the Add, Insert, Remove, and RemoveAt methods.

Jeśli używasz GridView DetailsView kontrolki lub, DataControlField obiekty, które są tworzone automatycznie (na przykład gdy AutoGenerateColumns Właściwość nie jest true ), nie są przechowywane w kolekcji pola dostępne publicznie.If you are using the GridView or DetailsView control, the DataControlField objects that are automatically created (for example, when the AutoGenerateColumns property is true) are not stored in the publicly accessible fields collection. Można uzyskać dostęp tylko do DataControlField obiektów, które nie są generowane automatycznie, i manipulować nimi.You can only access and manipulate DataControlField objects that are not automatically generated.

W poniższej tabeli wymieniono różne klasy pól kontroli danych i sposób ich użycia.The following table lists the different data control field classes and how they are used.

Klasa parametrówParameter Class OpisDescription
DataControlField Abstrakcyjna klasa bazowa dla wszystkich pól.The abstract base class for all fields.
BoundField Pole kontrolne powiązane z danymi, które jest używane do wiązania z tekstem lub danymi pobranymi z kontrolki źródła danych ASP.NET.A data-bound control field that is used to bind to text or data retrieved from an ASP.NET data source control.
ButtonFieldBase Pole kontrolne powiązane z danymi, które hermetyzuje funkcje przycisku ogólnego.A data-bound control field that encapsulates general button functionality. ButtonFieldi CheckBoxField pochodzą od niej.ButtonField and CheckBoxField are derived from it.
ButtonField Pole kontrolne powiązane z danymi, które wyświetla co najmniej jeden przycisk.A data-bound control field that displays at least one button.
CheckBoxField Pole kontrolne powiązane z danymi, które wyświetla CheckBox kontrolkę.A data-bound control field that displays a CheckBox control.
CommandField Pole kontrolne powiązane z danymi, które wyświetla akcje, które mogą być wykonywane na danych wyświetlanych przez wiersz (lub kolumnę), takich jak Edycja, aktualizacja lub usuwanie.A data-bound control field that displays actions that can be performed on the data displayed by the row (or column), such as edit, update, or delete.
HyperLinkField Pole kontrolne powiązane z danymi, które wyświetla HyperLink kontrolkę.A data-bound control field that displays a HyperLink control.
ImageField Pole kontrolne powiązane z danymi, które wyświetla Image kontrolkę.A data-bound control field that displays an Image control.
TemplateField Pole kontrolne powiązane z danymi, które wyświetla zawartość niestandardową w formancie powiązanym z danymi.A data-bound control field that displays custom content in a data-bound control.

Konstruktory

DataControlFieldCollection()

Inicjuje nowe wystąpienie klasy DataControlFieldCollection.Initializes a new instance of the DataControlFieldCollection class.

Właściwości

Count

Pobiera liczbę elementów zawartych w StateManagedCollection kolekcji.Gets the number of elements contained in the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
Item[Int32]

Pobiera lub ustawia DataControlField obiekt pod określonym indeksem w kolekcji.Gets or sets the DataControlField object at the specified index in the collection.

Metody

Add(DataControlField)

Dołącza określony DataControlField obiekt do końca kolekcji.Appends the specified DataControlField object to the end of the collection.

Clear()

Usuwa wszystkie elementy z StateManagedCollection kolekcji.Removes all items from the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
CloneFields()

Tworzy kopię bieżącej kolekcji.Creates a copy of the current collection.

Contains(DataControlField)

Określa, czy DataControlFieldCollection Kolekcja zawiera określony DataControlField obiekt.Determines whether the DataControlFieldCollection collection contains a specific DataControlField object.

CopyTo(Array, Int32)

Kopiuje elementy StateManagedCollection kolekcji do tablicy, rozpoczynając od określonego indeksu tablicy.Copies the elements of the StateManagedCollection collection to an array, starting at a particular array index.

(Odziedziczone po StateManagedCollection)
CopyTo(DataControlField[], Int32)

Kopiuje całą DataControlFieldCollection kolekcję do zgodnego jednowymiarowego Array , rozpoczynając od określonego indeksu tablicy docelowej.Copies the entire DataControlFieldCollection collection to a compatible one-dimensional Array, starting at the specified index of the target array.

CreateKnownType(Int32)

Gdy jest zastępowany w klasie pochodnej, tworzy wystąpienie klasy implementującej IStateManager .When overridden in a derived class, creates an instance of a class that implements IStateManager. Typ tworzonego obiektu jest oparty na określonym elemencie członkowskim kolekcji zwróconej przez GetKnownTypes() metodę.The type of object created is based on the specified member of the collection returned by the GetKnownTypes() method.

(Odziedziczone po StateManagedCollection)
Equals(Object)

Określa, czy dany obiekt jest taki sam, jak bieżący obiekt.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
GetEnumerator()

Zwraca iterator, który wykonuje iterację StateManagedCollection kolekcji.Returns an iterator that iterates through the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetKnownTypes()

Gdy jest zastępowany w klasie pochodnej, pobiera tablicę IStateManager typów, które StateManagedCollection może zawierać kolekcja.When overridden in a derived class, gets an array of IStateManager types that the StateManagedCollection collection can contain.

(Odziedziczone po StateManagedCollection)
GetType()

Pobiera Type bieżące wystąpienie.Gets the Type of the current instance.

(Odziedziczone po Object)
IndexOf(DataControlField)

Określa indeks określonego DataControlField obiektu w kolekcji.Determines the index of a specific DataControlField object in the collection.

Insert(Int32, DataControlField)

Wstawia określony DataControlField obiekt do DataControlFieldCollection kolekcji o określonym indeksie.Inserts the specified DataControlField object into the DataControlFieldCollection collection at the specified index.

MemberwiseClone()

Tworzy skróconą kopię bieżącego elementu Object .Creates a shallow copy of the current Object.

(Odziedziczone po Object)
OnClear()

Gdy jest zastępowany w klasie pochodnej, wykonuje dodatkową działanie przed Clear() usunięciem wszystkich elementów z kolekcji.When overridden in a derived class, performs additional work before the Clear() method removes all items from the collection.

(Odziedziczone po StateManagedCollection)
OnClearComplete()

Po zastąpieniu w klasie pochodnej wykonuje dodatkową pracę po Clear() zakończeniu usuwania wszystkich elementów z kolekcji przez metodę.When overridden in a derived class, performs additional work after the Clear() method finishes removing all items from the collection.

(Odziedziczone po StateManagedCollection)
OnInsert(Int32, Object)

Gdy jest zastępowany w klasie pochodnej, wykonuje dodatkową działanie przed IList.Insert(Int32, Object) IList.Add(Object) dodaniem elementu do kolekcji lub.When overridden in a derived class, performs additional work before the IList.Insert(Int32, Object) or IList.Add(Object) method adds an item to the collection.

(Odziedziczone po StateManagedCollection)
OnInsertComplete(Int32, Object)

Gdy jest zastępowany w klasie pochodnej, wykonuje dodatkową działanie po IList.Insert(Int32, Object) IList.Add(Object) dodaniu elementu do kolekcji lub przez metodę.When overridden in a derived class, performs additional work after the IList.Insert(Int32, Object) or IList.Add(Object) method adds an item to the collection.

(Odziedziczone po StateManagedCollection)
OnRemove(Int32, Object)

Gdy jest zastępowany w klasie pochodnej, wykonuje dodatkową czynność przed IList.Remove(Object) IList.RemoveAt(Int32) usunięciem określonego elementu z kolekcji.When overridden in a derived class, performs additional work before the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection.

(Odziedziczone po StateManagedCollection)
OnRemoveComplete(Int32, Object)

Gdy jest zastępowany w klasie pochodnej, wykonuje dodatkową czynność po usunięciu IList.Remove(Object) IList.RemoveAt(Int32) określonego elementu z kolekcji lub przez metodę.When overridden in a derived class, performs additional work after the IList.Remove(Object) or IList.RemoveAt(Int32) method removes the specified item from the collection.

(Odziedziczone po StateManagedCollection)
OnValidate(Object)

Gdy jest zastępowany w klasie pochodnej, sprawdza poprawność elementu StateManagedCollection kolekcji.When overridden in a derived class, validates an element of the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
Remove(DataControlField)

Usuwa określony DataControlField obiekt z DataControlFieldCollection kolekcji.Removes the specified DataControlField object from the DataControlFieldCollection collection.

RemoveAt(Int32)

Usuwa DataControlField obiekt z kolekcji w określonym indeksie DataControlFieldCollection .Removes the DataControlField object at the specified index from the DataControlFieldCollection collection.

SetDirty()

Wymusza, StateManagedCollection aby cała kolekcja była serializowana do stanu widoku.Forces the entire StateManagedCollection collection to be serialized into view state.

(Odziedziczone po StateManagedCollection)
SetDirtyObject(Object)

Gdy jest zastępowany w klasie pochodnej, instruuje object zawarty w kolekcji, aby zarejestrować jej cały stan, aby wyświetlić stan, a nie tylko rejestrować informacje o zmianach.When overridden in a derived class, instructs an object contained by the collection to record its entire state to view state, rather than recording only change information.

(Odziedziczone po StateManagedCollection)
ToString()

Zwraca ciąg reprezentujący bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Zdarzenia

FieldsChanged

Występuje, gdy pola w kolekcji zmieniają się zazwyczaj jako wynik Clear() Insert(Int32, DataControlField) Remove(DataControlField) Add(DataControlField) wywołania metody lub.Occurs when the fields in the collection change, usually as the result of a Clear(), Insert(Int32, DataControlField), Remove(DataControlField) or Add(DataControlField) method call. To zdarzenie jest również zgłaszane w dowolnym momencie DataControlField w kolekcji FieldChanged .This event is also raised anytime a DataControlField in the collection raises its FieldChanged event.

Jawne implementacje interfejsu

ICollection.Count

Pobiera liczbę elementów zawartych w StateManagedCollection kolekcji.Gets the number of elements contained in the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
ICollection.IsSynchronized

Pobiera wartość wskazującą, czy StateManagedCollection kolekcja jest synchronizowana (bezpieczne wątki).Gets a value indicating whether the StateManagedCollection collection is synchronized (thread safe). Ta metoda zwraca false we wszystkich przypadkach.This method returns false in all cases.

(Odziedziczone po StateManagedCollection)
ICollection.SyncRoot

Pobiera obiekt, który może służyć do synchronizowania dostępu do StateManagedCollection kolekcji.Gets an object that can be used to synchronize access to the StateManagedCollection collection. Ta metoda zwraca null we wszystkich przypadkach.This method returns null in all cases.

(Odziedziczone po StateManagedCollection)
IEnumerable.GetEnumerator()

Zwraca iterator, który wykonuje iterację StateManagedCollection kolekcji.Returns an iterator that iterates through the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
IList.Add(Object)

Dodaje element do StateManagedCollection kolekcji.Adds an item to the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
IList.Clear()

Usuwa wszystkie elementy z StateManagedCollection kolekcji.Removes all items from the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
IList.Contains(Object)

Określa, czy StateManagedCollection Kolekcja zawiera konkretną wartość.Determines whether the StateManagedCollection collection contains a specific value.

(Odziedziczone po StateManagedCollection)
IList.IndexOf(Object)

Określa indeks określonego elementu w StateManagedCollection kolekcji.Determines the index of a specified item in the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
IList.Insert(Int32, Object)

Wstawia element do StateManagedCollection kolekcji o określonym indeksie.Inserts an item into the StateManagedCollection collection at the specified index.

(Odziedziczone po StateManagedCollection)
IList.IsFixedSize

Pobiera wartość wskazującą, czy StateManagedCollection Kolekcja ma stały rozmiar.Gets a value indicating whether the StateManagedCollection collection has a fixed size. Ta metoda zwraca false we wszystkich przypadkach.This method returns false in all cases.

(Odziedziczone po StateManagedCollection)
IList.IsReadOnly

Pobiera wartość wskazującą, czy StateManagedCollection kolekcja jest tylko do odczytu.Gets a value indicating whether the StateManagedCollection collection is read-only.

(Odziedziczone po StateManagedCollection)
IList.Item[Int32]

Pobiera IStateManager element o określonym indeksie.Gets the IStateManager element at the specified index.

(Odziedziczone po StateManagedCollection)
IList.Remove(Object)

Usuwa pierwsze wystąpienie określonego obiektu z StateManagedCollection kolekcji.Removes the first occurrence of the specified object from the StateManagedCollection collection.

(Odziedziczone po StateManagedCollection)
IList.RemoveAt(Int32)

Usuwa IStateManager element o określonym indeksie.Removes the IStateManager element at the specified index.

(Odziedziczone po StateManagedCollection)
IStateManager.IsTrackingViewState

Pobiera wartość wskazującą, czy StateManagedCollection Kolekcja zapisuje zmiany w stanie widoku.Gets a value indicating whether the StateManagedCollection collection is saving changes to its view state.

(Odziedziczone po StateManagedCollection)
IStateManager.LoadViewState(Object)

Przywraca poprzednio zapisany stan widoku StateManagedCollection kolekcji i elementów, które IStateManager zawiera.Restores the previously saved view state of the StateManagedCollection collection and the IStateManager items it contains.

(Odziedziczone po StateManagedCollection)
IStateManager.SaveViewState()

Zapisuje zmiany do StateManagedCollection kolekcji i każdego IStateManager obiektu, który zawiera od momentu, gdy strona została opublikowana z powrotem na serwerze.Saves the changes to the StateManagedCollection collection and each IStateManager object it contains since the time the page was posted back to the server.

(Odziedziczone po StateManagedCollection)
IStateManager.TrackViewState()

Powoduje, że StateManagedCollection kolekcja i każdy z IStateManager obiektów, które zawiera, są śledzone w celu śledzenia zmian stanu widoku, aby mogły być utrwalane między żądaniami dotyczącymi tej samej strony.Causes the StateManagedCollection collection and each of the IStateManager objects it contains to track changes to their view state so they can be persisted across requests for the same page.

(Odziedziczone po StateManagedCollection)

Metody rozszerzania

Cast<TResult>(IEnumerable)

Rzutuje elementy elementu IEnumerable do określonego typu.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtruje elementy IEnumerable w oparciu o określony typ.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Włącza przetwarzanie równoległe zapytania.Enables parallelization of a query.

AsQueryable(IEnumerable)

Konwertuje IEnumerable do IQueryable .Converts an IEnumerable to an IQueryable.

Dotyczy

Zobacz też