SoapDocumentMethodAttribute.Action 属性

定义

命名空间:

System.Web.Services.Protocols

程序集:

System.Web.Services.dll

获取或设置 SOAP 请求的 SOAPActionHTTP 标头字段。

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

SOAP 请求的 SOAPActionHTTP 标头字段。 默认值为 http://tempuri.org/MethodName，其中 MethodName 是 XML Web 服务方法的名称。

示例

下面的代码示例将 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 是否可解析的任何规则。 Web 服务器（如防火墙）可以使用 属性的状态和内容 Action 来适当地筛选 HTTP 中的 SOAP 请求消息。

默认情况下，.NET Framework版本 1.1 在soapAction为 XML Web 服务生成的 WSDL 文档中每个受支持的 SOAP 绑定的 元素的 属性soap:operation中发布 Action 属性。 有关详细信息，请参阅 W3C 网站上的 SOAP 规范。