ISessionStateItemCollection Interface

Référence

Définition

Espace de noms:: System.Web.SessionState

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Définit le contrat de la collection utilisée par l'état de la session ASP.NET pour gérer la 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

Dérivé: System.Web.SessionState.SessionStateItemCollection

Implémente: ICollection IEnumerable

Exemples

L’exemple de code suivant implémente et ISessionStateItemCollection utilise la classe pour stocker les SortedList noms et les valeurs des variables d’état de session.

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

Remarques

L’interface ISessionStateItemCollection définit la collection d’éléments de session exposés au code d’application par la HttpSessionStateContainer classe .

L’implémentation ASP.NET de l’interface ISessionStateItemCollection est la SessionStateItemCollection classe .

Si vous créez une classe dérivée de la SessionStateStoreProviderBase classe pour stocker les données de session, vous pouvez utiliser la SessionStateItemCollection classe pour gérer les objets stockés ou implémenter l’interface ISessionStateItemCollection sur votre propre gestionnaire de collection.

Si vous implémentez l’interface ISessionStateItemCollection , vous devez également créer une classe qui hérite de la SessionStateStoreProviderBase classe afin d’utiliser votre ISessionStateItemCollection implémentation pour gérer les variables de session.

Une ISessionStateItemCollection implémentation doit également implémenter les membres de l’interface ICollection .

Propriétés

Count	Obtient le nombre d’éléments contenus dans le ICollection. (Hérité de ICollection)
Dirty	Obtient ou définit une valeur indiquant si la collection a été marquée comme étant modifiée.
IsSynchronized	Obtient une valeur indiquant si l’accès à ICollection est synchronisé (thread-safe). (Hérité de ICollection)
Item[Int32]	Obtient ou définit une valeur dans la collection par index numérique.
Item[String]	Obtient ou définit une valeur dans la collection par nom.
Keys	Obtient une collection des noms de variables de toutes les valeurs stockées dans la collection.
SyncRoot	Obtient un objet qui peut être utilisé pour synchroniser l’accès à ICollection. (Hérité de ICollection)

Méthodes

Clear()	Supprime l'ensemble des valeurs et des clés de la collection d'états de session.
CopyTo(Array, Int32)	Copie les éléments de ICollection dans Array, à partir d'un index particulier de Array. (Hérité de ICollection)
GetEnumerator()	Retourne un énumérateur qui itère au sein d’une collection. (Hérité de IEnumerable)
Remove(String)	Supprime un élément de la collection.
RemoveAt(Int32)	Supprime un élément de la collection au niveau de l'index spécifié.

Méthodes d’extension

Cast<TResult>(IEnumerable)	Effectue un cast des éléments d'un IEnumerable vers le type spécifié.
OfType<TResult>(IEnumerable)	Filtre les éléments d'un IEnumerable en fonction du type spécifié.
AsParallel(IEnumerable)	Active la parallélisation d'une requête.
AsQueryable(IEnumerable)	Convertit un IEnumerable en IQueryable.

S’applique à

Voir aussi

Vue d'ensemble de l'état de session ASP.NET

Partage via