IChannel Interface

Definição

Namespace:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

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::ICommunicationObject

public interface IChannel : System.ServiceModel.ICommunicationObject

type IChannel = interface
    interface ICommunicationObject

Public Interface IChannel
Implements ICommunicationObject

Derivado

System.ServiceModel.Channels.ChannelBase

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputChannel

System.ServiceModel.Channels.IInputSessionChannel

System.ServiceModel.Channels.IOutputChannel

System.ServiceModel.Channels.IOutputSessionChannel

System.ServiceModel.Channels.IReplyChannel

System.ServiceModel.Channels.IReplySessionChannel

System.ServiceModel.Channels.IRequestChannel

System.ServiceModel.Channels.IRequestSessionChannel

System.ServiceModel.ClientBase<TChannel>.ChannelBase<T>

System.ServiceModel.IClientChannel

System.ServiceModel.IContextChannel

System.ServiceModel.IDuplexContextChannel

System.ServiceModel.IServiceChannel

System.ServiceModel.Security.WSTrustChannel

Implementações

ICommunicationObject

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)