IChannel 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 básica que todos os objetos de canal devem implementar. Isso exige que eles implementem a interface do computador de estado compartilhada por todos os objetos de comunicação e que implementem um método para recuperar objetos da pilha de canal.
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- 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.
Os canais devem satisfazer o contrato de um computador de estado, conforme definido pela ICommunicationObject interface.
A IChannel interface adiciona o
GetProperty método para a ICommunicationObject interface. Esse método fornece um mecanismo para recuperar propriedades da pilha do canal, independentemente de onde essas propriedades residem na pilha. O termo "propriedade" no nome do método refere-se a uma informação que pertence a um dos canais na pilha. O tipo CLR para essa propriedade é determinado por T. Esse método de recuperação também é usado em fábricas de canais e ouvintes de canal.
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 para enviar uma solicitação.
IReplyChannel para enviar uma resposta.
IDuplexChannel para mensagens bidirecionais.
Propriedades
| Nome | Description |
|---|---|
| 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) |
| 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) |
| GetProperty<T>() |
Retorna um objeto digitado solicitado, se presente, da camada apropriada na pilha do canal. |
| 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) |
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) |
