Freigeben über

So erstellen Sie einen Anforderungs-Antwort-Vertrag

Ein Anforderungsantwort-Vertrag gibt eine Methode an, die eine Antwort zurückgibt. Die Antwort muss gemäß den Bedingungen dieses Vertrags an die Anfrage gesendet und korreliert werden. Auch wenn die Methode keine Antwort (void in C# oder in Sub Visual Basic) zurückgibt, erstellt und sendet die Infrastruktur eine leere Nachricht an den Aufrufer. Um das Senden einer leeren Antwortnachricht zu verhindern, verwenden Sie einen unidirektionalen Vertrag für die Operation.

So erstellen Sie einen Anforderungsantwort-Vertrag

  1. Erstellen Sie eine Schnittstelle in der Programmiersprache Ihrer Wahl.

  2. Wenden Sie das ServiceContractAttribute Attribut auf die Schnittstelle an.

  3. Wenden Sie das OperationContractAttribute Attribut auf jede Methode an, die Clients aufrufen können.

  4. Dies ist optional. Legen Sie den Wert der IsOneWay Eigenschaft auf true fest, um das Senden einer leeren Antwortnachricht zu verhindern. Standardmäßig sind alle Vorgänge Anforderungsantwortverträge.

Beispiel

Im folgenden Beispiel wird ein Vertrag für einen Rechnerdienst definiert, der die Methoden Add und Subtract bereitstellt. Die Multiply Methode ist nicht Teil des Vertrags, da sie nicht durch die OperationContractAttribute Klasse gekennzeichnet ist und daher für Clients nicht zugänglich ist.

using System.ServiceModel;

[ServiceContract]
public interface ICalculator
{
    [OperationContract]
    // It would be equivalent to write explicitly:
    // [OperationContract(IsOneWay=false)]
    int Add(int a, int b);

    [OperationContract]
    int Subtract(int a, int b);

    int Multiply(int a, int b)
}

  • Weitere Informationen zum Angeben von Vorgangsverträgen finden Sie in der OperationContractAttribute Klasse und der IsOneWay Eigenschaft.

  • Durch das Anwenden der Attribute ServiceContractAttribute und OperationContractAttribute führt dies nach der Bereitstellung des Diensts zur automatischen Generierung von Dienstvertragsdefinitionen in einem WSDL-Dokument (Web Services Description Language). Das Dokument wird heruntergeladen, indem ?wsdl an die HTTP-Basisadresse für den Dienst angefügt wird. Beispiel: http://microsoft/CalculatorService?wsdl

Siehe auch

  • Last updated on