IInputChannel 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 que un canal debe implementar para recibir un mensaje.
public interface class IInputChannel : System::ServiceModel::Channels::IChannelpublic interface IInputChannel : System.ServiceModel.Channels.IChanneltype IInputChannel = interface
interface IChannel
interface ICommunicationObjectPublic Interface IInputChannel
Implements IChannel- 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.
El contrato IInputChannel incluye variantes sincrónicas y asincrónicas de la funcionalidad de recepción, de intento de recepción y de espera por un mensaje.
El modelo de incorporación de cambios se utiliza normalmente con IInputChannel para recibir los mensajes: llama a Receive (para "incorporar cambios" en un mensaje del canal) y, a continuación, espera a que llegue un mensaje. Un modelo del uso alternativo es llamar a BeginWaitForMessage(TimeSpan, AsyncCallback, Object) o a BeginWaitForMessage(TimeSpan, AsyncCallback, Object)y, a continuación, llamar a Receive(TimeSpan). Este enfoque es común para los usos transaccionales donde se inicia la transacción entre las llamadas a WaitForMessage(TimeSpan) y a Receive.
Un IInputChannel no está necesariamente enlazado a un remitente único. Otros canales e interfaces de canal pueden proporcionar una correlación entre los remitentes determinados y IInputChannel, pero el contrato base no hace ninguna restricción así. Una implementación puede crear un IInputChannel nuevo para cada mensaje o reutilizar el mismo IInputChannel para varios mensajes y remitentes.
Propiedades
| LocalAddress |
Obtiene la dirección en la que este canal de entrada recibe los mensajes. |
| 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) |
| BeginReceive(AsyncCallback, Object) |
Comienza una operación asincrónica para recibir un mensaje que tiene un objeto de estados asociado a él. |
| BeginReceive(TimeSpan, AsyncCallback, Object) |
Comienza una operación asincrónica para recibir un mensaje que tiene un tiempo de espera especificado y un objeto de estados asociados a él. |
| BeginTryReceive(TimeSpan, AsyncCallback, Object) |
Comienza una operación asincrónica para recibir un mensaje que tiene un tiempo de espera especificado y un objeto de estados asociados a él. |
| BeginWaitForMessage(TimeSpan, AsyncCallback, Object) |
Comienza una operación asincrónica para esperar a que llegue un mensaje que tiene un tiempo de espera especificado y un objeto de estados asociados a él. |
| 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) |
| EndReceive(IAsyncResult) |
Completa una operación asincrónica para recibir un mensaje. |
| EndTryReceive(IAsyncResult, Message) |
Completa la operación asincrónica especificada para recibir un mensaje. |
| EndWaitForMessage(IAsyncResult) |
Completa la operación asincrónica especificada de espera por un mensaje. |
| GetProperty<T>() |
Devuelve un objeto escrito solicitado de la capa adecuada en la pila del canal si está presente. (Heredado de IChannel) |
| 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) |
| Receive() |
Devuelve el mensaje recibido si está disponible. Si no hay un mensaje disponible, se bloquea durante un intervalo de tiempo predeterminado. |
| Receive(TimeSpan) |
Devuelve el mensaje recibido si está disponible. Si no hay un mensaje disponible, se bloquea durante un intervalo de tiempo especificado. |
| TryReceive(TimeSpan, Message) |
Intenta recibir un mensaje dentro de un intervalo de tiempo especificado. |
| WaitForMessage(TimeSpan) |
Devuelve un valor que indica si un mensaje ha llegado dentro de un intervalo especificado de hora. |
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) |
