OperationContractAttribute.Action Свойство

Определение

Пространство имен:

System.ServiceModel

Сборка:

System.ServiceModel.Primitives.dll

Сборка:

System.ServiceModel.dll

Возвращает или задает действие WS-Addressing сообщения запроса.

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

public string Action { get; set; }

member this.Action : string with get, set

Public Property Action As String

Значение свойства

String

Действие, которое должно использоваться при создании заголовка действия WS-Addressing.

Исключения

ArgumentNullException

Значение — null.

Примеры

В следующем примере представлена служба, которая использует свойства Action и ReplyAction для явного управления действиями SOAP входных и выходных (или ответных) сообщений и свойство Name для управления именем операции в метаданных. Наконец, приложение также использует значение «*» свойства Action, чтобы указать метод, который обрабатывает нераспознанные сообщения.

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

Служба, реализующая этот контракт, отправляет сообщения, которые выглядят примерно так, как в следующем примере:

<s:Envelope xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing" xmlns:s="http://www.w3.org/2003/05/soap-envelope">
  <s:Header>
    <a:Action s:mustUnderstand="1">http://Microsoft.WCF.Documentation/ResponseToOCAMethod</a:Action>
  </s:Header>
  <s:Body>
    <OCAMethodResponse xmlns="http://Microsoft.WCF.Documentation">
      <OCAMethodResult>The service greets you: Hello!</OCAMethodResult>
    </OCAMethodResponse>
  </s:Body>
</s:Envelope>

Комментарии

Action Используйте свойство для управления действием входного сообщения метода. Так как WCF использует это действие для отправки входящего сообщения соответствующему методу, сообщения, используемые в операции контракта, должны иметь уникальные действия. Значение действия по умолчанию — это сочетание пространства имен контракта (значение по умолчанию), "http://tempuri.org/"имя контракта (имя интерфейса или имя класса, если не используется явный интерфейс службы), имя операции и дополнительная строка ("Ответ"), если сообщение является коррелированного ответа. Это значение по умолчанию можно переопределить с помощью свойства Action.

Чтобы указать, что операция службы обрабатывает все сообщения, которые принимает служба, но которые не могут быть направлены в операцию службы, задайте значение "*" (звездочка). Этот тип операции, называемый обработчиком несопоставленных сообщений, должен иметь одну из указанных ниже сигнатур метода. В противном случае вызывается исключение InvalidOperationException.

• Операция службы может принимать только объект Message и возвращать объект Message.

• Операция службы может принимать только объект Message и не возвращать ничего (т. е. возвращать void).

Примечание

Контракт службы может содержать только одну операцию службы со значением "*" свойства Action. Любая группа контрактов служб, размещенных в том же прослушивании URI, которую реализует класс службы, может иметь множество операций службы со Action свойством", если IsInitiating свойство имеет значение false"*". Однако только одна из этих операций службы может иметь Action свойство "*" и IsInitiating свойство имеет значение true. Дополнительные сведения см. в статье IsInitiating.