SessionStateItemCollection Classe

Definição

Namespace:

System.Web.SessionState

Assembly:

System.Web.dll

Uma coleção de objetos armazenados no estado de sessão. Essa classe não pode ser herdada.

public ref class SessionStateItemCollection sealed : System::Collections::Specialized::NameObjectCollectionBase, System::Collections::ICollection, System::Web::SessionState::ISessionStateItemCollection

public sealed class SessionStateItemCollection : System.Collections.Specialized.NameObjectCollectionBase, System.Collections.ICollection, System.Web.SessionState.ISessionStateItemCollection

type SessionStateItemCollection = class
    inherit NameObjectCollectionBase
    interface ISessionStateItemCollection
    interface ICollection
    interface IEnumerable

Public NotInheritable Class SessionStateItemCollection
Inherits NameObjectCollectionBase
Implements ICollection, ISessionStateItemCollection

Herança

Object

NameObjectCollectionBase

SessionStateItemCollection

Implementações

ICollection IEnumerable ISessionStateItemCollection

Exemplos

O exemplo de código a seguir cria um novo SessionStateItemCollection objeto e define e obtém valores na coleção por nome.

SessionStateItemCollection items = new SessionStateItemCollection();

items["LastName"] = "Wilson";
items["FirstName"] = "Dan";

foreach (string s in items.Keys)
  Response.Write("items[\"" + s + "\"] = " + items[s].ToString() + "<br />");

Dim items As SessionStateItemCollection = New SessionStateItemCollection()

items("LastName") = "Wilson"
items("FirstName") = "Dan"

For Each s As String In items.Keys
  Response.Write("items(""" & s & """) = " & items(s).ToString() & "<br />")
Next

Comentários

A SessionStateItemCollection classe é usada para gerenciar valores de variável de estado de sessão indexados por um nome de variável ou por índice numérico. As variáveis de estado de sessão são expostas a ASP.NET código do aplicativo usando a HttpSessionState classe , que é acessada usando a Session propriedade do atual HttpContext ou do Page. A HttpSessionState classe chama a HttpSessionStateContainer classe , que gerencia valores de variável de estado de sessão usando o SessionStateItemCollection.

Notas aos Herdeiros

Ao criar um provedor de estado de sessão personalizado com base na SessionStateStoreProviderBase classe , use a SessionStateItemCollection classe para gerenciar os itens armazenados no estado de sessão. Se você precisar criar um objeto personalizado para gerenciar itens de estado de sessão, implemente a ISessionStateItemCollection interface .

Construtores

SessionStateItemCollection()

Cria um novo objeto SessionStateItemCollection vazio.

Propriedades

Count	Obtém o número de pares chave-valor contidos na instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
Dirty	Obtém ou define um valor que indica se a coleção foi marcada como alterada.
IsReadOnly	Obtém ou define um valor que indica se a instância de NameObjectCollectionBase é somente leitura. (Herdado de NameObjectCollectionBase)
Item[Int32]	Obtém ou define um valor na coleção por índice numérico.
Item[String]	Obtém ou define um valor na coleção por nome.
Keys	Obtém uma coleção de nomes de variável para todos os valores armazenados na coleção.

Métodos

BaseAdd(String, Object)	Adiciona uma entrada com a chave e o valor especificados à instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseClear()	Remove todas as entradas da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGet(Int32)	Obtém o valor da entrada no índice especificado da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGet(String)	Obtém o valor da primeira entrada com a chave especificada da instância de NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGetAllKeys()	Retorna uma matriz String que contém todas as chaves na instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGetAllValues()	Retorna uma matriz Object que contém todos os valores na instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGetAllValues(Type)	Retorna uma matriz do tipo especificado que contém todos os valores na instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseGetKey(Int32)	Obtém a chave da entrada no índice especificado da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseHasKeys()	Obtém um valor que indica se a instância NameObjectCollectionBase contém entradas cujas chaves não são null. (Herdado de NameObjectCollectionBase)
BaseRemove(String)	Remove as entradas com a chave especificada da instância de NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseRemoveAt(Int32)	Remove a entrada no índice especificado da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseSet(Int32, Object)	Define o valor da entrada no índice especificado da instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
BaseSet(String, Object)	Define o valor da primeira entrada com a chave especificada na instância NameObjectCollectionBase, se encontrada; caso contrário, adiciona uma entrada com a chave especificada e o valor para a instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
Clear()	Remove todas as chaves e os valores da coleção de estado da sessão.
Deserialize(BinaryReader)	Cria uma coleção de SessionStateItemCollection de um local de armazenamento gravado usando o método Serialize(BinaryWriter).
Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetEnumerator()	Retorna um enumerador que pode ser usado para ler todos os nomes de chave na coleção.
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetObjectData(SerializationInfo, StreamingContext)	Implementa a interface ISerializable e retorna os dados necessários para serializar a instância NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
OnDeserialization(Object)	Implementa a interface ISerializable e gera o evento de desserialização quando a desserialização for concluída. (Herdado de NameObjectCollectionBase)
Remove(String)	Exclui um item da coleção.
RemoveAt(Int32)	Exclui um item em um índice especificado da coleção.
Serialize(BinaryWriter)	Grava o conteúdo da coleção para um BinaryWriter.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Implantações explícitas de interface

ICollection.CopyTo(Array, Int32)	Copia todo o NameObjectCollectionBase em um Array unidimensional compatível, começando no índice especificado da matriz de destino. (Herdado de NameObjectCollectionBase)
ICollection.IsSynchronized	Obtém um valor que indica se o acesso ao objeto NameObjectCollectionBase é sincronizado (thread-safe). (Herdado de NameObjectCollectionBase)
ICollection.SyncRoot	Obtém um objeto que pode ser usado para sincronizar o acesso ao objeto NameObjectCollectionBase. (Herdado de NameObjectCollectionBase)

Métodos de Extensão

Cast<TResult>(IEnumerable)	Converte os elementos de um IEnumerable para o tipo especificado.
OfType<TResult>(IEnumerable)	Filtra os elementos de um IEnumerable com base em um tipo especificado.
AsParallel(IEnumerable)	Habilita a paralelização de uma consulta.
AsQueryable(IEnumerable)	Converte um IEnumerable em um IQueryable.

Confira também

• Visão geral do estado de sessão do ASP.NET