ICustomMarshaler インターフェイス

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

ICustomMarshaler インターフェイス

メソッド呼び出しを処理するためのカスタム ラッパーの提供を目的としています。

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

Visual Basic (宣言)

<ComVisibleAttribute(True)> _
Public Interface ICustomMarshaler

Visual Basic (使用法)

Dim instance As ICustomMarshaler

C#

[ComVisibleAttribute(true)] 
public interface ICustomMarshaler

C++

[ComVisibleAttribute(true)] 
public interface class ICustomMarshaler

J#

/** @attribute ComVisibleAttribute(true) */ 
public interface ICustomMarshaler

JScript

ComVisibleAttribute(true) 
public interface ICustomMarshaler

解説

カスタム マーシャラを使用するには、マーシャリングするパラメータまたはフィールドに MarshalAsAttribute を適用する必要があります。また、UnmanagedType.CustomMarshaler をそのコンストラクタに渡し、MarshalType を指定する必要があります。属性は、適切なカスタム マーシャラを識別して、適切なラッパーをアクティブ化します。共通言語ランタイムの相互運用サービスは、次に属性を検査して、引数をマーシャリングするときにカスタム マーシャラを作成します。これは、カスタム マーシャラの MarshalNativeToManaged メソッドと MarshalManagedToNative メソッドを呼び出して、呼び出しを処理するために正しいラッパーをアクティブ化します。

ICustomMarshaler インターフェイスの実装に加えて、カスタム マーシャラは GetInstance という static メソッドを実装する必要があります。このメソッドは、パラメータとして String を受け入れ、戻り型は ICustomMarshaler です。この static メソッドは、カスタム マーシャラのインスタンスをインスタンス化するために、共通言語ランタイムの COM 相互運用層によって呼び出されます。GetInstance に渡される文字列は、返されたカスタム マーシャラをカスタマイズするためにメソッドが使用できる Cookie です。

プラットフォーム

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

参照

関連項目
ICustomMarshaler メンバ
System.Runtime.InteropServices 名前空間