ISessionStateItemCollection Schnittstelle

Referenz

Definition

Namespace:: System.Web.SessionState

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.

Definiert den Vertrag für die Auflistung, die vom ASP.NET-Sitzungszustand zum Verwalten der Sitzung verwendet wird.

public interface class ISessionStateItemCollection : System::Collections::ICollection

public interface ISessionStateItemCollection : System.Collections.ICollection

type ISessionStateItemCollection = interface
    interface ICollection
    interface IEnumerable

Public Interface ISessionStateItemCollection
Implements ICollection

Abgeleitet: System.Web.SessionState.SessionStateItemCollection

Implementiert: ICollection IEnumerable

Beispiele

Im folgenden Codebeispiel wird die ISessionStateItemCollection SortedList Klasse implementiert und verwendet, um Sitzungsstatusvariablennamen und -werte zu speichern.

using System;
using System.Web;
using System.Web.SessionState;
using System.Collections;
using System.Collections.Specialized;

namespace Samples.AspNet.Session
{

  public class MySessionStateItemCollection : ISessionStateItemCollection
  {
    private SortedList pItems = new SortedList();
    private bool pDirty = false;

    public bool Dirty
    {
      get { return pDirty; }
      set { pDirty = value; }
    }

    public object this[int index]
    {
      get { return pItems[index]; }
      set
      {
        pItems[index] = value;
        pDirty = true;
      }
    }

    public object this[string name]
    {
      get { return pItems[name]; }
      set
      {
        pItems[name] = value;
        pDirty = true;
      }
    }

    public NameObjectCollectionBase.KeysCollection Keys
    {
      get { return (NameObjectCollectionBase.KeysCollection)pItems.Keys; }
    }

    public int Count
    {
      get { return pItems.Count; }
    }

    public Object SyncRoot
    {
      get { return this; }
    }

    public bool IsSynchronized
    {
      get { return false; }
    }

    public IEnumerator GetEnumerator()
    {
      return pItems.GetEnumerator(); 
    }

    public void Clear()
    {
      pItems.Clear();
      pDirty = true;
    }

    public void Remove(string name)
    {
      pItems.Remove(name);
      pDirty = true;
    }

    public void RemoveAt(int index)
    {
      if (index < 0 || index >= this.Count)
        throw new ArgumentOutOfRangeException("The specified index is not within the acceptable range.");

      pItems.RemoveAt(index);
      pDirty = true;
    }

    public void CopyTo(Array array, int index)
    {
      pItems.CopyTo(array, index);
    }
  }
}

Imports System.Web
Imports System.Web.SessionState
Imports System.Collections
Imports System.Collections.Specialized


Namespace Samples.AspNet.Session

  Public Class MySessionStateItemCollection
    Implements ISessionStateItemCollection
  
    Private pItems As SortedList = New SortedList()
    Private pDirty As Boolean = False

    Public Property Dirty As Boolean Implements ISessionStateItemCollection.Dirty    
      Get
        Return pDirty
      End Get
      Set
        pDirty = value
      End Set
    End Property

    Public Property Item(index As Integer) As Object Implements ISessionStateItemCollection.Item
      Get
        Return pItems(index)
      End Get
      Set
        pItems(index) = value
        pDirty = True
      End Set
    End Property

    Public Property Item(name As String) As Object Implements ISessionStateItemCollection.Item
      Get
        Return pItems(name)
      End Get
      Set
        pItems(name) = value
        pDirty = True
      End Set
    End Property

    Public ReadOnly Property Keys As NameObjectCollectionBase.KeysCollection _
      Implements ISessionStateItemCollection.Keys
      Get
        Return CType(pItems.Keys, NameObjectCollectionBase.KeysCollection)
      End Get
    End Property

    Public ReadOnly Property Count As Integer Implements ICollection.Count    
      Get
        Return pItems.Count
      End Get
    End Property

    Public ReadOnly Property SyncRoot As Object Implements ICollection.SyncRoot    
      Get
        Return Me
      End Get
    End Property

    Public ReadOnly Property IsSynchronized As Boolean Implements ICollection.IsSynchronized
      Get
        Return False
      End Get
    End Property

    Public Function GetEnumerator() As IEnumerator Implements ICollection.GetEnumerator    
      Return pItems.GetEnumerator() 
    End Function

    Public Sub Clear() Implements ISessionStateItemCollection.Clear
      pItems.Clear()
      pDirty = True
    End Sub

    Public Sub Remove(name As String) Implements ISessionStateItemCollection.Remove
      pItems.Remove(name)
      pDirty = True
    End Sub

    Public Sub RemoveAt(index As Integer) Implements ISessionStateItemCollection.RemoveAt 
      If index < 0 OrElse index >= Me.Count Then _
        Throw New ArgumentOutOfRangeException("The specified index is not within the acceptable range.")
   
      pItems.RemoveAt(index)
      pDirty = True
    End Sub

    Public Sub CopyTo(array As Array, index As Integer) Implements ICollection.CopyTo
      pItems.CopyTo(array, index)
    End Sub

  End Class

End Namespace

Hinweise

Die ISessionStateItemCollection Schnittstelle definiert die Auflistung von Sitzungselementen, die dem Anwendungscode von der HttpSessionStateContainer Klasse verfügbar gemacht werden.

Die ASP.NET Implementierung der ISessionStateItemCollection Schnittstelle ist die SessionStateItemCollection Klasse.

Wenn Sie eine von der SessionStateStoreProviderBase Klasse abgeleitete Klasse zum Speichern von Sitzungsdaten erstellen, können Sie entweder die SessionStateItemCollection Klasse verwenden, um die gespeicherten Objekte zu verwalten oder die ISessionStateItemCollection Schnittstelle auf Ihrem eigenen Auflistungs-Manager zu implementieren.

Wenn Sie die Schnittstelle implementieren, müssen Sie auch eine Klasse erstellen, die die ISessionStateItemCollection SessionStateStoreProviderBase Klasse erbt, um Ihre ISessionStateItemCollection Implementierung zum Verwalten von Sitzungsvariablen zu verwenden.

Eine ISessionStateItemCollection Implementierung muss auch die Member der ICollection Schnittstelle implementieren.

Eigenschaften

Count	Ruft die Anzahl der Elemente ab, die in ICollection enthalten sind. (Geerbt von ICollection)
Dirty	Ruft einen Wert ab, der angibt, ob die Auflistung als geändert markiert wurde, oder legt diesen fest.
IsSynchronized	Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert (threadsicher) ist. (Geerbt von ICollection)
Item[Int32]	Ruft einen Wert in der Auflistung über den numerischen Index ab oder legt diesen fest.
Item[String]	Ruft einen Wert in der Auflistung über den Namen ab oder legt diesen fest.
Keys	Ruft eine Auflistung der Variablennamen für alle in der Auflistung gespeicherten Werte ab.
SyncRoot	Ruft ein Objekt ab, mit dem der Zugriff auf ICollection synchronisiert werden kann. (Geerbt von ICollection)

Methoden

Clear()	Entfernt alle Werte und Schlüssel aus der Sitzungszustandsauflistung.
CopyTo(Array, Int32)	Kopiert die Elemente der ICollection in ein Array, beginnend bei einem bestimmten Array-Index. (Geerbt von ICollection)
GetEnumerator()	Gibt einen Enumerator zurück, der eine Auflistung durchläuft. (Geerbt von IEnumerable)
Remove(String)	Löscht ein Element aus der Auflistung.
RemoveAt(Int32)	Löscht ein Element an einem angegebenen Index aus der Auflistung.

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

Siehe auch

Überblick über den ASP.NET-Sitzungsstatus