SessionStateStoreProviderBase.GetItemExclusive Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Retorna dados de estado de sessão somente leitura do armazenamento de dados da sessão.
public:
abstract System::Web::SessionState::SessionStateStoreData ^ GetItemExclusive(System::Web::HttpContext ^ context, System::String ^ id, [Runtime::InteropServices::Out] bool % locked, [Runtime::InteropServices::Out] TimeSpan % lockAge, [Runtime::InteropServices::Out] System::Object ^ % lockId, [Runtime::InteropServices::Out] System::Web::SessionState::SessionStateActions % actions);public abstract System.Web.SessionState.SessionStateStoreData GetItemExclusive(System.Web.HttpContext context, string id, out bool locked, out TimeSpan lockAge, out object lockId, out System.Web.SessionState.SessionStateActions actions);abstract member GetItemExclusive : System.Web.HttpContext * string * bool * TimeSpan * obj * SessionStateActions -> System.Web.SessionState.SessionStateStoreDataPublic MustOverride Function GetItemExclusive (context As HttpContext, id As String, ByRef locked As Boolean, ByRef lockAge As TimeSpan, ByRef lockId As Object, ByRef actions As SessionStateActions) As SessionStateStoreDataParâmetros
- context
- HttpContext
A HttpContext solicitação atual.
- locked
- Boolean
Quando esse método é retornado, contém um valor booliano definido como true se um bloqueio for obtido com êxito; caso contrário, false.
- lockAge
- TimeSpan
Quando esse método é retornado, contém um TimeSpan objeto que é definido como a quantidade de tempo que um item no armazenamento de dados de sessão foi bloqueado.
- lockId
- Object
Quando esse método é retornado, contém um objeto que é definido como o identificador de bloqueio da solicitação atual. Para obter detalhes sobre o identificador de bloqueio, consulte "Bloqueio de dados Session-Store" no resumo da SessionStateStoreProviderBase classe.
- actions
- SessionStateActions
Quando esse método é retornado, contém um dos SessionStateActions valores, indicando se a sessão atual é uma sessão sem cookie não inicializada.
Retornos
Um SessionStateStoreData preenchido com valores de sessão e informações do armazenamento de dados da sessão.
Exemplos
Para obter um exemplo de implementação de provedor de repositório de estado de sessão, consulte Implementando um provedor de repositório de Session-State.
Comentários
O SessionStateModule objeto chama o GetItemExclusive método no início de uma solicitação, durante o AcquireRequestState evento, quando o EnableSessionState atributo é definido como true, que é o padrão. Se o EnableSessionState atributo for definido como ReadOnly, o SessionStateModule objeto chamará o GetItem método.
O GetItemExclusive método retorna um SessionStateStoreData objeto preenchido com informações de sessão do armazenamento de dados, atualiza a data de validade dos dados armazenados e bloqueia os dados do item de sessão no armazenamento de dados durante a solicitação. Se nenhum dado de item de sessão for encontrado no armazenamento de dados, o GetItemExclusive método definirá o lockedout parâmetro false como e retornará null. Isso faz com que o SessionStateModule objeto chame o CreateNewStoreData método para criar um novo item de sessão no armazenamento de dados. Se os dados do item de sessão forem encontrados no armazenamento de dados, mas os dados estiverem bloqueados, o GetItemExclusive método definirá o lockedout parâmetro como true, define o lockAgeout parâmetro como a data e hora atuais menos a data e a hora em que o item foi bloqueado (que é recuperado do armazenamento de dados), define o lockIdout parâmetro como o identificador de bloqueio recuperado do armazenamento de dados, e retorna null. Isso faz com que o SessionStateModule objeto chame o GetItemExclusive método novamente após um intervalo de meio segundo para tentar recuperar as informações do item de sessão e obter um bloqueio nos dados. Se o valor definido para o lockAgeout parâmetro exceder o ExecutionTimeout valor, o SessionStateModule método chamará o ReleaseItemExclusive método para limpar o bloqueio nos dados do item de sessão e, em seguida, chamará o GetItemExclusive método novamente.
O actionFlags parâmetro é usado quando os atributos e regenerateExpiredSessionId os cookieless dois são definidos como true. Um actionFlags valor definido para InitializeItem indicar que a entrada no armazenamento de dados de sessão é uma nova sessão que requer inicialização. Entradas não inicializadas no armazenamento de dados de sessão são criadas por uma chamada para o CreateUninitializedItem método. Se o item do armazenamento de dados de sessão não for um item não inicializado, o actionFlags parâmetro será definido como zero.
Os implementadores personalizados do repositório de estado de sessão que dão suporte a sessões sem cookie devem definir o actionFlagsout parâmetro como o valor retornado do armazenamento de dados de sessão para o item atual. Se o valor do actionFlags parâmetro para o item de repositório de sessão solicitado for igual ao InitializeItem valor de enumeração, o GetItemExclusive método deverá definir o valor no armazenamento de dados como zero depois de definir o actionFlagsout parâmetro.