IInputChannel Interfaz

Definición

Espacio de nombres:

System.ServiceModel.Channels

Ensamblado:

System.ServiceModel.Primitives.dll

Paquete:

System.ServiceModel.Primitives v8.0.0

Source:

IInputChannel.cs

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

System.ServiceModel.Channels.IDuplexChannel

System.ServiceModel.Channels.IDuplexSessionChannel

System.ServiceModel.Channels.IInputSessionChannel

Implementaciones

IChannel 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.

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)