SoapDocumentMethodAttribute.Action SoapDocumentMethodAttribute.Action SoapDocumentMethodAttribute.Action SoapDocumentMethodAttribute.Action Property

Определение

Получает или задает поле HTTP-заголовка SOAPAction запроса SOAP.Gets or sets the SOAPAction HTTP header field of the SOAP request.

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.The SOAPAction HTTP header field of the SOAP request. Значение по умолчанию — http://tempuri.org/MethodName, где MethodName — это имя метода веб-службы XML.The default is http://tempuri.org/MethodName, where MethodName is the name of the XML Web service method.

Примеры

В следующем примере кода Action http://www.contoso.com/GetUserNameсвойству присваивается значение.The following code example sets the Action property to 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, указывающим цель запроса.Typically, the Action property is a URI indicating the intent of the request. Однако спецификация SOAP не накладывает ограничений на формат URI или любые правила, определяющие, является ли URI разрешаемым.However, the SOAP specification places no restrictions on the format of the URI, or any rules about whether the URI is resolvable. Присутствие и содержимое Action свойства может использоваться веб-серверами, такими как брандмауэры, для соответствующей фильтрации сообщений запросов SOAP по протоколу HTTP.The presence and content of the Action property can be used by Web servers, such as firewalls, to appropriately filter SOAP request messages in HTTP.

По умолчанию .NET Framework версии 1,1 публикует Action свойство soapAction в атрибуте soap:operation элемента для каждой поддерживаемой привязки SOAP в документах WSDL, созданных для веб-службы XML.By default, the .NET Framework version 1.1 publishes the Action property in the soapAction attribute of the soap:operation element for each supported SOAP binding in WSDL documents generated for an XML Web service. Дополнительные сведения см. в спецификации SOAP на веб-сайте W3C.For more information, see the SOAP specification on the W3C website.

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