ReliableSessionBindingElement Klasse

Referenz

Definition

Namespace:: System.ServiceModel.Channels

Assembly:: System.ServiceModel.Primitives.dll

Assembly:: System.ServiceModel.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt das Bindungselement dar, das die Sende- und Empfangskanäle für eine zuverlässige Sitzung zwischen Endpunkten erzeugen kann.

public ref class ReliableSessionBindingElement sealed : System::ServiceModel::Channels::BindingElement

public ref class ReliableSessionBindingElement sealed : System::ServiceModel::Channels::BindingElement, System::ServiceModel::Description::IPolicyExportExtension

public sealed class ReliableSessionBindingElement : System.ServiceModel.Channels.BindingElement

public sealed class ReliableSessionBindingElement : System.ServiceModel.Channels.BindingElement, System.ServiceModel.Description.IPolicyExportExtension

type ReliableSessionBindingElement = class
    inherit BindingElement

type ReliableSessionBindingElement = class
    inherit BindingElement
    interface IPolicyExportExtension

Public NotInheritable Class ReliableSessionBindingElement
Inherits BindingElement

Public NotInheritable Class ReliableSessionBindingElement
Inherits BindingElement
Implements IPolicyExportExtension

Vererbung: Object

BindingElement
ReliableSessionBindingElement

Implementiert: IPolicyExportExtension

Beispiele

Das ReliableSessionBindingElement kann jeder benutzerdefinierten Bindung hinzugefügt werden. Dies wird mit den folgenden Konfigurationselementen erreicht.

<bindings>  
    <customBinding>  
        <binding configurationName="ReliabilityHTTP">  
            <reliableSession/>  
        </binding>  
    </customBinding>  
</bindings>

Im folgenden Beispielcode wird die Verwendung des ReliableSessionBindingElement im Code veranschaulicht.

Uri baseAddress = new Uri("http://localhost:8000/servicemodelsamples/service");

// Create a ServiceHost for the CalculatorService type and provide the base address.
using (ServiceHost serviceHost = new ServiceHost(typeof(CalculatorService), baseAddress))
{
    // Create a custom binding that contains two binding elements.
    ReliableSessionBindingElement reliableSession = new ReliableSessionBindingElement();
    reliableSession.Ordered = true;

    HttpTransportBindingElement httpTransport = new HttpTransportBindingElement();
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous;
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard;

    CustomBinding binding = new CustomBinding(reliableSession, httpTransport);

    // Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(typeof(ICalculator), binding, "");

    // Add a MEX endpoint.
    ServiceMetadataBehavior smb = new ServiceMetadataBehavior();
    smb.HttpGetEnabled = true;
    smb.HttpGetUrl = new Uri("http://localhost:8001/servicemodelsamples");
    serviceHost.Description.Behaviors.Add(smb);

    // Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open();

    // The service can now be accessed.
    Console.WriteLine("The service is ready.");
    Console.WriteLine("Press <ENTER> to terminate service.");
    Console.WriteLine();
    Console.ReadLine();

    // Close the ServiceHostBase to shutdown the service.
    serviceHost.Close();
}

Dim baseAddress As New Uri("http://localhost:8000/servicemodelsamples/service")

' Create a ServiceHost for the CalculatorService type and provide the base address.
Using serviceHost As New ServiceHost(GetType(CalculatorService), baseAddress)
    ' Create a custom binding that contains two binding elements.
    Dim reliableSession As New ReliableSessionBindingElement()
    reliableSession.Ordered = True

    Dim httpTransport As New HttpTransportBindingElement()
    httpTransport.AuthenticationScheme = System.Net.AuthenticationSchemes.Anonymous
    httpTransport.HostNameComparisonMode = HostNameComparisonMode.StrongWildcard

    Dim binding As New CustomBinding(reliableSession, httpTransport)

    ' Add an endpoint using that binding.
    serviceHost.AddServiceEndpoint(GetType(ICalculator), binding, "")

    ' Add a MEX endpoint.
    Dim smb As New ServiceMetadataBehavior()
    smb.HttpGetEnabled = True
    smb.HttpGetUrl = New Uri("http://localhost:8001/servicemodelsamples")
    serviceHost.Description.Behaviors.Add(smb)

    ' Open the ServiceHostBase to create listeners and start listening for messages.
    serviceHost.Open()

    ' The service can now be accessed.
    Console.WriteLine("The service is ready.")
    Console.WriteLine("Press <ENTER> to terminate service.")
    Console.WriteLine()
    Console.ReadLine()

    ' Close the ServiceHostBase to shutdown the service.
    serviceHost.Close()
End Using

Hinweise

Stellt Sitzungen sowie optional sortierte Nachrichtenübermittlung bereit. Diese implementierte Sitzung kann SOAP und Transportvermittler überqueren.

Jedes Bindungselement stellt einen Verarbeitungsschritt beim Senden und Empfangen von Nachrichten dar. Zur Laufzeit erstellen Bindungselemente die Kanalfactorys und die Listener, die notwendig sind, um ausgehende und eingehende Kanalstapel zum Senden und Empfangen von Nachrichten zu erstellen. Das ReliableSessionBindingElement bietet eine optionale Ebene im Stapel, die eine zuverlässige Sitzung zwischen Endpunkten herstellen und das Sitzungsverhalten konfigurieren kann.

Das ReliableSessionBindingElement wird für die Standardbindungen in der folgenden Tabelle zur Verfügung gestellt.

Bindung	Standard
NetTcpBinding	Aus
WSHttpBinding	Aus
WSDualHttpBinding	Aktiviert (erforderlich)

Konstruktoren

ReliableSessionBindingElement()	Initialisiert eine neue Instanz der ReliableSessionBindingElement-Klasse.
ReliableSessionBindingElement(Boolean)	Initialisiert eine neue Instanz der ReliableSessionBindingElement-Klasse, die angibt, ob bei der Nachrichtenübermittlung die Reihenfolge beibehalten werden soll, in der die Nachrichten gesendet werden.

Eigenschaften

AcknowledgementInterval	Ruft das Zeitintervall ab oder legt fest, wie lange ein Ziel wartet, bevor eine Bestätigung an die Nachrichtenquelle in zuverlässigen Kanälen gesendet wird, die von der Factory erstellt werden.
FlowControlEnabled	Ruft einen Wert ab, der angibt, ob in einer zuverlässigen Sitzung Flusssteuerung aktiviert ist, oder legt diesen fest.
InactivityTimeout	Ruft ein Zeitintervall ab oder legt fest, wie lange ein Dienst vor Schließung inaktiv bleibt.
MaxPendingChannels	Ruft die Höchstanzahl von Kanälen ab oder legt die Anzahl fest, die während der zuverlässigen Sitzung anstehen können.
MaxRetryCount	Ruft die maximale Anzahl der Übertragungsversuche ab oder legt die Anzahl der Versuche fest, die eine Nachricht während der zuverlässigen Sitzung hat.
MaxTransferWindowSize	Ruft die Höchstanzahl von Nachrichten ab oder legt die Anzahl fest, die im Sende- oder Empfangspuffer vorhanden sein kann.
Ordered	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob bei der Nachrichtenübermittlung die Reihenfolge beibehalten werden soll, in der die Nachrichten gesendet wurden.
ReliableMessagingVersion	Ruft die Version des vom Bindungselement angegebenen WS-ReliableMessaging ab oder legt sie fest.

Methoden

BuildChannelFactory<TChannel>(BindingContext)	Gibt eine Factory zurück, die einen Kanal eines angegebenen Typs erstellt, der eine zuverlässige Sitzung unterstützt.
BuildChannelListener<TChannel>(BindingContext)	Gibt einen Listener zurück, der einen Kanal eines angegebenen Typs akzeptiert, der eine zuverlässige Sitzung unterstützt.
BuildChannelListener<TChannel>(BindingContext)	Initialisiert einen Kanallistener, der Kanäle eines bestimmten Typs aus dem Bindungskontext annimmt. (Geerbt von BindingElement)
CanBuildChannelFactory<TChannel>(BindingContext)	Gibt einen Wert zurück, der angibt, ob eine Kanalfactory für den bereitgestellten Kanal und Kontext erstellt werden kann, die eine zuverlässige Sitzung unterstützt.
CanBuildChannelListener<TChannel>(BindingContext)	Gibt einen Wert zurück, der angibt, ob ein Kanallistener für den bereitgestellten Kanal und Kontext erstellt werden kann, der eine zuverlässige Sitzung unterstützt.
CanBuildChannelListener<TChannel>(BindingContext)	Gibt einen Wert zurück, der angibt, ob das Bindungselement einen Listener für einen bestimmten Typ von Kanal erstellen kann. (Geerbt von BindingElement)
Clone()	Erstellt eine Kopie des aktuellen Bindungselements der zuverlässigen Sitzung.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetProperty<T>(BindingContext)	Ruft eine Eigenschaft des angegebenen Typs aus dem Bindungskontext ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Explizite Schnittstellenimplementierungen

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext)

Ordnet die im Bindungselement der zuverlässigen Sitzung enthaltenen Informationen den WSDL-Elementen zu, die einem Remoteendpunkt ermöglichen, über eine zuverlässige Sitzung auf den Dienst zuzugreifen.

Gilt für