ISessionStateItemCollection Interface

Definitie

Definieert het contract voor de verzameling die wordt gebruikt door ASP.NET sessiestatus voor het beheren van de sessie.

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
Afgeleid
Implementeringen

Voorbeelden

In het volgende codevoorbeeld wordt de ISessionStateItemCollection klasse geïmplementeerd en wordt de SortedList klasse gebruikt om namen en waarden van sessiestatusvariabelen op te slaan.

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

Opmerkingen

De ISessionStateItemCollection interface definieert de verzameling sessie-items die door de HttpSessionStateContainer klasse worden blootgesteld aan toepassingscode.

De ASP.NET implementatie van de interface ISessionStateItemCollection is de klasse SessionStateItemCollection.

Als u een klasse maakt die is afgeleid van de SessionStateStoreProviderBase klasse om sessiegegevens op te slaan, kunt u de SessionStateItemCollection klasse gebruiken om de opgeslagen objecten te beheren of de ISessionStateItemCollection interface in uw eigen verzamelingsbeheer te implementeren.

Als u de ISessionStateItemCollection interface implementeert, moet u ook een klasse maken die de SessionStateStoreProviderBase klasse over neemt om gebruik te kunnen maken van uw ISessionStateItemCollection implementatie voor het beheren van sessievariabelen.

Een ISessionStateItemCollection implementatie moet ook de leden van de ICollection interface implementeren.

Eigenschappen

Name Description
Count

Hiermee haalt u het aantal elementen op dat is opgenomen in de ICollection.

(Overgenomen van ICollection)
Dirty

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de verzameling is gemarkeerd als gewijzigd.

IsSynchronized

Hiermee wordt een waarde opgehaald die aangeeft of de toegang tot de ICollection synchronisatie is gesynchroniseerd (thread safe).

(Overgenomen van ICollection)
Item[Int32]

Hiermee wordt een waarde in de verzameling opgehaald of ingesteld op basis van een numerieke index.

Item[String]

Hiermee haalt u een waarde in de verzameling op naam op of stelt u deze in.

Keys

Hiermee haalt u een verzameling van de variabelenamen op voor alle waarden die zijn opgeslagen in de verzameling.

SyncRoot

Hiermee haalt u een object op dat kan worden gebruikt om de toegang tot het ICollectionobject te synchroniseren.

(Overgenomen van ICollection)

Methoden

Name Description
Clear()

Hiermee verwijdert u alle waarden en sleutels uit de verzameling sessiestatus.

CopyTo(Array, Int32)

Kopieert de elementen van de ICollection elementen naar een Array, beginnend bij een bepaalde Array index.

(Overgenomen van ICollection)
GetEnumerator()

Retourneert een enumerator die door een verzameling wordt herhaald.

(Overgenomen van IEnumerable)
Remove(String)

Hiermee verwijdert u een item uit de verzameling.

RemoveAt(Int32)

Hiermee verwijdert u een item in een opgegeven index uit de verzameling.

Extensiemethoden

Name Description
AsParallel(IEnumerable)

Hiermee schakelt u parallelle uitvoering van een query in.

AsQueryable(IEnumerable)

Converteert een IEnumerable naar een IQueryable.

Cast<TResult>(IEnumerable)

Cast de elementen van een IEnumerable naar het opgegeven type.

OfType<TResult>(IEnumerable)

Hiermee filtert u de elementen van een IEnumerable op basis van een opgegeven type.

Van toepassing op

Zie ook