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::IChannel
public interface IInputChannel : System.ServiceModel.Channels.IChannel
type IInputChannel = interface
interface IChannel
interface ICommunicationObject
Public 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) |
Métodos de extensión
CloseHelperAsync(ICommunicationObject, TimeSpan) |
Define la interfaz que un canal debe implementar para recibir un mensaje. |
OpenHelperAsync(ICommunicationObject, TimeSpan) |
Define la interfaz que un canal debe implementar para recibir un mensaje. |