Assembly Klasa

Definicja

Przestrzeń nazw:

System.Reflection

Zestaw:

System.Runtime.dll

Źródło:

Assembly.cs

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 Examplez metodą o nazwie SampleMethod. Konstruktor klasy akceptuje liczbę całkowitą, która służy do obliczania wartości zwracanej metody.

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

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

Za pomocą klasy Assembly 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ę obiektów Assembly reprezentujących zestawy aktualnie załadowane do domeny aplikacji (na przykład domyślna domena aplikacji prostego projektu), użyj metody AppDomain.GetAssemblies.

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

• Zalecanym sposobem ładowania zestawów jest użycie metody Load, 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 How the Runtime Lokalizuje zestawy.

• Metody ReflectionOnlyLoad i ReflectionOnlyLoadFrom umożliwiają ładowanie zestawu do odbicia, ale nie do wykonywania. Na przykład zestaw przeznaczony dla platformy 64-bitowej można zbadać za pomocą kodu działającego 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ć obiekt Assembly dla aktualnie wykonywanego zestawu, użyj metody GetExecutingAssembly.

Wiele elementów członkowskich klasy Assembly zawiera informacje o zestawie. Na przykład:

• Metoda GetName zwraca obiekt AssemblyName, 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 zawiera nazwy zasobów w manifeście zestawu.

Metoda GetTypes zawiera listę wszystkich typów w zestawie. Metoda GetExportedTypes zawiera listę typów widocznych dla obiektó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 Application Domains.

Konstruktory

Assembly()

Inicjuje nowe wystąpienie klasy Assembly.

Właściwości

CodeBase	Przestarzałe. Pobiera lokalizację zestawu, jak określono pierwotnie, na przykład w obiekcie AssemblyName.
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	Przestarzałe. Pobiera identyfikator URI, w tym znaki ucieczki, który reprezentuje 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	Przestarzałe. 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 zbieralnej 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 dla bieżącego zestawu.
Modules	Pobiera kolekcję zawierającą moduły w tym zestawie.
ReflectionOnly	Pobiera wartość Boolean wskazującą, 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 uwzględniającym wielkość liter oraz określonymi kulturami, argumentami i atrybutami powiązania i aktywacji.
CreateQualifiedName(String, String)	Tworzy nazwę typu kwalifikowanego przez nazwę wyświetlaną jego 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 Assembly metody, 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 Assembly, wyrażone jako obiekty CustomAttributeData.
GetEntryAssembly()	Pobiera zestaw wejściowy dla uruchomionej aplikacji.
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 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 mają być uwzględniane 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 kod 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 mają zawierać 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 mają być uwzględniane moduły zasobów.
GetName()	Pobiera AssemblyName dla tego zestawu.
GetName(Boolean)	Pobiera AssemblyName dla tego zestawu, ustawiając bazę kodu zgodnie z copiedName.
GetObjectData(SerializationInfo, StreamingContext)	Przestarzałe. Pobiera informacje o serializacji ze wszystkimi danymi potrzebnymi do przywrócenia tego zestawu.
GetReferencedAssemblies()	Pobiera obiekty AssemblyName 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()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
GetType(String)	Pobiera obiekt Type o określonej nazwie w wystąpieniu zestawu.
GetType(String, Boolean)	Pobiera obiekt Type o określonej nazwie w wystąpieniu zestawu i opcjonalnie zgłasza wyjątek, jeśli typ nie zostanie znaleziony.
GetType(String, Boolean, Boolean)	Pobiera obiekt Type 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, biorąc pod uwagę jego AssemblyName.
Load(Byte[])	Ładuje zestaw ze wspólnym obrazem opartym na pliku obiektów (COFF) zawierającym emitowany zestaw.
Load(Byte[], Byte[])	Ładuje zestaw ze wspólnym obrazem opartym na pliku obiektów (COFF) zawierającym emitowany zestaw, opcjonalnie w tym symbole zestawu.
Load(String)	Ładuje zestaw o określonej nazwie.
LoadFile(String)	Ładuje zawartość pliku zestawu na 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 obiektu (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 obiektu (COFF) zawierającym emitowany moduł lub plik zasobu. Załadowano również nieprzetworzone bajty reprezentujące symbole modułu.
LoadWithPartialName(String)	Przestarzałe. Ł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 Object. (Odziedziczone po Object)
ReflectionOnlyLoad(Byte[])	Przestarzałe. Ładuje zestaw z obrazu opartego na typowym formacie pliku obiektu (COFF) zawierającym emitowany zestaw. Zestaw jest ładowany do kontekstu tylko odbicia domeny aplikacji obiektu wywołującego.
ReflectionOnlyLoad(String)	Przestarzałe. Ładuje zestaw do kontekstu tylko odbicia, biorąc pod uwagę jego nazwę wyświetlaną.
ReflectionOnlyLoadFrom(String)	Przestarzałe. Ładuje zestaw do kontekstu tylko odbicia, biorąc pod uwagę jego ścieżkę.
ToString()	Zwraca pełną nazwę zestawu, znaną również jako nazwa wyświetlana.
UnsafeLoadFrom(String)	Ładuje zestaw do kontekstu ładowania, pomijając niektóre kontrole zabezpieczeń.

Operatory

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

Zdarzenia

ModuleResolve

Występuje, gdy moduł ładujący klas ś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 MetadataReader.

Bezpieczeństwo wątkowe

Ten typ jest bezpieczny wątkiem.

Zobacz też

• AppDomain
• AssemblyName
• domen aplikacji