IChannel IChannel IChannel IChannel Interface

Définition

Définit l'interface de base que tous les objets de canal doivent implémenter.Defines the basic interface that all channel objects must implement. Cela requiert l'implémentation de l'interface d'ordinateur d'état partagée par tous les objets de communication et l'implémentation d'une méthode pour récupérer des objets de la pile de canaux.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
Dérivé
Implémente

Remarques

Important

L’appel de méthodes de classes qui implémentent cette interface avec des données non approuvées est un risque de sécurité.Calling methods from classes that implement this interface with untrusted data is a security risk. Appelez les méthodes de classes qui implémentent cette interface avec des données approuvées uniquement.Call the methods from classes that implement this interface only with trusted data. Pour plus d’informations, consultez Validation des données.For more information, see Data Validation.

Les canaux doivent être conformes au contrat d'un ordinateur d'état défini par l'interface ICommunicationObject.Channels must satisfy the contract of a state machine as defined by the ICommunicationObject interface.

L'interface IChannel ajoute laThe IChannel interface adds the

méthode GetProperty à l'interface ICommunicationObject.GetProperty method to the ICommunicationObject interface. Cette méthode fournit un mécanisme pour récupérer des propriétés de la pile de canaux quel que soit l'emplacement des propriétés dans la pile.This method provides a mechanism for retrieving properties from the channel stack regardless of where in the stack those properties live. Le terme "propriété" dans le nom de méthode fait référence à une information qui appartient à l'un des canaux dans la pile.The term "property" in the method name refers to a piece of information that belongs to one of the channels in the stack. Le type CLR pour cette propriété est déterminé par T.The CLR type for that property is determined by T. Cette méthode de récupération est également utilisée sur les fabriques de canaux et les écouteurs de canal.This method of retrieval is also used on channel factories and channel listeners.

IChannel est héritée par chacune des interfaces de canal associée aux modèles d'échange de messages de base :IChannel is inherited by each of the channel interfaces associated with the basic message-exchange patterns:

Méthodes

Abort() Abort() Abort() Abort()

Provoque la transition immédiate d'un objet de communication de son état actuel à l'état fermé.Causes a communication object to transition immediately from its current state into the closed state.

(Inherited from ICommunicationObject)
BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object) BeginClose(AsyncCallback, Object)

Commence une opération asynchrone pour fermer un objet de communication.Begins an asynchronous operation to close a communication object.

(Inherited from ICommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object) BeginClose(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour fermer un objet de communication avec un délai d'attente spécifié.Begins an asynchronous operation to close a communication object with a specified timeout.

(Inherited from ICommunicationObject)
BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object) BeginOpen(AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication.Begins an asynchronous operation to open a communication object.

(Inherited from ICommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object) BeginOpen(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication dans un intervalle de temps spécifié.Begins an asynchronous operation to open a communication object within a specified interval of time.

(Inherited from ICommunicationObject)
Close() Close() Close() Close()

Provoque la transition d'un objet de communication de son état actuel à l'état fermé.Causes a communication object to transition from its current state into the closed state.

(Inherited from ICommunicationObject)
Close(TimeSpan) Close(TimeSpan) Close(TimeSpan) Close(TimeSpan)

Provoque la transition d'un objet de communication de son état actuel à l'état fermé.Causes a communication object to transition from its current state into the closed state.

(Inherited from ICommunicationObject)
EndClose(IAsyncResult) EndClose(IAsyncResult) EndClose(IAsyncResult) EndClose(IAsyncResult)

Termine une opération asynchrone pour fermer un objet de communication.Completes an asynchronous operation to close a communication object.

(Inherited from ICommunicationObject)
EndOpen(IAsyncResult) EndOpen(IAsyncResult) EndOpen(IAsyncResult) EndOpen(IAsyncResult)

Termine une opération asynchrone pour ouvrir un objet de communication.Completes an asynchronous operation to open a communication object.

(Inherited from ICommunicationObject)
GetProperty<T>() GetProperty<T>() GetProperty<T>() GetProperty<T>()

Retourne un objet typé demandé (s'il existe) à partir de la couche appropriée dans la pile de canaux.Returns a typed object requested, if present, from the appropriate layer in the channel stack.

Open() Open() Open() Open()

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert.Causes a communication object to transition from the created state into the opened state.

(Inherited from ICommunicationObject)
Open(TimeSpan) Open(TimeSpan) Open(TimeSpan) Open(TimeSpan)

Provoque la transition d'un objet de communication de l'état créé à l'état ouvert dans un intervalle de temps spécifié.Causes a communication object to transition from the created state into the opened state within a specified interval of time.

(Inherited from ICommunicationObject)

Événements

Closed Closed Closed Closed

Se produit lorsque l'objet de communication termine sa transition de l'état de fermeture à l'état fermé.Occurs when the communication object completes its transition from the closing state into the closed state.

(Inherited from ICommunicationObject)
Closing Closing Closing Closing

Se produit lorsque l'objet de communication entre d'abord dans l'état fermeture.Occurs when the communication object first enters the closing state.

(Inherited from ICommunicationObject)
Faulted Faulted Faulted Faulted

Se produit lorsque l'objet de communication entre d'abord dans l'état de faute.Occurs when the communication object first enters the faulted state.

(Inherited from ICommunicationObject)
Opened Opened Opened Opened

Se produit lorsque l'objet de communication termine sa transition de l'état d'ouverture à l'état ouvert.Occurs when the communication object completes its transition from the opening state into the opened state.

(Inherited from ICommunicationObject)
Opening Opening Opening Opening

Se produit lorsque l'objet de communication entre d'abord dans l'état d'ouverture.Occurs when the communication object first enters the opening state.

(Inherited from ICommunicationObject)

Propriétés

State State State State

Obtient l'état actuel de l'objet orienté communication.Gets the current state of the communication-oriented object.

(Inherited from ICommunicationObject)

S’applique à