DataControlFieldCollection Klasse

Referenz

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt eine Auflistung von DataControlField-Objekten dar, die von datengebundenen Steuerelementen wie GridView und DetailsView verwendet werden.

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: Object

StateManagedCollection
DataControlFieldCollection

Hinweise

Die DataControlFieldCollection Klasse stellt eine Auflistung von Objekten dar, die DataControlField von datengebundenen Steuerelementen verwendet werden, um anzugeben, wie ihre untergeordneten Steuerelemente dargestellt werden. Die DataControlFieldCollection Klasse abgeleitet von StateManagedCollectioneiner abstrakten Basissammlungsklasse, die speziell zum Speichern IStateManager von Objekten verwendet wird.

Ein StateManagedCollection Objekt beeinflusst das Verhalten eines DataControlFieldCollection Objekts. DataControlField Objekte, die der Auflistung dynamisch hinzugefügt werden, werden dem Steuerelement erneut hinzugefügt, wenn der Zustand wiederhergestellt wird. Dies bedeutet, dass ein Feld nur einmal anstelle jedes Postbacks hinzugefügt, entfernt oder geändert werden muss, da die meisten Auflistungstypen in ASP.NET erforderlich sind.

(Die DataControlField Klasse implementiert die IStateManager Schnittstelle, die es ermöglicht, den Zustand in ASP.NET Ansichtszustand zu speichern. )

Verwenden Sie die DataControlFieldCollection Klasse, um eine Gruppe von DataControlField Objekten programmgesteuert zu verwalten. Beachten Sie, dass diese Felder deklarativ definiert werden.

Sie können Objekte mithilfe der entsprechenden Methoden der DataControlFieldCollection Klasse hinzufügen, einfügen und entfernenDataControlField. Zum programmgesteuerten Abrufen DataControlField von Objekten aus einer Auflistung verwenden Sie eine der folgenden Methoden:

Verwenden Sie den Indexer, um ein einzelnes DataControlField Objekt aus der Auflistung mithilfe von Arraynotation abzurufen.
Verwenden Sie die GetEnumerator Methode, um ein implementiertes System.Collections.IEnumeratorObjekt zu erstellen, das dann zum Abrufen von Elementen aus der Auflistung verwendet werden kann.

Die Count Eigenschaft gibt die Gesamtzahl der Elemente in der Auflistung an und wird häufig verwendet, um die obere Grenze der Auflistung zu bestimmen. Sie können Elemente aus der Auflistung mithilfe des Add, Insert Removeund methoden hinzufügen und RemoveAt entfernen.

Wenn Sie das GridView DetailsView Steuerelement verwenden, werden die Objekte, die automatisch erstellt werden (z. B. wenn die DataControlField AutoGenerateColumns Eigenschaft truevorhanden ist), nicht in der Sammlung öffentlich zugänglicher Felder gespeichert. Sie können nur auf Objekte zugreifen und bearbeiten DataControlField , die nicht automatisch generiert werden.

In der folgenden Tabelle sind die verschiedenen Datensteuerelementfeldklassen aufgeführt und wie sie verwendet werden.

Parameterklasse	BESCHREIBUNG
DataControlField	Die abstrakte Basisklasse für alle Felder.
BoundField	Ein datengebundenes Steuerelementfeld, das zum Binden an Text oder Daten verwendet wird, die aus einem ASP.NET Datenquellensteuerelement abgerufen werden.
ButtonFieldBase	Ein datengebundenes Steuerelementfeld, das allgemeine Schaltflächenfunktionen kapselt. ButtonField und CheckBoxField werden daraus abgeleitet.
ButtonField	Ein datengebundenes Steuerelementfeld, das mindestens eine Schaltfläche anzeigt.
CheckBoxField	Ein datengebundenes Steuerelementfeld, das ein CheckBox Steuerelement anzeigt.
CommandField	Ein datengebundenes Steuerelementfeld, das Aktionen anzeigt, die auf den Daten ausgeführt werden können, die von der Zeile (oder Spalte) angezeigt werden können, z. B. Bearbeiten, Aktualisieren oder Löschen.
HyperLinkField	Ein datengebundenes Steuerelementfeld, das ein HyperLink Steuerelement anzeigt.
ImageField	Ein datengebundenes Steuerelementfeld, das ein Image Steuerelement anzeigt.
TemplateField	Ein datengebundenes Steuerelementfeld, das benutzerdefinierte Inhalte in einem datengebundenen Steuerelement anzeigt.

Konstruktoren

DataControlFieldCollection()

Initialisiert eine neue Instanz der DataControlFieldCollection-Klasse.

Eigenschaften

Count	Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab. (Geerbt von StateManagedCollection)
Item[Int32]	Ruft das DataControlField-Objekt am angegebenen Index in der Auflistung ab oder legt dieses fest.

Methoden

Add(DataControlField)	Fügt das angegebene DataControlField-Objekt an das Ende der Auflistung an.
Clear()	Entfernt alle Elemente aus der StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
CloneFields()	Erstellt eine Kopie der aktuellen Auflistung.
Contains(DataControlField)	Ermittelt, ob die DataControlFieldCollection-Auflistung ein bestimmtes DataControlField-Objekt enthält.
CopyTo(Array, Int32)	Kopiert die Elemente der StateManagedCollection-Auflistung in ein Array, wobei an einem bestimmten Arrayindex begonnen wird. (Geerbt von StateManagedCollection)
CopyTo(DataControlField[], Int32)	Kopiert die gesamte DataControlFieldCollection-Auflistung in ein kompatibles eindimensionales Array, beginnend ab dem angegebenen Index im Zielarray.
CreateKnownType(Int32)	Beim Überschreiben in einer abgeleiteten Klasse wird eine Instanz einer Klasse erstellt, die IStateManager implementiert. Der Typ des erstellten Objekts basiert auf dem angegebenen Element der Auflistung, der von der GetKnownTypes()-Methode zurückgegeben wird. (Geerbt von StateManagedCollection)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetEnumerator()	Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft. (Geerbt von StateManagedCollection)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetKnownTypes()	Beim Überschreiben in einer abgeleiteten Klasse wird ein Array von IStateManager-Typen abgerufen, die die StateManagedCollection-Auflistung enthalten kann. (Geerbt von StateManagedCollection)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
IndexOf(DataControlField)	Bestimmt den Index eines bestimmten DataControlField-Objekts in der Auflistung.
Insert(Int32, DataControlField)	Fügt das angegebene DataControlField-Objekt am angegebenen Index in die DataControlFieldCollection-Auflistung ein.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnClear()	Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Clear()-Methode alle Elemente aus der Auflistung entfernt. (Geerbt von StateManagedCollection)
OnClearComplete()	Beim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die Clear()-Methode alle Elemente aus der Auflistung entfernt hat. (Geerbt von StateManagedCollection)
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. (Geerbt von StateManagedCollection)
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. (Geerbt von StateManagedCollection)
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. (Geerbt von StateManagedCollection)
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. (Geerbt von StateManagedCollection)
OnValidate(Object)	Beim Überschreiben in einer abgeleiteten Klasse wird ein Element der StateManagedCollection-Auflistung validiert. (Geerbt von StateManagedCollection)
Remove(DataControlField)	Entfernt das angegebene DataControlField-Objekt aus der DataControlFieldCollection-Auflistung.
RemoveAt(Int32)	Entfernt das DataControlField-Objekt am angegebenen Index aus der DataControlFieldCollection-Auflistung.
SetDirty()	Erzwingt den serialisierten Ansichtszustand für die gesamte StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
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. (Geerbt von StateManagedCollection)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

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). Dieses Ereignis wird zudem immer dann ausgelöst, wenn ein DataControlField in der Auflistung das zugehörige FieldChanged-Ereignis auslöst.

Explizite Schnittstellenimplementierungen

ICollection.Count	Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab. (Geerbt von StateManagedCollection)
ICollection.IsSynchronized	Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung synchronisiert (threadsicher) ist. Diese Methode gibt immer `false` zurück. (Geerbt von StateManagedCollection)
ICollection.SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf die StateManagedCollection-Auflistung synchronisiert werden kann. Diese Methode gibt immer `null` zurück. (Geerbt von StateManagedCollection)
IEnumerable.GetEnumerator()	Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft. (Geerbt von StateManagedCollection)
IList.Add(Object)	Fügt der StateManagedCollection-Auflistung ein Element hinzu. (Geerbt von StateManagedCollection)
IList.Clear()	Entfernt alle Elemente aus der StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
IList.Contains(Object)	Ermittelt, ob die StateManagedCollection-Auflistung einen bestimmten Wert enthält. (Geerbt von StateManagedCollection)
IList.IndexOf(Object)	Bestimmt den Index eines bestimmten Elements in der StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
IList.Insert(Int32, Object)	Fügt ein Element am angegebenen Index in die StateManagedCollection-Auflistung ein. (Geerbt von StateManagedCollection)
IList.IsFixedSize	Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung eine feste Größe aufweist. Diese Methode gibt immer `false` zurück. (Geerbt von StateManagedCollection)
IList.IsReadOnly	Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung schreibgeschützt ist. (Geerbt von StateManagedCollection)
IList.Item[Int32]	Ruft das IStateManager-Element am angegebenen Index ab. (Geerbt von StateManagedCollection)
IList.Remove(Object)	Entfernt das erste Vorkommen des angegebenen Objekts aus der StateManagedCollection-Auflistung. (Geerbt von StateManagedCollection)
IList.RemoveAt(Int32)	Entfernt das IStateManager-Element am angegebenen Index. (Geerbt von StateManagedCollection)
IStateManager.IsTrackingViewState	Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung Änderungen des Ansichtszustands speichert. (Geerbt von StateManagedCollection)
IStateManager.LoadViewState(Object)	Stellt den zuvor gespeicherten Ansichtszustand der StateManagedCollection-Auflistung und der in ihr enthaltenen IStateManager-Elemente wieder her. (Geerbt von StateManagedCollection)
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. (Geerbt von StateManagedCollection)
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. (Geerbt von StateManagedCollection)

Erweiterungsmethoden

Cast<TResult>(IEnumerable)	Wandelt die Elemente eines IEnumerable in den angegebenen Typ um
OfType<TResult>(IEnumerable)	Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs
AsParallel(IEnumerable)	Ermöglicht die Parallelisierung einer Abfrage.
AsQueryable(IEnumerable)	Konvertiert einen IEnumerable in einen IQueryable.

Gilt für

Freigeben über