IChannel Interfaz
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Define la interfaz básica que deben implementar todos los objetos de canal. Requiere que implementen la interfaz de máquina de estado compartida por todos los objetos de comunicación y que implementen un método para recuperar objetos de la pila del canal.
public interface class IChannel : System::ServiceModel::ICommunicationObjectpublic interface IChannel : System.ServiceModel.ICommunicationObjecttype IChannel = interface
interface ICommunicationObjectPublic Interface IChannel
Implements ICommunicationObject- Derivado
- Implementaciones
Comentarios
Importante
Llamar a métodos de clases que implementan esta interfaz con datos que no son de confianza es un riesgo de seguridad. Llame a los métodos de las clases que implementan esta interfaz solo con datos de confianza. Para obtener más información, vea Validar todas las entradas.
Los canales deben cumplir el contrato de una máquina de estado tal como se define en la ICommunicationObject interfaz.
La IChannel interfaz agrega el
GetProperty método a la ICommunicationObject interfaz . Este método proporciona un mecanismo para recuperar propiedades de la pila de canales, independientemente de dónde se encuentran en la pila esas propiedades. El término "property" del nombre del método hace referencia a un fragmento de información que pertenece a uno de los canales de la pila. El tipo CLR de esa propiedad viene determinado por T. Este método de recuperación también se usa en generadores de canales y agentes de escucha de canales.
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
| Nombre | Description |
|---|---|
| State |
Obtiene el estado actual del objeto orientado a la comunicación. (Heredado de ICommunicationObject) |
Métodos
| Nombre | Description |
|---|---|
| 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() |
Hace que un objeto de comunicación pase de su estado actual al estado cerrado. (Heredado de ICommunicationObject) |
| Close(TimeSpan) |
Hace 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 con tipo solicitado, si está presente, de la capa adecuada en la pila de canales. |
| 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
| Nombre | Description |
|---|---|
| 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 entra primero en el estado de cierre. (Heredado de ICommunicationObject) |
| Faulted |
Se produce cuando el objeto de comunicación entra primero en el estado con errores. (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 entra primero en el estado de apertura. (Heredado de ICommunicationObject) |
