SoapDocumentMethodAttribute.Action プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

SoapDocumentMethodAttribute.Action プロパティ

SOAP 要求の SOAPAction HTTP ヘッダーフィールドを取得または設定します。

名前空間: System.Web.Services.Protocols
アセンブリ: System.Web.Services (system.web.services.dll 内)
構文

Visual Basic (宣言)

Public Property Action As
 String

Visual Basic (使用法)

Dim instance As SoapDocumentMethodAttribute
Dim value As String

value = instance.Action

instance.Action = value

public string Action { get;
 set; }

C++

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

/** @property */
public String get_Action ()

/** @property */
public void set_Action (String value)

JScript

public function get Action
 () : String

public function set Action
 (value : String)

プロパティ値
SOAP 要求の SOAPAction HTTP ヘッダーフィールド。既定値は http://tempuri.org/MethodName です。MethodName は XML Web サービスメソッドの名前です。

解説

通常、Action プロパティは、要求の意図を示す URI です。ただし、SOAP 仕様では、URI の書式や、URI を解決できるかどうかに関する規則について制限は規定されていません。Action プロパティの存在と内容は、ファイアウォールなどの Web サーバーによって、HTTP 上の SOAP 要求メッセージを適切にフィルタ処理するために使用できます。

既定で .NET Framework Version 1.1 は、XML Web サービス用に生成された WSDL ドキュメント内のサポートされている SOAP バインディングごとに、Action プロパティを soap:operation 要素の soapAction 属性に発行します。SOAP 仕様の詳細については、W3C Web サイト (http://www.w3.org/TR/SOAP) を参照してください。

使用例

Action プロパティを http://www.contoso.com/GetUserName に設定するコード例を次に示します。

Visual Basic

<%@ 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

<%@ 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;
      }
 }