DataControlFieldCollection DataControlFieldCollection DataControlFieldCollection DataControlFieldCollection Class

Definition

Stellt eine Auflistung von DataControlField-Objekten dar, die von datengebundenen Steuerelementen wie GridView und DetailsView verwendet werden.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
Vererbung
DataControlFieldCollectionDataControlFieldCollectionDataControlFieldCollectionDataControlFieldCollection

Hinweise

Die DataControlFieldCollection -Klasse stellt eine Auflistung DataControlField von-Objekten dar, die von Daten gebundenen Steuerelementen verwendet werden, um anzugeben, wie ihre untergeordneten Steuerelemente dargestelltThe DataControlFieldCollection class represents a collection of DataControlField objects used by data-bound controls to specify how their child controls are presented. Die DataControlFieldCollection -Klasse wird StateManagedCollectionvon abgeleitet, einer abstrakten Basis Sammlungsklasse, die IStateManager speziell zum Speichern von-Objekten verwendet wird.The DataControlFieldCollection class derives from StateManagedCollection, an abstract base collection class used specifically to store IStateManager objects.

Ein StateManagedCollection -Objekt wirkt sich DataControlFieldCollection auf das Verhalten eines-Objekts aus.A StateManagedCollection object influences the behavior of a DataControlFieldCollection object. DataControlFieldObjekte, die der Auflistung dynamisch hinzugefügt werden, werden dem-Steuerelement erneut hinzugefügt, wenn der Zustand wieder hergestellt wird.DataControlField objects that are dynamically added to the collection will be re-added to the control when state is restored. Dies bedeutet, dass ein Feld nur einmal statt bei jedem Postback hinzugefügt, entfernt oder geändert werden muss, da die meisten Sammlungs Typen in ASP.net erfordern.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.

(Die DataControlField -Klasse implementiert IStateManager die-Schnittstelle, die es ermöglicht, ihren Zustand im ASP.net-Ansichts Zustand zu speichern.(The DataControlField class implements the IStateManager interface, which enables it to store its state in ASP.NET view state. ))

Verwenden Sie DataControlFieldCollection die-Klasse, um einen Satz von DataControlField -Objekten Programm gesteuert zu verwalten.Use the DataControlFieldCollection class to programmatically manage a set of DataControlField objects. Beachten Sie, dass es häufiger ist, diese Felder deklarativ zu definieren.Note that it is more common to define these fields declaratively.

Sie können-Objekte hinzufügen, einfügen DataControlField und entfernen, indem Sie die entsprechenden DataControlFieldCollection Methoden der-Klasse verwenden.You can add, insert, and remove DataControlField objects using the appropriate methods of the DataControlFieldCollection class. Zum programmgesteuerten abrufen DataControlField von Objekten aus einer Auflistung verwenden Sie eine der folgenden Methoden:To programmatically retrieve DataControlField objects from a collection, use one of following methods:

Die Count -Eigenschaft gibt die Gesamtanzahl der Elemente in der Auflistung an und wird häufig verwendet, um die obere Grenze der Auflistung zu bestimmen.The Count property specifies the total number of items in the collection, and is commonly used to determine the upper bound of the collection. Mithilfe der AddMethoden, Insert, Removeund RemoveAt können Sie Elemente zur Auflistung hinzufügen und daraus entfernen.You can add items to and remove items from the collection using the Add, Insert, Remove, and RemoveAt methods.

Wenn Sie das-Steuer GridView Element DetailsView oder das- DataControlField Steuerelement verwenden, werden die Objekte, die automatisch erstellt AutoGenerateColumns werden ( truez. b. wenn die-Eigenschaft ist) nicht in der öffentlich zugänglichen Fields-Auflistung gespeichert.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. Sie können nur Objekte aufrufen und DataControlField bearbeiten, die nicht automatisch generiert werden.You can only access and manipulate DataControlField objects that are not automatically generated.

In der folgenden Tabelle werden die verschiedenen Daten Steuerungs Feld Klassen und deren Verwendung aufgelistet.The following table lists the different data control field classes and how they are used.

Parameter KlasseParameter Class BeschreibungDescription
DataControlField Die abstrakte Basisklasse für alle Felder.The abstract base class for all fields.
BoundField Ein Daten gebundenes Steuerelement Feld, das zum Binden an Text oder Daten verwendet wird, die aus einem ASP.NET-Datenquellen-Steuerelement abgerufen werden.A data-bound control field that is used to bind to text or data retrieved from an ASP.NET data source control.
ButtonFieldBase Ein Daten gebundenes Steuerelement Feld, das die Funktionen der allgemeinen Schaltfläche kapselt.A data-bound control field that encapsulates general button functionality. ButtonFieldund CheckBoxField werden davon abgeleitet.ButtonField and CheckBoxField are derived from it.
ButtonField Ein Daten gebundenes Steuerelement Feld, das mindestens eine Schaltfläche anzeigt.A data-bound control field that displays at least one button.
CheckBoxField Ein Daten gebundenes Steuerelement Feld, das CheckBox ein-Steuerelement anzeigt.A data-bound control field that displays a CheckBox control.
CommandField Ein Daten gebundenes Steuerelement Feld, das Aktionen anzeigt, die für die Daten ausgeführt werden können, die von der Zeile (oder Spalte) angezeigt werden, z. b. bearbeiten, aktualisieren oder löschen.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 Ein Daten gebundenes Steuerelement Feld, das HyperLink ein-Steuerelement anzeigt.A data-bound control field that displays a HyperLink control.
ImageField Ein Daten gebundenes Steuerelement Feld, das Image ein-Steuerelement anzeigt.A data-bound control field that displays an Image control.
TemplateField Ein Daten gebundenes Steuerelement Feld, das benutzerdefinierten Inhalt in einem Daten gebundenen Steuerelement anzeigt.A data-bound control field that displays custom content in a data-bound control.

Konstruktoren

DataControlFieldCollection() DataControlFieldCollection() DataControlFieldCollection() DataControlFieldCollection()

Initialisiert eine neue Instanz der DataControlFieldCollection-Klasse.Initializes a new instance of the DataControlFieldCollection class.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab.Gets the number of elements contained in the StateManagedCollection collection.

(Inherited from StateManagedCollection)
ICollection.Count ICollection.Count ICollection.Count ICollection.Count

Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab.Gets the number of elements contained in the StateManagedCollection collection.

(Inherited from StateManagedCollection)
ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized ICollection.IsSynchronized

Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung synchronisiert (threadsicher) ist.Gets a value indicating whether the StateManagedCollection collection is synchronized (thread safe). Diese Methode gibt immer false zurück.This method returns false in all cases.

(Inherited from StateManagedCollection)
ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot ICollection.SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf die StateManagedCollection-Auflistung synchronisiert werden kann.Gets an object that can be used to synchronize access to the StateManagedCollection collection. Diese Methode gibt immer null zurück.This method returns null in all cases.

(Inherited from StateManagedCollection)
IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize IList.IsFixedSize

Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung eine feste Größe aufweist.Gets a value indicating whether the StateManagedCollection collection has a fixed size. Diese Methode gibt immer false zurück.This method returns false in all cases.

(Inherited from StateManagedCollection)
IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly IList.IsReadOnly

Ruft einen Wert ab, der angibt, ob die StateManagedCollection -Auflistung schreibgeschützt ist.Gets a value indicating whether the StateManagedCollection collection is read-only.

(Inherited from StateManagedCollection)
IList.Item[Int32] IList.Item[Int32] IList.Item[Int32] IList.Item[Int32]

Ruft das IStateManager-Element am angegebenen Index ab.Gets the IStateManager element at the specified index.

(Inherited from StateManagedCollection)
IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState IStateManager.IsTrackingViewState

Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung Änderungen des Ansichtszustands speichert.Gets a value indicating whether the StateManagedCollection collection is saving changes to its view state.

(Inherited from StateManagedCollection)
Item[Int32] Item[Int32] Item[Int32] Item[Int32]

Ruft das DataControlField-Objekt am angegebenen Index in der Auflistung ab oder legt dieses fest.Gets or sets the DataControlField object at the specified index in the collection.

Methoden

Add(DataControlField) Add(DataControlField) Add(DataControlField) Add(DataControlField)

Fügt das angegebene DataControlField-Objekt an das Ende der Auflistung an.Appends the specified DataControlField object to the end of the collection.

Clear() Clear() Clear() Clear()

Entfernt alle Elemente aus der StateManagedCollection-Auflistung.Removes all items from the StateManagedCollection collection.

(Inherited from StateManagedCollection)
CloneFields() CloneFields() CloneFields() CloneFields()

Erstellt eine Kopie der aktuellen Auflistung.Creates a copy of the current collection.

Contains(DataControlField) Contains(DataControlField) Contains(DataControlField) Contains(DataControlField)

Ermittelt, ob die DataControlFieldCollection-Auflistung ein bestimmtes DataControlField-Objekt enthält.Determines whether the DataControlFieldCollection collection contains a specific DataControlField object.

CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32) CopyTo(Array, Int32)

Kopiert die Elemente der StateManagedCollection-Auflistung in ein Array, wobei an einem bestimmten Arrayindex begonnen wird.Copies the elements of the StateManagedCollection collection to an array, starting at a particular array index.

(Inherited from StateManagedCollection)
CopyTo(DataControlField[], Int32) CopyTo(DataControlField[], Int32) CopyTo(DataControlField[], Int32) CopyTo(DataControlField[], Int32)

Kopiert die gesamte DataControlFieldCollection-Auflistung in ein kompatibles eindimensionales Array, beginnend ab dem angegebenen Index im Zielarray.Copies the entire DataControlFieldCollection collection to a compatible one-dimensional Array, starting at the specified index of the target array.

CreateKnownType(Int32) CreateKnownType(Int32) CreateKnownType(Int32) CreateKnownType(Int32)

Beim Überschreiben in einer abgeleiteten Klasse wird eine Instanz einer Klasse erstellt, die IStateManager implementiert.When overridden in a derived class, creates an instance of a class that implements IStateManager. Der Typ des erstellten Objekts basiert auf dem angegebenen Element der Auflistung, der von der GetKnownTypes()-Methode zurückgegeben wird.The type of object created is based on the specified member of the collection returned by the GetKnownTypes() method.

(Inherited from StateManagedCollection)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft.Returns an iterator that iterates through the StateManagedCollection collection.

(Inherited from StateManagedCollection)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetKnownTypes() GetKnownTypes() GetKnownTypes() GetKnownTypes()

Beim Überschreiben in einer abgeleiteten Klasse wird ein Array von IStateManager-Typen abgerufen, die die StateManagedCollection-Auflistung enthalten kann.When overridden in a derived class, gets an array of IStateManager types that the StateManagedCollection collection can contain.

(Inherited from StateManagedCollection)
GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
IndexOf(DataControlField) IndexOf(DataControlField) IndexOf(DataControlField) IndexOf(DataControlField)

Bestimmt den Index eines bestimmten DataControlField-Objekts in der Auflistung.Determines the index of a specific DataControlField object in the collection.

Insert(Int32, DataControlField) Insert(Int32, DataControlField) Insert(Int32, DataControlField) Insert(Int32, DataControlField)

Fügt das angegebene DataControlField-Objekt am angegebenen Index in die DataControlFieldCollection-Auflistung ein.Inserts the specified DataControlField object into the DataControlFieldCollection collection at the specified index.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnClear() OnClear() OnClear() OnClear()

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Clear()-Methode alle Elemente aus der Auflistung entfernt.When overridden in a derived class, performs additional work before the Clear() method removes all items from the collection.

(Inherited from StateManagedCollection)
OnClearComplete() OnClearComplete() OnClearComplete() OnClearComplete()

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die Clear()-Methode alle Elemente aus der Auflistung entfernt hat.When overridden in a derived class, performs additional work after the Clear() method finishes removing all items from the collection.

(Inherited from StateManagedCollection)
OnInsert(Int32, Object) OnInsert(Int32, Object) OnInsert(Int32, Object) OnInsert(Int32, Object)

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die IList.Insert(Int32, Object)-Methode oder die IList.Add(Object)-Methode der Auflistung ein Element hinzufügt.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.

(Inherited from StateManagedCollection)
OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object) OnInsertComplete(Int32, Object)

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die IList.Insert(Int32, Object)-Methode oder die IList.Add(Object)-Methode der Auflistung ein Element hinzugefügt hat.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.

(Inherited from StateManagedCollection)
OnRemove(Int32, Object) OnRemove(Int32, Object) OnRemove(Int32, Object) OnRemove(Int32, Object)

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die IList.Remove(Object)-Methode oder die IList.RemoveAt(Int32)-Methode das angegebene Element aus der Auflistung entfernt.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.

(Inherited from StateManagedCollection)
OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object) OnRemoveComplete(Int32, Object)

Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die IList.Remove(Object)-Methode oder die IList.RemoveAt(Int32)-Methode das angegebene Element aus der Auflistung entfernt hat.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.

(Inherited from StateManagedCollection)
OnValidate(Object) OnValidate(Object) OnValidate(Object) OnValidate(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein Element der StateManagedCollection-Auflistung validiert.When overridden in a derived class, validates an element of the StateManagedCollection collection.

(Inherited from StateManagedCollection)
Remove(DataControlField) Remove(DataControlField) Remove(DataControlField) Remove(DataControlField)

Entfernt das angegebene DataControlField-Objekt aus der DataControlFieldCollection-Auflistung.Removes the specified DataControlField object from the DataControlFieldCollection collection.

RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32) RemoveAt(Int32)

Entfernt das DataControlField-Objekt am angegebenen Index aus der DataControlFieldCollection-Auflistung.Removes the DataControlField object at the specified index from the DataControlFieldCollection collection.

SetDirty() SetDirty() SetDirty() SetDirty()

Erzwingt den serialisierten Ansichtszustand für die gesamte StateManagedCollection-Auflistung.Forces the entire StateManagedCollection collection to be serialized into view state.

(Inherited from StateManagedCollection)
SetDirtyObject(Object) SetDirtyObject(Object) SetDirtyObject(Object) SetDirtyObject(Object)

Beim Überschreiben in einer abgeleiteten Klasse wird ein in der Auflistung enthaltenes object angewiesen, seinen gesamten Zustand im Ansichtszustand aufzuzeichnen, anstatt nur die Änderungsinformationen aufzuzeichnen.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.

(Inherited from StateManagedCollection)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Ereignisse

FieldsChanged FieldsChanged FieldsChanged FieldsChanged

Tritt ein, wenn sich die Felder in der Auflistung ändern. Dies geschieht normalerweise als Ergebnis des Aufrufs einer der folgenden Methoden: Clear(), Insert(Int32, DataControlField), Remove(DataControlField) oder Add(DataControlField).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. Dieses Ereignis wird zudem immer dann ausgelöst, wenn ein DataControlField in der Auflistung das zugehörige FieldChanged-Ereignis auslöst.This event is also raised anytime a DataControlField in the collection raises its FieldChanged event.

Explizite Schnittstellenimplementierungen

IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft.Returns an iterator that iterates through the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Add(Object) IList.Add(Object) IList.Add(Object) IList.Add(Object)

Fügt der StateManagedCollection-Auflistung ein Element hinzu.Adds an item to the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Clear() IList.Clear() IList.Clear() IList.Clear()

Entfernt alle Elemente aus der StateManagedCollection-Auflistung.Removes all items from the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Contains(Object) IList.Contains(Object) IList.Contains(Object) IList.Contains(Object)

Ermittelt, ob die StateManagedCollection-Auflistung einen bestimmten Wert enthält.Determines whether the StateManagedCollection collection contains a specific value.

(Inherited from StateManagedCollection)
IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object) IList.IndexOf(Object)

Bestimmt den Index eines bestimmten Elements in der StateManagedCollection-Auflistung.Determines the index of a specified item in the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object) IList.Insert(Int32, Object)

Fügt ein Element am angegebenen Index in die StateManagedCollection-Auflistung ein.Inserts an item into the StateManagedCollection collection at the specified index.

(Inherited from StateManagedCollection)
IList.Remove(Object) IList.Remove(Object) IList.Remove(Object) IList.Remove(Object)

Entfernt das erste Vorkommen des angegebenen Objekts aus der StateManagedCollection-Auflistung.Removes the first occurrence of the specified object from the StateManagedCollection collection.

(Inherited from StateManagedCollection)
IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32) IList.RemoveAt(Int32)

Entfernt das IStateManager-Element am angegebenen Index.Removes the IStateManager element at the specified index.

(Inherited from StateManagedCollection)
IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object) IStateManager.LoadViewState(Object)

Stellt den zuvor gespeicherten Ansichtszustand der StateManagedCollection-Auflistung und der in ihr enthaltenen IStateManager-Elemente wieder her.Restores the previously saved view state of the StateManagedCollection collection and the IStateManager items it contains.

(Inherited from StateManagedCollection)
IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState() IStateManager.SaveViewState()

Speichert die Änderungen an der StateManagedCollection-Auflistung und allen darin enthaltenen IStateManager-Objekten seit dem Zeitpunkt, zu dem die Seite zurück an den Server gesendet wurde.Saves the changes to the StateManagedCollection collection and each IStateManager object it contains since the time the page was posted back to the server.

(Inherited from StateManagedCollection)
IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState() IStateManager.TrackViewState()

Weist die StateManagedCollection-Auflistung und alle in ihr enthaltenen IStateManager-Objekte an, die Änderungen im Ansichtszustand nachzuverfolgen, sodass diese für die gleiche Seite anforderungsübergreifend beibehalten werden können.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.

(Inherited from StateManagedCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Wandelt die Elemente eines IEnumerable in den angegebenen Typ umCasts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filtert die Elemente eines IEnumerable anhand eines angegebenen TypsFilters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Ermöglicht die Parallelisierung einer Abfrage.Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Konvertiert einen IEnumerable in einen IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch