Dieser Artikel wurde manuell übersetzt. Bewegen Sie den Mauszeiger über die Sätze im Artikel, um den Originaltext anzuzeigen.
Übersetzung
Original
Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

StateManagedCollection-Klasse

Stellt eine Basisklasse für alle stark typisierten Auflistungen bereit, die IStateManager-Objekte verwalten.

System.Object
  System.Web.UI.StateManagedCollection
    Weitere Informationen...

Namespace:  System.Web.UI
Assembly:  System.Web (in System.Web.dll)
public abstract class StateManagedCollection : IList, 
	ICollection, IEnumerable, IStateManager

Der StateManagedCollection-Typ macht die folgenden Member verfügbar.

  NameBeschreibung
Geschützte MethodeStateManagedCollectionInitialisiert eine neue Instanz der StateManagedCollection-Klasse.
Zum Seitenanfang
  NameBeschreibung
Öffentliche EigenschaftCountRuft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab.
Zum Seitenanfang
  NameBeschreibung
Öffentliche MethodeClearEntfernt alle Elemente aus der StateManagedCollection-Auflistung.
Öffentliche MethodeCopyToKopiert die Elemente der StateManagedCollection-Auflistung in ein Array, wobei an einem bestimmten Arrayindex begonnen wird.
Geschützte MethodeCreateKnownTypeBeim Überschreiben in einer abgeleiteten Klasse wird eine Instanz einer Klasse erstellt, die IStateManager implementiert. Der Typ des erstellten Objekts basiert auf dem angegebenen Member der Auflistung, der von der GetKnownTypes-Methode zurückgegeben wird.
Öffentliche MethodeEquals(Object) Bestimmt, ob das übergegebene Object und das aktuelle Object gleich sind. (Von Object geerbt.)
Geschützte MethodeFinalize Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
Öffentliche MethodeGetEnumeratorGibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft.
Öffentliche MethodeGetHashCodeFungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
Geschützte MethodeGetKnownTypesBeim Überschreiben in einer abgeleiteten Klasse wird ein Array von IStateManager-Typen abgerufen, die die StateManagedCollection-Auflistung enthalten kann.
Öffentliche MethodeGetTypeRuft den Type der aktuellen Instanz ab. (Von Object geerbt.)
Geschützte MethodeMemberwiseCloneErstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
Geschützte MethodeOnClearBeim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Clear-Methode alle Elemente aus der Auflistung entfernt.
Geschützte MethodeOnClearCompleteBeim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die Clear-Methode alle Elemente aus der Auflistung entfernt hat.
Geschützte MethodeOnInsertBeim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Insert(Int32, Object)-Methode oder die Add(Object)-Methode der Auflistung ein Element hinzufügt.
Geschützte MethodeOnInsertCompleteBeim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die Insert(Int32, Object)-Methode oder die Add(Object)-Methode der Auflistung ein Element hinzugefügt hat.
Geschützte MethodeOnRemoveBeim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, bevor die Remove(Object)-Methode oder die RemoveAt(Int32)-Methode das angegebene Element aus der Auflistung entfernt.
Geschützte MethodeOnRemoveCompleteBeim Überschreiben in einer abgeleiteten Klasse werden zusätzliche Aufgaben ausgeführt, nachdem die Remove(Object)-Methode oder die RemoveAt(Int32)-Methode das angegebene Element aus der Auflistung entfernt hat.
Geschützte MethodeOnValidateBeim Überschreiben in einer abgeleiteten Klasse wird ein Element der StateManagedCollection-Auflistung validiert.
Öffentliche MethodeSetDirtyErzwingt den serialisierten Ansichtszustand für die gesamte StateManagedCollection-Auflistung.
Geschützte MethodeSetDirtyObjectBeim Überschreiben in einer abgeleiteten Klasse wird ein in der Auflistung enthaltenes object angewiesen, seinen gesamten Zustand im Ansichtszustand aufzuzeichnen, anstatt nur die Änderungsinformationen aufzuzeichnen.
Öffentliche MethodeToStringGibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)
Zum Seitenanfang
  NameBeschreibung
Öffentliche ErweiterungsmethodeAsParallelErmöglicht die Parallelisierung einer Abfrage. (Durch ParallelEnumerable definiert.)
Öffentliche ErweiterungsmethodeAsQueryableKonvertiert einen IEnumerable in einen IQueryable. (Durch Queryable definiert.)
Öffentliche ErweiterungsmethodeCast<TResult>Konvertiert die Elemente eines IEnumerable in den angegebenen Typ. (Durch Enumerable definiert.)
Öffentliche ErweiterungsmethodeOfType<TResult>Filtert die Elemente eines IEnumerable anhand eines angegebenen Typs. (Durch Enumerable definiert.)
Zum Seitenanfang
  NameBeschreibung
Explizite SchnittstellenimplementierungPrivate EigenschaftICollection.CountInfrastruktur. Ruft die Anzahl der Elemente in der StateManagedCollection-Auflistung ab.
Explizite SchnittstellenimplementierungPrivate EigenschaftICollection.IsSynchronizedInfrastruktur. Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung synchronisiert (threadsicher) ist. Diese Methode gibt immer false zurück.
Explizite SchnittstellenimplementierungPrivate EigenschaftICollection.SyncRootInfrastruktur. Ruft ein Objekt ab, mit dem der Zugriff auf die StateManagedCollection-Auflistung synchronisiert werden kann. Diese Methode gibt immer null zurück.
Explizite SchnittstellenimplementierungPrivate MethodeIEnumerable.GetEnumeratorInfrastruktur. Gibt einen Iterator zurück, der die StateManagedCollection-Auflistung durchläuft.
Explizite SchnittstellenimplementierungPrivate MethodeIList.AddFügt der StateManagedCollection-Auflistung ein Element hinzu.
Explizite SchnittstellenimplementierungPrivate MethodeIList.ClearInfrastruktur. Entfernt alle Elemente aus der StateManagedCollection-Auflistung.
Explizite SchnittstellenimplementierungPrivate MethodeIList.ContainsErmittelt, ob die StateManagedCollection-Auflistung einen bestimmten Wert enthält.
Explizite SchnittstellenimplementierungPrivate MethodeIList.IndexOfBestimmt den Index eines bestimmten Elements in der StateManagedCollection-Auflistung.
Explizite SchnittstellenimplementierungPrivate MethodeIList.InsertFügt ein Element am angegebenen Index in die StateManagedCollection-Auflistung ein.
Explizite SchnittstellenimplementierungPrivate EigenschaftIList.IsFixedSizeInfrastruktur. Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung eine feste Größe hat. Diese Methode gibt immer false zurück.
Explizite SchnittstellenimplementierungPrivate EigenschaftIList.IsReadOnlyInfrastruktur. Ruft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung schreibgeschützt ist.
Explizite SchnittstellenimplementierungPrivate EigenschaftIList.ItemInfrastruktur. Ruft das IStateManager-Element am angegebenen Index ab.
Explizite SchnittstellenimplementierungPrivate MethodeIList.RemoveEntfernt das erste Vorkommen des angegebenen Objekts aus der StateManagedCollection-Auflistung.
Explizite SchnittstellenimplementierungPrivate MethodeIList.RemoveAtEntfernt das IStateManager-Element am angegebenen Index.
Explizite SchnittstellenimplementierungPrivate EigenschaftIStateManager.IsTrackingViewStateRuft einen Wert ab, der angibt, ob die StateManagedCollection-Auflistung Änderungen des Ansichtszustands speichert.
Explizite SchnittstellenimplementierungPrivate MethodeIStateManager.LoadViewStateStellt den zuvor gespeicherten Ansichtszustand der StateManagedCollection-Auflistung und der in ihr enthaltenen IStateManager-Elemente wieder her.
Explizite SchnittstellenimplementierungPrivate MethodeIStateManager.SaveViewStateSpeichert 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.
Explizite SchnittstellenimplementierungPrivate MethodeIStateManager.TrackViewStateWeist 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.
Zum Seitenanfang

Die StateManagedCollection-Klasse ist die Basisklasse für alle stark typisierten Auflistungen, die IStateManager-Elemente speichern, einschließlich DataControlFieldCollection, ParameterCollection, StyleCollection, TreeNodeBindingCollection usw. Die StateManagedCollection-Auflistung verwaltet ihren eigenen Zustand sowie den Zustand der in ihr enthaltenen Elemente. Deshalb werden bei einem Aufruf von SaveViewState() der Zustand der Auflistung und der Zustand aller Elemente gespeichert, die gegenwärtig in der Auflistung enthalten sind.

Im Folgenden sind die wichtigsten Methoden aufgeführt, die beim Ableiten von der StateManagedCollection-Klasse zu berücksichtigen sind: CreateKnownType, GetKnownTypes, OnValidate, SetDirty und SetDirtyObject. Die CreateKnownType-Methode und die GetKnownTypes-Methode werden verwendet, um für den Typ eines enthaltenen Elements einen Index im Ansichtszustand zu speichern. Die Leistung wird verbessert, wenn anstelle eines vollqualifizierten Typnamens ein Index gespeichert wird. Die OnValidate-Methode wird immer dann aufgerufen, wenn Elemente der Auflistung bearbeitet werden. Sie überprüft die Elemente entsprechend den Geschäftsregeln. Gegenwärtig verhindert die Implementierung der OnValidate-Methode das Speichern von null-Objekten in der Auflistung. Sie können diese Methode jedoch überschreiben, um ein eigenes Validierungsverhalten in einem abgeleiteten Typ zu definieren. Anstatt nur die Zustandsänderungen zu serialisieren, die seit dem letzten Ladevorgang vorgenommen wurden, erzwingt die SetDirty-Methode einen serialisierten Ansichtszustand für die gesamte Auflistung. Die SetDirtyObject-Methode ist eine abstrakte Methode, die Sie zum Ausführen desselben Verhaltens auf der Elementebene implementieren können.

SicherheitshinweisSicherheitshinweis

StateManagedCollection speichert durch die Assembly qualifizierte Typnamen der Auflistungselemente im Ansichtszustand. Ein Sitebesucher könnte den Ansichtszustand decodieren und den Typnamen abrufen. Wenn dies für Ihre Website riskant wäre, können Sie den Typnamen vor der Platzierung im Ansichtszustand manuell verschlüsseln.

Im folgenden Codebeispiel wird veranschaulicht, wie eine stark typisierte Auflistungsklasse von StateManagedCollection abgeleitet wird, die IStateManager-Objekte enthält. In diesem Beispiel wird die CycleCollection abgeleitet, die Instanzen der abstrakten Cycle-Klasse enthält. Dabei kann es sich um Bicycle-Objekte oder um Tricycle-Objekte handeln. Die Cycle-Klasse implementiert die IStateManager-Schnittstelle, da sie den Wert der CycleColor-Eigenschaft im Ansichtszustand speichert.


namespace Samples.AspNet.CS.Controls {

    using System;
    using System.Security.Permissions;
    using System.Collections;
    using System.ComponentModel;
    using System.Drawing;           
    using System.Web;
    using System.Web.UI;            
    //////////////////////////////////////////////////////////////
    //
    // The strongly typed CycleCollection class is a collection
    // that contains Cycle class instances, which implement the
    // IStateManager interface.
    //
    //////////////////////////////////////////////////////////////
    [AspNetHostingPermission(SecurityAction.Demand, 
        Level=AspNetHostingPermissionLevel.Minimal)]
    public sealed class CycleCollection : StateManagedCollection {

        private static readonly Type[] _typesOfCycles 
            = new Type[] { typeof(Bicycle), typeof(Tricycle) };

        protected override object CreateKnownType(int index) {
            switch(index) {
                case 0:
                    return new Bicycle();
                case 1:
                    return new Tricycle();                    
                default:
                    throw new ArgumentOutOfRangeException("Unknown Type");
            }            
        }

        protected override Type[] GetKnownTypes() {
            return _typesOfCycles;
        }

        protected override void SetDirtyObject(object o) {
            ((Cycle)o).SetDirty();
        }

    }
    //////////////////////////////////////////////////////////////
    //
    // The abstract Cycle class represents bicycles and tricycles.
    //
    //////////////////////////////////////////////////////////////
    public abstract class Cycle : IStateManager {

        protected internal Cycle(int numWheels) : this(numWheels, "Red"){ }

        protected internal Cycle(int numWheels, String color) {    
            numberOfWheels = numWheels;
            CycleColor = color;
        }

        private int numberOfWheels = 0;
        public int NumberOfWheels {
            get { return numberOfWheels; }
        }

        public string CycleColor {
            get { 
                object o = ViewState["Color"];
                return (null == o) ? String.Empty : o.ToString() ;
            }
            set {
                ViewState["Color"] = value;            
            }        
        }

        internal void SetDirty() {
            ViewState.SetDirty(true);
        }

        // Because Cycle does not derive from Control, it does not 
        // have access to an inherited view state StateBag object.
        private StateBag viewState;
        private StateBag ViewState {
            get {
                if (viewState == null) {
                    viewState = new StateBag(false);
                    if (isTrackingViewState) {
                        ((IStateManager)viewState).TrackViewState();
                    }
                }
                return viewState;
            }
        }

        // The IStateManager implementation.
        private bool isTrackingViewState;
        bool IStateManager.IsTrackingViewState {
            get {
                return isTrackingViewState;
            }
        }

        void IStateManager.LoadViewState(object savedState) {
            object[] cycleState = (object[]) savedState;

            // In SaveViewState, an array of one element is created.
            // Therefore, if the array passed to LoadViewState has 
            // more than one element, it is invalid.
            if (cycleState.Length != 1) {
                throw new ArgumentException("Invalid Cycle View State");
            }

            // Call LoadViewState on the StateBag object.
            ((IStateManager)ViewState).LoadViewState(cycleState[0]);
        }

        // Save the view state by calling the StateBag's SaveViewState
        // method.
        object IStateManager.SaveViewState() {
            object[] cycleState = new object[1];

            if (viewState != null) {
                cycleState[0] = ((IStateManager)viewState).SaveViewState();
            }
            return cycleState;
        }

        // Begin tracking view state. Check the private variable, because 
        // if the view state has not been accessed or set, then it is not  
        // being used and there is no reason to store any view state.
        void IStateManager.TrackViewState() {
            isTrackingViewState = true;
            if (viewState != null) {
                ((IStateManager)viewState).TrackViewState();
            }
        }        
    }

    public sealed class Bicycle : Cycle {

        // Create a red Cycle with two wheels.
        public Bicycle() : base(2) {}    
    }

    public sealed class Tricycle : Cycle {

        // Create a red Cycle with three wheels.
        public Tricycle() : base(3) {}
    }

}


.NET Framework

Unterstützt in: 4, 3.5, 3.0, 2.0

Windows 7, Windows Vista SP1 oder höher, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core wird nicht unterstützt), Windows Server 2008 R2 (Server Core wird mit SP1 oder höher unterstützt), Windows Server 2003 SP2

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.
Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.
Fanden Sie dies hilfreich?
(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN
© 2013 Microsoft. Alle Rechte vorbehalten.