IInputChannel Interface
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.
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
Observações
Importante
Chamar métodos de classes que implementam esta interface com dados não confiáveis é um risco de segurança. Chame os métodos das classes que implementam esta interface apenas com dados confiáveis. Para obter mais informações, consulte Validar todas as informações inseridas.
O IInputChannel contrato inclui variantes síncronas e assíncronas de funcionalidades de receção, tentativa de receber e espera por uma mensagem.
O modelo de pull é normalmente usado com um IInputChannel para receber mensagens: liga-se Receive (para "puxar" uma mensagem para fora do canal) e depois espera que uma mensagem chegue. Um padrão de uso alternativo é chamar BeginWaitForMessage(TimeSpan, AsyncCallback, Object) ou BeginWaitForMessage(TimeSpan, AsyncCallback, Object), e depois chamar Receive(TimeSpan). Esta abordagem é comum em usos transacionais onde se inicia a transação entre as chamadas para WaitForMessage(TimeSpan) e Receive.
An IInputChannel não está necessariamente vinculado a um único remetente. Outros canais e interfaces de canal podem fornecer uma correlação entre emissores particulares e um IInputChannel, mas o contrato base não impõe tal restrição. Uma implementação pode criar uma nova IInputChannel para cada mensagem ou reutilizá-la IInputChannel para múltiplas mensagens e remetentes.
Propriedades
| Name | Description |
|---|---|
| LocalAddress |
Obtém o endereço onde o canal de entrada recebe as mensagens. |
| State |
Obtém o estado atual do objeto orientado à comunicação. (Herdado de ICommunicationObject) |
Métodos
| Name | Description |
|---|---|
| Abort() |
Faz com que um objeto de comunicação transite imediatamente do 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 timeout 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 tenha um objeto de estado associado. |
| BeginReceive(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona para receber uma mensagem que tenha um time out e um objeto de estado especificados associados. |
| BeginTryReceive(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona para receber uma mensagem que tenha um time out e um objeto de estado especificados associados. |
| BeginWaitForMessage(TimeSpan, AsyncCallback, Object) |
Inicia uma operação assíncrona de espera por uma mensagem chegar, que tem um tempo de expiração e um objeto de estado especificados associados. |
| Close() |
Faz com que um objeto de comunicação faça a transição do 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 do seu estado atual para o estado fechado. (Herdado de ICommunicationObject) |
| EndClose(IAsyncResult) |
Completa uma operação assíncrona para fechar um objeto de comunicação. (Herdado de ICommunicationObject) |
| EndOpen(IAsyncResult) |
Completa uma operação assíncrona para abrir um objeto de comunicação. (Herdado de ICommunicationObject) |
| EndReceive(IAsyncResult) |
Completa uma operação assíncrona para receber uma mensagem. |
| EndTryReceive(IAsyncResult, Message) |
Completa a operação assíncrona especificada para receber uma mensagem. |
| EndWaitForMessage(IAsyncResult) |
Conclui a operação assíncrona de espera por uma mensagem especificada. |
| GetProperty<T>() |
Devolve um objeto tipado solicitado, se presente, da camada apropriada na pilha de canais. (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() |
Devolve a mensagem recebida, caso exista disponível. Se uma mensagem não estiver disponível, bloqueia-a por um intervalo de tempo predefinido. |
| Receive(TimeSpan) |
Devolve a mensagem recebida, caso exista disponível. Se uma mensagem não estiver disponível, bloqueia-se durante um intervalo de tempo especificado. |
| TryReceive(TimeSpan, Message) |
Tenta receber uma mensagem dentro de um intervalo de tempo especificado. |
| WaitForMessage(TimeSpan) |
Devolve um valor que indica se uma mensagem chegou dentro de um intervalo de tempo especificado. |
evento
| Name | Description |
|---|---|
| Closed |
Ocorre quando o objeto de comunicação completa a sua transição do estado de fecho para o estado fechado. (Herdado de ICommunicationObject) |
| Closing |
Ocorre quando o objeto de comunicação entra pela primeira vez no estado de fecho. (Herdado de ICommunicationObject) |
| Faulted |
Ocorre quando o objeto de comunicação entra pela primeira vez no estado de falha. (Herdado de ICommunicationObject) |
| Opened |
Ocorre quando o objeto de comunicação completa a 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) |
