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 .
Реализация ASP.NET интерфейса ISessionStateItemCollection является классом 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) |
Копирует элементы объекта ICollectionArrayв определенный индекс, начиная с определенного Array индекса. (Унаследовано от ICollection) |
| GetEnumerator() |
Возвращает перечислитель, который выполняет итерацию по коллекции. (Унаследовано от IEnumerable) |
| Remove(String) |
Удаляет элемент из коллекции. |
| RemoveAt(Int32) |
Удаляет элемент по указанному индексу из коллекции. |
Методы расширения
| Имя | Описание |
|---|---|
| AsParallel(IEnumerable) |
Включает параллелизацию запроса. |
| AsQueryable(IEnumerable) |
Преобразует IEnumerable в IQueryable. |
| Cast<TResult>(IEnumerable) |
Приведение элементов IEnumerable к указанному типу. |
| OfType<TResult>(IEnumerable) |
Фильтрует элементы IEnumerable на основе указанного типа. |