Assembly Klasse

Definition

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Quelle:

Assembly.cs

Stellt eine Assembly dar, die ein wiederverwendbarer, in verschiedenen Versionen einsetzbarer und selbstbeschreibender Baustein einer Anwendung der Common Language Runtime (CLR) ist.

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::Serialization::ISerializable

public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.Serialization.ISerializable

type Assembly = class
    interface ICustomAttributeProvider
    interface ISerializable

Public MustInherit Class Assembly
Implements ICustomAttributeProvider, ISerializable

Vererbung

Object

Assembly

Abgeleitet

System.Reflection.Emit.AssemblyBuilder

Implementiert

ICustomAttributeProvider ISerializable

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die derzeit ausgeführte Assembly abrufen, eine instance eines in dieser Assembly enthaltenen Typs erstellen und eine der Methoden des Typs mit später Bindung aufrufen. Zu diesem Zweck definiert das Codebeispiel eine Klasse mit dem Namen Example, mit einer Methode namens SampleMethod. Der Konstruktor der -Klasse akzeptiert eine ganze Zahl, die verwendet wird, um den Rückgabewert der -Methode zu berechnen.

Das Codebeispiel veranschaulicht auch die Verwendung der GetName -Methode zum Abrufen eines AssemblyName Objekts, das zum Analysieren des vollständigen Namens der Assembly verwendet werden kann. Im Beispiel werden die Versionsnummer der Assembly, die CodeBase -Eigenschaft und die EntryPoint -Eigenschaft angezeigt.

using namespace System;
using namespace System::Reflection;
using namespace System::Security::Permissions;

[assembly:AssemblyVersionAttribute("1.0.2000.0")];

public ref class Example
{
private: 
    int factor;

public:
    Example(int f)
    {
        factor = f;
    }

    int SampleMethod(int x) 
    { 
        Console::WriteLine("\nExample->SampleMethod({0}) executes.", x);
        return x * factor;
    }
};

void main()
{
    Assembly^ assem = Example::typeid->Assembly;

    Console::WriteLine("Assembly Full Name:");
    Console::WriteLine(assem->FullName);

    // The AssemblyName type can be used to parse the full name.
    AssemblyName^ assemName = assem->GetName();
    Console::WriteLine("\nName: {0}", assemName->Name);
    Console::WriteLine("Version: {0}.{1}", 
        assemName->Version->Major, assemName->Version->Minor);

    Console::WriteLine("\nAssembly CodeBase:");
    Console::WriteLine(assem->CodeBase);

    // Create an object from the assembly, passing in the correct number and
    // type of arguments for the constructor.
    Object^ o = assem->CreateInstance("Example", false, 
        BindingFlags::ExactBinding, 
        nullptr, gcnew array<Object^> { 2 }, nullptr, nullptr);

    // Make a late-bound call to an instance method of the object.    
    MethodInfo^ m = assem->GetType("Example")->GetMethod("SampleMethod");
    Object^ ret = m->Invoke(o, gcnew array<Object^> { 42 });
    Console::WriteLine("SampleMethod returned {0}.", ret);

    Console::WriteLine("\nAssembly entry point:");
    Console::WriteLine(assem->EntryPoint);
}

/* This code example produces output similar to the following:

Assembly Full Name:
source, Version=1.0.2000.0, Culture=neutral, PublicKeyToken=null

Name: source
Version: 1.0

Assembly CodeBase:
file:///C:/sdtree/AssemblyClass/cpp/source.exe

Example->SampleMethod(42) executes.
SampleMethod returned 84.

Assembly entry point:
UInt32 _mainCRTStartup()
 */

using System;
using System.Reflection;
using System.Security.Permissions;

[assembly:AssemblyVersionAttribute("1.0.2000.0")]

public class Example
{
    private int factor;
    public Example(int f)
    {
        factor = f;
    }

    public int SampleMethod(int x)
    {
        Console.WriteLine("\nExample.SampleMethod({0}) executes.", x);
        return x * factor;
    }

    public static void Main()
    {
        Assembly assem = typeof(Example).Assembly;

        Console.WriteLine("Assembly Full Name:");
        Console.WriteLine(assem.FullName);

        // The AssemblyName type can be used to parse the full name.
        AssemblyName assemName = assem.GetName();
        Console.WriteLine("\nName: {0}", assemName.Name);
        Console.WriteLine("Version: {0}.{1}",
            assemName.Version.Major, assemName.Version.Minor);

        Console.WriteLine("\nAssembly CodeBase:");
        Console.WriteLine(assem.CodeBase);

        // Create an object from the assembly, passing in the correct number
        // and type of arguments for the constructor.
        Object o = assem.CreateInstance("Example", false,
            BindingFlags.ExactBinding,
            null, new Object[] { 2 }, null, null);

        // Make a late-bound call to an instance method of the object.
        MethodInfo m = assem.GetType("Example").GetMethod("SampleMethod");
        Object ret = m.Invoke(o, new Object[] { 42 });
        Console.WriteLine("SampleMethod returned {0}.", ret);

        Console.WriteLine("\nAssembly entry point:");
        Console.WriteLine(assem.EntryPoint);
    }
}

/* This code example produces output similar to the following:

Assembly Full Name:
source, Version=1.0.2000.0, Culture=neutral, PublicKeyToken=null

Name: source
Version: 1.0

Assembly CodeBase:
file:///C:/sdtree/AssemblyClass/cs/source.exe

Example.SampleMethod(42) executes.
SampleMethod returned 84.

Assembly entry point:
Void Main()
 */

Imports System.Reflection
Imports System.Security.Permissions

<assembly: AssemblyVersionAttribute("1.0.2000.0")>

Public Class Example
    Private factor As Integer
    
    Public Sub New(ByVal f As Integer) 
        factor = f
    End Sub 
    
    Public Function SampleMethod(ByVal x As Integer) As Integer 
        Console.WriteLine(vbCrLf & "Example.SampleMethod({0}) executes.", x)
        Return x * factor
    End Function 
    
    Public Shared Sub Main() 
        Dim assem As Assembly = GetType(Example).Assembly
        
        Console.WriteLine("Assembly Full Name:")
        Console.WriteLine(assem.FullName)
        
        ' The AssemblyName type can be used to parse the full name.
        Dim assemName As AssemblyName = assem.GetName()
        Console.WriteLine(vbLf + "Name: {0}", assemName.Name)
        Console.WriteLine("Version: {0}.{1}", assemName.Version.Major, _
            assemName.Version.Minor)
        
        Console.WriteLine(vbLf + "Assembly CodeBase:")
        Console.WriteLine(assem.CodeBase)
        
        ' Create an object from the assembly, passing in the correct number
        ' and type of arguments for the constructor.
        Dim o As Object = assem.CreateInstance("Example", False, _
            BindingFlags.ExactBinding, Nothing, _
            New Object() { 2 }, Nothing, Nothing)
        
        ' Make a late-bound call to an instance method of the object.    
        Dim m As MethodInfo = assem.GetType("Example").GetMethod("SampleMethod")
        Dim ret As Object = m.Invoke(o, New Object() { 42 })
        Console.WriteLine("SampleMethod returned {0}.", ret)
        
        Console.WriteLine(vbCrLf & "Assembly entry point:")
        Console.WriteLine(assem.EntryPoint)
    
    End Sub 
End Class 

' This code example produces output similar to the following:
'
'Assembly Full Name:
'source, Version=1.0.2000.0, Culture=neutral, PublicKeyToken=null
'
'Name: source
'Version: 1.0
'
'Assembly CodeBase:
'file:///C:/sdtree/AssemblyClass/vb/source.exe
'
'Example.SampleMethod(42) executes.
'SampleMethod returned 84.
'
'Assembly entry point:
'Void Main()
'

Hinweise

Verwenden Sie die Assembly -Klasse, um Assemblys zu laden, die Metadaten und bestandteile von Assemblys zu untersuchen, die in Assemblys enthaltenen Typen zu ermitteln und Instanzen dieser Typen zu erstellen.

Verwenden Sie die AppDomain.GetAssemblies -Methode, um ein Array von Assembly Objekten abzurufen, die die Assemblys darstellen, die derzeit in eine Anwendungsdomäne geladen werden (z. B. die Standardanwendungsdomäne eines einfachen Projekts).

Zum dynamischen Laden von Assemblys stellt die Assembly -Klasse die folgenden statischen Methoden (Shared Methoden in Visual Basic) bereit. Assemblys werden in die Anwendungsdomäne geladen, in der der Ladevorgang stattfindet.

• Die empfohlene Methode zum Laden von Assemblys besteht darin, die Load Methode zu verwenden, die die zu ladende Assembly anhand ihres Anzeigenamens identifiziert (z. B. "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). Die Suche nach der Assembly folgt den Unter How the Runtime Locates Assemblies beschriebenen Regeln.

• Mit den ReflectionOnlyLoad Methoden und ReflectionOnlyLoadFrom können Sie eine Assembly zur Reflexion, aber nicht zur Ausführung laden. Beispielsweise kann eine Assembly, die auf eine 64-Bit-Plattform abzielt, durch Code untersucht werden, der auf einer 32-Bit-Plattform ausgeführt wird.

• Die LoadFile Methoden und LoadFrom werden für seltene Szenarien bereitgestellt, in denen eine Assembly per Pfad identifiziert werden muss.

Verwenden Sie die GetExecutingAssembly -Methode, um ein Assembly Objekt für die derzeit ausgeführte Assembly abzurufen.

Viele Member der Assembly -Klasse stellen Informationen zu einer Assembly bereit. Beispiel:

• Die GetName -Methode gibt ein AssemblyName -Objekt zurück, das Zugriff auf die Teile des Assemblyanzeigenamens ermöglicht.

• Die GetCustomAttributes -Methode listet die Attribute auf, die auf die Assembly angewendet werden.

• Die GetFiles -Methode bietet Zugriff auf die Dateien im Assemblymanifest.

• Die GetManifestResourceNames -Methode stellt die Namen der Ressourcen im Assemblymanifest bereit.

Die GetTypes -Methode listet alle Typen in der Assembly auf. Die GetExportedTypes -Methode listet die Typen auf, die für Aufrufer außerhalb der Assembly sichtbar sind. Die GetType -Methode kann verwendet werden, um nach einem bestimmten Typ in der Assembly zu suchen. Die CreateInstance -Methode kann verwendet werden, um Instanzen von Typen in der Assembly zu suchen und zu erstellen.

Weitere Informationen zu Assemblys finden Sie im Abschnitt "Anwendungsdomänen und Assemblys" im Thema Anwendungsdomänen .

Konstruktoren

Assembly()

Initialisiert eine neue Instanz der Assembly-Klasse.

Eigenschaften

CodeBase	Veraltet. Ruft den ursprünglich angegebenen Speicherort der Assembly ab, z. B. in einem AssemblyName-Objekt.
CustomAttributes	Ruft eine Sammlung ab, die die benutzerdefinierten Attribute dieser Assembly enthält.
DefinedTypes	Ruft eine Auflistung der Typen ab, die in dieser Assembly definiert sind.
EntryPoint	Ruft den Einstiegspunkt dieser Assembly ab.
EscapedCodeBase	Veraltet. Ruft den URI einschließlich Escapezeichen ab, der die CodeBase darstellt.
ExportedTypes	Ruft eine Auflistung der in dieser Assembly definierten öffentlichen Typen ab, die außerhalb der Assembly sichtbar sind.
FullName	Ruft den Anzeigenamen der Assembly ab.
GlobalAssemblyCache	Veraltet. Ruft einen Wert ab, der angibt, ob die Assembly aus dem globalen Assemblycache geladen wurde (nur .NET Framework).
HostContext	Ruft den Hostkontext ab, mit dem die Assembly geladen wurde.
ImageRuntimeVersion	Ruft eine Zeichenfolge ab, die die Version der CLR darstellt, die in der Datei mit dem Manifest gespeichert wurde.
IsCollectible	Ruft einen Wert ab, der angibt, ob sich diese Assembly in einem entladbaren AssemblyLoadContext befindet.
IsDynamic	Ruft einen Wert ab, der angibt, ob die aktuelle Assembly dynamisch im aktuellen Prozess mithilfe der Reflektionsausgabe generiert wurde.
IsFullyTrusted	Ruft einen Wert ab, der angibt, ob die aktuelle Assembly mit voller Vertrauenswürdigkeit geladen wird.
Location	Ruft den vollständigen Pfad oder UNC-Pfad der geladenen Datei ab, die das Manifest enthält.
ManifestModule	Ruft das Modul mit dem Manifest für die aktuelle Assembly ab.
Modules	Ruft eine Sammlung ab, die die Module in dieser Assembly enthält.
ReflectionOnly	Ruft einen Boolean-Wert ab, der angibt, ob diese Assembly in den ReflectionOnly-Kontext geladen wurde.
SecurityRuleSet	Ruft einen Wert ab, der angibt, welchen Satz von Sicherheitsregeln die Common Language Runtime (CLR) für diese Assembly erzwingt.

Methoden

CreateInstance(String)	Sucht den angegebenen Typ aus dieser Assembly unter Berücksichtigung der Groß- und Kleinschreibung und erstellt mithilfe der Systemaktivierung eine Instanz dieses Typs.
CreateInstance(String, Boolean)	Sucht den angegebenen Typ aus dieser Assembly, unter wahlweiser Berücksichtigung der Groß- und Kleinschreibung, und erstellt mithilfe der Systemaktivierung eine Instanz dieses Typs.
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Sucht den angegebenen Typ aus dieser Assembly und erstellt mithilfe der Systemaktivierung eine Instanz dieses Typs. Hierbei ist die Berücksichtigung der Groß- und Kleinschreibung optional und Kultur, Argumente, Bindungs- und Aktivierungsattribute sind angegeben.
CreateQualifiedName(String, String)	Erstellt den Namen eines Typs, der durch den Anzeigenamen der zugehörigen Assembly gekennzeichnet wird.
Equals(Object)	Bestimmt, ob diese Assembly und das angegebene Objekt gleich sind.
GetAssembly(Type)	Ruft die derzeit geladene Assembly ab, in der der angegebene Typ definiert ist.
GetCallingAssembly()	Gibt die Assembly der Methode zurück, die die derzeit ausgeführte Methode aufgerufen hat.
GetCustomAttributes(Boolean)	Ruft alle benutzerdefinierten Attribute für diese Assembly ab.
GetCustomAttributes(Type, Boolean)	Ruft die benutzerdefinierten Attribute für diese Assembly ab, wie durch den Typ angegeben.
GetCustomAttributesData()	Gibt Informationen zu den Attributen zurück, die auf den aktuellen Assemblyangewendet wurden. Diese sind als CustomAttributeData -Objekte ausgedrückt.
GetEntryAssembly()	Ruft den in der Standardanwendungsdomäne ausführbaren Prozess ab. In anderen Anwendungsdomänen ist dies die erste ausführbare Datei, die von ExecuteAssembly(String) ausgeführt wurde.
GetExecutingAssembly()	Ruft die Assembly ab, die den derzeit ausgeführten Code enthält.
GetExportedTypes()	Ruft die in dieser Assembly definierten öffentlichen Typen ab, die außerhalb der Assembly sichtbar sind.
GetFile(String)	Ruft einen FileStream für die angegebene Datei in der Dateitabelle des Manifests dieser Assembly ab.
GetFiles()	Ruft die Dateien in der Dateitabelle eines Assemblymanifests ab.
GetFiles(Boolean)	Ruft die Dateien in der Dateitabelle eines Assemblymanifests ab und gibt an, ob Ressourcenmodule eingebunden werden sollen.
GetForwardedTypes()	Stellt eine Assembly dar, die ein wiederverwendbarer, in verschiedenen Versionen einsetzbarer und selbstbeschreibender Baustein einer Anwendung der Common Language Runtime (CLR) ist.
GetHashCode()	Gibt den Hashcode für diese Instanz zurück.
GetLoadedModules()	Ruft alle geladenen Module ab, die Bestandteil dieser Assembly sind.
GetLoadedModules(Boolean)	Ruft alle geladenen Module ab, die Bestandteil dieser Assembly sind, und gibt an, ob Ressourcenmodule eingebunden werden sollen.
GetManifestResourceInfo(String)	Gibt Informationen darüber zurück, wie die angegebene Ressource beibehalten wurde.
GetManifestResourceNames()	Gibt die Namen aller Ressourcen in dieser Assembly zurück.
GetManifestResourceStream(String)	Lädt die angegebene Manifestressource aus dieser Assembly.
GetManifestResourceStream(Type, String)	Lädt die angegebene Manifestressource, deren Gültigkeitsbereich durch den Namespace des angegebenen Typs festgelegt ist, aus dieser Assembly.
GetModule(String)	Ruft das angegebene Modul in dieser Assembly ab.
GetModules()	Ruft alle Module ab, die Bestandteil dieser Assembly sind.
GetModules(Boolean)	Ruft alle Module ab, die Bestandteil dieser Assembly sind, und gibt an, ob Ressourcenmodule eingebunden werden sollen.
GetName()	Ruft einen AssemblyName für diese Assembly ab.
GetName(Boolean)	Ruft einen AssemblyName für diese Assembly ab und legt die CodeBase fest, wie in copiedName angegeben.
GetObjectData(SerializationInfo, StreamingContext)	Veraltet. Ruft Serialisierungsinformationen mit allen Daten ab, die für das erneute Instanziieren dieser Assembly benötigt werden.
GetReferencedAssemblies()	Ruft die AssemblyName-Objekte für alle Assemblys ab, auf die diese Assembly verweist.
GetSatelliteAssembly(CultureInfo)	Ruft die Satellitenassembly für die angegebene Kultur ab.
GetSatelliteAssembly(CultureInfo, Version)	Ruft die angegebene Version der Satellitenassembly für die angegebene Kultur ab.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
GetType(String)	Ruft das Type-Objekt mit dem angegebenen Namen aus der Assemblyinstanz ab.
GetType(String, Boolean)	Ruft das Type-Objekt mit dem angegebenen Namen in der Assemblyinstanz ab und löst optional eine Ausnahme aus, wenn der Typ nicht gefunden wurde.
GetType(String, Boolean, Boolean)	Ruft das Type-Objekt mit dem angegebenen Namen in der Assemblyinstanz ab, wobei optional die Groß- und Kleinschreibung unberücksichtigt bleiben und optional eine Ausnahme ausgelöst werden kann, wenn der Typ nicht gefunden wurde.
GetTypes()	Ruft alle in dieser Assembly definierten Typen ab.
IsDefined(Type, Boolean)	Gibt an, ob ein angegebenes Attribut für die Assembly übernommen worden ist.
Load(AssemblyName)	Lädt eine Assembly bei Angabe von AssemblyName.
Load(Byte[])	Lädt die Assembly mit einem COFF (Common Object File Format)-Image, das eine ausgegebene Assembly enthält.
Load(Byte[], Byte[])	Lädt die Assembly mit einem COFF-Image (Common Object File Format), das eine ausgegebene Assembly und optional Symbole für die Assembly enthält.
Load(String)	Lädt einen Typ mit dem angegebenen Namen.
LoadFile(String)	Lädt den Inhalt einer Assemblydatei mit dem angegebenen Pfad.
LoadFrom(String)	Lädt eine Assembly bei Angabe des Anzeigenamens oder Pfads.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Lädt eine Assembly bei Angabe des Dateinamens bzw. -pfads, des Hashwerts und des Hashalgorithmus.
LoadModule(String, Byte[])	Lädt das Modul, das für diese Assembly intern ist, mit einem COFF (Common Object File Format)-Image, das ein ausgegebenes Modul enthält, oder eine Ressourcendatei.
LoadModule(String, Byte[], Byte[])	Lädt das Modul, das für diese Assembly intern ist, mit einem COFF (Common Object File Format)-Image, das ein ausgegebenes Modul enthält, oder eine Ressourcendatei. Die Rohdatenbytes, die die Symbole für das Modul darstellen, werden ebenfalls geladen.
LoadWithPartialName(String)	Veraltet. Lädt eine Assembly mithilfe eines unvollständigen Namens aus dem Anwendungsverzeichnis oder dem globalen Assemblycache.
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
ReflectionOnlyLoad(Byte[])	Veraltet. Lädt die Assembly aus einem COFF (Common Object File Format)-Image, das eine ausgegebene Assembly enthält. Die Assembly wird in den ReflectionOnly-Kontext der Anwendungsdomäne des Aufrufers geladen.
ReflectionOnlyLoad(String)	Veraltet. Lädt eine Assembly in den ReflectionOnly-Kontext, wenn ihr Anzeigename angegeben wurde.
ReflectionOnlyLoadFrom(String)	Veraltet. Lädt eine Assembly in den ReflectionOnly-Kontext, wenn ihr Pfad angegeben wurde.
ToString()	Gibt den vollständigen Namen der Assembly zurück, der auch als Anzeigename bezeichnet wird.
UnsafeLoadFrom(String)	Lädt eine Assembly in den Ladekontext und umgeht einige Sicherheitsüberprüfungen.

Operatoren

Equality(Assembly, Assembly)	Gibt an, ob zwei Assembly-Objekte gleich sind.
Inequality(Assembly, Assembly)	Gibt an, ob zwei Assembly-Objekte ungleich sind.

Ereignisse

ModuleResolve

Tritt ein, wenn das Klassenladeprogramm der Common Language Runtime einen Verweis auf ein internes Modul einer Assembly nicht auf normale Weise auflösen kann.

Erweiterungsmethoden

GetExportedTypes(Assembly)	Stellt eine Assembly dar, die ein wiederverwendbarer, in verschiedenen Versionen einsetzbarer und selbstbeschreibender Baustein einer Anwendung der Common Language Runtime (CLR) ist.
GetModules(Assembly)	Stellt eine Assembly dar, die ein wiederverwendbarer, in verschiedenen Versionen einsetzbarer und selbstbeschreibender Baustein einer Anwendung der Common Language Runtime (CLR) ist.
GetTypes(Assembly)	Stellt eine Assembly dar, die ein wiederverwendbarer, in verschiedenen Versionen einsetzbarer und selbstbeschreibender Baustein einer Anwendung der Common Language Runtime (CLR) ist.
GetCustomAttribute(Assembly, Type)	Ruft ein benutzerdefiniertes Attribut eines angegebenen Typs ab, der für eine angegebene Assembly angewendet wird.
GetCustomAttribute<T>(Assembly)	Ruft ein benutzerdefiniertes Attribut eines angegebenen Typs ab, der für eine angegebene Assembly angewendet wird.
GetCustomAttributes(Assembly)	Ruft eine Auflistung benutzerdefinierter Attribute ab, die für eine angegebene Assembly angewendet werden.
GetCustomAttributes(Assembly, Type)	Ruft eine Auflistung benutzerdefinierter Attribute eines angegebenen Typs ab, die für eine angegebene Assembly angewendet werden.
GetCustomAttributes<T>(Assembly)	Ruft eine Auflistung benutzerdefinierter Attribute eines angegebenen Typs ab, die für eine angegebene Assembly angewendet werden.
IsDefined(Assembly, Type)	Gibt an, ob irgend welche benutzerdefinierten Attribute eines bestimmten Typs auf eine angegebene Assembly angewendet werden.
TryGetRawMetadata(Assembly, Byte*, Int32)	Ruft den Metadatenabschnitt der Assembly zur Verwendung mit MetadataReaderab.

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen

• AppDomain
• AssemblyName
• Anwendungsdomänen