ContextBindingElement Classe

Définition

Espace de noms:

System.ServiceModel.Channels

Assembly:

System.ServiceModel.dll

Fournit un niveau de protection et un mécanisme d’échange dans le cadre du contexte d’un élément de liaison et de la fonctionnalité permettant de créer les écouteurs et les fabriques de canal.

public ref class ContextBindingElement : System::ServiceModel::Channels::BindingElement, System::ServiceModel::Channels::IContextBindingElement, System::ServiceModel::Description::IPolicyExportExtension

public class ContextBindingElement : System.ServiceModel.Channels.BindingElement, System.ServiceModel.Channels.IContextBindingElement, System.ServiceModel.Description.IPolicyExportExtension

type ContextBindingElement = class
    inherit BindingElement
    interface IPolicyExportExtension
    interface IContextBindingElement

Public Class ContextBindingElement
Inherits BindingElement
Implements IContextBindingElement, IPolicyExportExtension

Héritage

Object

BindingElement

ContextBindingElement

Implémente

IContextBindingElement IPolicyExportExtension

Remarques

L’utilisateur ContextBindingElement permet à l’utilisateur d’ajouter un élément à la liaison d’un service pour gérer son protocole d’échange de contexte. Il ContextBindingElement est généralement empilé en plus de la fiabilité, de la sécurité et des éléments de liaison de transport. A ContextBindingElement ne nécessite aucune option de configuration et peut créer des fabriques de canaux pour IRequestChannel, IRequestSessionChannelet IDuplexSessionChannel. Il peut également créer des écouteurs de canal pour IReplyChannel, IReplySessionChannelet IDuplexSessionChannel. Un canal de contexte ne modifie pas l’interface du canal : la pile de canaux sous-jacente doit prendre en charge la forme de canal et la fonctionnalité de session demandées.

Les écouteurs de canal et les fabriques sont utilisés pour construire la partie des piles de canaux utilisées pour traiter les messages entrants et sortants.

Note

Si une liaison basée sur une session est créée avec un ContextBindingElement contrat qui spécifieNotAllowedSessionMode = , une InvalidOperationException liaison basée sur une session est levée lorsque le canal est créé avec le texte suivant : « La gestion du contexte de canal ne peut pas être activée ou désactivée une fois le canal ouvert ». Vous devez définir SessionModeAllowed ou Required ne pas utiliser un canal basé sur une session.

Lors de la création d’une liaison personnalisée, il est recommandé d’ajouter la ContextBindingElementBindingElementCollection liaison personnalisée avant d’ajouter des éléments de liaison de fiabilité et de sécurité, le cas échéant. Si ce n’est pas le cas, votre service peut lever un ProtocolException message avec le message suivant :

« Le canal de contexte a reçu un message avec un contexte qui ne correspond pas au contexte actuel mis en cache sur le canal. Vérifiez que le service ne modifie pas le contexte après qu’il a été initialement défini ou désactivé la gestion du contexte en définissant la propriété de canal « IContextManager.Enabled » sur false. »

Constructeurs

Nom	Description
ContextBindingElement()	Initialise une nouvelle instance de la classe ContextBindingElement.
ContextBindingElement(ProtectionLevel, ContextExchangeMechanism, Uri, Boolean)	Initialise une nouvelle instance de la ContextBindingElement classe avec le niveau de protection, le mécanisme d’échange de contexte, l’adresse de rappel du client et une valeur qui spécifie si la gestion du contexte est activée.
ContextBindingElement(ProtectionLevel, ContextExchangeMechanism, Uri)	Initialise une nouvelle instance de la ContextBindingElement classe avec le niveau de protection, le mécanisme d’échange de contexte et l’adresse de rappel client spécifiées.
ContextBindingElement(ProtectionLevel, ContextExchangeMechanism)	Initialise une nouvelle instance de la ContextBindingElement classe avec un niveau de protection et de mécanisme d’échange spécifié.
ContextBindingElement(ProtectionLevel)	Initialise une nouvelle instance de la ContextBindingElement classe avec un niveau de protection spécifié.

Propriétés

Nom	Description
ClientCallbackAddress	Obtient ou définit l’adresse de rappel du client pour l’élément de liaison.
ContextExchangeMechanism	Obtient ou définit le mécanisme d’échange utilisé pour communiquer le contexte de l’élément de liaison.
ContextManagementEnabled	Obtient ou définit une valeur qui spécifie si la gestion du contexte est activée.
ProtectionLevel	Obtient ou définit le niveau de protection de l’élément de liaison à partir du contexte.

Méthodes

Nom	Description
BuildChannelFactory<TChannel>(BindingContext)	Génère la pile de fabrique de canaux sur le client qui crée un type de canal spécifié pour un contexte spécifié.
BuildChannelListener<TChannel>(BindingContext)	Génère la pile de l’écouteur de canal sur le client qui accepte un type de canal spécifié pour un contexte spécifié.
CanBuildChannelFactory<TChannel>(BindingContext)	Retourne une valeur qui indique si l’élément de liaison actuel peut générer une fabrique pour un type de canal et de contexte spécifiés.
CanBuildChannelListener<TChannel>(BindingContext)	Retourne une valeur qui indique si la liaison actuelle peut générer un écouteur pour un type de canal et de contexte spécifié.
Clone()	Crée un ContextBindingElement objet initialisé à partir de celui en cours.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
ExportPolicy(MetadataExporter, PolicyConversionContext)	Écrit des assertions de stratégie personnalisées dans le contexte de l’élément de liaison.
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetProperty<T>(BindingContext)	Retourne l’objet typé avec le contexte spécifié à 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)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)