SoapDocumentMethodAttribute.Action Свойство

Определение

Получает или задает поле HTTP-заголовка SOAPAction запроса 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

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

Поле HTTP-заголовка SOAPAction запроса SOAP. Значение по умолчанию — http://tempuri.org/MethodName, где 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.

Применяется к