ReliableSessionBindingElement ReliableSessionBindingElement ReliableSessionBindingElement ReliableSessionBindingElement Class

Definition

Stellt das Bindungselement dar, das die Sende- und Empfangskanäle für eine zuverlässige Sitzung zwischen Endpunkten erzeugen kann.Represents the binding element that can produce the sending and receiving channels required for a reliable session between endpoints.

public ref class ReliableSessionBindingElement sealed : System::ServiceModel::Channels::BindingElement, System::ServiceModel::Description::IPolicyExportExtension
public sealed class ReliableSessionBindingElement : System.ServiceModel.Channels.BindingElement, System.ServiceModel.Description.IPolicyExportExtension
type ReliableSessionBindingElement = class
    inherit BindingElement
    interface IPolicyExportExtension
Public NotInheritable Class ReliableSessionBindingElement
Inherits BindingElement
Implements IPolicyExportExtension
Vererbung
ReliableSessionBindingElementReliableSessionBindingElementReliableSessionBindingElementReliableSessionBindingElement
Implementiert

Beispiele

Das ReliableSessionBindingElement kann jeder benutzerdefinierten Bindung hinzugefügt werden.The ReliableSessionBindingElement can be added to any custom binding. Dies wird mit den folgenden Konfigurationselementen erreicht.This is done using the following configuration elements.

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

Im folgenden Beispielcode wird die Verwendung des ReliableSessionBindingElement im Code veranschaulicht.The following sample code demonstrates how to use ReliableSessionBindingElement in code.

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.Provides sessions and optionally provides ordered message delivery. Diese implementierte Sitzung kann SOAP und Transportvermittler überqueren.This implemented session can cross SOAP and transport intermediaries.

Jedes Bindungselement stellt einen Verarbeitungsschritt beim Senden und Empfangen von Nachrichten dar.Each binding element represents a processing step when sending or receiving messages. 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.At runtime, binding elements create the channel factories and listeners that are necessary to build outgoing and incoming channel stacks required to send and receive messages. Das ReliableSessionBindingElement bietet eine optionale Ebene im Stapel, die eine zuverlässige Sitzung zwischen Endpunkten herstellen und das Sitzungsverhalten konfigurieren kann.The ReliableSessionBindingElement provides an optional layer in the stack that can establish a reliable session between endpoints and configure the behavior of this session.

Das ReliableSessionBindingElement wird für die Standardbindungen in der folgenden Tabelle zur Verfügung gestellt.The ReliableSessionBindingElement is provided on the standard bindings in the following table.

BindungBinding StandardDefault
NetTcpBinding AusOff
WSHttpBinding AusOff
WSDualHttpBinding Aktiviert (erforderlich)On (required)

Konstruktoren

ReliableSessionBindingElement() ReliableSessionBindingElement() ReliableSessionBindingElement() ReliableSessionBindingElement()

Initialisiert eine neue Instanz der ReliableSessionBindingElement-Klasse.Initializes a new instance of the ReliableSessionBindingElement class.

ReliableSessionBindingElement(Boolean) ReliableSessionBindingElement(Boolean) ReliableSessionBindingElement(Boolean) 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.Initializes a new instance of the ReliableSessionBindingElement class that specifies whether message delivery must preserve the order in which messages are sent.

Eigenschaften

AcknowledgementInterval AcknowledgementInterval AcknowledgementInterval 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.Gets or sets the interval of time that a destination waits before sending an acknowledgment to the message source on reliable channels that are created by the factory.

FlowControlEnabled FlowControlEnabled FlowControlEnabled FlowControlEnabled

Ruft einen Wert ab, der angibt, ob in einer zuverlässigen Sitzung Flusssteuerung aktiviert ist, oder legt diesen fest.Gets or sets a value that indicates whether the reliable session has flow control enabled.

InactivityTimeout InactivityTimeout InactivityTimeout InactivityTimeout

Ruft ein Zeitintervall ab oder legt fest, wie lange ein Dienst vor Schließung inaktiv bleibt.Gets or sets an interval of time that a service remains inactive before closing.

MaxPendingChannels MaxPendingChannels MaxPendingChannels MaxPendingChannels

Ruft die Höchstanzahl von Kanälen ab oder legt die Anzahl fest, die während der zuverlässigen Sitzung anstehen können.Gets or sets the largest number of channels that can be pending during the reliable session.

MaxRetryCount MaxRetryCount MaxRetryCount 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.Gets or sets the maximum number of times that a message attempts to be transferred during the reliable session.

MaxTransferWindowSize MaxTransferWindowSize MaxTransferWindowSize MaxTransferWindowSize

Ruft die Höchstanzahl von Nachrichten ab oder legt die Anzahl fest, die im Sende- oder Empfangspuffer vorhanden sein kann.Gets or sets the largest number of messages that can exist in either the send buffer or the receive buffer.

Ordered Ordered Ordered 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.Gets or sets a value that indicates whether message delivery must preserve the order in which messages are sent.

ReliableMessagingVersion ReliableMessagingVersion ReliableMessagingVersion ReliableMessagingVersion

Ruft die Version des vom Bindungselement angegebenen WS-ReliableMessaging ab oder legt sie fest.Gets or sets the version of WS-ReliableMessaging specified by the binding element.

Methoden

BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext) BuildChannelFactory<TChannel>(BindingContext)

Gibt eine Factory zurück, die einen Kanal eines angegebenen Typs erstellt, der eine zuverlässige Sitzung unterstützt.Returns a factory that creates a channel of a specified type that supports a reliable session.

BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext) BuildChannelListener<TChannel>(BindingContext)

Gibt einen Listener zurück, der einen Kanal eines angegebenen Typs akzeptiert, der eine zuverlässige Sitzung unterstützt.Returns a listener that accepts a channel of a specified type that supports a reliable session.

CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext) CanBuildChannelFactory<TChannel>(BindingContext) 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.Returns a value that indicates whether the channel factory can be built for the channel and context provided that can support a reliable session.

CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext) CanBuildChannelListener<TChannel>(BindingContext) 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.Returns a value that indicates whether the channel listener can be built for the channel and context provided that can support a reliable session.

Clone() Clone() Clone() Clone()

Erstellt eine Kopie des aktuellen Bindungselements der zuverlässigen Sitzung.Creates a copy of the current reliable session binding element.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetProperty<T>(BindingContext) GetProperty<T>(BindingContext) GetProperty<T>(BindingContext) GetProperty<T>(BindingContext)

Ruft eine Eigenschaft des angegebenen Typs aus dem Bindungskontext ab.Gets a property of the specified type from its binding context.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Explizite Schnittstellenimplementierungen

IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) IPolicyExportExtension.ExportPolicy(MetadataExporter, PolicyConversionContext) 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.Maps the information contained in the reliable session binding element into the WSDL elements that enable a remote endpoint to access the service with a reliable session.

Gilt für: