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