RequestContext Classe
Definição
Fornece uma resposta correlacionada a uma solicitação de entrada.Provides a reply that is correlated to an incoming request.
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
Comentários
Você Obtém um contexto de solicitação de um IReplyChannel .You get a request context from an IReplyChannel. Cada RequestContext encapsula as informações necessárias para responder à solicitação, para que você não precise bloquear no canal ao aguardar que cada mensagem de solicitação receba uma resposta.Each RequestContext encapsulates the information required to reply to the request, so that you do not have to block on the channel when waiting for each request message to receive a reply.
No modelo de solicitação/resposta, o RequestContext objeto é o link entre a solicitação que chega e a resposta que sai. Quando o servidor recebe uma solicitação, ele fornece uma RequestContext instância que representa a solicitação ao canal.In the request/reply model, the RequestContext object is the link between the request that comes in and the reply that goes out. When the server receives a request, it provides a RequestContext instance that represents the request to the channel. O contexto da solicitação contém a mensagem de solicitação original entre outras propriedades úteis.The request context contains the original request message among other useful properties. Esse contexto de solicitação é então stash dentro do OperationContext para recuperação por seu serviço.This request context is then stashed inside the OperationContext for retrieval by your service. Normalmente, você usa a Current propriedade para acessar a solicitação da operação atual.You typically use the Current property to access the request of the current operation.
O valor de RequestContext pode ser null .The value of the RequestContext can be null. Como a função do contexto de solicitação é vincular solicitações a respostas, não faz sentido ter um contexto de solicitação quando você não tem uma resposta e, nesse caso, o contexto é definido como null .Because the role of the request context is to link requests to replies, it does not make sense to have a request context when you do not have a reply, and so in this case the context is set to null. Para uma operação unidirecional na parte superior do modelo de solicitação/resposta, o servidor recebe solicitações, mas não envia uma resposta para o cliente.For a one-way operation on top of the request/reply model, the server receives requests but does not send back a response to the client. Portanto, se o RequestContext for null inesperadamente, verifique primeiro se o contrato de operação é IsOneWay.So if the RequestContext is null unexpectedly, check first whether the operation contract is IsOneWay.
Observação especial para usuários gerenciados do C++ que derivam desta classe:Special note for Managed C++ users deriving from this class:
Coloque seu código de limpeza em (ativado) (início) fechar (e/ou OnAbort), não em um destruidor.Put your cleanup code in (On)(Begin)Close (and/or OnAbort), not in a destructor.
Evite destruidores: eles fazem com que o compilador gere automaticamente IDisposable .Avoid destructors: they cause the compiler to auto-generate IDisposable.
Evite membros de não referência: eles podem fazer com que o compilador gere automaticamente IDisposable .Avoid non-reference members: they can cause the compiler to auto-generate IDisposable.
Evitar finalizadores; Mas se você incluir um, deverá suprimir o aviso e a chamada de compilação SuppressFinalize(Object) e o próprio finalizador de (on) (Begin) Close (e/ou OnAbort) para emular o que teria sido o comportamento gerado automaticamente IDisposable .Avoid finalizers; but if you include one, you should suppress the build warning and call SuppressFinalize(Object) and the finalizer itself from (On)(Begin)Close (and/or OnAbort) to emulate what would have been the auto-generated IDisposable behavior.
Construtores
| RequestContext() |
Inicializa uma nova instância da classe RequestContext.Initializes a new instance of the RequestContext class. |
Propriedades
| RequestMessage |
Quando substituído em uma classe derivada, obtém a mensagem que contém a solicitação.When overridden in a derived class, gets the message that contains the request. |
Métodos
| Abort() |
Quando substituído em uma classe derivada, anula o processamento da solicitação associada ao contexto.When overridden in a derived class, aborts processing the request associated with the context. |
| BeginReply(Message, AsyncCallback, Object) |
Quando substituído em uma classe derivada, inicia uma operação assíncrona para responder à solicitação associada ao contexto atual.When overridden in a derived class, begins an asynchronous operation to reply to the request associated with the current context. |
| BeginReply(Message, TimeSpan, AsyncCallback, Object) |
Quando substituído em uma classe derivada, inicia uma operação assíncrona para responder à solicitação associada ao contexto atual em um intervalo de tempo especificado.When overridden in a derived class, begins an asynchronous operation to reply to the request associated with the current context within a specified interval of time. |
| Close() |
Quando substituído em uma classe derivada, fecha a operação que se está respondendo ao contexto de solicitação associado ao contexto atual.When overridden in a derived class, closes the operation that is replying to the request context associated with the current context. |
| Close(TimeSpan) |
Quando substituído em uma classe derivada, fecha a operação que está respondendo ao contexto de solicitação associado ao contexto atual em um intervalo de tempo especificado.When overridden in a derived class, closes the operation that is replying to the request context associated with the current context within a specified interval of time. |
| Dispose(Boolean) |
Libera os recursos associados ao contexto.Releases resources associated with the context. |
| EndReply(IAsyncResult) |
Quando substituído em uma classe derivada, conclui uma operação assíncrona para responder a uma mensagem de solicitação.When overridden in a derived class, completes an asynchronous operation to reply to a request message. |
| Equals(Object) |
Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object. (Herdado de Object) |
| GetHashCode() |
Serve como a função de hash padrão.Serves as the default hash function. (Herdado de Object) |
| GetType() |
Obtém o Type da instância atual.Gets the Type of the current instance. (Herdado de Object) |
| MemberwiseClone() |
Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object. (Herdado de Object) |
| Reply(Message) |
Quando substituído em uma classe derivada, responde a uma mensagem de solicitação.When overridden in a derived class, replies to a request message. |
| Reply(Message, TimeSpan) |
Quando substituído em uma classe derivada, responde a uma mensagem de solicitação dentro de um intervalo de tempo especificado.When overridden in a derived class, replies to a request message within a specified interval of time. |
| ToString() |
Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object. (Herdado de Object) |
Implantações explícitas de interface
| IDisposable.Dispose() |
Libera os recursos gerenciados e não gerenciados associados ao contexto.Releases both managed and unmanaged resources associated with the context. |