IChannel Interfaz

Definición

Define la interfaz básica que todos los objetos de canal deben implementar.Defines the basic interface that all channel objects must implement. 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.It requires that they implement the state machine interface shared by all communication objects and that they implement a method to retrieve objects from the channel stack.

public interface class IChannel : System::ServiceModel::ICommunicationObject
public interface IChannel : System.ServiceModel.ICommunicationObject
type IChannel = interface
    interface ICommunicationObject
Public 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.Calling methods from classes that implement this interface with untrusted data is a security risk. Llame a métodos de clases que implementan esta interfaz solo con datos de confianza.Call the methods from classes that implement this interface only with trusted data. Para obtener más información, vea Data Validation (Validación de datos).For more information, see Data Validation.

Los canales deben satisfacer el contrato de un equipo de estado, tal y como lo define la interfaz ICommunicationObject.Channels must satisfy the contract of a state machine as defined by the ICommunicationObject interface.

La interfaz IChannel agrega:The IChannel interface adds the

GetProperty método a la interfaz ICommunicationObject.GetProperty method to the ICommunicationObject interface. 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.This method provides a mechanism for retrieving properties from the channel stack regardless of where in the stack those properties live. 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.The term "property" in the method name refers to a piece of information that belongs to one of the channels in the stack. T determina el tipo CLR para esa propiedad.The CLR type for that property is determined by T. Este método de recuperación también se utiliza en los generadores del canal y agentes de escucha del canal.This method of retrieval is also used on channel factories and channel listeners.

cada una de las interfaces de canal asociadas a los patrones de intercambio de mensajes básicos hereda IChannel:IChannel is inherited by each of the channel interfaces associated with the basic message-exchange patterns:

Propiedades

State

Obtiene el estado actual del objeto orientado a la comunicación.Gets the current state of the communication-oriented object.

(Heredado de ICommunicationObject)

Métodos

Abort()

Hace que un objeto de comunicación pase inmediatamente de su estado actual al estado cerrado.Causes a communication object to transition immediately from its current state into the closed state.

(Heredado de ICommunicationObject)
BeginClose(AsyncCallback, Object)

Comienza una operación asincrónica para cerrar un objeto de comunicación.Begins an asynchronous operation to close a communication object.

(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.Begins an asynchronous operation to close a communication object with a specified timeout.

(Heredado de ICommunicationObject)
BeginOpen(AsyncCallback, Object)

Comienza una operación asincrónica para abrir un objeto de comunicación.Begins an asynchronous operation to open a communication object.

(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.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Heredado de ICommunicationObject)
Close()

Provoca que un objeto de comunicación pase de su estado actual al estado cerrado.Causes a communication object to transition from its current state into the closed state.

(Heredado de ICommunicationObject)
Close(TimeSpan)

Provoca que un objeto de comunicación pase de su estado actual al estado cerrado.Causes a communication object to transition from its current state into the closed state.

(Heredado de ICommunicationObject)
EndClose(IAsyncResult)

Completa una operación asincrónica para cerrar un objeto de comunicación.Completes an asynchronous operation to close a communication object.

(Heredado de ICommunicationObject)
EndOpen(IAsyncResult)

Completa una operación asincrónica para abrir un objeto de comunicación.Completes an asynchronous operation to open a communication object.

(Heredado de ICommunicationObject)
GetProperty<T>()

Devuelve un objeto escrito solicitado de la capa adecuada en la pila del canal si está presente.Returns a typed object requested, if present, from the appropriate layer in the channel stack.

Open()

Hace que un objeto de comunicación pase del estado creado al estado abierto.Causes a communication object to transition from the created state into the opened state.

(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.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Heredado de ICommunicationObject)

Eventos

Closed

Se produce cuando el objeto de comunicación completa su transición del estado de cierre al estado cerrado.Occurs when the communication object completes its transition from the closing state into the closed state.

(Heredado de ICommunicationObject)
Closing

Se produce cuando el objeto de comunicación introduce primero el estado de cierre.Occurs when the communication object first enters the closing state.

(Heredado de ICommunicationObject)
Faulted

Se produce cuando el objeto de comunicación introduce primero el estado de error.Occurs when the communication object first enters the faulted state.

(Heredado de ICommunicationObject)
Opened

Se produce cuando el objeto de comunicación completa su transición del estado de apertura al estado abierto.Occurs when the communication object completes its transition from the opening state into the opened state.

(Heredado de ICommunicationObject)
Opening

Se produce cuando el objeto de comunicación introduce primero el estado de apertura.Occurs when the communication object first enters the opening state.

(Heredado de ICommunicationObject)

Se aplica a