_Assembly.GetModule

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

Assembly.GetModule メソッド

このアセンブリから指定されたモジュールを取得します。

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

Visual Basic (宣言)

Public Function GetModule ( _
    name As String _
) As Module

Visual Basic (使用法)

Dim instance As Assembly
Dim name As String
Dim returnValue As Module

returnValue = instance.GetModule(name)

C#

public Module GetModule (
    string name
)

C++

public:
virtual Module^ GetModule (
    String^ name
) sealed

J#

public final Module GetModule (
    String name
)

JScript

public final function GetModule (
    name : String
) : Module

パラメータ

name

要求するモジュールの名前。

戻り値
要求するモジュール。モジュールが見つからない場合は null 参照 (Visual Basic では Nothing)。

例外

例外の種類	条件
ArgumentNullException	name パラメータが null 参照 (Visual Basic では Nothing) です。
ArgumentException	name パラメータが空の文字列 ("") です。
FileLoadException	見つかったファイルを読み込むことができませんでした。
FileNotFoundException	name は見つかりませんでした。
BadImageFormatException	name が有効なアセンブリではありません。

解説

このメソッドは、ファイル名に対して機能します。

Reflection.Emit 名前空間のクラスは、動的モジュールのスコープ名を生成します。スコープ名は、Module.ScopeName プロパティで定義できます。必要なモジュールの種類を Assembly.GetModule に渡します。たとえば、アセンブリ マニフェストを格納しているモジュールを取得するには、モジュールのスコープ名を GetModule に渡します。それ以外の場合は、モジュールのファイル名を渡します。byte[] パラメータをとる Load メソッドのいずれかによって読み込んだアセンブリには、モジュールが 1 つだけあります。このモジュールは、マニフェスト モジュールです。これらのモジュールを検索するときは、常にスコープ名を使用します。

型は、Module.GetType を使用して特定のモジュールから取得できます。マニフェストを含んでいるモジュールに対する Module.GetType の呼び出しによって、アセンブリ全体が検索されることはありません。どのモジュールに含まれているかに関係なく、アセンブリから型を取得するには、Assembly.GetType を呼び出す必要があります。

プラットフォーム

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

参照

関連項目
Assembly クラス
Assembly メンバ
System.Reflection 名前空間

_Assembly.GetModule メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

COM オブジェクトに、GetModule メソッドへのバージョンに依存しないアクセスが用意されています。

このメソッドは、CLS に準拠していません。  

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

Visual Basic (宣言)

Function GetModule ( _
    name As String _
) As Module

Visual Basic (使用法)

Dim instance As _Assembly
Dim name As String
Dim returnValue As Module

returnValue = instance.GetModule(name)

C#

Module GetModule (
    string name
)

C++

Module^ GetModule (
    String^ name
)

J#

Module GetModule (
    String name
)

JScript

function GetModule (
    name : String
) : Module

パラメータ

name

要求するモジュールの名前。

戻り値
要求するモジュール。モジュールが見つからない場合は null 参照 (Visual Basic では Nothing)。

解説

このメソッドは、アンマネージ コードからマネージ クラスにアクセスするためのメソッドであるため、マネージ コードからは呼び出さないでください。

GetModule メソッドは、このアセンブリから指定されたモジュールを取得します。

プラットフォーム

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

参照

関連項目
_Assembly インターフェイス
_Assembly メンバ
System.Runtime.InteropServices 名前空間
GetModule