ChannelBase Classe

Définition

Fournit l’implémentation de base pour les canaux personnalisés.

public ref class ChannelBase abstract : System::ServiceModel::Channels::CommunicationObject, System::ServiceModel::Channels::IChannel, System::ServiceModel::IDefaultCommunicationTimeouts
public abstract class ChannelBase : System.ServiceModel.Channels.CommunicationObject, System.ServiceModel.Channels.IChannel, System.ServiceModel.IDefaultCommunicationTimeouts
type ChannelBase = class
    inherit CommunicationObject
    interface IChannel
    interface ICommunicationObject
    interface IDefaultCommunicationTimeouts
Public MustInherit Class ChannelBase
Inherits CommunicationObject
Implements IChannel, IDefaultCommunicationTimeouts
Héritage
Implémente

Remarques

Important

L’appel de méthodes de cette classe avec des données non approuvées est un risque de sécurité. Appelez les méthodes de cette classe uniquement avec des données approuvées. Pour plus d’informations, consultez Valider toutes les entrées.

La ChannelBase classe fournit une implémentation abstraite de la classe de base de l’interface IChannel . Il exige également que chaque canal soit associé à un gestionnaire de canaux. Notez que le seul constructeur disponible pour la création d’instances de ChannelBase nécessite un paramètre d’entrée channelManager .

Les modifications d’état sont gérées en héritent de l’implémentation CommunicationObject de l’ordinateur d’état.

Obtient ChannelBase ses délais d’expiration de communication par défaut pour les opérations d’ouverture, de fermeture, d’envoi et de réception de l’associé ChannelManagerBase .

Il ChannelBase gère également le responsable pour vous. Outre l’exposition d’une référence au responsable, la classe de base informe également le responsable lorsque les canaux sont créés et détruits. Mais la référence au responsable n’est bonne que jusqu’à ce que le canal soit détruit.

Même si vous utilisez la classe de base, vous devez toujours fournir des comportements pour l’ouverture et la fermeture du canal. Les implémentations par défaut de ces méthodes ne fournissent pas d’informations utiles.

Vous devez également vous assurer de remplacer GetProperty chaque fois que vous implémentez un canal. GetProperty est un excellent moyen de communiquer des informations le long de la pile de canaux sans avoir à savoir quels canaux sont en dessous de vous, ou quels canaux ci-dessus vous pouvez effectuer des requêtes. Définissez des interfaces qui peuvent être interrogées pour obtenir des informations disponibles. Chaque fois que vous ne reconnaissez pas l’argument de type pour GetProperty, déléguer au canal suivant dans la pile ou retourner null si vous créez un canal de transport en bas de la pile.

Constructeurs

Nom Description
ChannelBase(ChannelManagerBase)

Initialise une nouvelle instance de la classe ChannelBase.

Propriétés

Nom Description
DefaultCloseTimeout

Obtient l’intervalle de temps par défaut fourni pour qu’une opération de fermeture se termine.

DefaultOpenTimeout

Obtient l’intervalle de temps par défaut fourni pour qu’une opération ouverte se termine.

DefaultReceiveTimeout

Obtient l’intervalle de temps par défaut fourni pour qu’une opération de réception se termine.

DefaultSendTimeout

Obtient l’intervalle de temps par défaut fourni pour qu’une opération d’envoi se termine.

IsDisposed

Obtient une valeur qui indique si l’objet de communication a été supprimé.

(Hérité de CommunicationObject)
Manager

Obtient le gestionnaire de canaux associé au canal actuel.

State

Obtient une valeur qui indique l’état actuel de l’objet de communication.

(Hérité de CommunicationObject)
ThisLock

Obtient le verrou mutuellement exclusif qui protège l’instance de classe pendant une transition d’état.

(Hérité de CommunicationObject)

Méthodes

Nom Description
Abort()

Provoque la transition immédiate d’un objet de communication de son état actuel vers l’état fermant.

(Hérité de CommunicationObject)
BeginClose(AsyncCallback, Object)

Commence une opération asynchrone pour fermer un objet de communication.

(Hérité de CommunicationObject)
BeginClose(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour fermer un objet de communication avec un délai d’expiration spécifié.

(Hérité de CommunicationObject)
BeginOpen(AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication.

(Hérité de CommunicationObject)
BeginOpen(TimeSpan, AsyncCallback, Object)

Commence une opération asynchrone pour ouvrir un objet de communication dans un intervalle de temps spécifié.

(Hérité de CommunicationObject)
Close()

Provoque la transition d’un objet de communication de son état actuel vers l’état fermé.

(Hérité de CommunicationObject)
Close(TimeSpan)

Provoque la transition d’un objet de communication de son état actuel vers l’état fermé dans un intervalle de temps spécifié.

(Hérité de CommunicationObject)
EndClose(IAsyncResult)

Termine une opération asynchrone pour fermer un objet de communication.

(Hérité de CommunicationObject)
EndOpen(IAsyncResult)

Termine une opération asynchrone pour ouvrir un objet de communication.

(Hérité de CommunicationObject)
Equals(Object)

Détermine si l’objet spécifié est égal à l’objet actuel.

(Hérité de Object)
Fault()

Provoque la transition d’un objet de communication de son état actuel vers l’état défectueux.

(Hérité de CommunicationObject)
GetCommunicationObjectType()

Obtient le type d’objet de communication.

(Hérité de CommunicationObject)
GetHashCode()

Sert de fonction de hachage par défaut.

(Hérité de Object)
GetProperty<T>()

Retourne l’objet typé demandé, le cas échéant, à partir de la couche appropriée dans la pile de canaux.

GetType()

Obtient la Type de l’instance actuelle.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Objectactuel.

(Hérité de Object)
OnAbort()

Insère le traitement sur un objet de communication après qu’il passe à l’état fermant en raison de l’appel d’une opération d’abandon synchrone.

(Hérité de CommunicationObject)
OnBeginClose(TimeSpan, AsyncCallback, Object)

Insère le traitement après qu’un objet de communication passe à l’état de fermeture en raison de l’appel d’une opération de fermeture asynchrone.

(Hérité de CommunicationObject)
OnBeginOpen(TimeSpan, AsyncCallback, Object)

Insère le traitement sur un objet de communication après qu’il passe à l’état d’ouverture en raison de l’appel d’une opération d’ouverture asynchrone.

(Hérité de CommunicationObject)
OnClose(TimeSpan)

Insère le traitement sur un objet de communication après qu’il passe à l’état de fermeture en raison de l’appel d’une opération de fermeture synchrone.

(Hérité de CommunicationObject)
OnClosed()

Utilise le suivi de diagnostic pendant la transition vers l’état de fermeture.

OnClosing()

Appelé pendant la transition d’un objet de communication dans l’état fermant.

(Hérité de CommunicationObject)
OnEndClose(IAsyncResult)

Termine une opération asynchrone sur la fermeture d’un objet de communication.

(Hérité de CommunicationObject)
OnEndOpen(IAsyncResult)

Termine une opération asynchrone sur l’ouverture d’un objet de communication.

(Hérité de CommunicationObject)
OnFaulted()

Insère le traitement sur un objet de communication après qu’il passe à l’état défectueux en raison de l’appel d’une opération d’erreur synchrone.

(Hérité de CommunicationObject)
OnOpen(TimeSpan)

Insère le traitement sur un objet de communication après qu’il passe à l’état d’ouverture qui doit se terminer dans un intervalle de temps spécifié.

(Hérité de CommunicationObject)
OnOpened()

Appelé pendant la transition d’un objet de communication dans l’état ouvert.

(Hérité de CommunicationObject)
OnOpening()

Appelé pendant la transition d’un objet de communication dans l’état d’ouverture.

(Hérité de CommunicationObject)
Open()

Provoque la transition d’un objet de communication entre l’état créé et l’état ouvert.

(Hérité de CommunicationObject)
Open(TimeSpan)

Provoque la transition d’un objet de communication entre l’état créé et l’état ouvert dans un intervalle de temps spécifié.

(Hérité de CommunicationObject)
ThrowIfDisposed()

Lève une exception si l’objet de communication est supprimé.

(Hérité de CommunicationObject)
ThrowIfDisposedOrImmutable()

Lève une exception si l’objet de communication que la State propriété n’est pas définie sur l’état Created .

(Hérité de CommunicationObject)
ThrowIfDisposedOrNotOpen()

Lève une exception si l’objet de communication n’est pas dans l’état Opened .

(Hérité de CommunicationObject)
ToString()

Retourne une chaîne qui représente l’objet actuel.

(Hérité de Object)

Événements

Nom Description
Closed

Se produit lorsqu’un objet de communication passe à l’état fermé.

(Hérité de CommunicationObject)
Closing

Se produit lorsqu’un objet de communication passe à l’état fermant.

(Hérité de CommunicationObject)
Faulted

Se produit lorsqu’un objet de communication passe à l’état défectueux.

(Hérité de CommunicationObject)
Opened

Se produit lorsqu’un objet de communication passe à l’état ouvert.

(Hérité de CommunicationObject)
Opening

Se produit lorsqu’un objet de communication passe à l’état d’ouverture.

(Hérité de CommunicationObject)

Implémentations d’interfaces explicites

Nom Description
IDefaultCommunicationTimeouts.CloseTimeout

Obtient l’intervalle de temps après lequel la méthode close, appelée par un objet de communication, expire.

IDefaultCommunicationTimeouts.OpenTimeout

Obtient l’intervalle de temps après lequel la méthode ouverte, appelée par un objet de communication, expire.

IDefaultCommunicationTimeouts.ReceiveTimeout

Obtient l’intervalle de temps après lequel la méthode de réception, appelée par un objet de communication, expire.

IDefaultCommunicationTimeouts.SendTimeout

Obtient l’intervalle de temps après lequel la méthode d’envoi, appelée par un objet de communication, expire.

S’applique à