ISessionStateItemCollection Interfejs

Definicja

Przestrzeń nazw:

System.Web.SessionState

Zestaw:

System.Web.dll

Definiuje kontrakt dla kolekcji używanej przez stan sesji ASP.NET do zarządzania sesją.

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

Pochodne

System.Web.SessionState.SessionStateItemCollection

Implementuje

ICollection IEnumerable

Przykłady

Poniższy przykład kodu implementuje klasę ISessionStateItemCollection i używa SortedList klasy do przechowywania nazw i wartości zmiennych stanu sesji.

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

Uwagi

Interfejs ISessionStateItemCollection definiuje kolekcję elementów sesji uwidocznionych w kodzie aplikacji przez klasę HttpSessionStateContainer .

Implementacja ASP.NET interfejsu ISessionStateItemCollection jest klasą SessionStateItemCollection .

Jeśli tworzysz klasę pochodzącą z SessionStateStoreProviderBase klasy do przechowywania danych sesji, możesz użyć SessionStateItemCollection klasy do zarządzania przechowywanymi obiektami lub zaimplementować ISessionStateItemCollection interfejs we własnym menedżerze kolekcji.

W przypadku zaimplementowania interfejsu ISessionStateItemCollection należy również utworzyć klasę dziedziczą SessionStateStoreProviderBase klasę, aby korzystać z ISessionStateItemCollection implementacji w celu zarządzania zmiennymi sesji.

Implementacja ISessionStateItemCollection musi również implementować elementy członkowskie interfejsu ICollection .

Właściwości

Count	Pobiera liczbę elementów zawartych w słowniku ICollection. (Odziedziczone po ICollection)
Dirty	Pobiera lub ustawia wartość wskazującą, czy kolekcja została oznaczona jako zmieniona.
IsSynchronized	Pobiera wartość wskazującą, czy dostęp do elementu ICollection jest synchronizowany (bezpieczny wątek). (Odziedziczone po ICollection)
Item[Int32]	Pobiera lub ustawia wartość w kolekcji według indeksu liczbowego.
Item[String]	Pobiera lub ustawia wartość w kolekcji według nazwy.
Keys	Pobiera kolekcję nazw zmiennych dla wszystkich wartości przechowywanych w kolekcji.
SyncRoot	Pobiera obiekt, który może służyć do synchronizowania dostępu do obiektu ICollection. (Odziedziczone po ICollection)

Metody

Clear()	Usuwa wszystkie wartości i klucze z kolekcji stanu sesji.
CopyTo(Array, Int32)	Kopiuje elementy ICollection elementu do obiektu Array, zaczynając od określonego Array indeksu. (Odziedziczone po ICollection)
GetEnumerator()	Zwraca moduł wyliczający, który iteruje po kolekcji. (Odziedziczone po IEnumerable)
Remove(String)	Usuwa element z kolekcji.
RemoveAt(Int32)	Usuwa element w określonym indeksie z kolekcji.

Metody rozszerzania

Cast<TResult>(IEnumerable)	Rzutuje elementy elementu IEnumerable do określonego typu.
OfType<TResult>(IEnumerable)	Filtruje elementy elementu IEnumerable na podstawie określonego typu.
AsParallel(IEnumerable)	Umożliwia równoległość zapytania.
AsQueryable(IEnumerable)	Konwertuje element IEnumerable na .IQueryable

Zobacz też

• ASP.NET Session State Overview