ISessionStateItemCollection Antarmuka

Definisi

Ruang nama:

System.Web.SessionState

Rakitan:

System.Web.dll

Menentukan kontrak untuk koleksi yang digunakan oleh status sesi ASP.NET untuk mengelola sesi.

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

Turunan

System.Web.SessionState.SessionStateItemCollection

Penerapan

ICollection IEnumerable

Contoh

Contoh kode berikut mengimplementasikan ISessionStateItemCollection dan menggunakan SortedList kelas untuk menyimpan nama dan nilai variabel status sesi.

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

Keterangan

Antarmuka ISessionStateItemCollection mendefinisikan pengumpulan item sesi yang diekspos ke kode aplikasi oleh HttpSessionStateContainer kelas .

Implementasi ISessionStateItemCollection ASP.NET antarmuka adalah SessionStateItemCollection kelas .

Jika Anda membuat kelas yang berasal dari SessionStateStoreProviderBase kelas untuk menyimpan data sesi, Anda dapat menggunakan SessionStateItemCollection kelas untuk mengelola objek yang disimpan atau mengimplementasikan ISessionStateItemCollection antarmuka pada manajer koleksi Anda sendiri.

Jika Anda menerapkan ISessionStateItemCollection antarmuka, Anda juga harus membuat kelas yang mewarisi SessionStateStoreProviderBase kelas untuk memanfaatkan implementasi Anda ISessionStateItemCollection untuk mengelola variabel sesi.

Implementasi ISessionStateItemCollection juga harus mengimplementasikan anggota ICollection antarmuka.

Properti

Count	Mendapatkan jumlah elemen yang terkandung dalam ICollection. (Diperoleh dari ICollection)
Dirty	Mendapatkan atau menetapkan nilai yang menunjukkan apakah koleksi telah ditandai sebagai diubah.
IsSynchronized	Mendapatkan nilai yang menunjukkan apakah akses ke disinkronkan ICollection (utas aman). (Diperoleh dari ICollection)
Item[Int32]	Mendapatkan atau menetapkan nilai dalam koleksi menurut indeks numerik.
Item[String]	Mendapatkan atau menetapkan nilai dalam koleksi berdasarkan nama.
Keys	Mendapatkan kumpulan nama variabel untuk semua nilai yang disimpan dalam koleksi.
SyncRoot	Mendapatkan objek yang dapat digunakan untuk menyinkronkan akses ke ICollection. (Diperoleh dari ICollection)

Metode

Clear()	Menghapus semua nilai dan kunci dari koleksi status sesi.
CopyTo(Array, Int32)	Menyalin elemen ICollection ke Array, dimulai dari indeks tertentu Array . (Diperoleh dari ICollection)
GetEnumerator()	Mengembalikan enumerator yang berulang melalui koleksi. (Diperoleh dari IEnumerable)
Remove(String)	Menghapus item dari koleksi.
RemoveAt(Int32)	Menghapus item pada indeks tertentu dari koleksi.

Metode Ekstensi

Cast<TResult>(IEnumerable)	Mentransmisikan elemen dari ke IEnumerable jenis yang ditentukan.
OfType<TResult>(IEnumerable)	Memfilter elemen berdasarkan IEnumerable jenis yang ditentukan.
AsParallel(IEnumerable)	Mengaktifkan paralelisasi kueri.
AsQueryable(IEnumerable)	Mengonversi menjadi IEnumerableIQueryable.

Lihat juga

• Gambaran Umum Status Sesi ASP.NET