DataControlFieldCollection Klasse
Definition
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.
public ref class DataControlFieldCollection sealed : System::Web::UI::StateManagedCollectionpublic sealed class DataControlFieldCollection : System.Web.UI.StateManagedCollectiontype DataControlFieldCollection = class
inherit StateManagedCollectionPublic NotInheritable Class DataControlFieldCollection
Inherits StateManagedCollection- Vererbung
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 wird von StateManagedCollectioneiner abstrakten Basissammlungsklasse abgeleitet, 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 Sammlungstypen 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 einen Satz von DataControlField Objekten programmgesteuert zu verwalten. Beachten Sie, dass es häufiger ist, diese Felder deklarativ zu definieren.
Sie können Objekte mithilfe der entsprechenden Methoden der DataControlFieldCollection Klasse hinzufügen, einfügen und entfernenDataControlField. Verwenden Sie eine der folgenden Methoden, um Objekte programmgesteuert aus einer Auflistung abzurufen DataControlField :
Verwenden Sie den Indexer, um ein einzelnes DataControlField Objekt aus der Auflistung mithilfe der 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 Gesamtanzahl der Elemente in der Auflistung an und wird häufig verwendet, um die obere Grenze der Auflistung zu bestimmen. Sie können Elemente mithilfe der AddMethoden , Insert, , Removeund die Elemente aus der Auflistung hinzufügen und RemoveAt daraus entfernen.
Wenn Sie das GridView Steuerelement verwenden, DetailsView werden die DataControlField automatisch erstellten Objekte (z. B. wenn die AutoGenerateColumns Eigenschaft lautet true) nicht in der Auflistung öffentlich zugänglicher Felder gespeichert. Sie können nur auf Objekte zugreifen und diese bearbeiten DataControlField , die nicht automatisch generiert werden.
In der folgenden Tabelle sind die verschiedenen Datensteuerelement-Feldklassen und deren Verwendung aufgeführt.
| 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 für die von der Zeile (oder Spalte) angezeigten Daten ausgeführt 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
| Name | Beschreibung |
|---|---|
| DataControlFieldCollection() |
Initialisiert eine neue Instanz der DataControlFieldCollection-Klasse. |
Eigenschaften
| Name | Beschreibung |
|---|---|
| Count |
Ruft die Anzahl der In der StateManagedCollection Auflistung enthaltenen Elemente ab. (Geerbt von StateManagedCollection) |
| Item[Int32] |
Dient zum Abrufen oder Festlegen des DataControlField Objekts am angegebenen Index in der Auflistung. |
Methoden
| Name | Beschreibung |
|---|---|
| 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) |
Bestimmt, ob die DataControlFieldCollection Auflistung ein bestimmtes DataControlField Objekt enthält. |
| CopyTo(Array, Int32) |
Kopiert die Elemente der StateManagedCollection Auflistung in ein Array, beginnend bei einem bestimmten Arrayindex. (Geerbt von StateManagedCollection) |
| CopyTo(DataControlField[], Int32) |
Kopiert die gesamte DataControlFieldCollection Auflistung in eine kompatible eindimensionale ArrayAuflistung, beginnend am angegebenen Index des Zielarrays. |
| CreateKnownType(Int32) |
Wenn sie in einer abgeleiteten Klasse überschrieben IStateManagerwird, wird eine Instanz einer Klasse erstellt, die implementiert wird. Der Typ des erstellten Objekts basiert auf dem angegebenen Element der Auflistung, die von der GetKnownTypes() Methode zurückgegeben wird. (Geerbt von StateManagedCollection) |
| Equals(Object) |
Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object) |
| GetEnumerator() |
Gibt einen Iterator zurück, der die StateManagedCollection Auflistung durchläuft. (Geerbt von StateManagedCollection) |
| GetHashCode() |
Dient als Standardhashfunktion. (Geerbt von Object) |
| GetKnownTypes() |
Wenn eine abgeleitete Klasse überschrieben wird, wird ein Array von IStateManager Typen abgerufen, die die StateManagedCollection Auflistung enthalten kann. (Geerbt von StateManagedCollection) |
| GetType() |
Ruft die 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 in die DataControlFieldCollection Auflistung am angegebenen Index ein. |
| MemberwiseClone() |
Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object) |
| OnClear() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, werden zusätzliche Aufgaben ausgeführt, bevor die Clear() Methode alle Elemente aus der Auflistung entfernt. (Geerbt von StateManagedCollection) |
| OnClearComplete() |
Wenn sie in einer abgeleiteten Klasse überschrieben wird, führt die Methode zusätzliche Arbeit aus, nachdem die Clear() Methode beendet ist, alle Elemente aus der Auflistung zu entfernen. (Geerbt von StateManagedCollection) |
| OnInsert(Int32, Object) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, führt sie zusätzliche Arbeit durch, bevor die IList.Insert(Int32, Object)IList.Add(Object) Auflistung ein Element hinzufügt. (Geerbt von StateManagedCollection) |
| OnInsertComplete(Int32, Object) |
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, führt sie zusätzliche Arbeit durch, nachdem die IList.Insert(Int32, Object) Auflistung IList.Add(Object) ein Element hinzugefügt hat. (Geerbt von StateManagedCollection) |
| OnRemove(Int32, Object) |
Wenn sie in einer abgeleiteten Klasse überschrieben werden, werden zusätzliche Aufgaben ausgeführt, bevor das IList.Remove(Object)IList.RemoveAt(Int32) angegebene Element aus der Auflistung entfernt wird. (Geerbt von StateManagedCollection) |
| OnRemoveComplete(Int32, Object) |
Wenn sie in einer abgeleiteten Klasse außer Kraft gesetzt wird, führt sie zusätzliche Arbeit durch, nachdem das IList.Remove(Object)IList.RemoveAt(Int32) angegebene Element aus der Auflistung entfernt wurde. (Geerbt von StateManagedCollection) |
| OnValidate(Object) |
Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, wird ein Element der StateManagedCollection Auflistung überprüft. (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, dass die gesamte StateManagedCollection Sammlung in den Ansichtszustand serialisiert wird. (Geerbt von StateManagedCollection) |
| SetDirtyObject(Object) |
Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, weist sie eine |
| ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |
Ereignisse
| Name | Beschreibung |
|---|---|
| FieldsChanged |
Tritt auf, wenn sich die Felder in der Auflistung ändern, in der Regel als Ergebnis eines Clear()Aufrufs Insert(Int32, DataControlField)der Methode oder Add(DataControlField) eines MethodenaufrufsRemove(DataControlField). Dieses Ereignis wird auch ausgelöst, wenn eine DataControlField In der Auflistung das |
Explizite Schnittstellenimplementierungen
| Name | Beschreibung |
|---|---|
| ICollection.Count |
Ruft die Anzahl der In der StateManagedCollection Auflistung enthaltenen Elemente ab. (Geerbt von StateManagedCollection) |
| ICollection.IsSynchronized |
Ruft einen Wert ab, der angibt, ob die StateManagedCollection Auflistung synchronisiert wird (Threadsicher). Diese Methode gibt in allen Fällen zurück |
| ICollection.SyncRoot |
Ruft ein Objekt ab, das zum Synchronisieren des Zugriffs auf die StateManagedCollection Auflistung verwendet werden kann. Diese Methode gibt in allen Fällen zurück |
| 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) |
Bestimmt, ob die StateManagedCollection Auflistung einen bestimmten Wert enthält. (Geerbt von StateManagedCollection) |
| IList.IndexOf(Object) |
Bestimmt den Index eines angegebenen Elements in der StateManagedCollection Auflistung. (Geerbt von StateManagedCollection) |
| IList.Insert(Int32, Object) |
Fügt ein Element in die StateManagedCollection Auflistung am angegebenen Index ein. (Geerbt von StateManagedCollection) |
| IList.IsFixedSize |
Ruft einen Wert ab, der angibt, ob die StateManagedCollection Auflistung eine feste Größe aufweist. Diese Methode gibt in allen Fällen zurück |
| 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 am Ansichtszustand speichert. (Geerbt von StateManagedCollection) |
| IStateManager.LoadViewState(Object) |
Stellt den zuvor gespeicherten Ansichtsstatus der StateManagedCollection Auflistung und der IStateManager darin enthaltenen Elemente wieder her. (Geerbt von StateManagedCollection) |
| IStateManager.SaveViewState() |
Speichert die Änderungen an der StateManagedCollection Auflistung und jedes IStateManager Objekt, das sie enthält, seit der Zeitpunkt, zu dem die Seite wieder auf dem Server gepostet wurde. (Geerbt von StateManagedCollection) |
| IStateManager.TrackViewState() |
Bewirkt, dass die StateManagedCollection Auflistung und jedes der IStateManager darin enthaltenen Objekte Änderungen am Ansichtszustand nachverfolgt, sodass sie über Anforderungen für dieselbe Seite hinweg beibehalten werden können. (Geerbt von StateManagedCollection) |
Erweiterungsmethoden
| Name | Beschreibung |
|---|---|
| AsParallel(IEnumerable) |
Aktiviert die Parallelisierung einer Abfrage. |
| AsQueryable(IEnumerable) |
Konvertiert ein IEnumerable In ein IQueryable. |
| Cast<TResult>(IEnumerable) |
Wandelt die Elemente eines IEnumerable Elements in den angegebenen Typ um. |
| OfType<TResult>(IEnumerable) |
Filtert die Elemente einer IEnumerable basierend auf einem angegebenen Typ. |
