ContextBindingElement Třída

Definice

Obor názvů:

System.ServiceModel.Channels

Sestavení:

System.ServiceModel.dll

Poskytuje úroveň ochrany a mechanismus výměny jako součást kontextu elementu vazby a funkce pro sestavení kanálů naslouchací procesy a továrny.

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

Dědičnost

Object

BindingElement

ContextBindingElement

Implementuje

IContextBindingElement IPolicyExportExtension

Poznámky

Umožňuje ContextBindingElement uživateli přidat prvek do vazby služby pro správu jejího protokolu výměny kontextu. Je ContextBindingElement obvykle naskládaná nad prvky spolehlivosti, zabezpečení a přenosových vazeb. A ContextBindingElement nevyžaduje žádné možnosti konfigurace a může vytvořit objekty pro vytváření kanálů pro IRequestChannel, IRequestSessionChannela IDuplexSessionChannel. Může také vytvářet naslouchací procesy kanálů pro IReplyChannel, IReplySessionChannela IDuplexSessionChannel. Kontextový kanál nemění rozhraní kanálu – základní zásobník kanálu musí podporovat požadovaný tvar kanálu a schopnost relace.

Naslouchací procesy a továrny kanálů se používají k vytvoření části zásobníků kanálů, které se používají ke zpracování příchozích a odchozích zpráv.

Poznámka

Pokud je vytvořena vazba založená na relaci s ContextBindingElement a použita se kontraktem, který určujeNotAllowedSessionMode = , InvalidOperationException vyvolá se při vytvoření kanálu s následujícím textem: "Po otevření kanálu nelze povolit nebo zakázat správu kontextu kanálu." Musíte nastavit SessionMode nebo Required nepoužívat Allowed kanál založený na relaci.

Při vytváření vlastní vazby se doporučuje přidat ContextBindingElement do BindingElementCollection vlastní vazby před přidáním prvků vazby spolehlivosti a zabezpečení, pokud existují. Pokud to neuděláte, může služba vyvolat ProtocolException následující zprávu:

Kontextový kanál přijal zprávu s kontextem, který neodpovídá aktuálnímu kontextu uloženému v mezipaměti kanálu. Ujistěte se, že služba po původním nastavení nemění kontext, nebo zakažte správu kontextu nastavením vlastnosti kanálu IContextManager.Enabled na hodnotu false.

Konstruktory

ContextBindingElement()	Inicializuje novou instanci ContextBindingElement třídy .
ContextBindingElement(ProtectionLevel)	Inicializuje novou instanci ContextBindingElement třídy se zadanou úrovní ochrany.
ContextBindingElement(ProtectionLevel, ContextExchangeMechanism)	Inicializuje novou instanci ContextBindingElement třídy se zadanou úrovní ochrany a mechanismu výměny.
ContextBindingElement(ProtectionLevel, ContextExchangeMechanism, Uri)	Inicializuje novou instanci třídy se zadanou úrovní ochrany, mechanismem výměny kontextu a adresou zpětného ContextBindingElement volání klienta.
ContextBindingElement(ProtectionLevel, ContextExchangeMechanism, Uri, Boolean)	Inicializuje novou instanci třídy se zadanou úrovní ochrany, mechanismem výměny kontextu, adresou zpětného ContextBindingElement volání klienta a hodnotou, která určuje, zda je povolena správa kontextu.

Vlastnosti

ClientCallbackAddress	Získá nebo nastaví adresu zpětného volání klienta pro element vazby.
ContextExchangeMechanism	Získá nebo nastaví mechanismus výměny použité ke komunikaci kontextu pro element vazby.
ContextManagementEnabled	Získá nebo nastaví hodnotu, která určuje, zda je povolena správa kontextu.
ProtectionLevel	Získá nebo nastaví úroveň ochrany elementu vazby z kontextu.

Metody

BuildChannelFactory<TChannel>(BindingContext)	Sestaví zásobník pro vytváření kanálů na klientovi, který vytvoří zadaný typ kanálu pro zadaný kontext.
BuildChannelListener<TChannel>(BindingContext)	Sestaví zásobník naslouchacího procesu kanálu na klientovi, který přijímá zadaný typ kanálu pro zadaný kontext.
CanBuildChannelFactory<TChannel>(BindingContext)	Vrátí hodnotu, která označuje, zda aktuální element vazby může vytvořit objekt pro zadaný typ kanálu a kontextu.
CanBuildChannelListener<TChannel>(BindingContext)	Vrátí hodnotu, která označuje, zda aktuální vazba může sestavit naslouchací proces pro zadaný typ kanálu a kontextu.
Clone()	Vytvoří nový ContextBindingElement objekt inicializovaný z aktuálního objektu.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
ExportPolicy(MetadataExporter, PolicyConversionContext)	Zapíše vlastní kontrolní výrazy zásad do kontextu elementu binding.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetProperty<T>(BindingContext)	Vrátí zadaný objekt se zadaným kontextem z příslušné vrstvy v zásobníku kanálů.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)