SoapExtension.Initialize メソッド

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

SoapExtension.Initialize メソッド

派生クラスでオーバーライドされると、SOAP 拡張機能は GetInitializer メソッドにキャッシュされているデータを使用して自らを初期化します。

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

Visual Basic (宣言)

Public MustOverride Sub
 Initialize ( _
    initializer As Object _
)

Visual Basic (使用法)

Dim instance As SoapExtension
Dim initializer As Object

instance.Initialize(initializer)

C#

public abstract void Initialize (
    Object initializer
)

C++

public:
virtual void Initialize (
    Object^ initializer
) abstract

J#

public abstract void Initialize (
    Object initializer
)

JScript

public abstract function Initialize (
    initializer : Object
)

パラメータ

initializer

ASP.NET によりキャッシュされる GetInitializer から返された Object。

解説

SOAP 拡張機能によるデータの初期化方法は以下のように 3 種類あり、それぞれ目的が異なっています。

• クラス コンストラクタ - クラス コンストラクタは SOAP 拡張機能がインスタンス化されるたびに呼び出され、通常はメンバ変数の初期化に使用されます。

• GetInitializer - GetInitializer。ただし、XML Web サービス メソッドへの SOAP 要求が最初に行われたときに 1 回だけ実行されます。XML Web サービス メソッドにカスタム属性が適用されている場合は、GetInitializer メソッドが呼び出されます。この呼び出しにより SOAP 拡張機能は、プロトタイプ情報について XML Web サービス メソッドの LogicalMethodInfo を調査したり、SoapExtensionAttribute の派生クラスから渡された拡張機能固有のデータにアクセスできます。戻り値は ASP.NET によりキャッシュされ、後続の Initialize メソッドに渡されます。したがって、GetInitializer で行われた初期化は、基本的に一度だけ実行されるようにカプセル化されます。

• Initialize - Initialize が呼び出されるたびに XML Web サービス メソッドに対して SOAP 要求が行われますが、GetInitializer で初期化された Object が渡されるという点でクラス コンストラクタより優れています。

メモ
構成ファイルで <soapExtensionTypes> 要素 を使用することにより、SoapExtensionAttribute から派生せずに SOAP 拡張を追加することもできます。詳細については、「<soapExtensionTypes> 要素」と「SOAP 拡張機能を使用した SOAP メッセージの変更」を参照してください。

使用例

GetInitializer メソッドでキャッシュされたデータを使用する方法を次の例に示します。

Visual Basic

' Receive the file name stored by GetInitializer and store it in a 
' member variable for this specific instance.
Public Overrides Sub Initialize(initializer
 As Object)
    m_filename = CStr(initializer)
End Sub

C#

// Receive the file name stored by GetInitializer and store it in
// a member variable for this specific instance.
public override void Initialize(object initializer)
 {
    filename = (string) initializer;
}

C++

   // Receive the file name stored by GetInitializer and store it in
   // a member variable for this specific instance.
public:
   virtual void Initialize( Object^ initializer ) override
   {
      filename = dynamic_cast<String^>(initializer);
   }

J#

// Receive the file name stored by GetInitializer and store it in
// a member variable for this specific instance.
public void Initialize(Object initializer)
{
    filename = (String)(initializer);
} //Initialize

プラットフォーム

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

参照

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