IInputChannel Interface
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.
Define a interface que um canal deve implementar para receber uma mensagem.
public interface class IInputChannel : System::ServiceModel::Channels::IChannelpublic interface IInputChannel : System.ServiceModel.Channels.IChanneltype IInputChannel = interface
interface IChannel
interface ICommunicationObjectPublic Interface IInputChannel
Implements IChannel- Derivado
- Implementações
Comentários
Importante
Chamar métodos de classes que implementam essa interface com dados não confiáveis é um risco de segurança. Chame os métodos de classes que implementam essa interface apenas com dados confiáveis. Para obter mais informações, consulte Validar Todas as Entradas.
O IInputChannel contrato inclui variantes síncronas e assíncronas de recebimento, funcionalidade try-to-receive e wait-for-a-message.
O modelo de pull normalmente é usado com uma IInputChannel mensagem para receber: você chama Receive (para "efetuar pull" de uma mensagem para fora do canal) e aguarda uma mensagem chegar. Um padrão de uso alternativo é chamar BeginWaitForMessage(TimeSpan, AsyncCallback, Object) ou BeginWaitForMessage(TimeSpan, AsyncCallback, Object), em seguida, chamar Receive(TimeSpan). Essa abordagem é comum para usos transacionais em que você inicia a transação entre as chamadas para WaitForMessage(TimeSpan) .Receive
Um IInputChannel não está necessariamente associado a um único remetente. Outros canais e interfaces de canal podem fornecer uma correlação entre remetentes específicos e um IInputChannel, mas o contrato base não faz essa restrição. Uma implementação pode criar uma nova IInputChannel para cada mensagem ou reutilizar a mesma IInputChannel para várias mensagens e remetentes.
Propriedades
| Nome | Description |
|---|---|
| LocalAddress |
Obtém o endereço no qual o canal de entrada recebe mensagens. |
| State |
Obtém o estado atual do objeto orientado à comunicação. (Herdado de ICommunicationObject) |
Métodos
| Nome | Description |
|---|---|
| Abort() |
Faz com que um objeto de comunicação faça a transição imediatamente de seu estado atual para o estado fechado. (Herdado de ICommunicationObject) |
| BeginClose(AsyncCallback, Object) |
Inicia uma operação assíncrona para fechar um objeto de comunicação. (Herdado de ICommunicationObject) |
| BeginClose(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona para fechar um objeto de comunicação com um tempo limite especificado. (Herdado de ICommunicationObject) |
| BeginOpen(AsyncCallback, Object) |
Inicia uma operação assíncrona para abrir um objeto de comunicação. (Herdado de ICommunicationObject) |
| BeginOpen(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona para abrir um objeto de comunicação dentro de um intervalo de tempo especificado. (Herdado de ICommunicationObject) |
| BeginReceive(AsyncCallback, Object) |
Inicia uma operação assíncrona para receber uma mensagem que tem um objeto de estado associado a ela. |
| BeginReceive(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona para receber uma mensagem que tem um tempo limite especificado e um objeto de estado associado a ela. |
| BeginTryReceive(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona para receber uma mensagem que tem um tempo limite especificado e um objeto de estado associado a ela. |
| BeginWaitForMessage(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona de espera para uma mensagem de chegada que tem um tempo limite especificado e um objeto de estado associado a ele. |
| Close() |
Faz com que um objeto de comunicação faça a transição de seu estado atual para o estado fechado. (Herdado de ICommunicationObject) |
| Close(TimeSpan) |
Faz com que um objeto de comunicação faça a transição de seu estado atual para o estado fechado. (Herdado de ICommunicationObject) |
| EndClose(IAsyncResult) |
Conclui uma operação assíncrona para fechar um objeto de comunicação. (Herdado de ICommunicationObject) |
| EndOpen(IAsyncResult) |
Conclui uma operação assíncrona para abrir um objeto de comunicação. (Herdado de ICommunicationObject) |
| EndReceive(IAsyncResult) |
Conclui uma operação assíncrona para receber uma mensagem. |
| EndTryReceive(IAsyncResult, Message) |
Conclui a operação assíncrona especificada para receber uma mensagem. |
| EndWaitForMessage(IAsyncResult) |
Conclui a operação assíncrona de espera por mensagem especificada. |
| GetProperty<T>() |
Retorna um objeto digitado solicitado, se presente, da camada apropriada na pilha do canal. (Herdado de IChannel) |
| Open() |
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto. (Herdado de ICommunicationObject) |
| Open(TimeSpan) |
Faz com que um objeto de comunicação faça a transição do estado criado para o estado aberto dentro de um intervalo de tempo especificado. (Herdado de ICommunicationObject) |
| Receive() |
Retorna a mensagem recebida, se houver uma disponível. Se uma mensagem não estiver disponível, bloqueará um intervalo de tempo padrão. |
| Receive(TimeSpan) |
Retorna a mensagem recebida, se houver uma disponível. Se uma mensagem não estiver disponível, bloqueará um intervalo de tempo especificado. |
| TryReceive(TimeSpan, Message) |
Tenta receber uma mensagem dentro de um intervalo de tempo especificado. |
| WaitForMessage(TimeSpan) |
Retorna um valor que indica se uma mensagem chegou dentro de um intervalo de tempo especificado. |
Eventos
| Nome | Description |
|---|---|
| Closed |
Ocorre quando o objeto de comunicação conclui sua transição do estado de fechamento para o estado fechado. (Herdado de ICommunicationObject) |
| Closing |
Ocorre quando o objeto de comunicação entra pela primeira vez no estado de fechamento. (Herdado de ICommunicationObject) |
| Faulted |
Ocorre quando o objeto de comunicação entra pela primeira vez no estado com falha. (Herdado de ICommunicationObject) |
| Opened |
Ocorre quando o objeto de comunicação conclui sua transição do estado de abertura para o estado aberto. (Herdado de ICommunicationObject) |
| Opening |
Ocorre quando o objeto de comunicação entra pela primeira vez no estado de abertura. (Herdado de ICommunicationObject) |
