StreamUpgradeProvider Classe

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.dll

Implémente un fournisseur de mise à niveau personnalisé, hérité de cette classe de base abstract.

public ref class StreamUpgradeProvider abstract : System::ServiceModel::Channels::CommunicationObject

public abstract class StreamUpgradeProvider : System.ServiceModel.Channels.CommunicationObject

type StreamUpgradeProvider = class
    inherit CommunicationObject

Public MustInherit Class StreamUpgradeProvider
Inherits CommunicationObject

Héritage

Object

CommunicationObject

StreamUpgradeProvider

Dérivé

System.ServiceModel.Channels.StreamSecurityUpgradeProvider

Remarques

Un exemple d'une mise à niveau de flux de données consiste à générer directement un flux de données de compression sur le flux de données de transport. Pour ajouter une mise à niveau de sécurité, vous implémentez en outre une classe qui dérive de StreamSecurityUpgradeProvider. Vous pouvez implémenter plusieurs mises à niveau et chacune encapsule la mise à niveau précédente.

Le processus de mise à niveau se compose des étapes suivantes :

1. Implémentez une classe qui dérive de StreamUpgradeProvider ;

2. Inscrivez-la en créant un élément de liaison pour cette classe et en inscrivant le fournisseur dans une liaison personnalisée.

3. La classe dérivée que vous implémentez crée une instance de StreamUpgradeInitiator qui initie au moment de l'exécution une demande à l'autre extrémité de sa connexion pour mettre à niveau la couche de transport de canal.

4. La classe dérivée que vous implémentez crée une instance de StreamUpgradeAcceptor qui au moment de l'exécution reçoit la demande de mise à niveau de l'étape précédente et, si possible, accepte la mise à niveau et retourne le flux de données mis à niveau de l'autre côté de sa connexion.

5. S'il y a des demandes de mise à niveau supplémentaires, elles sont traitées de façon séquentielle, comme décrit dans les deux étapes précédentes.

Constructeurs

StreamUpgradeProvider()	Initialise une nouvelle instance de la classe StreamUpgradeProvider.
StreamUpgradeProvider(IDefaultCommunicationTimeouts)	Initialise une nouvelle instance de la classe StreamUpgradeProvider.

Propriétés

DefaultCloseTimeout	Obtient la DefaultCloseTimeout.
DefaultOpenTimeout	Obtient la DefaultOpenTimeout.
IsDisposed	Obtient une valeur qui indique si l'objet de communication a été supprimé. (Hérité de CommunicationObject)
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

Abort()	Provoque la transition immédiate d'un objet de communication de son état actuel à l'état de fermeture. (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'attente 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 à l'état fermé. (Hérité de CommunicationObject)
Close(TimeSpan)	Provoque la transition d'un objet de communication de son état actuel à l'état fermé dans un intervalle de temps spécifié. (Hérité de CommunicationObject)
CreateUpgradeAcceptor()	Crée une instance de StreamUpgradeAcceptor.
CreateUpgradeInitiator(EndpointAddress, Uri)	Crée une instance de StreamUpgradeInitiator.
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 à l'état d'erreur. (Hérité de CommunicationObject)
GetCommunicationObjectType()	Obtient le type d'objet de communication. (Hérité de CommunicationObject)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetProperty<T>()	En cas d'implémentation dans une classe dérivée, obtient une propriété du flux actuel qui représente un initiateur de mise à niveau de flux.
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
OnAbort()	Insère le traitement sur un objet de communication après la transition vers l’état de fermeture 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 est passé à 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 sa transition vers 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 sa transition vers l’état de fermeture en raison de l’appel d’une opération de fermeture synchrone. (Hérité de CommunicationObject)
OnClosed()	Appelé pendant la transition d'un objet de communication à l'état de fermeture. (Hérité de CommunicationObject)
OnClosing()	Appelé pendant la transition d'un objet de communication à l'état de fermeture. (Hérité de CommunicationObject)
OnEndClose(IAsyncResult)	Termine une opération asynchrone à la fermeture d'un objet de communication. (Hérité de CommunicationObject)
OnEndOpen(IAsyncResult)	Termine une opération asynchrone à l'ouverture d'un objet de communication. (Hérité de CommunicationObject)
OnFaulted()	Insère le traitement sur un objet de communication après sa transition vers l’état d’erreur 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 la transition vers 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 à l'état ouvert. (Hérité de CommunicationObject)
OnOpening()	Appelé pendant la transition d'un objet de communication à l'état d'ouverture. (Hérité de CommunicationObject)
Open()	Provoque la transition d'un objet de communication de l'état créé à l'état ouvert. (Hérité de CommunicationObject)
Open(TimeSpan)	Provoque la transition d'un objet de communication de l'état créé à l'état ouvert dans un intervalle de temps spécifié. (Hérité de CommunicationObject)
ThrowIfDisposed()	Renvoie une exception si l'objet de communication est supprimé. (Hérité de CommunicationObject)
ThrowIfDisposedOrImmutable()	Renvoie une exception si la propriété State de l'objet de communication n'a pas pour valeur l'état Created. (Hérité de CommunicationObject)
ThrowIfDisposedOrNotOpen()	Renvoie 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

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 de fermeture. (Hérité de CommunicationObject)
Faulted	Se produit lorsqu'un objet de communication passe à l'état d'erreur. (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)

Voir aussi

• Mises à niveau de flux personnalisées