OperationContractAttribute.ReplyAction Eigenschaft

Definition

Namespace:

System.ServiceModel

Assembly:

System.ServiceModel.Primitives.dll

Assembly:

System.ServiceModel.dll

Ruft ab oder legt den Wert der SOAP-Aktion für die Antwortnachricht des Vorgangs fest.

public:
 property System::String ^ ReplyAction { System::String ^ get(); void set(System::String ^ value); };

public string ReplyAction { get; set; }

member this.ReplyAction : string with get, set

Public Property ReplyAction As String

Eigenschaftswert

String

Der Wert der SOAP-Aktion für die Antwortnachtricht.

Ausnahmen

ArgumentNullException

ReplyAction ist null.

Beispiele

Im nachstehenden Beispiel ist ein Dienst dargestellt, der mit der Action-Eigenschaft und der ReplyAction-Eigenschaft die SOAP-Aktionen der eingehenden und ausgehenden (oder Antwort) Nachrichten ausdrücklich steuert. Zusätzlich wird mit der Name-Eigenschaft der Name des Vorgangs deklariert, wie er in den Metadaten verfügbar gemacht wurde.

using System;
using System.Collections.Generic;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.Text;

namespace Microsoft.WCF.Documentation
{
  [ServiceContract(Namespace="http://Microsoft.WCF.Documentation")]
  public interface ISampleService{

    [OperationContract(
      Action="http://Microsoft.WCF.Documentation/OperationContractMethod",
      Name="OCAMethod",
      ReplyAction="http://Microsoft.WCF.Documentation/ResponseToOCAMethod"
    )]
    string SampleMethod(string msg);

    [OperationContractAttribute(Action = "*")]
    void UnrecognizedMessageHandler(Message msg);
  }

  class SampleService : ISampleService
  {
    public string  SampleMethod(string msg)
    {
      Console.WriteLine("Called with: {0}", msg);
        return "The service greets you: " + msg;
    }

    public void UnrecognizedMessageHandler(Message msg)
    {
      Console.WriteLine("Unrecognized message: " + msg.ToString());
    }
  }
}

Imports System.ServiceModel
Imports System.ServiceModel.Channels
Imports System.Text

Namespace Microsoft.WCF.Documentation
  <ServiceContract(Namespace:="http://Microsoft.WCF.Documentation")> _
  Public Interface ISampleService

        <OperationContract(Action:="http://Microsoft.WCF.Documentation/OperationContractMethod", _
                           Name:="OCAMethod", ReplyAction:="http://Microsoft.WCF.Documentation/ResponseToOCAMethod")> _
        Function SampleMethod(ByVal msg As String) As String

    <OperationContractAttribute(Action := "*")> _
    Sub UnrecognizedMessageHandler(ByVal msg As Message)
  End Interface

  Friend Class SampleService
      Implements ISampleService
    Public Function SampleMethod(ByVal msg As String) As String Implements ISampleService.SampleMethod
      Console.WriteLine("Called with: {0}", msg)
         Return "The service greets you: " & msg
    End Function

    Public Sub UnrecognizedMessageHandler(ByVal msg As Message) Implements ISampleService.UnrecognizedMessageHandler
      Console.WriteLine("Unrecognized message: " & msg.ToString())
    End Sub
  End Class
End Namespace

Hinweise

Zusätzlich zur Angabe eines bestimmten Werts für den Aktionsheader der Antwortnachricht können Sie die Zeichenfolge "*" (ein Sternchen) angeben. Wenn Sie ein Sternchen im Dienst angeben, wird WCF angewiesen, der Nachricht keine Antwortaktion hinzuzufügen, was nützlich ist, wenn Sie nachrichten direkt programmieren. Das Angeben eines Sternchens in einer Clientanwendung weist WCF an, die Antwortaktion nicht zu überprüfen.