IChannel Interfaz

Definición

Espacio de nombres:

System.ServiceModel.Channels

Ensamblado:

System.ServiceModel.Primitives.dll

Ensamblado:

System.ServiceModel.dll

Define la interfaz básica que todos los objetos de canal deben implementar. Requiere que implementen la interfaz de equipo de estado compartida por todos los objetos de comunicación y que implementen un método para recuperar los objetos de la pila del canal.

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

Implementaciones

ICommunicationObject

Comentarios

Importante

Llamar a métodos de clases que implementen esta interfaz con datos que no son de confianza supone un riesgo de seguridad. Llame a métodos de clases que implementan esta interfaz solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.

Los canales deben satisfacer el contrato de un equipo de estado, tal y como lo define la interfaz ICommunicationObject.

La interfaz IChannel agrega:

GetProperty método a la ICommunicationObject interfaz . Este método proporciona un mecanismo para recuperar las propiedades de la pila del canal sin tener en cuenta en qué parte de la pila residen esas propiedades. El término "propiedad" en el nombre de método hace referencia a una información que pertenece a uno de los canales en la pila. T determina el tipo CLR para esa propiedad. Este método de recuperación también se utiliza en los generadores del canal y agentes de escucha del canal.

IChannel se hereda por cada una de las interfaces de canal asociadas a los patrones básicos de intercambio de mensajes:

• IInputChannel para recibir mensajes.

• IOutputChannel para enviar mensajes.

• IRequestChannel para enviar una solicitud.

• IReplyChannel para enviar una respuesta.

• IDuplexChannel para mensajería bidireccional.

Propiedades

State

Obtiene el estado actual del objeto orientado a la comunicación. (Heredado de ICommunicationObject)

Métodos

Abort()	Hace que un objeto de comunicación pase inmediatamente de su estado actual al estado cerrado. (Heredado de ICommunicationObject)
BeginClose(AsyncCallback, Object)	Comienza una operación asincrónica para cerrar un objeto de comunicación. (Heredado de ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)	Comienza una operación asincrónica para cerrar un objeto de comunicación con un tiempo de espera especificado. (Heredado de ICommunicationObject)
BeginOpen(AsyncCallback, Object)	Comienza una operación asincrónica para abrir un objeto de comunicación. (Heredado de ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)	Comienza una operación asincrónica para abrir un objeto de comunicación dentro de un intervalo de tiempo especificado. (Heredado de ICommunicationObject)
Close()	Provoca que un objeto de comunicación pase de su estado actual al estado cerrado. (Heredado de ICommunicationObject)
Close(TimeSpan)	Provoca que un objeto de comunicación pase de su estado actual al estado cerrado. (Heredado de ICommunicationObject)
EndClose(IAsyncResult)	Completa una operación asincrónica para cerrar un objeto de comunicación. (Heredado de ICommunicationObject)
EndOpen(IAsyncResult)	Completa una operación asincrónica para abrir un objeto de comunicación. (Heredado de ICommunicationObject)
GetProperty<T>()	Devuelve un objeto escrito solicitado de la capa adecuada en la pila del canal si está presente.
Open()	Hace que un objeto de comunicación pase del estado creado al estado abierto. (Heredado de ICommunicationObject)
Open(TimeSpan)	Hace que un objeto de comunicación pase del estado creado al estado abierto dentro de un intervalo de tiempo especificado. (Heredado de ICommunicationObject)

Eventos

Closed	Se produce cuando el objeto de comunicación completa su transición del estado de cierre al estado cerrado. (Heredado de ICommunicationObject)
Closing	Se produce cuando el objeto de comunicación introduce primero el estado de cierre. (Heredado de ICommunicationObject)
Faulted	Se produce cuando el objeto de comunicación introduce primero el estado de error. (Heredado de ICommunicationObject)
Opened	Se produce cuando el objeto de comunicación completa su transición del estado de apertura al estado abierto. (Heredado de ICommunicationObject)
Opening	Se produce cuando el objeto de comunicación introduce primero el estado de apertura. (Heredado de ICommunicationObject)