ISessionStateItemCollection Interfaccia

Definizione

Definisce il contratto per l'insieme utilizzato dallo stato sessione ASP.NET per la gestione della sessione.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
Derivato
Implementazioni

Esempi

Nell'esempio di codice seguente viene ISessionStateItemCollection implementato l'oggetto SortedList e viene utilizzata la classe per archiviare i nomi e i valori delle variabili dello stato sessione.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.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

Commenti

L' ISessionStateItemCollection interfaccia definisce la raccolta di elementi della sessione esposti al codice dell'applicazione HttpSessionStateContainer dalla classe.The ISessionStateItemCollection interface defines the collection of session items exposed to application code by the HttpSessionStateContainer class.

L'implementazione di ASP.NET dell' ISessionStateItemCollection interfaccia è la SessionStateItemCollection classe.The ASP.NET implementation of the ISessionStateItemCollection interface is the SessionStateItemCollection class.

Se si crea una classe derivata dalla SessionStateStoreProviderBase classe per archiviare i dati della sessione, è possibile usare la SessionStateItemCollection classe per gestire gli oggetti archiviati o implementare l' ISessionStateItemCollection interfaccia sul proprio gestore della raccolta.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.

Se si implementa l' ISessionStateItemCollection interfaccia, è necessario creare anche una classe che erediti la SessionStateStoreProviderBase classe per utilizzare ISessionStateItemCollection l'implementazione di per gestire le variabili di sessione.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.

Un' ISessionStateItemCollection implementazioneICollection di deve inoltre implementare i membri dell'interfaccia.An ISessionStateItemCollection implementation must also implement the members of the ICollection interface.

Proprietà

Count

Ottiene il numero di elementi contenuti in ICollection.Gets the number of elements contained in the ICollection.

(Ereditato da ICollection)
Dirty

Ottiene o imposta un valore che indica se l'insieme è stato contrassegnato come modificato.Gets or sets a value indicating whether the collection has been marked as changed.

IsSynchronized

Ottiene un valore che indica se l'accesso a ICollection è sincronizzato (thread-safe).Gets a value indicating whether access to the ICollection is synchronized (thread safe).

(Ereditato da ICollection)
Item[Int32]

Ottiene o imposta un valore nell'insieme in base all'indice numerico.Gets or sets a value in the collection by numerical index.

Item[String]

Ottiene o imposta un valore nell'insieme in base al nome.Gets or sets a value in the collection by name.

Keys

Ottiene un insieme dei nomi delle variabili per tutti i valori archiviati nell'insieme.Gets a collection of the variable names for all values stored in the collection.

SyncRoot

Ottiene un oggetto che può essere usato per sincronizzare l'accesso a ICollection.Gets an object that can be used to synchronize access to the ICollection.

(Ereditato da ICollection)

Metodi

Clear()

Rimuove tutti i valori e le chiavi dall'insieme dello stato sessione.Removes all values and keys from the session-state collection.

CopyTo(Array, Int32)

Copia gli elementi di ICollection in Array a partire da un particolare indice Array.Copies the elements of the ICollection to an Array, starting at a particular Array index.

(Ereditato da ICollection)
GetEnumerator()

Restituisce un enumeratore che consente di eseguire l'iterazione di una raccolta.Returns an enumerator that iterates through a collection.

(Ereditato da IEnumerable)
Remove(String)

Elimina un elemento dall'insieme.Deletes an item from the collection.

RemoveAt(Int32)

Elimina dall'insieme un elemento con un indice specifico.Deletes an item at a specified index from the collection.

Metodi di estensione

Cast<TResult>(IEnumerable)

Esegue il cast degli elementi di un oggetto IEnumerable nel tipo specificato.Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable)

Filtra gli elementi di un oggetto IEnumerable in base a un tipo specificato.Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable)

Consente la parallelizzazione di una query.Enables parallelization of a query.

AsQueryable(IEnumerable)

Converte un oggetto IEnumerable in un oggetto IQueryable.Converts an IEnumerable to an IQueryable.

Si applica a

Vedi anche