RequestContext Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece uma resposta correlacionada com um pedido recebido.
public ref class RequestContext abstract : IDisposable
public abstract class RequestContext : IDisposable
type RequestContext = class
interface IDisposable
Public MustInherit Class RequestContext
Implements IDisposable
- Herança
-
RequestContext
- Implementações
Observações
Obtém-se um contexto de pedido a partir de um IReplyChannel. Cada um RequestContext encapsula a informação necessária para responder ao pedido, para que não tenha de bloquear no canal ao esperar que cada mensagem de pedido receba uma resposta.
No modelo de pedido/resposta, o RequestContext objeto é a ligação entre o pedido que chega e a resposta que é enviada. Quando o servidor recebe um pedido, fornece uma RequestContext instância que representa o pedido ao canal. O contexto do pedido contém a mensagem original do pedido, entre outras propriedades úteis. Este contexto de pedido é depois guardado para OperationContext recuperação pelo seu serviço. Normalmente, usa a Current propriedade para aceder ao pedido da operação atual.
O valor do RequestContext pode ser null. Como o papel do contexto de pedido é ligar pedidos a respostas, não faz sentido ter um contexto de pedido quando não se tem resposta, e neste caso o contexto é definido para null. Para uma operação unidirecional sobre o modelo de pedido/resposta, o servidor recebe pedidos mas não envia resposta ao cliente. Portanto, se for RequestContextnull inesperadamente, verifique primeiro se o contrato de operação é IsOneWay.
Nota especial para utilizadores de C++ gerido derivados desta classe:
- Coloca o teu código de limpeza em (On)(Begin)Close (e/ou OnAbort), não num destrutor.
- Evite destruidores: eles fazem com que o compilador gere IDisposableautomaticamente .
- Evite membros que não sejam de referência: podem fazer com que o compilador gere IDisposableautomaticamente .
- Evite finalizadores; mas se incluir um, deve suprimir o aviso de compilação e a chamada SuppressFinalize(Object) e o próprio finalizador de (On)(Begin)Close (e/ou OnAbort) para emular o que teria sido o comportamento gerado IDisposable automaticamente.
Construtores
| Name | Description |
|---|---|
| RequestContext() |
Inicializa uma nova instância da RequestContext classe. |
Propriedades
| Name | Description |
|---|---|
| RequestMessage |
Quando é sobreposto numa classe derivada, recebe a mensagem que contém o pedido. |
Métodos
| Name | Description |
|---|---|
| Abort() |
Quando é sobreposto numa classe derivada, aborta o processamento do pedido associado ao contexto. |
| BeginReply(Message, AsyncCallback, Object) |
Quando sobrescrito numa classe derivada, inicia-se uma operação assíncrona para responder ao pedido associado ao contexto atual. |
| BeginReply(Message, TimeSpan, AsyncCallback, Object) |
Quando sobreposto numa classe derivada, inicia-se uma operação assíncrona para responder ao pedido associado ao contexto atual dentro de um intervalo de tempo especificado. |
| Close() |
Quando sobrescrito numa classe derivada, fecha a operação que está a responder ao contexto de pedido associado ao contexto atual. |
| Close(TimeSpan) |
Quando é sobreposto numa classe derivada, fecha a operação que responde ao contexto de pedido associado ao contexto atual dentro de um intervalo de tempo especificado. |
| Dispose(Boolean) |
Liberta recursos associados ao contexto. |
| EndReply(IAsyncResult) |
Quando é sobreposto numa classe derivada, completa uma operação assíncrona para responder a uma mensagem de pedido. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object) |
| GetHashCode() |
Serve como função de hash predefinida. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do atual Object. (Herdado de Object) |
| Reply(Message, TimeSpan) |
Quando sobreposta numa classe derivada, responde a uma mensagem de pedido dentro de um intervalo de tempo especificado. |
| Reply(Message) |
Quando é sobreposto numa classe derivada, responde a uma mensagem de pedido. |
| ToString() |
Devolve uma cadeia que representa o objeto atual. (Herdado de Object) |
Implementações de Interface Explícita
| Name | Description |
|---|---|
| IDisposable.Dispose() |
Liberta recursos geridos e não geridos associados ao contexto. |