Assembly Klasa

Definicja

Przestrzeń nazw:

System.Reflection

Zestaw:

System.Runtime.dll

Reprezentuje zestaw, który jest wielokrotnego użytku, wersjonowalny i samoopisujący blok konstrukcyjny aplikacji środowiska uruchomieniowego języka wspólnego.

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

Dziedziczenie

Object

Assembly

Pochodne

System.Reflection.Emit.AssemblyBuilder

Implementuje

ICustomAttributeProvider ISerializable

Przykłady

Poniższy przykład kodu pokazuje, jak uzyskać aktualnie wykonywany zestaw, utworzyć wystąpienie typu zawartego w tym zestawie i wywołać jedną z metod typu z późnym powiązaniem. W tym celu przykład kodu definiuje klasę o nazwie Example, z metodą o nazwie SampleMethod. Konstruktor klasy akceptuje liczbę całkowitą, która służy do obliczania wartości zwracanej metody.

Przykład kodu pokazuje również użycie GetName metody w celu uzyskania AssemblyName obiektu, który może służyć do analizowania pełnej nazwy zestawu. W przykładzie przedstawiono numer wersji zestawu, CodeBase właściwości i EntryPoint właściwości.

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()
'

Uwagi

Assembly Za pomocą klasy można ładować zestawy, eksplorować metadane i części składowe zestawów, odnajdywać typy zawarte w zestawach oraz tworzyć wystąpienia tych typów.

Aby uzyskać tablicę Assembly obiektów reprezentujących zestawy aktualnie załadowane do domeny aplikacji (na przykład domyślna domena aplikacji prostego projektu), użyj AppDomain.GetAssemblies metody .

Aby dynamicznie ładować zestawy, Assembly klasa udostępnia następujące metody statyczne (Shared metody w Visual Basic). Zestawy są ładowane do domeny aplikacji, w której odbywa się operacja ładowania.

• Zalecanym sposobem ładowania zestawów jest użycie Load metody , która identyfikuje zestaw do załadowania według jego nazwy wyświetlanej (na przykład "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). Wyszukiwanie zestawu jest zgodne z regułami opisanymi w temacie Jak środowisko uruchomieniowe lokalizuje zestawy.

• Metody ReflectionOnlyLoad i ReflectionOnlyLoadFrom umożliwiają ładowanie zestawu do odbicia, ale nie na potrzeby wykonywania. Na przykład zestaw przeznaczony dla platformy 64-bitowej można zbadać za pomocą kodu uruchomionego na 32-bitowej platformie.

• Metody LoadFile i LoadFrom są udostępniane w rzadkich scenariuszach, w których zestaw musi być identyfikowany przez ścieżkę.

Aby uzyskać Assembly obiekt dla aktualnie wykonywanego zestawu, użyj GetExecutingAssembly metody .

Wiele elementów członkowskich Assembly klasy udostępnia informacje o zestawie. Przykład:

• Metoda GetName zwraca AssemblyName obiekt, który zapewnia dostęp do części nazwy wyświetlanej zestawu.

• Metoda GetCustomAttributes zawiera listę atrybutów zastosowanych do zestawu.

• Metoda GetFiles zapewnia dostęp do plików w manifeście zestawu.

• Metoda GetManifestResourceNames udostępnia nazwy zasobów w manifeście zestawu.

Metoda GetTypes wyświetla listę wszystkich typów w zestawie. Metoda GetExportedTypes zawiera listę typów widocznych dla elementów wywołujących poza zestawem. Metoda GetType może służyć do wyszukiwania określonego typu w zestawie. Metoda CreateInstance może służyć do wyszukiwania i tworzenia wystąpień typów w zestawie.

Aby uzyskać więcej informacji na temat zestawów, zobacz sekcję "Domeny aplikacji i zestawy" w temacie Domeny aplikacji .

Konstruktory

Assembly()

Inicjuje nowe wystąpienie klasy Assembly.

Właściwości

CodeBase	Nieaktualne. Pobiera lokalizację zestawu, jak określono pierwotnie, na przykład w AssemblyName obiekcie.
CustomAttributes	Pobiera kolekcję zawierającą atrybuty niestandardowe tego zestawu.
DefinedTypes	Pobiera kolekcję typów zdefiniowanych w tym zestawie.
EntryPoint	Pobiera punkt wejścia tego zestawu.
EscapedCodeBase	Nieaktualne. Pobiera identyfikator URI, w tym znaki ucieczki, które reprezentują bazę kodu.
ExportedTypes	Pobiera kolekcję typów publicznych zdefiniowanych w tym zestawie, które są widoczne poza zestawem.
FullName	Pobiera nazwę wyświetlaną zestawu.
GlobalAssemblyCache	Nieaktualne. Pobiera wartość wskazującą, czy zestaw został załadowany z globalnej pamięci podręcznej zestawów (tylko .NET Framework).
HostContext	Pobiera kontekst hosta, z którym został załadowany zestaw.
ImageRuntimeVersion	Pobiera ciąg reprezentujący wersję środowiska uruchomieniowego języka wspólnego (CLR) zapisany w pliku zawierającym manifest.
IsCollectible	Pobiera wartość wskazującą, czy ten zestaw jest przechowywany w kolekcji .AssemblyLoadContext
IsDynamic	Pobiera wartość wskazującą, czy bieżący zestaw został wygenerowany dynamicznie w bieżącym procesie przy użyciu emisji odbicia.
IsFullyTrusted	Pobiera wartość wskazującą, czy bieżący zestaw jest ładowany z pełnym zaufaniem.
Location	Pobiera pełną ścieżkę lub lokalizację UNC załadowanego pliku zawierającego manifest.
ManifestModule	Pobiera moduł zawierający manifest bieżącego zestawu.
Modules	Pobiera kolekcję zawierającą moduły w tym zestawie.
ReflectionOnly	Pobiera wartość wskazującą, Boolean czy ten zestaw został załadowany do kontekstu tylko odbicia.
SecurityRuleSet	Pobiera wartość wskazującą, który zestaw reguł zabezpieczeń wymusza środowisko uruchomieniowe języka wspólnego (CLR) dla tego zestawu.

Metody

CreateInstance(String)	Lokalizuje określony typ z tego zestawu i tworzy wystąpienie przy użyciu aktywatora systemu przy użyciu funkcji wyszukiwania uwzględniającego wielkość liter.
CreateInstance(String, Boolean)	Lokalizuje określony typ z tego zestawu i tworzy wystąpienie przy użyciu aktywatora systemu z opcjonalnym wyszukiwaniem uwzględniającym wielkość liter.
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Lokalizuje określony typ z tego zestawu i tworzy wystąpienie przy użyciu aktywatora systemu, z opcjonalnym wyszukiwaniem z uwzględnieniem wielkości liter oraz o określonej kulturze, argumentach i powiązaniach i atrybutach aktywacji.
CreateQualifiedName(String, String)	Tworzy nazwę typu kwalifikowanego przez nazwę wyświetlaną zestawu.
Equals(Object)	Określa, czy ten zestaw i określony obiekt są równe.
GetAssembly(Type)	Pobiera aktualnie załadowany zestaw, w którym zdefiniowano określony typ.
GetCallingAssembly()	Zwraca metodę Assembly , która wywołała aktualnie wykonującą metodę.
GetCustomAttributes(Boolean)	Pobiera wszystkie atrybuty niestandardowe dla tego zestawu.
GetCustomAttributes(Type, Boolean)	Pobiera atrybuty niestandardowe dla tego zestawu zgodnie z typem.
GetCustomAttributesData()	Zwraca informacje o atrybutach, które zostały zastosowane do bieżącej Assemblywartości , wyrażonej jako CustomAttributeData obiekty.
GetEntryAssembly()	Pobiera plik wykonywalny procesu w domyślnej domenie aplikacji. W innych domenach aplikacji jest to pierwszy plik wykonywalny, który został wykonany przez ExecuteAssembly(String)program .
GetExecutingAssembly()	Pobiera zestaw zawierający aktualnie wykonywany kod.
GetExportedTypes()	Pobiera typy publiczne zdefiniowane w tym zestawie, które są widoczne poza zestawem.
GetFile(String)	Pobiera element FileStream dla określonego pliku w tabeli plików manifestu tego zestawu.
GetFiles()	Pobiera pliki w tabeli plików manifestu zestawu.
GetFiles(Boolean)	Pobiera pliki w tabeli plików manifestu zestawu, określając, czy należy uwzględnić moduły zasobów.
GetForwardedTypes()	Reprezentuje zestaw, który jest wielokrotnego użytku, wersjonowalny i samoopisujący blok konstrukcyjny aplikacji środowiska uruchomieniowego języka wspólnego.
GetHashCode()	Zwraca wartość skrótu dla tego wystąpienia.
GetLoadedModules()	Pobiera wszystkie załadowane moduły, które są częścią tego zestawu.
GetLoadedModules(Boolean)	Pobiera wszystkie załadowane moduły, które są częścią tego zestawu, określając, czy należy uwzględnić moduły zasobów.
GetManifestResourceInfo(String)	Zwraca informacje o tym, jak dany zasób został utrwalone.
GetManifestResourceNames()	Zwraca nazwy wszystkich zasobów w tym zestawie.
GetManifestResourceStream(String)	Ładuje określony zasób manifestu z tego zestawu.
GetManifestResourceStream(Type, String)	Ładuje określony zasób manifestu o określonym zakresie według przestrzeni nazw określonego typu z tego zestawu.
GetModule(String)	Pobiera określony moduł w tym zestawie.
GetModules()	Pobiera wszystkie moduły, które są częścią tego zestawu.
GetModules(Boolean)	Pobiera wszystkie moduły, które są częścią tego zestawu, określając, czy należy uwzględnić moduły zasobów.
GetName()	Pobiera element AssemblyName dla tego zestawu.
GetName(Boolean)	Pobiera element AssemblyName dla tego zestawu, ustawiając bazę kodu zgodnie z wartością copiedName.
GetObjectData(SerializationInfo, StreamingContext)	Nieaktualne. Pobiera informacje o serializacji ze wszystkimi danymi potrzebnymi do przywrócenia tego zestawu.
GetReferencedAssemblies()	AssemblyName Pobiera obiekty dla wszystkich zestawów, do których odwołuje się ten zestaw.
GetSatelliteAssembly(CultureInfo)	Pobiera zestaw satelitarny dla określonej kultury.
GetSatelliteAssembly(CultureInfo, Version)	Pobiera określoną wersję zestawu satelitarnego dla określonej kultury.
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetType(String)	Type Pobiera obiekt o określonej nazwie w wystąpieniu zestawu.
GetType(String, Boolean)	Type Pobiera obiekt o określonej nazwie w wystąpieniu zestawu i opcjonalnie zgłasza wyjątek, jeśli typ nie zostanie znaleziony.
GetType(String, Boolean, Boolean)	Type Pobiera obiekt o określonej nazwie w wystąpieniu zestawu, z opcjami ignorowania przypadku i zgłaszania wyjątku, jeśli typ nie zostanie znaleziony.
GetTypes()	Pobiera wszystkie typy zdefiniowane w tym zestawie.
IsDefined(Type, Boolean)	Wskazuje, czy określony atrybut został zastosowany do zestawu.
Load(AssemblyName)	Ładuje zestaw przy użyciu elementu AssemblyName.
Load(Byte[])	Ładuje zestaw ze wspólnym obrazem opartym na pliku obiektu (COFF) zawierającym emitowany zestaw. Zestaw jest ładowany do domeny aplikacji obiektu wywołującego.
Load(Byte[], Byte[])	Ładuje zestaw przy użyciu wspólnego obrazu opartego na pliku obiektu (COFF) zawierającego emitowany zestaw, opcjonalnie w tym symbole zestawu. Zestaw jest ładowany do domeny aplikacji obiektu wywołującego.
Load(String)	Ładuje zestaw o określonej nazwie.
LoadFile(String)	Ładuje zawartość pliku zestawu w określonej ścieżce.
LoadFrom(String)	Ładuje zestaw pod nazwą pliku lub ścieżką.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Ładuje zestaw pod nazwą pliku lub ścieżką, wartością skrótu i algorytmem skrótu.
LoadModule(String, Byte[])	Ładuje moduł wewnętrzny do tego zestawu z obrazem opartym na wspólnym formacie pliku obiektów (COFF) zawierającym emitowany moduł lub plik zasobu.
LoadModule(String, Byte[], Byte[])	Ładuje moduł wewnętrzny do tego zestawu z obrazem opartym na wspólnym formacie pliku obiektów (COFF) zawierającym emitowany moduł lub plik zasobu. Załadowano również nieprzetworzone bajty reprezentujące symbole modułu.
LoadWithPartialName(String)	Nieaktualne. Ładuje zestaw z katalogu aplikacji lub z globalnej pamięci podręcznej zestawów przy użyciu częściowej nazwy.
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ReflectionOnlyLoad(Byte[])	Nieaktualne. Ładuje zestaw z obrazu opartego na formacie wspólnego pliku obiektu (COFF) zawierający emitowany zestaw. Zestaw jest ładowany do kontekstu tylko odbicia domeny aplikacji obiektu wywołującego.
ReflectionOnlyLoad(String)	Nieaktualne. Ładuje zestaw do kontekstu tylko odbicia, biorąc pod uwagę jego nazwę wyświetlaną.
ReflectionOnlyLoadFrom(String)	Nieaktualne. Ładuje zestaw do kontekstu tylko odbicia, biorąc pod uwagę jego ścieżkę.
ToString()	Zwraca pełną nazwę zestawu, znaną również jako nazwę wyświetlaną.
UnsafeLoadFrom(String)	Ładuje zestaw do kontekstu ładowania, pomijając niektóre kontrole zabezpieczeń.

Operatory

Equality(Assembly, Assembly)	Wskazuje, czy dwa Assembly obiekty są równe.
Inequality(Assembly, Assembly)	Wskazuje, czy dwa Assembly obiekty nie są równe.

Zdarzenia

ModuleResolve

Występuje, gdy moduł ładujący klasy środowiska uruchomieniowego języka wspólnego nie może rozpoznać odwołania do wewnętrznego modułu zestawu za pomocą normalnych środków.

Metody rozszerzania

GetExportedTypes(Assembly)	Reprezentuje zestaw, który jest wielokrotnego użytku, wersjonowalny i samoopisujący blok konstrukcyjny aplikacji środowiska uruchomieniowego języka wspólnego.
GetModules(Assembly)	Reprezentuje zestaw, który jest wielokrotnego użytku, wersjonowalny i samoopisujący blok konstrukcyjny aplikacji środowiska uruchomieniowego języka wspólnego.
GetTypes(Assembly)	Reprezentuje zestaw, który jest wielokrotnego użytku, wersjonowalny i samoopisujący blok konstrukcyjny aplikacji środowiska uruchomieniowego języka wspólnego.
GetCustomAttribute(Assembly, Type)	Pobiera atrybut niestandardowy określonego typu, który jest stosowany do określonego zestawu.
GetCustomAttribute<T>(Assembly)	Pobiera atrybut niestandardowy określonego typu, który jest stosowany do określonego zestawu.
GetCustomAttributes(Assembly)	Pobiera kolekcję atrybutów niestandardowych, które są stosowane do określonego zestawu.
GetCustomAttributes(Assembly, Type)	Pobiera kolekcję atrybutów niestandardowych określonego typu, które są stosowane do określonego zestawu.
GetCustomAttributes<T>(Assembly)	Pobiera kolekcję atrybutów niestandardowych określonego typu, które są stosowane do określonego zestawu.
IsDefined(Assembly, Type)	Wskazuje, czy atrybuty niestandardowe określonego typu są stosowane do określonego zestawu.
TryGetRawMetadata(Assembly, Byte*, Int32)	Pobiera sekcję metadanych zestawu do użycia z MetadataReaderprogramem .

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny wątkowo.

Zobacz też

• AppDomain
• AssemblyName
• Domeny aplikacji