ContextBindingElement Klas
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Biedt een beveiligingsniveau en een uitwisselingsmechanisme als onderdeel van de context van een bindingselement en de functionaliteit om de kanaallisteners en factory's te bouwen.
public ref class ContextBindingElement : System::ServiceModel::Channels::BindingElement, System::ServiceModel::Channels::IContextBindingElement, System::ServiceModel::Description::IPolicyExportExtensionpublic class ContextBindingElement : System.ServiceModel.Channels.BindingElement, System.ServiceModel.Channels.IContextBindingElement, System.ServiceModel.Description.IPolicyExportExtensiontype ContextBindingElement = class
inherit BindingElement
interface IPolicyExportExtension
interface IContextBindingElementPublic Class ContextBindingElement
Inherits BindingElement
Implements IContextBindingElement, IPolicyExportExtension- Overname
- Implementeringen
Opmerkingen
Hiermee ContextBindingElement kan de gebruiker een element toevoegen aan de binding van een service voor het beheren van het contextuitwisselingsprotocol. De ContextBindingElement bindingselementen worden meestal gestapeld op betrouwbaarheid, beveiliging en transportbindingselementen. A ContextBindingElement vereist geen configuratieopties en kan kanaalfactory's maken voor IRequestChannel, IRequestSessionChannelen IDuplexSessionChannel. Het kan ook kanaallisteners maken voor IReplyChannel, IReplySessionChannelen IDuplexSessionChannel. Een contextkanaal wijzigt de kanaalinterface niet. De onderliggende kanaalstack moet de aangevraagde kanaalshape en sessiemogelijkheid ondersteunen.
De kanaallisteners en -factory's worden gebruikt om het deel van de kanaalstacks te maken dat wordt gebruikt voor het verwerken van binnenkomende en uitgaande berichten.
Note
Als er een sessiebinding wordt gemaakt met een ContextBindingElement en gebruikt met een contract dat aangeeft SessionMode = NotAllowed, wordt er een InvalidOperationException gegenereerd wanneer het kanaal wordt gemaakt met de volgende tekst: 'Kanaalcontextbeheer kan niet worden ingeschakeld of uitgeschakeld nadat het kanaal is geopend'. U moet een op sessies gebaseerd kanaal instellen SessionModeAllowed of Required niet gebruiken.
Wanneer u een aangepaste binding maakt, wordt u aangeraden de ContextBindingElement binding toe te voegen aan de BindingElementCollection aangepaste binding voordat u eventuele elementen van betrouwbaarheids- en beveiligingsbindingen toevoegt, indien aanwezig. Als u dit niet doet, kan uw service een ProtocolException bericht met het volgende bericht verzenden:
'Contextkanaal heeft een bericht ontvangen met context die niet overeenkomt met de huidige context die in de cache van het kanaal is opgeslagen. Zorg ervoor dat de service de context niet wijzigt nadat deze oorspronkelijk is ingesteld of uitgeschakeld door de kanaaleigenschap 'IContextManager.Enabled' in te stellen op false.'
Constructors
| Name | Description |
|---|---|
| ContextBindingElement() |
Initialiseert een nieuw exemplaar van de ContextBindingElement klasse. |
| ContextBindingElement(ProtectionLevel, ContextExchangeMechanism, Uri, Boolean) |
Initialiseert een nieuw exemplaar van de ContextBindingElement klasse met het opgegeven beveiligingsniveau, het mechanisme voor contextuitwisseling, het callbackadres van de client en een waarde die aangeeft of contextbeheer is ingeschakeld. |
| ContextBindingElement(ProtectionLevel, ContextExchangeMechanism, Uri) |
Initialiseert een nieuw exemplaar van de ContextBindingElement klasse met het opgegeven beveiligingsniveau, het mechanisme voor contextuitwisseling en het callback-adres van de client. |
| ContextBindingElement(ProtectionLevel, ContextExchangeMechanism) |
Initialiseert een nieuw exemplaar van de ContextBindingElement klasse met een opgegeven beveiligings- en uitwisselingsmechanisme. |
| ContextBindingElement(ProtectionLevel) |
Initialiseert een nieuw exemplaar van de ContextBindingElement klasse met een opgegeven beveiligingsniveau. |
Eigenschappen
| Name | Description |
|---|---|
| ClientCallbackAddress |
Hiermee wordt het callback-adres van de client voor het bindingselement ophaalt of ingesteld. |
| ContextExchangeMechanism |
Hiermee haalt u het uitwisselingsmechanisme op dat wordt gebruikt om context voor het bindingselement te communiceren. |
| ContextManagementEnabled |
Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt aangegeven of contextbeheer is ingeschakeld. |
| ProtectionLevel |
Hiermee wordt het beveiligingsniveau voor het bindingselement opgehaald of ingesteld vanuit de context. |
Methoden
| Name | Description |
|---|---|
| BuildChannelFactory<TChannel>(BindingContext) |
Hiermee wordt de stack van de kanaalfactory gebouwd op de client waarmee een opgegeven type kanaal voor een opgegeven context wordt gemaakt. |
| BuildChannelListener<TChannel>(BindingContext) |
Hiermee wordt de kanaallistenerstack gebouwd op de client die een opgegeven type kanaal accepteert voor een opgegeven context. |
| CanBuildChannelFactory<TChannel>(BindingContext) |
Retourneert een waarde die aangeeft of het huidige bindingselement een factory kan bouwen voor een opgegeven type kanaal en context. |
| CanBuildChannelListener<TChannel>(BindingContext) |
Retourneert een waarde die aangeeft of de huidige binding een listener kan bouwen voor een opgegeven type kanaal en context. |
| Clone() |
Hiermee maakt u een nieuw ContextBindingElement object dat is geïnitialiseerd op basis van het huidige object. |
| Equals(Object) |
Bepaalt of het opgegeven object gelijk is aan het huidige object. (Overgenomen van Object) |
| ExportPolicy(MetadataExporter, PolicyConversionContext) |
Schrijft aangepaste beleidsverklaringen naar de context van het bindingselement. |
| GetHashCode() |
Fungeert als de standaardhashfunctie. (Overgenomen van Object) |
| GetProperty<T>(BindingContext) |
Retourneert het getypte object met de opgegeven context van de juiste laag in de kanaalstack. |
| GetType() |
Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object) |
| MemberwiseClone() |
Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object) |
| ToString() |
Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object) |