ISessionStateItemCollection インターフェイス

定義

セッションを管理するためにセッション状態 ASP.NET 使用されるコレクションのコントラクトを定義します。

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
派生
実装

次のコード例では、 ISessionStateItemCollection を実装し、 SortedList クラスを使用してセッション状態の変数名と値を格納します。

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

注釈

ISessionStateItemCollection インターフェイスは、HttpSessionStateContainer クラスによってアプリケーション コードに公開されるセッション項目のコレクションを定義します。

ISessionStateItemCollection インターフェイスの ASP.NET 実装は、SessionStateItemCollection クラスです。

SessionStateStoreProviderBase クラスから派生したクラスを作成してセッション データを格納する場合は、SessionStateItemCollection クラスを使用して格納されているオブジェクトを管理するか、独自のコレクション マネージャーに ISessionStateItemCollection インターフェイスを実装できます。

ISessionStateItemCollection インターフェイスを実装する場合は、SessionStateStoreProviderBaseの実装を使用してセッション変数を管理するために、ISessionStateItemCollection クラスを継承するクラスも作成する必要があります。

ISessionStateItemCollection実装では、ICollection インターフェイスのメンバーも実装する必要があります。

プロパティ

名前 説明
Count

ICollectionに含まれる要素の数を取得します。

(継承元 ICollection)
Dirty

コレクションが変更済みとしてマークされているかどうかを示す値を取得または設定します。

IsSynchronized

ICollectionへのアクセスが同期されているかどうかを示す値を取得します (スレッド セーフ)。

(継承元 ICollection)
Item[Int32]

数値インデックスを使用してコレクション内の値を取得または設定します。

Item[String]

コレクション内の値を名前で取得または設定します。

Keys

コレクションに格納されているすべての値の変数名のコレクションを取得します。

SyncRoot

ICollectionへのアクセスを同期するために使用できるオブジェクトを取得します。

(継承元 ICollection)

メソッド

名前 説明
Clear()

セッション状態コレクションからすべての値とキーを削除します。

CopyTo(Array, Int32)

特定のICollectionインデックスから始まるArrayの要素をArrayにコピーします。

(継承元 ICollection)
GetEnumerator()

コレクションを反復処理する列挙子を返します。

(継承元 IEnumerable)
Remove(String)

コレクションから項目を削除します。

RemoveAt(Int32)

指定したインデックス位置にある項目をコレクションから削除します。

拡張メソッド

名前 説明
AsParallel(IEnumerable)

クエリの並列化を有効にします。

AsQueryable(IEnumerable)

IEnumerableIQueryableに変換します。

Cast<TResult>(IEnumerable)

IEnumerable の要素を指定した型にキャストします。

OfType<TResult>(IEnumerable)

指定した型に基づいて、IEnumerable の要素をフィルター処理します。

適用対象

こちらもご覧ください