Assembly Klasse

Definition

public ref class Assembly abstract

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

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider

public ref class Assembly : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory

public abstract class Assembly

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

public abstract class Assembly : System.Reflection.ICustomAttributeProvider

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

type Assembly = class

type Assembly = class
    interface ICustomAttributeProvider
    interface ISerializable

type Assembly = class
    interface ICustomAttributeProvider

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
type Assembly = class
    interface _Assembly
    interface IEvidenceFactory
    interface ICustomAttributeProvider
    interface ISerializable

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Assembly = class
    interface _Assembly
    interface IEvidenceFactory
    interface ICustomAttributeProvider
    interface ISerializable

Public MustInherit Class Assembly

Public MustInherit Class Assembly
Implements ICustomAttributeProvider, ISerializable

Public MustInherit Class Assembly
Implements ICustomAttributeProvider

Public Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable

Public MustInherit Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable

Vererbung

Object

Assembly

Abgeleitet

System.Reflection.Emit.AssemblyBuilder

Attribute

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementiert

ICustomAttributeProvider ISerializable _Assembly IEvidenceFactory

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

Eigenschaften

Methoden

Operatoren

Ereignisse

Explizite Schnittstellenimplementierungen

Erweiterungsmethoden

Gilt für:

Threadsicherheit

Dieser Typ ist threadsicher.

Weitere Informationen

• AppDomain
• AssemblyName
• Anwendungsdomänen