Freigeben über


Assembly.GetModule-Methode

Ruft das angegebene Modul in dieser Assembly ab.

Namespace: System.Reflection
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Function GetModule ( _
    name As String _
) As Module
'Usage
Dim instance As Assembly
Dim name As String
Dim returnValue As Module

returnValue = instance.GetModule(name)
public Module GetModule (
    string name
)
public:
virtual Module^ GetModule (
    String^ name
) sealed
public final Module GetModule (
    String name
)
public final function GetModule (
    name : String
) : Module

Parameter

  • name
    Der Name des Moduls, das angefordert wird.

Rückgabewert

Das angeforderte Modul oder NULL (Nothing in Visual Basic), wenn das Modul nicht gefunden wurde.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentNullException

Der name-Parameter ist NULL (Nothing in Visual Basic).

ArgumentException

Der name-Parameter ist eine leere Zeichenfolge ("").

FileLoadException

Eine gefundene Datei konnte nicht geladen werden.

FileNotFoundException

name wurde nicht gefunden.

BadImageFormatException

name ist keine gültige Assembly.

Hinweise

Diese Methode ist für Dateinamen geeignet.

Klassen im Reflection.Emit-Namespace geben den Bereichsnamen für ein dynamisches Modul aus. Der Bereichsname kann durch die Module.ScopeName-Eigenschaft bestimmt werden. Übergeben Sie die Art des gewünschten Moduls an Assembly.GetModule. Wenn es sich hierbei z. B. um das Modul handelt, das das Assemblymanifest enthält, übergeben Sie den Bereichsnamen des Moduls an GetModule. Andernfalls übergeben Sie den Dateinamen des Moduls. Mithilfe einer der Load-Methoden geladene Assemblys mit einem byte[]-Parameter verfügen über nur ein Modul. Dieses Modul ist das Manifestmodul. Suchen Sie diese Module stets unter Verwendung des Bereichsnamens.

Ein Typ kann unter Verwendung von Module.GetType aus einem bestimmten Modul abgerufen werden. Der Aufruf von Module.GetType für das Modul, das das Manifest enthält, initiiert keine Suche in der gesamten Assembly. Um einen Typ aus einer Assembly abzurufen, müssen Sie Assembly.GetType aufrufen, unabhängig davon, in welchem Modul sich die Assembly befindet.

Plattformen

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 unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Assembly-Klasse
Assembly-Member
System.Reflection-Namespace