SoapDocumentMethodAttribute.Action プロパティ

.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

C#

public string Action { get;
 set; }

C++

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

J#

/** @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

C#

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
SoapDocumentMethodAttribute クラス
SoapDocumentMethodAttribute メンバ
System.Web.Services.Protocols 名前空間