SoapDocumentMethodAttribute.Action Свойство

Определение

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

System.Web.Services.Protocols

Сборка:

System.Web.Services.dll

Возвращает или задает SOAPAction поле заголовка HTTP запроса SOAP.

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

SOAPAction Поле заголовка HTTP запроса SOAP. Значение по умолчанию — http://tempuri.org/MethodNameимя метода веб-службы XML.

Примеры

Следующий пример кода задает Action для http://www.contoso.com/GetUserNameсвойства значение .

<%@ WebService Language="C#" class="MyUser" %>
 
 using System.Web.Services;
 using System.Web.Services.Protocols;
 
 public class MyUser : WebService {
 
      [ SoapDocumentMethod(Action="http://www.contoso.com/GetUserName")]
      public string GetUserName() {
       return User.Identity.Name;
      }
 }

<%@ WebService Language="VB" class="MyUser" %>

Imports System.Web.Services
Imports System.Web.Services.Protocols

Public Class MyUser
    Inherits WebService
        
    <SoapDocumentMethod(Action := "http://www.contoso.com/GetUserName")> _
    Public Function _
        GetUserName() As String
        
        Return User.Identity.Name
    End Function
End Class

Комментарии

Как правило, Action свойство является универсальным кодом ресурса (URI), указывающим намерение запроса. Однако спецификация SOAP не ограничивает формат URI или какие-либо правила о том, разрешается ли URI. Наличие и содержимое свойства можно использовать веб-серверами, такими как брандмауэры, для соответствующего Action фильтрации сообщений запросов SOAP в HTTP.

По умолчанию платформа .NET Framework версии 1.1 публикует Action свойство в soapAction атрибуте элемента для каждой soap:operation поддерживаемой привязки SOAP в документах WSDL, созданных для веб-службы XML. Дополнительные сведения см. в спецификации SOAP на веб-сайте W3C.