ChannelBase Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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. |