Vorgehensweise: Austauschen von Nachrichten innerhalb einer zuverlässigen Sitzung

Artikel
06/22/2023

Dieses Thema enthält einen Überblick über die Schritte zum Aktivieren einer zuverlässigen Sitzung mithilfe einer der vom System bereitgestellten Bindungen, die eine solche Sitzung zwar unterstützen, dies jedoch nicht standardmäßig. Eine zuverlässige Sitzung aktivieren Sie zwingend mit Code oder deklarativ in Ihrer Konfigurationsdatei. In dieser Prozedur werden die Client- und die Dienstkonfigurationsdatei verwendet, um die zuverlässige Sitzung zu aktivieren und um festzulegen, dass die Nachrichten in der Reihenfolge empfangen werden, in der sie gesendet wurden.

Der wesentliche Teil dieser Prozedur ist der, dass das endpoint-Konfigurationselement ein bindingConfiguration-Attribut enthält, das auf eine benutzerdefinierte Bindungskonfiguration mit dem Namen Binding1 verweist. Das <Bindungskonfigurationselement> verweist auf diesen Namen, um zuverlässige Sitzungen zu ermöglichen, indem das enabled- Attribut des <reliableSession-Elements> auf true festgelegt wird. Sie geben die Zusicherung einer Zustellung in der richtigen Reihenfolge für die zuverlässige Sitzung an, indem Sie das ordered-Attribut auf true festlegen.

Den Quelltext dieses Beispiels finden Sie unter WS Zuverlässige Sitzung.

Konfigurieren Sie den Dienst mit einer WSHttpBinding, um eine zuverlässige Sitzung zu verwenden

Definieren Sie einen Dienstvertrag für den Diensttyp.

[ServiceContract]
public interface ICalculator
{
    [OperationContract]
    double Add(double n1, double n2);
    [OperationContract]
    double Subtract(double n1, double n2);
    [OperationContract]
    double Multiply(double n1, double n2);
    [OperationContract]
    double Divide(double n1, double n2);
}

Implementieren Sie den Dienstvertrag in einer Dienstklasse. Beachten Sie, dass die Adresse oder die Bindungsinformationen in der Implementierung des Diensts nicht angegeben werden. Sie müssen keinen Code schreiben, um die Adress- oder Bindungsinformationen aus der Konfigurationsdatei abzurufen.

public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        return n1 + n2;
    }
    public double Subtract(double n1, double n2)
    {
        return n1 - n2;
    }
    public double Multiply(double n1, double n2)
    {
        return n1 * n2;
    }
    public double Divide(double n1, double n2)
    {
        return n1 / n2;
    }
}

Erstellen Sie eine Web.config-Datei, um einen Endpunkt für CalculatorService zu konfigurieren, der WSHttpBinding mit aktivierter zuverlässiger Sitzung und erforderlicher Zustellung der Nachrichten in der richtigen Reihenfolge verwendet.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>

    <services>
      <service name="Microsoft.ServiceModel.Samples.CalculatorService">

        <!--
             This endpoint is exposed at the base address provided by
             host: http://localhost/servicemodelsamples/service.svc

             Specify wsHttpBinding binding and a binding configuration
             to use
        -->
        <endpoint address=""
                  binding="wsHttpBinding"
                  bindingConfiguration="Binding1"
                  contract="Microsoft.ServiceModel.Samples.ICalculator" />

        <!--
          The mex endpoint is exposed at
          http://localhost/servicemodelsamples/service.svc/mex
        -->
        <endpoint address="mex"
                  binding="mexHttpBinding"
                  contract="IMetadataExchange" />
      </service>
    </services>

    <!--
         Configures WSHttpBinding for reliable sessions with ordered
         delivery.
    -->
    <bindings>
      <wsHttpBinding>
        <binding name="Binding1">
          <reliableSession enabled="true" ordered="true" />
        </binding>
      </wsHttpBinding>
    </bindings>

  </system.serviceModel>
</configuration>

Erstellen Sie eine Service.svc-Datei, die die folgende Zeile enthält:
```
<%@ServiceHost language=c# Service="CalculatorService" %>
```
Stellen Sie die Datei Service.svc in das virtuelle IIS-Verzeichnis.

Konfigurieren Sie den Client mit einer WSHttpBinding für die Verwendung einer zuverlässigen Sitzung

Verwenden Sie das ServiceModel Metadata Utility-Tool (Svcutil.exe) aus der Befehlszeile, um Code aus Dienstmetadaten zu generieren:
```
Svcutil.exe <service's Metadata Exchange (MEX) address or HTTP GET address>
```

Der generierte Client enthält die ICalculator-Schnittstelle, die den Dienstvertrag definiert, dem die Clientimplementierung entsprechen muss.

//Generated interface defining the ICalculator contract	
[System.ServiceModel.ServiceContractAttribute(
Namespace="http://Microsoft.ServiceModel.Samples",
ConfigurationName="Microsoft.ServiceModel.Samples.ICalculator")]
public interface ICalculator
{
    [System.ServiceModel.OperationContractAttribute(
    Action="http://Microsoft.ServiceModel.Samples/ICalculator/Add",
    ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/AddResponse")]
    double Add(double n1, double n2);

    [System.ServiceModel.OperationContractAttribute(
    Action="http://Microsoft.ServiceModel.Samples/ICalculator/Subtract",
    ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/SubtractResponse")]
    double Subtract(double n1, double n2);

    [System.ServiceModel.OperationContractAttribute(
    Action="http://Microsoft.ServiceModel.Samples/ICalculator/Multiply",
    ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/MultiplyResponse")]
    double Multiply(double n1, double n2);

    [System.ServiceModel.OperationContractAttribute(
    Action="http://Microsoft.ServiceModel.Samples/ICalculator/Divide",
    ReplyAction="http://Microsoft.ServiceModel.Samples/ICalculator/DivideResponse")]
    double Divide(double n1, double n2);
}

Die generierte Clientanwendung enthält außerdem die Implementierung von ClientCalculator. Beachten Sie, dass die Adresse und die Bindungsinformationen in der Implementierung des Diensts nirgendwo angegeben werden. Sie müssen keinen Code schreiben, um die Adress- oder Bindungsinformationen aus der Konfigurationsdatei abzurufen.

// Implementation of the CalculatorClient
public partial class CalculatorClient :
    System.ServiceModel.ClientBase<Microsoft.ServiceModel.Samples.ICalculator>,
    Microsoft.ServiceModel.Samples.ICalculator
{
    public CalculatorClient()
    {
    }

    public CalculatorClient(string endpointConfigurationName) :
        base(endpointConfigurationName)
    {
    }

    public CalculatorClient(string endpointConfigurationName, string remoteAddress) :
        base(endpointConfigurationName, remoteAddress)
    {
    }

    public CalculatorClient(string endpointConfigurationName,
        System.ServiceModel.EndpointAddress remoteAddress) :
        base(endpointConfigurationName, remoteAddress)
    {
    }

    public CalculatorClient(System.ServiceModel.Channels.Binding binding,
        System.ServiceModel.EndpointAddress remoteAddress) :
        base(binding, remoteAddress)
    {
    }

    public double Add(double n1, double n2)
    {
        return base.Channel.Add(n1, n2);
    }

    public double Subtract(double n1, double n2)
    {
        return base.Channel.Subtract(n1, n2);
    }

    public double Multiply(double n1, double n2)
    {
        return base.Channel.Multiply(n1, n2);
    }

    public double Divide(double n1, double n2)
    {
        return base.Channel.Divide(n1, n2);
    }
}

Svcutil.exe generiert auch die Konfiguration für den Client, der die WSHttpBinding-Klasse verwendet. Benennen Sie die Konfigurationsdatei App.config, wenn Sie Visual Studio verwenden.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>

    <client>
      <!-- 
        Specify wsHttpBinding binding and a binding configuration 
        to use
      -->
      <endpoint 
          address="http://localhost/servicemodelsamples/service.svc" 
          binding="wsHttpBinding" 
          bindingConfiguration="Binding1" 
          contract="Microsoft.ServiceModel.Samples.ICalculator" />
    </client>

    <!-- 
      Configures WSHttpBinding for reliable sessions with ordered 
      delivery
    -->
    <bindings>
      <wsHttpBinding>
        <binding name="Binding1">
          <reliableSession enabled="true" ordered="true" />
        </binding>
      </wsHttpBinding>
    </bindings>

  </system.serviceModel>
</configuration>

Erstellen Sie eine Instanz des ClientCalculator in einer Anwendung, und rufen Sie dann die Dienstvorgänge auf.

//Client implementation code.
class Client
{
    static void Main()
    {
        // Create a client with given client endpoint configuration
        CalculatorClient client = new CalculatorClient();

        // Call the Add service operation.
        double value1 = 100.00D;
        double value2 = 15.99D;
        double result = client.Add(value1, value2);
        Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

        // Call the Subtract service operation.
        value1 = 145.00D;
        value2 = 76.54D;
        result = client.Subtract(value1, value2);
        Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

        // Call the Multiply service operation.
        value1 = 9.00D;
        value2 = 81.25D;
        result = client.Multiply(value1, value2);
        Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

        // Call the Divide service operation.
        value1 = 22.00D;
        value2 = 7.00D;
        result = client.Divide(value1, value2);
        Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

        //Closing the client gracefully closes the connection and cleans up resources
        client.Close();

        Console.WriteLine();
        Console.WriteLine("Press <ENTER> to terminate client.");
        Console.ReadLine();
    }
}

Kompilieren Sie den Code, und führen Sie den Client aus.

Beispiel

Mehrere der vom System bereitgestellten Bindungen unterstützen standardmäßig zuverlässige Sitzungen. Dazu gehören:

Ein Beispiel für die Erstellung einer benutzerdefinierten Bindung, die zuverlässige Sitzungen unterstützt, finden Sie unter Vorgehensweise: Erstellen einer benutzerdefinierten verlässlichen Sitzungsbindung mit HTTPS.

Siehe auch

Zuverlässige Sitzungen

Vorgehensweise: Austauschen von Nachrichten innerhalb einer zuverlässigen Sitzung

Konfigurieren Sie den Dienst mit einer WSHttpBinding, um eine zuverlässige Sitzung zu verwenden

Konfigurieren Sie den Client mit einer WSHttpBinding für die Verwendung einer zuverlässigen Sitzung

Beispiel

Siehe auch

Zusätzliche Ressourcen