Assembly Třída

Definice

Obor názvů:

System.Reflection

Sestavení:

System.Runtime.dll

Zdroj:

Assembly.cs

Představuje sestavení, které je opakovaně použitelné, s možností správy verzí a vlastním popisem stavebního bloku aplikace common language runtime.

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

Dědičnost

Object

Assembly

Odvozené

System.Reflection.Emit.AssemblyBuilder

Implementuje

ICustomAttributeProvider ISerializable

Příklady

Následující příklad kódu ukazuje, jak získat aktuálně spuštěné sestavení, vytvořit instanci typu obsažené v tomto sestavení a vyvolat jednu z metod typu s pozdní vazbou. Pro tento účel příklad kódu definuje třídu s názvem Example, s metodou s názvem SampleMethod. Konstruktor třídy přijímá celé číslo, které se používá k výpočtu návratové hodnoty metody.

Příklad kódu také ukazuje použití GetName metoda k získání AssemblyName objektu, který lze použít k analýze celého názvu sestavení. Příklad zobrazí číslo verze sestavení, CodeBase vlastnost a vlastnost 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()
'

Poznámky

Pomocí třídy Assembly načtěte sestavení, prozkoumat metadata a součásti sestavení, zjistit typy obsažené v sestaveních a vytvářet instance těchto typů.

Pokud chcete získat pole Assembly objektů představujících sestavení aktuálně načtená do domény aplikace (například výchozí doména aplikace jednoduchého projektu), použijte metodu AppDomain.GetAssemblies.

K dynamickému načtení sestavení poskytuje třída Assembly následující statické metody (Shared metody v jazyce Visual Basic). Sestavení se načtou do domény aplikace, kde dojde k operaci načítání.

• Doporučeným způsobem načtení sestavení je použít metodu Load, která identifikuje sestavení, které má být načteno podle zobrazovaného názvu (například System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089). Hledání sestavení se řídí pravidly popsanými v Jak modul runtime vyhledá sestavení.

• Metody ReflectionOnlyLoad a ReflectionOnlyLoadFrom umožňují načíst sestavení pro reflexi, ale ne pro spuštění. Například sestavení, které cílí na 64bitovou platformu, je možné prozkoumat kódem, který běží na 32bitové platformě.

• Metody LoadFile a LoadFrom jsou k dispozici ve výjimečných scénářích, ve kterých musí být sestavení identifikováno cestou.

Chcete-li získat objekt Assembly pro aktuálně spuštěné sestavení, použijte GetExecutingAssembly metoda.

Mnoho členů Assembly třídy poskytuje informace o sestavení. Například:

• Metoda GetName vrátí objekt AssemblyName, který poskytuje přístup k částem zobrazovaného názvu sestavení.

• Metoda GetCustomAttributes vypíše atributy použité na sestavení.

• Metoda GetFiles poskytuje přístup k souborům v manifestu sestavení.

• Metoda GetManifestResourceNames poskytuje názvy prostředků v manifestu sestavení.

Metoda GetTypes zobrazí seznam všech typů v sestavení. Metoda GetExportedTypes uvádí typy, které jsou viditelné volajícím mimo sestavení. Metodu GetType lze použít k vyhledání konkrétního typu v sestavení. Metodu CreateInstance lze použít k vyhledání a vytvoření instancí typů v sestavení.

Další informace o sestaveních naleznete v části Domény aplikace a sestavení v tématu Domény aplikace.

Konstruktory

Assembly()

Inicializuje novou instanci Assembly třídy.

Vlastnosti

CodeBase	Zastaralé. Získá umístění sestavení, jak bylo uvedeno původně, například v AssemblyName objektu.
CustomAttributes	Získá kolekci, která obsahuje vlastní atributy tohoto sestavení.
DefinedTypes	Získá kolekci typů definovaných v tomto sestavení.
EntryPoint	Získá vstupní bod tohoto sestavení.
EscapedCodeBase	Zastaralé. Získá identifikátor URI, včetně řídicích znaků, který představuje základ kódu.
ExportedTypes	Získá kolekci veřejných typů definovaných v tomto sestavení, které jsou viditelné mimo sestavení.
FullName	Získá zobrazovaný název sestavení.
GlobalAssemblyCache	Zastaralé. Získá hodnotu určující, zda sestavení bylo načteno z globální mezipaměti sestavení (pouze rozhraní .NET Framework).
HostContext	Získá kontext hostitele, se kterým bylo sestavení načteno.
ImageRuntimeVersion	Získá řetězec představující verzi modulu CLR (Common Language Runtime) uloženého v souboru obsahujícím manifest.
IsCollectible	Získá hodnotu, která označuje, zda je toto sestavení uloženo v shromažďovatelné AssemblyLoadContext.
IsDynamic	Získá hodnotu, která označuje, zda aktuální sestavení bylo vygenerováno dynamicky v aktuálním procesu pomocí generování reflexe.
IsFullyTrusted	Získá hodnotu, která určuje, zda je aktuální sestavení načteno s úplným vztahem důvěryhodnosti.
Location	Získá úplnou cestu nebo umístění UNC načteného souboru, který obsahuje manifest.
ManifestModule	Získá modul, který obsahuje manifest pro aktuální sestavení.
Modules	Získá kolekci, která obsahuje moduly v tomto sestavení.
ReflectionOnly	Získá Boolean hodnotu určující, zda bylo toto sestavení načteno do kontextu pouze reflexe.
SecurityRuleSet	Získá hodnotu, která určuje, která sada pravidel zabezpečení modul CLR (Common Language Runtime) vynucuje pro toto sestavení.

Metody

CreateInstance(String)	Vyhledá zadaný typ z tohoto sestavení a vytvoří jeho instanci pomocí aktivátoru systému pomocí vyhledávání s rozlišováním velkých a malých písmen.
CreateInstance(String, Boolean)	Vyhledá zadaný typ z tohoto sestavení a vytvoří instanci pomocí aktivátoru systému s volitelným vyhledáváním s rozlišováním velkých a malých písmen.
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Vyhledá zadaný typ z tohoto sestavení a vytvoří jeho instanci pomocí aktivátoru systému, s volitelným vyhledáváním s rozlišováním velkých a malých písmen a se zadanými jazykovými verzemi, argumenty a atributy vazby a aktivace.
CreateQualifiedName(String, String)	Vytvoří název typu kvalifikovaného zobrazovaný název sestavení.
Equals(Object)	Určuje, zda toto sestavení a zadaný objekt jsou stejné.
GetAssembly(Type)	Získá aktuálně načtené sestavení, ve kterém je definován zadaný typ.
GetCallingAssembly()	Vrátí Assembly metody, která vyvolala aktuálně spuštěnou metodu.
GetCustomAttributes(Boolean)	Získá všechny vlastní atributy pro toto sestavení.
GetCustomAttributes(Type, Boolean)	Získá vlastní atributy pro toto sestavení podle typu.
GetCustomAttributesData()	Vrátí informace o atributech, které byly použity na aktuální Assembly, vyjádřeno jako CustomAttributeData objekty.
GetEntryAssembly()	Získá vstupní sestavení pro spuštěnou aplikaci.
GetExecutingAssembly()	Získá sestavení, které obsahuje kód, který se právě spouští.
GetExportedTypes()	Získá veřejné typy definované v tomto sestavení, které jsou viditelné mimo sestavení.
GetFile(String)	Získá FileStream pro zadaný soubor v tabulce souboru manifestu tohoto sestavení.
GetFiles()	Získá soubory v tabulce souboru manifestu sestavení.
GetFiles(Boolean)	Získá soubory v tabulce souboru manifestu sestavení určující, zda se mají zahrnout moduly prostředků.
GetForwardedTypes()	Představuje sestavení, které je opakovaně použitelné, s možností správy verzí a vlastním popisem stavebního bloku aplikace common language runtime.
GetHashCode()	Vrátí kód hash pro tuto instanci.
GetLoadedModules()	Získá všechny načtené moduly, které jsou součástí tohoto sestavení.
GetLoadedModules(Boolean)	Získá všechny načtené moduly, které jsou součástí tohoto sestavení, určující, zda zahrnout moduly prostředků.
GetManifestResourceInfo(String)	Vrátí informace o tom, jak byl daný prostředek zachován.
GetManifestResourceNames()	Vrátí názvy všech prostředků v tomto sestavení.
GetManifestResourceStream(String)	Načte zadaný prostředek manifestu z tohoto sestavení.
GetManifestResourceStream(Type, String)	Načte zadaný prostředek manifestu vymezený oborem názvů zadaného typu z tohoto sestavení.
GetModule(String)	Získá zadaný modul v tomto sestavení.
GetModules()	Získá všechny moduly, které jsou součástí tohoto sestavení.
GetModules(Boolean)	Získá všechny moduly, které jsou součástí tohoto sestavení, určující, zda zahrnout moduly prostředků.
GetName()	Získá AssemblyName pro toto sestavení.
GetName(Boolean)	Získá AssemblyName pro toto sestavení, nastavení základu kódu podle copiedName.
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Získá serializační informace se všemi daty potřebnými k obnovení tohoto sestavení.
GetReferencedAssemblies()	Získá AssemblyName objekty pro všechna sestavení odkazovaná tímto sestavením.
GetSatelliteAssembly(CultureInfo)	Získá satelitní sestavení pro zadanou jazykovou verzi.
GetSatelliteAssembly(CultureInfo, Version)	Získá zadanou verzi satelitního sestavení pro zadanou jazykovou verzi.
GetType()	Získá Type aktuální instance. (Zděděno od Object)
GetType(String)	Získá Type objekt se zadaným názvem v instanci sestavení.
GetType(String, Boolean)	Získá Type objekt se zadaným názvem v instanci sestavení a volitelně vyvolá výjimku, pokud typ nebyl nalezen.
GetType(String, Boolean, Boolean)	Získá Type objekt se zadaným názvem v instanci sestavení, s možnostmi ignorování případu a vyvolá výjimku, pokud typ nebyl nalezen.
GetTypes()	Získá všechny typy definované v tomto sestavení.
IsDefined(Type, Boolean)	Určuje, zda byl zadaný atribut použit na sestavení.
Load(AssemblyName)	Načte sestavení vzhledem k jeho AssemblyName.
Load(Byte[])	Načte sestavení s běžným formátem souboru objektu (COFF) obsahující generované sestavení.
Load(Byte[], Byte[])	Načte sestavení s běžným formátem souboru objektu (COFF) obsahující vygenerované sestavení, volitelně včetně symbolů sestavení.
Load(String)	Načte sestavení se zadaným názvem.
LoadFile(String)	Načte obsah souboru sestavení na zadanou cestu.
LoadFrom(String)	Načte sestavení s názvem souboru nebo cestou.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Načte sestavení s názvem souboru nebo cestou, hodnotou hash a hashovacím algoritmem.
LoadModule(String, Byte[])	Načte modul, interní do tohoto sestavení, s obrázkem založeným na společném formátu souboru objektu (COFF), který obsahuje vygenerovaný modul nebo soubor prostředků.
LoadModule(String, Byte[], Byte[])	Načte modul, interní do tohoto sestavení, s obrázkem založeným na společném formátu souboru objektu (COFF), který obsahuje vygenerovaný modul nebo soubor prostředků. Načtou se také nezpracované bajty představující symboly modulu.
LoadWithPartialName(String)	Zastaralé. Načte sestavení z adresáře aplikace nebo z globální mezipaměti sestavení pomocí částečného názvu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
ReflectionOnlyLoad(Byte[])	Zastaralé. Načte sestavení z bitové kopie založené na společném formátu souboru objektu (COFF), která obsahuje generované sestavení. Sestavení se načte do kontextu jen reflexe domény aplikace volajícího.
ReflectionOnlyLoad(String)	Zastaralé. Načte sestavení do kontextu jen pro odraz vzhledem k jeho zobrazovaným názvům.
ReflectionOnlyLoadFrom(String)	Zastaralé. Načte sestavení do kontextu jen reflexe vzhledem k jeho cestě.
ToString()	Vrátí úplný název sestavení, označovaný také jako zobrazovaný název.
UnsafeLoadFrom(String)	Načte sestavení do kontextu načtení z kontextu a vynechá některé kontroly zabezpečení.

Operátory

Equality(Assembly, Assembly)	Určuje, zda jsou dva Assembly objekty stejné.
Inequality(Assembly, Assembly)	Určuje, zda se dva Assembly objekty nerovnají.

Událost

ModuleResolve

Nastane, když zavaděč třídy common language runtime nemůže přeložit odkaz na interní modul sestavení pomocí normálních prostředků.

Metody rozšíření

GetExportedTypes(Assembly)	Představuje sestavení, které je opakovaně použitelné, s možností správy verzí a vlastním popisem stavebního bloku aplikace common language runtime.
GetModules(Assembly)	Představuje sestavení, které je opakovaně použitelné, s možností správy verzí a vlastním popisem stavebního bloku aplikace common language runtime.
GetTypes(Assembly)	Představuje sestavení, které je opakovaně použitelné, s možností správy verzí a vlastním popisem stavebního bloku aplikace common language runtime.
GetCustomAttribute(Assembly, Type)	Načte vlastní atribut zadaného typu, který se použije na zadané sestavení.
GetCustomAttribute<T>(Assembly)	Načte vlastní atribut zadaného typu, který se použije na zadané sestavení.
GetCustomAttributes(Assembly)	Načte kolekci vlastních atributů, které se použijí na zadané sestavení.
GetCustomAttributes(Assembly, Type)	Načte kolekci vlastních atributů zadaného typu, které se použijí na zadané sestavení.
GetCustomAttributes<T>(Assembly)	Načte kolekci vlastních atributů zadaného typu, které se použijí na zadané sestavení.
IsDefined(Assembly, Type)	Určuje, zda jsou vlastní atributy zadaného typu použity na zadané sestavení.
TryGetRawMetadata(Assembly, Byte*, Int32)	Načte část metadat sestavení pro použití s MetadataReader.

Bezpečný přístup z více vláken

Tento typ je bezpečný pro přístup z více vláken.

Viz také

• AppDomain
• AssemblyName
• domén aplikací