SoapMethodAttributeとは何？わかりやすく解説 Weblio辞書

すべての辞書から再検索する

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

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

SoapMethodAttribute クラス

メソッドの SOAP 生成および SOAP 処理をカスタマイズします。このクラスは継承できません。

名前空間: System.Runtime.Remoting.Metadata
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<AttributeUsageAttribute(AttributeTargets.Method)> _
<ComVisibleAttribute(True)> _
Public NotInheritable Class
 SoapMethodAttribute
    Inherits SoapAttribute

Visual Basic (使用法)

Dim instance As SoapMethodAttribute

[AttributeUsageAttribute(AttributeTargets.Method)] 
[ComVisibleAttribute(true)] 
public sealed class SoapMethodAttribute : SoapAttribute

C++

[AttributeUsageAttribute(AttributeTargets::Method)] 
[ComVisibleAttribute(true)] 
public ref class SoapMethodAttribute sealed
 : public SoapAttribute

/** @attribute AttributeUsageAttribute(AttributeTargets.Method) */ 
/** @attribute ComVisibleAttribute(true) */ 
public final class SoapMethodAttribute extends
 SoapAttribute

JScript

AttributeUsageAttribute(AttributeTargets.Method) 
ComVisibleAttribute(true) 
public final class SoapMethodAttribute extends
 SoapAttribute

解説

SoapMethodAttribute 属性のターゲットオブジェクトは、リモートから呼び出すことができるメソッドです。SOAP 生成および SOAP 処理をカスタマイズするために SoapMethodAttribute を適用します。この属性のプロパティを使用すると、プログラマは SOAPAction HTTP ヘッダーフィールドをカスタマイズして、SOAP HTTP 要求の意図を示すことができます。

使用例

SoapMethodAttribute クラスのメンバを使用して、メソッドの SOAP 生成と処理をカスタマイズする方法を次のコード例に示します。

using System;
using System.Runtime.Remoting.Metadata;
using System.Security.Permissions;

namespace ExampleNamespace
{
    public class ExampleClass
    {
        [SoapMethod(
             ResponseXmlElementName="ExampleResponseElement",
             ResponseXmlNamespace=
                "http://example.org/MethodResponseXmlNamespace"
,
             ReturnXmlElementName="HelloMessage",
             SoapAction="http://example.org/ExampleSoapAction#GetHello"
,
             XmlNamespace="http://example.org/MethodCallXmlNamespace")]
        public string GetHello(string
 name)
        {
            return "Hello, " + name;
        }
    }
}

public class Demo
{
[SecurityPermission(SecurityAction.Demand)]
    public static void Main(string[]
 args)
    {
        // Get the method info object for the GetHello method.
        System.Reflection.MethodBase getHelloMethod = 
            typeof(ExampleNamespace.ExampleClass).GetMethod("GetHello");

        // Print the XML namespace for the invocation of this method.
        string methodCallXmlNamespace = 
            System.Runtime.Remoting.SoapServices.
                GetXmlNamespaceForMethodCall(getHelloMethod);
        Console.WriteLine(
            "The XML namespace for the
 response of the method " +
            "GetHello in ExampleClass is {0}.",
            methodCallXmlNamespace);

        // Print the XML namespace for the response of this method.
        string methodResponseXmlNamespace =
            System.Runtime.Remoting.SoapServices.
                GetXmlNamespaceForMethodResponse(getHelloMethod);
        Console.WriteLine(
            "The XML namespace for the
 invocation of the method " +
            "GetHello in ExampleClass is {0}.",
            methodResponseXmlNamespace);

        // Print the SOAP action for this method.
        string getHelloSoapAction =
            System.Runtime.Remoting.SoapServices.
                GetSoapActionFromMethodBase(getHelloMethod);
        Console.WriteLine(
            "The SOAP action for the method " +
            "GetHello in ExampleClass is {0}.", 
            getHelloSoapAction);
    }
}

C++

#using <System.dll>
#using <System.Runtime.Remoting.dll>
using namespace System;
using namespace System::Runtime::Remoting::Metadata;

namespace ExampleNamespace
{
   public ref class ExampleClass
   {
   public:
      [SoapMethod(
         ResponseXmlElementName="ExampleResponseElement",
         ResponseXmlNamespace=
         "http://example.org/MethodResponseXmlNamespace",
         ReturnXmlElementName="HelloMessage",
         SoapAction="http://example.org/ExampleSoapAction#GetHello"
,
         XmlNamespace="http://example.org/MethodCallXmlNamespace")]
      String^ GetHello( String^ name )
      {
         return String::Format( L"Hello, {0}", name
 );
      }
   };

}

int main()
{
   
   // Get the method info object for the GetHello method.
   System::Reflection::MethodBase^ getHelloMethod = 
      ExampleNamespace::ExampleClass::typeid->GetMethod( L"GetHello"
 );
   
   // Print the XML namespace for the invocation of this method.
   String^ methodCallXmlNamespace =
      System::Runtime::Remoting::SoapServices::GetXmlNamespaceForMethodCall(
         getHelloMethod );
   Console::WriteLine( L"The XML namespace for
 the response of the method "
         L"GetHello in ExampleClass is {0}.", methodCallXmlNamespace
 );
   
   // Print the XML namespace for the response of this method.
   String^ methodResponseXmlNamespace =
      System::Runtime::Remoting::SoapServices::GetXmlNamespaceForMethodCall(
         getHelloMethod );
   Console::WriteLine( L"The XML namespace for
 the invocation of the method "
         L"GetHello in ExampleClass is {0}.", methodResponseXmlNamespace
 );
   
   // Print the SOAP action for this method.
   String^ getHelloSoapAction =
      System::Runtime::Remoting::SoapServices::GetXmlNamespaceForMethodCall(
         getHelloMethod );
   Console::WriteLine( L"The SOAP action for the method "
         L"GetHello in ExampleClass is {0}.", getHelloSoapAction
 );
}

継承階層

System.Object
   System.Attribute
     System.Runtime.Remoting.Metadata.SoapAttribute
      System.Runtime.Remoting.Metadata.SoapMethodAttribute

スレッドセーフ

この型の public static (Visual Basic では Shared) メンバはすべて、スレッドセーフです。インスタンスメンバの場合は、スレッドセーフであるとは限りません。

プラットフォーム

バージョン情報

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

参照

関連項目
SoapMethodAttribute メンバ
System.Runtime.Remoting.Metadata 名前空間

SoapMethodAttribute コンストラクタ

SoapMethodAttribute クラスの新しいインスタンスを初期化します。

名前空間: System.Runtime.Remoting.Metadata
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Sub New

Visual Basic (使用法)

Dim instance As New SoapMethodAttribute

public SoapMethodAttribute ()

C++

public:
SoapMethodAttribute ()

public SoapMethodAttribute ()

JScript

public function SoapMethodAttribute ()

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, 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

参照

SoapMethodAttribute プロパティ

パブリックプロパティパブリックプロパティ

	名前	説明
	Embedded	SOAP のシリアル化時に、型を入れ子にする必要があるかどうかを示す値を取得または設定します。 ( SoapAttribute から継承されます。)
	ResponseXmlElementName	ターゲットメソッドへのメソッドの応答に使用する XML 要素名を取得または設定します。
	ResponseXmlNamespace	ターゲットメソッドへのメソッドの応答に使用する XML 要素の名前空間を取得または設定します。
	ReturnXmlElementName	ターゲットメソッドからの戻り値に使用する XML 要素名を取得または設定します。
	SoapAction	このメソッドで送信された HTTP 要求で使用する SOAPAction ヘッダーフィールドを取得または設定します。このプロパティは現在実装されていません。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。 ( Attribute から継承されます。)
	UseAttribute	オーバーライドされます。現在の属性のターゲットを XML フィールドではなく XML 属性としてシリアル化するかどうかを示す値を取得または設定します。
	XmlNamespace	オーバーライドされます。ターゲットメソッドの、リモートメソッドの呼び出しのシリアル化中に使用する XML 名前空間を取得または設定します。

参照

SoapMethodAttribute メソッド

パブリックメソッドパブリックメソッド

	名前	説明
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用された指定した型のカスタム属性を取得します。 ( Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されたカスタム属性の配列を取得します。 ( Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュコードを返します。 ( Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 ( Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 ( Attribute から継承されます。)
	IsDefined	オーバーロードされます。指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されているかどうかを判断します。 ( Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 ( Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 ( Object から継承されます。)
	ToString	現在の Object を表す String を返します。 ( Object から継承されます。)

参照

SoapMethodAttribute メンバ

メソッドの SOAP 生成および SOAP 処理をカスタマイズします。このクラスは継承できません。

SoapMethodAttribute データ型で公開されるメンバを以下の表に示します。

パブリックコンストラクタ

	名前	説明
	SoapMethodAttribute

パブリックプロパティ

	名前	説明
	Embedded	SOAP のシリアル化時に、型を入れ子にする必要があるかどうかを示す値を取得または設定します。(SoapAttribute から継承されます。)
	ResponseXmlElementName	ターゲットメソッドへのメソッドの応答に使用する XML 要素名を取得または設定します。
	ResponseXmlNamespace	ターゲットメソッドへのメソッドの応答に使用する XML 要素の名前空間を取得または設定します。
	ReturnXmlElementName	ターゲットメソッドからの戻り値に使用する XML 要素名を取得または設定します。
	SoapAction	このメソッドで送信された HTTP 要求で使用する SOAPAction ヘッダーフィールドを取得または設定します。このプロパティは現在実装されていません。
	TypeId	派生クラスに実装されている場合は、この Attribute の一意の識別子を取得します。(Attribute から継承されます。)
	UseAttribute	オーバーライドされます。現在の属性のターゲットを XML フィールドではなく XML 属性としてシリアル化するかどうかを示す値を取得または設定します。
	XmlNamespace	オーバーライドされます。ターゲットメソッドの、リモートメソッドの呼び出しのシリアル化中に使用する XML 名前空間を取得または設定します。

パブリックメソッド

	名前	説明
	Equals	オーバーロードされます。 ( Attribute から継承されます。)
	GetCustomAttribute	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用された指定した型のカスタム属性を取得します。 (Attribute から継承されます。)
	GetCustomAttributes	オーバーロードされます。アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されたカスタム属性の配列を取得します。 (Attribute から継承されます。)
	GetHashCode	このインスタンスのハッシュコードを返します。 (Attribute から継承されます。)
	GetType	現在のインスタンスの Type を取得します。 (Object から継承されます。)
	IsDefaultAttribute	派生クラス内でオーバーライドされたときに、このインスタンスの値が派生クラスの既定値かどうかを示します。 (Attribute から継承されます。)
	IsDefined	オーバーロードされます。指定した型のカスタム属性が、アセンブリ、モジュール、型のメンバ、またはメソッドパラメータに適用されているかどうかを判断します。 (Attribute から継承されます。)
	Match	派生クラス内でオーバーライドされたときに、指定したオブジェクトとこのインスタンスが等しいかどうかを示す値を返します。 (Attribute から継承されます。)
	ReferenceEquals	指定した複数の Object インスタンスが同一かどうかを判断します。 (Object から継承されます。)
	ToString	現在の Object を表す String を返します。 (Object から継承されます。)

参照

SoapMethodAttributeとは？わかりやすく解説

SoapMethodAttribute クラス

SoapMethodAttribute コンストラクタ

.NET Framework

関連項目

SoapMethodAttribute プロパティ

関連項目

SoapMethodAttribute メソッド

関連項目

SoapMethodAttribute メンバ

関連項目

「SoapMethodAttribute」の関連用語


	© 2025 Microsoft.All rights reserved.

SoapMethodAttributeとは？ わかりやすく解説

SoapMethodAttribute クラス

SoapMethodAttribute コンストラクタ

.NET Framework

関連項目

SoapMethodAttribute プロパティ

関連項目

SoapMethodAttribute メソッド

関連項目

SoapMethodAttribute メンバ

関連項目

急上昇のことば

「SoapMethodAttribute」の関連用語

SoapMethodAttributeとは？わかりやすく解説