ISessionStateItemCollection ISessionStateItemCollection ISessionStateItemCollection ISessionStateItemCollection Interface

Definition

Definiert den Vertrag für die Auflistung, die vom ASP.NET-Sitzungszustand zum Verwalten der Sitzung verwendet wird.Defines the contract for the collection used by ASP.NET session state to manage session.

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
Implementiert

Beispiele

Das folgende Codebeispiel implementiert die ISessionStateItemCollection und verwendet die SortedList -Klasse zum Speichern des Sitzungszustands-Namen und Werte.The following code example implements the ISessionStateItemCollection and uses the SortedList class to store session-state variable names and values.

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
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 der Sitzungselemente, die verfügbar gemacht werden, zum Anwendungscode von der HttpSessionStateContainer Klasse.The ISessionStateItemCollection interface defines the collection of session items exposed to application code by the HttpSessionStateContainer class.

Die ASP.NET-Implementierung der ISessionStateItemCollection Schnittstelle ist die SessionStateItemCollection Klasse.The ASP.NET implementation of the ISessionStateItemCollection interface is the SessionStateItemCollection class.

Bei der Erstellung einer Klasse abgeleitet der SessionStateStoreProviderBase Klasse, um Daten zu speichern, können Sie entweder die SessionStateItemCollection Klasse, um die gespeicherten Objekte verwalten, oder implementieren Sie die ISessionStateItemCollection Schnittstelle auf Ihre eigenen sammlungsmanager.If you create a class derived from the SessionStateStoreProviderBase class to store session data, you can either use the SessionStateItemCollection class to manage the stored objects or implement the ISessionStateItemCollection interface on your own collection manager.

Wenn Sie implementieren die ISessionStateItemCollection -Schnittstelle, müssen Sie auch eine Klasse, die erbt erstellen die SessionStateStoreProviderBase Klasse, um die Stellen verwenden Ihre ISessionStateItemCollection Implementierung zum Verwalten von Sitzungsvariablen.If you implement the ISessionStateItemCollection interface, you must also create a class that inherits the SessionStateStoreProviderBase class in order to make use of your ISessionStateItemCollection implementation to manage session variables.

Ein ISessionStateItemCollection Implementierung muss auch die Elemente der implementieren die ICollection Schnittstelle.An ISessionStateItemCollection implementation must also implement the members of the ICollection interface.

Eigenschaften

Count Count Count Count

Ruft die Anzahl der Elemente ab, die in ICollection enthalten sind.Gets the number of elements contained in the ICollection.

(Inherited from ICollection)
Dirty Dirty Dirty Dirty

Ruft einen Wert ab, der angibt, ob die Auflistung als geändert markiert wurde, oder legt diesen fest.Gets or sets a value indicating whether the collection has been marked as changed.

IsSynchronized IsSynchronized IsSynchronized IsSynchronized

Ruft einen Wert ab, der angibt, ob der Zugriff auf die ICollection synchronisiert (threadsicher) ist.Gets a value indicating whether access to the ICollection is synchronized (thread safe).

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

Ruft einen Wert in der Auflistung über den numerischen Index ab oder legt diesen fest.Gets or sets a value in the collection by numerical index.

Item[String] Item[String] Item[String] Item[String]

Ruft einen Wert in der Auflistung über den Namen ab oder legt diesen fest.Gets or sets a value in the collection by name.

Keys Keys Keys Keys

Ruft eine Auflistung der Variablennamen für alle in der Auflistung gespeicherten Werte ab.Gets a collection of the variable names for all values stored in the collection.

SyncRoot SyncRoot SyncRoot SyncRoot

Ruft ein Objekt ab, mit dem der Zugriff auf ICollection synchronisiert werden kann.Gets an object that can be used to synchronize access to the ICollection.

(Inherited from ICollection)

Methoden

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

Entfernt alle Werte und Schlüssel aus der Sitzungszustandsauflistung.Removes all values and keys from the session-state collection.

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

Kopiert die Elemente der ICollection in ein Array, beginnend bei einem bestimmten Array-Index.Copies the elements of the ICollection to an Array, starting at a particular Array index.

(Inherited from ICollection)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Gibt einen Enumerator zurück, der eine Auflistung durchläuft.Returns an enumerator that iterates through a collection.

(Inherited from IEnumerable)
Remove(String) Remove(String) Remove(String) Remove(String)

Löscht ein Element aus der Auflistung.Deletes an item from the collection.

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

Löscht ein Element an einem angegebenen Index aus der Auflistung.Deletes an item at a specified index from the collection.

Extension Methods

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 eine IEnumerable auf eine IQueryable.Converts an IEnumerable to an IQueryable.

Gilt für:

Siehe auch