Assembly Třída

Definice

Obor názvů:

System.Reflection

Sestavení:

System.Runtime.dll

Zdroj:

Assembly.cs

Představuje sestavení, což je opakovaně použitelný, s možností správy verzí a samopopisující stavební blok 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ého v tomto sestavení a vyvolat jednu z metod typu s pozdní vazbou. Příklad kódu pro tento účel definuje třídu s názvem Examples 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 metody k získání objektu AssemblyName , který lze použít k analýze úplného názvu sestavení. Příklad zobrazuje číslo verze sestavení, CodeBase vlastnost a EntryPoint vlastnost.

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

Assembly Použijte třídu k načtení sestavení, k prozkoumání metadat a základních částí sestavení, ke zjišťování typů obsažených v sestaveních a k vytváření instancí těchto typů.

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

Pro dynamické Assembly načítání sestavení poskytuje třída následující statické metody (Shared metody v jazyce Visual Basic). Sestavení jsou načtena do domény aplikace, kde probíhá operace načítání.

• Doporučeným způsobem načtení sestavení je použití Load metody, která identifikuje sestavení, které se má načíst, podle jeho 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 tématu 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, může být prozkoumáno kódem, který běží na 32bitové platformě.

• Metody LoadFile a LoadFrom jsou k dispozici pro vzácné scénáře, ve kterých musí být sestavení identifikováno cestou.

Pokud chcete získat Assembly objekt pro aktuálně spuštěné sestavení, použijte metodu GetExecutingAssembly .

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

• Metoda GetName vrátí AssemblyName objekt, 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 vypíše typy, které jsou viditelné pro volající mimo sestavení. Metodu GetType lze použít k vyhledání konkrétního typu v sestavení. Metodu CreateInstance lze použít k vyhledávání a vytváření instancí typů v sestavení.

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

Konstruktory

Assembly()

Inicializuje novou instanci Assembly třídy.

Vlastnosti

CodeBase	Zastaralé. Získá umístění sestavení, jak bylo původně zadáno, například v objektu AssemblyName .
CustomAttributes	Získá kolekci, která obsahuje vlastní atributy 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 označ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 načteno sestavení.
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í drženo v collectible AssemblyLoadContext.
IsDynamic	Získá hodnotu, která označuje, zda aktuální sestavení bylo vygenerováno dynamicky v aktuálním procesu pomocí reflexe emit.
IsFullyTrusted	Získá hodnotu, která označuje, zda aktuální sestavení je načtena 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	Boolean Získá hodnotu označující, zda bylo toto sestavení načteno do kontextu pouze reflexe.
SecurityRuleSet	Získá hodnotu, která označuje, která sada pravidel zabezpečení common language runtime (CLR) 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ří jeho instanci pomocí aktivátoru systému s volitelným vyhledáváním s rozlišováním malý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 malých a malých písmen a má zadanou jazykovou verzi, argumenty a vazby a aktivační atributy.
CreateQualifiedName(String, String)	Vytvoří název typu kvalifikovaného zobrazovaný název jeho sestavení.
Equals(Object)	Určuje, zda je toto sestavení a zadaný objekt rovny.
GetAssembly(Type)	Získá aktuálně načtené sestavení, ve kterém je definován zadaný typ.
GetCallingAssembly()	Assembly Vrátí metodu, 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í, jak je určeno typem.
GetCustomAttributesData()	Vrátí informace o atributech, které byly použity na aktuální Assembly, vyjádřené jako CustomAttributeData objekty.
GetEntryAssembly()	Získá spustitelný soubor procesu ve výchozí doméně aplikace. V jiných aplikačních doménách se jedná o první spustitelný soubor, který spustil .ExecuteAssembly(String)
GetExecutingAssembly()	Získá sestavení, které obsahuje kód, který je právě spuštěn.
GetExportedTypes()	Získá veřejné typy definované v tomto sestavení, které jsou viditelné mimo sestavení.
GetFile(String)	Získá pro FileStream zadaný soubor v tabulce souborů manifestu tohoto sestavení.
GetFiles()	Získá soubory v tabulce souborů manifestu sestavení.
GetFiles(Boolean)	Získá soubory v tabulce souborů manifestu sestavení a určí, zda zahrnout moduly prostředků.
GetForwardedTypes()	Představuje sestavení, což je opakovaně použitelný, s možností správy verzí a samopopisující stavební blok aplikace common language runtime.
GetHashCode()	Vrátí hodnotu 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í, a určí, zda zahrnout moduly prostředků.
GetManifestResourceInfo(String)	Vrátí informace o tom, jak byl daný prostředek trvale 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)	Z tohoto sestavení načte zadaný prostředek manifestu vymezený oborem názvů zadaného typu.
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í, a určuje, zda zahrnout moduly prostředků.
GetName()	Získá pro AssemblyName toto sestavení.
GetName(Boolean)	Získá pro AssemblyName toto sestavení a nastaví základ kódu, jak je uvedeno v copiedName.
GetObjectData(SerializationInfo, StreamingContext)	Zastaralé. Získá informace o serializaci se všemi daty potřebnými k obnovení tohoto sestavení.
GetReferencedAssemblies()	AssemblyName Získá 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á aktuální Type instanci. (Zděděno od Object)
GetType(String)	Type Získá objekt se zadaným názvem v instanci sestavení.
GetType(String, Boolean)	Type Získá objekt se zadaným názvem v instanci sestavení a volitelně vyvolá výjimku, pokud typ není nalezen.
GetType(String, Boolean, Boolean)	Type Získá objekt se zadaným názvem v instanci sestavení s možnostmi ignorovat případ a vyvolání výjimky, pokud typ není nalezen.
GetTypes()	Získá všechny typy definované v tomto sestavení.
IsDefined(Type, Boolean)	Určuje, zda byl na sestavení použit zadaný atribut.
Load(AssemblyName)	Načte sestavení vzhledem k jeho AssemblyName.
Load(Byte[])	Načte sestavení s obrázkem založeným na formátu COFF (Common Object File Format), který obsahuje generované sestavení.
Load(Byte[], Byte[])	Načte sestavení s obrázkem založeným na formátu COFF (Common Object File Format), který obsahuje generované sestavení, volitelně včetně symbolů pro 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 nebo cestou souboru, hodnotou hash a hashovacím algoritmem.
LoadModule(String, Byte[])	Načte modul, interní pro toto sestavení, s obrázkem založeným na formátu COFF (Common Object File Format), která obsahuje vygenerovaný modul nebo soubor prostředků.
LoadModule(String, Byte[], Byte[])	Načte modul, interní pro toto sestavení, s obrázkem založeným na formátu COFF (Common Object File Format), 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í s použitím částečného názvu.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ReflectionOnlyLoad(Byte[])	Zastaralé. Načte sestavení z obrázku založeného na formátu COFF (Common Object File Format) obsahujícího generované sestavení. Sestavení se načte do kontextu pouze reflexe domény aplikace volajícího.
ReflectionOnlyLoad(String)	Zastaralé. Načte sestavení do kontextu jen pro reflexi s ohledem na jeho zobrazovaný název.
ReflectionOnlyLoadFrom(String)	Zastaralé. Načte sestavení do kontextu pouze 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čítání a obchází některé kontroly zabezpečení.

Operátory

Equality(Assembly, Assembly)	Určuje, zda jsou dva Assembly objekty rovny.
Inequality(Assembly, Assembly)	Určuje, zda si dva Assembly objekty nejsou rovny.

Událost

ModuleResolve

Nastane, když zavaděč tříd common language runtime nemůže přeložit odkaz na interní modul sestavení normálním způsobem.

Metody rozšíření

GetExportedTypes(Assembly)	Představuje sestavení, což je opakovaně použitelný, s možností správy verzí a samopopisující stavební blok aplikace common language runtime.
GetModules(Assembly)	Představuje sestavení, což je opakovaně použitelný, s možností správy verzí a samopopisující stavební blok aplikace common language runtime.
GetTypes(Assembly)	Představuje sestavení, což je opakovaně použitelný, s možností správy verzí a samopopisující stavební blok aplikace common language runtime.
GetCustomAttribute(Assembly, Type)	Načte vlastní atribut zadaného typu, který je použit na zadané sestavení.
GetCustomAttribute<T>(Assembly)	Načte vlastní atribut zadaného typu, který je použit na zadané sestavení.
GetCustomAttributes(Assembly)	Načte kolekci vlastních atributů, které jsou použity na zadané sestavení.
GetCustomAttributes(Assembly, Type)	Načte kolekci vlastních atributů zadaného typu, které jsou použity na zadané sestavení.
GetCustomAttributes<T>(Assembly)	Načte kolekci vlastních atributů zadaného typu, které jsou použity na zadané sestavení.
IsDefined(Assembly, Type)	Určuje, zda jsou na zadané sestavení použity vlastní atributy zadaného typu.
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
• Aplikační domény