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. É necessário que eles implementem a interface de máquina de estado compartilhada 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
Comentários
Importante
Chamar métodos de classes que implementam esta interface quando você tiver dados não confiáveis é um risco à segurança. Chame os métodos de classes que implementam essa interface somente quando você tiver dados confiáveis. Para obter mais informações, consulte Validar todas as entradas.
Os canais devem atender ao 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 de canais, 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
| State |
Obtém o estado atual do objeto voltado à comunicação. (Herdado de ICommunicationObject) |
Métodos
| Abort() |
Faz com que um objeto de comunicação faça a transição imediata do 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 do 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 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 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 em um intervalo de tempo especificado. (Herdado de ICommunicationObject) |
Eventos
| 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 um objeto de comunicação entra em estado de fechamento primeiro. (Herdado de ICommunicationObject) |
| Faulted |
Ocorre quando um objeto de comunicação entra em estado de falha primeiro. (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 um objeto de comunicação entra em estado de abertura primeiro. (Herdado de ICommunicationObject) |
