Assembly Klasse

Definition

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Quelle:

Assembly.cs

Stellt eine Assembly dar, bei der es sich um einen wiederverwendbaren, versionsfähigen und selbst beschreibenden Baustein einer Common Language Runtime-Anwendung handelt.

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 Instanz eines Typs erstellen, der in dieser Assembly enthalten ist, und eine der Methoden des Typs mit verspäteter Bindung aufrufen. Zu diesem Zweck definiert das Codebeispiel eine Klasse mit dem Namen Examplemit einer Methode mit dem Namen SampleMethod. Der Konstruktor der Klasse akzeptiert eine ganze Zahl, die zum Berechnen des Rückgabewerts der Methode verwendet wird.

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 Komponenten von Assemblys zu untersuchen, um die in Assemblys enthaltenen Typen zu ermitteln und Instanzen dieser Typen zu erstellen.

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

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

• Die empfohlene Methode zum Laden von Assemblys besteht darin, die Load-Methode zu verwenden, die die Assembly identifiziert, die mit dem Anzeigenamen geladen werden soll (z. B. "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). Die Suche nach der Assembly folgt den in How the Runtime Locates Assembliesbeschriebenen Regeln.

• Mit den methoden ReflectionOnlyLoad und ReflectionOnlyLoadFrom können Sie eine Assembly zur Spiegelung, aber nicht für die Ausführung laden. Beispielsweise kann eine Assembly, die auf eine 64-Bit-Plattform ausgerichtet ist, anhand von Code untersucht werden, der auf einer 32-Bit-Plattform ausgeführt wird.

• Die methoden LoadFile und LoadFrom werden für seltene Szenarien bereitgestellt, in denen eine Assembly anhand des Pfads identifiziert werden muss.

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

Viele Member der Assembly Klasse enthalten Informationen zu einer Assembly. Zum 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 nach 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 die Position der Assembly wie ursprünglich angegeben ab, z. B. in einem AssemblyName -Objekt.
CustomAttributes	Ruft eine Auflistung ab, die die benutzerdefinierten Attribute dieser Assembly enthält.
DefinedTypes	Ruft eine Auflistung der in dieser Assembly definierten Typen ab.
EntryPoint	Ruft den Einstiegspunkt dieser Assembly ab.
EscapedCodeBase	Veraltet. Ruft den URI ab, einschließlich Escapezeichen, die die Codebasis darstellt.
ExportedTypes	Ruft eine Auflistung der öffentlichen Typen ab, die in dieser Assembly definiert sind, 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 (nur.NET Framework) geladen wurde.
HostContext	Ruft den Hostkontext ab, mit dem die Assembly geladen wurde.
ImageRuntimeVersion	Ruft eine Zeichenfolge ab, die die Version der Common Language Runtime (CLR) darstellt, die in der Datei gespeichert ist, die das Manifest enthält.
IsCollectible	Ruft einen Wert ab, der angibt, ob diese Assembly in einem sammelbaren AssemblyLoadContextgehalten wird.
IsDynamic	Ruft einen Wert ab, der angibt, ob die aktuelle Assembly dynamisch im aktuellen Prozess mithilfe von Spiegelung emit 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-Speicherort der geladenen Datei ab, die das Manifest enthält.
ManifestModule	Ruft das Modul ab, das das Manifest für die aktuelle Assembly enthält.
Modules	Ruft eine Auflistung ab, die die Module in dieser Assembly enthält.
ReflectionOnly	Ruft einen Boolean Wert ab, der angibt, ob diese Assembly in den Nur-Spiegelungskontext geladen wurde.
SecurityRuleSet	Ruft einen Wert ab, der angibt, welche Sicherheitsregeln die Common Language Runtime (CLR) für diese Assembly erzwingt.

Methoden

CreateInstance(String)	Sucht den angegebenen Typ aus dieser Assembly und erstellt eine Instanz dieses Typs mithilfe des Systemaktivators unter Verwendung der Suche nach Groß-/Kleinschreibung.
CreateInstance(String, Boolean)	Sucht den angegebenen Typ aus dieser Assembly und erstellt eine Instanz davon mithilfe des Systemaktivators, bei der bei optionaler Suche nach Groß-/Kleinschreibung unterschieden wird.
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Sucht den angegebenen Typ aus dieser Assembly und erstellt eine Instanz davon mithilfe des Systemaktivators, bei der bei optionaler Suche nach Groß-/Kleinschreibung die angegebene Kultur, Argumente und Bindungs- und Aktivierungsattribute vorhanden sind.
CreateQualifiedName(String, String)	Erstellt den Namen eines Typs, der durch den Anzeigenamen der Assembly qualifiziert ist.
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 vom Typ angegeben.
GetCustomAttributesData()	Gibt Informationen zu den Attributen zurück, die auf das aktuelle Assemblyangewendet wurden , ausgedrückt als CustomAttributeData -Objekte.
GetEntryAssembly()	Ruft die Eintragsassembly für die ausgeführte Anwendung ab.
GetExecutingAssembly()	Ruft die Assembly ab, die den derzeit ausgeführten Code enthält.
GetExportedTypes()	Ruft die öffentlichen Typen ab, die in dieser Assembly definiert sind, die außerhalb der Assembly sichtbar sind.
GetFile(String)	Ruft eine 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, die angibt, ob Ressourcenmodule eingeschlossen werden sollen.
GetForwardedTypes()	Stellt eine Assembly dar, bei der es sich um einen wiederverwendbaren, versionsfähigen und selbst beschreibenden Baustein einer Common Language Runtime-Anwendung handelt.
GetHashCode()	Gibt den Hashcode für diese Instanz zurück.
GetLoadedModules()	Ruft alle geladenen Module ab, die Teil dieser Assembly sind.
GetLoadedModules(Boolean)	Ruft alle geladenen Module ab, die Teil dieser Assembly sind, und gibt an, ob Ressourcenmodule eingeschlossen werden sollen.
GetManifestResourceInfo(String)	Gibt Informationen dazu 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 im Bereich des Namespaces des angegebenen Typs aus dieser Assembly.
GetModule(String)	Ruft das angegebene Modul in dieser Assembly ab.
GetModules()	Ruft alle Module ab, die Teil dieser Assembly sind.
GetModules(Boolean)	Ruft alle Module ab, die Teil dieser Assembly sind, und gibt an, ob Ressourcenmodule eingeschlossen werden sollen.
GetName()	Ruft eine AssemblyName für diese Assembly ab.
GetName(Boolean)	Ruft eine AssemblyName für diese Assembly ab, wobei die Codebasis wie durch copiedNameangegeben festgelegt wird.
GetObjectData(SerializationInfo, StreamingContext)	Veraltet. Ruft Serialisierungsinformationen mit allen Daten ab, die erforderlich sind, um diese Assembly erneut zu ermitteln.
GetReferencedAssemblies()	Ruft die AssemblyName Objekte für alle Assemblys ab, auf die von dieser Assembly verwiesen wird.
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 die Type der aktuellen Instanz ab. (Geerbt von Object)
GetType(String)	Ruft das Type -Objekt mit dem angegebenen Namen in 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 wird.
GetType(String, Boolean, Boolean)	Ruft das Type -Objekt mit dem angegebenen Namen in der Assemblyinstanz ab, mit den Optionen zum Ignorieren des Falls und auslösen einer Ausnahme, wenn der Typ nicht gefunden wird.
GetTypes()	Ruft alle typen ab, die in dieser Assembly definiert sind.
IsDefined(Type, Boolean)	Gibt an, ob ein angegebenes Attribut auf die Assembly angewendet wurde.
Load(AssemblyName)	Lädt eine Assembly aufgrund der AssemblyName.
Load(Byte[])	Lädt die Assembly mit einem gemeinsamen Objektdateiformat (COFF)-basierten Image, das eine ausgelassene Assembly enthält.
Load(Byte[], Byte[])	Lädt die Assembly mit einem allgemeinen Objektdateiformat (COFF)-basierten Image, das eine ausgelassene Assembly enthält, optional auch Symbole für die Assembly.
Load(String)	Lädt eine Assembly mit dem angegebenen Namen.
LoadFile(String)	Lädt den Inhalt einer Assemblydatei auf dem angegebenen Pfad.
LoadFrom(String)	Lädt eine Assembly mit dem Dateinamen oder Pfad.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Lädt eine Assembly anhand des Dateinamens oder Pfads, des Hashwerts und des Hashalgorithmus.
LoadModule(String, Byte[])	Lädt das Modul intern in dieser Assembly mit einem gemeinsamen Objektdateiformat (COFF)-basierten Bild, das ein ausgegebenes Modul oder eine Ressourcendatei enthält.
LoadModule(String, Byte[], Byte[])	Lädt das Modul intern in dieser Assembly mit einem gemeinsamen Objektdateiformat (COFF)-basierten Bild, das ein ausgegebenes Modul oder eine Ressourcendatei enthält. Die unformatierten Bytes, die die Symbole für das Modul darstellen, werden ebenfalls geladen.
LoadWithPartialName(String)	Veraltet. Lädt eine Assembly aus dem Anwendungsverzeichnis oder aus dem globalen Assemblycache mit einem teilweisen Namen.
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ReflectionOnlyLoad(Byte[])	Veraltet. Lädt die Assembly aus einem gängigen Objektdateiformat (COFF)-basierten Image, das eine ausgegebene Assembly enthält. Die Assembly wird in den Spiegelungskontext der Anwendungsdomäne des Aufrufers geladen.
ReflectionOnlyLoad(String)	Veraltet. Lädt eine Assembly in den Nur-Spiegelungskontext unter Angabe des Anzeigenamens.
ReflectionOnlyLoadFrom(String)	Veraltet. Lädt eine Assembly in den Nur-Spiegelungskontext, je nach Pfad.
ToString()	Gibt den vollständigen Namen der Assembly zurück, der auch als Anzeigename bezeichnet wird.
UnsafeLoadFrom(String)	Lädt eine Assembly in den Kontext "Laden aus", wobei einige Sicherheitsprüfungen umgangen werden.

Operatoren

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

Ereignisse

ModuleResolve

Tritt auf, wenn das Klassenladeprogramm für common language runtime keinen Verweis auf ein internes Modul einer Assembly auf normalem Wege auflösen kann.

Erweiterungsmethoden

GetExportedTypes(Assembly)	Stellt eine Assembly dar, bei der es sich um einen wiederverwendbaren, versionsfähigen und selbst beschreibenden Baustein einer Common Language Runtime-Anwendung handelt.
GetModules(Assembly)	Stellt eine Assembly dar, bei der es sich um einen wiederverwendbaren, versionsfähigen und selbst beschreibenden Baustein einer Common Language Runtime-Anwendung handelt.
GetTypes(Assembly)	Stellt eine Assembly dar, bei der es sich um einen wiederverwendbaren, versionsfähigen und selbst beschreibenden Baustein einer Common Language Runtime-Anwendung handelt.
GetCustomAttribute(Assembly, Type)	Ruft ein benutzerdefiniertes Attribut eines angegebenen Typs ab, das auf eine angegebene Assembly angewendet wird.
GetCustomAttribute<T>(Assembly)	Ruft ein benutzerdefiniertes Attribut eines angegebenen Typs ab, das auf eine angegebene Assembly angewendet wird.
GetCustomAttributes(Assembly)	Ruft eine Auflistung von benutzerdefinierten Attributen ab, die auf eine angegebene Assembly angewendet werden.
GetCustomAttributes(Assembly, Type)	Ruft eine Auflistung von benutzerdefinierten Attributen eines angegebenen Typs ab, die auf eine angegebene Assembly angewendet werden.
GetCustomAttributes<T>(Assembly)	Ruft eine Auflistung von benutzerdefinierten Attributen eines angegebenen Typs ab, die auf eine angegebene Assembly angewendet werden.
IsDefined(Assembly, Type)	Gibt an, ob benutzerdefinierte Attribute eines angegebenen Typs auf eine angegebene Assembly angewendet werden.
TryGetRawMetadata(Assembly, Byte*, Int32)	Ruft den Metadatenabschnitt der Assembly für die Verwendung mit MetadataReaderab.

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen

• AppDomain
• AssemblyName
• Anwendungsdomänen