IChannel 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 básica que todos os objetos do canal devem implementar. Requer que implementem a interface da máquina de estados partilhada por todos os objetos de comunicação e que implementem um método para recuperar objetos da pilha de canais.
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- 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.
Os canais devem satisfazer o contrato de uma máquina de estados tal como definido pela ICommunicationObject interface.
A IChannel interface adiciona o
GetProperty método para a ICommunicationObject interface. Este método fornece um mecanismo para recuperar propriedades da pilha de canal, independentemente de onde essas propriedades estejam presentes na pilha. O termo "propriedade" no nome do método refere-se a uma informação que pertence a um dos canais da pilha. O tipo CLR para essa propriedade é determinado por T. Este método de recuperação é também utilizado em fábricas de canais e ouvintes de canais.
IChannel é herdado por cada uma das interfaces de canal associadas aos padrões básicos de troca de mensagens:
IInputChannel para receber mensagens.
IOutputChannel para enviar mensagens.
IRequestChannel por enviar um pedido.
IReplyChannel por enviar uma resposta.
IDuplexChannel para mensagens bidirecionais.
Propriedades
| Name | Description |
|---|---|
| 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) |
| 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) |
| GetProperty<T>() |
Devolve um objeto tipado solicitado, se presente, da camada apropriada na pilha de canais. |
| 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) |
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) |