Assembly Osztály

Definíció

Névtér:

System.Reflection

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

Assembly.cs

Olyan szerelvényt jelöl, amely egy közös nyelvi futtatókörnyezeti alkalmazás újrafelhasználható, verziószámozható és önleíró építőeleme.

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

Öröklődés

Object

Assembly

Származtatott

System.Reflection.Emit.AssemblyBuilder

Megvalósítás

ICustomAttributeProvider ISerializable

Példák

Az alábbi példakód bemutatja, hogyan szerezheti be a jelenleg végrehajtó szerelvényt, hogyan hozhat létre egy példányt az adott szerelvényben, és hogyan hívhatja meg a típus egyik metódusát késői kötéssel. Erre a célra a példakód egy nevesített Exampleosztályt határoz meg, amelynek neve SampleMethodegy metódus. Az osztály konstruktora egy egész számot fogad el, amely a metódus visszatérési értékének kiszámítására szolgál.

A példakód azt is bemutatja, hogy a GetName metódus használatával olyan objektumot szerezhet be AssemblyName , amely a szerelvény teljes nevének elemzéséhez használható. A példa a szerelvény verziószámát, a tulajdonságot CodeBase és a tulajdonságot jeleníti meg EntryPoint .

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

Megjegyzések

Az osztály használatával betöltheti a Assembly szerelvényeket, megismerheti a szerelvények metaadatait és összetevőit, felderítheti a szerelvényekben található típusokat, és létrehozhat példányokat ezekből a típusokból.

Ha egy alkalmazástartományba jelenleg betöltött szerelvényeket (például egy egyszerű projekt alapértelmezett alkalmazástartományát) képviselő objektumtömböt Assembly szeretne lekérni, használja a metódust AppDomain.GetAssemblies .

A szerelvények dinamikus betöltéséhez a Assembly osztály a következő statikus metódusokat biztosítja (Shared metódusokat Visual Basic). A rendszer betölti a szerelvényeket abba az alkalmazástartományba, ahol a terhelési művelet történik.

• A szerelvények betöltésének ajánlott módja a Load metódus használata, amely azonosítja a megjelenítendő szerelvényt (például "System.Windows. Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). A szerelvény keresése a Futtatókörnyezet szerelvények megkeresése című cikkben leírt szabályokat követi.

• A ReflectionOnlyLoad metódusok lehetővé ReflectionOnlyLoadFrom teszik, hogy egy szerelvényt tükrözés céljából töltsön be, végrehajtásra azonban nem. Egy 64 bites platformot megcélozó szerelvény például egy 32 bites platformon futó kóddal vizsgálható meg.

• A LoadFile metódusok olyan LoadFrom ritka forgatókönyvekhez tartoznak, amelyekben a szerelvényt elérési úton kell azonosítani.

Az aktuálisan végrehajtó szerelvény objektumának lekéréséhez Assembly használja a metódust GetExecutingAssembly .

Az osztály számos tagja Assembly információt nyújt egy szerelvényről. Például:

• A GetName metódus egy AssemblyName objektumot ad vissza, amely hozzáférést biztosít a szerelvény megjelenítendő nevének részeihez.

• A GetCustomAttributes metódus felsorolja a szerelvényre alkalmazott attribútumokat.

• A GetFiles metódus hozzáférést biztosít a szerelvényjegyzék fájljaihoz.

• A GetManifestResourceNames metódus az erőforrások nevét adja meg a szerelvényjegyzékben.

A GetTypes metódus felsorolja a szerelvény összes típusát. A GetExportedTypes metódus felsorolja azokat a típusokat, amelyek a szerelvényen kívüli hívók számára láthatók. A GetType metódussal megkereshet egy adott típust a szerelvényben. A CreateInstance metódus használható típuspéldányok keresésére és létrehozására a szerelvényben.

A szerelvényekről további információt az Alkalmazástartományok témakör "Alkalmazástartományok és szerelvények" című szakaszában talál.

Konstruktorok

Name	Description
Assembly()	Inicializálja a Assembly osztály új példányát.

Tulajdonságok

Name	Description
CodeBase	Elavult. Lekéri a szerelvény eredetileg megadott helyét, például egy AssemblyName objektumban.
CustomAttributes	Lekéri a szerelvény egyéni attribútumait tartalmazó gyűjteményt.
DefinedTypes	Lekéri a szerelvényben definiált típusok gyűjteményét.
EntryPoint	Lekéri a szerelvény belépési pontját.
EscapedCodeBase	Elavult. Lekéri a kódbázist képviselő URI-t, beleértve a feloldó karaktereket is.
ExportedTypes	Lekéri az ebben a szerelvényben definiált nyilvános típusok gyűjteményét, amelyek a szerelvényen kívül láthatók.
FullName	Lekéri a szerelvény megjelenítendő nevét.
GlobalAssemblyCache	Elavult. Beolvas egy értéket, amely jelzi, hogy a szerelvény betöltődött-e a globális szerelvény-gyorsítótárból (csak .NET keretrendszerből).
HostContext	Lekéri azt a gazdagépkörnyezetet, amellyel a szerelvény betöltődött.
ImageRuntimeVersion	Lekéri a jegyzékfájlba mentett közös nyelvi futtatókörnyezet (CLR) verzióját képviselő sztringet.
IsCollectible	Olyan értéket kap, amely jelzi, hogy a szerelvény gyűjthető AssemblyLoadContexthelyen van-e.
IsDynamic	Olyan értéket kap, amely jelzi, hogy az aktuális szerelvény dinamikusan lett-e létrehozva az aktuális folyamatban a tükröződés kibocsátásával.
IsFullyTrusted	Olyan értéket kap, amely jelzi, hogy az aktuális szerelvény teljes megbízhatósággal van-e betöltve.
Location	Lekéri a jegyzékfájlt tartalmazó betöltött fájl teljes elérési útját vagy UNC-helyét.
ManifestModule	Lekéri az aktuális szerelvény jegyzékjegyzékét tartalmazó modult.
Modules	Lekéri a szerelvény moduljait tartalmazó gyűjteményt.
ReflectionOnly	Beolvas egy Boolean értéket, amely jelzi, hogy a szerelvény be lett-e töltve a csak tükrözési környezetbe.
SecurityRuleSet	Olyan értéket kap, amely jelzi, hogy a közös nyelvi futtatókörnyezet (CLR) mely biztonsági szabályokat kényszeríti ki ehhez a szerelvényhez.

Metódusok

Name	Description
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Megkeresi a megadott típust ebből a szerelvényből, és létrehozza annak egy példányát a rendszeraktivátor használatával, a kis- és nagybetűk megkülönböztetésével, valamint a megadott kultúrával, argumentumokkal, kötési és aktiválási attribútumokkal.
CreateInstance(String, Boolean)	Megkeresi a megadott típust ebből a szerelvényből, és létrehozza annak egy példányát a rendszeraktivátor használatával, a kis- és nagybetűket nem kötelező kereséssel.
CreateInstance(String)	Megkeresi a megadott típust ebből a szerelvényből, és létrehoz egy példányt a rendszeraktivátor használatával, a kis- és nagybetűket megkülönböztető kereséssel.
CreateQualifiedName(String, String)	Létrehozza a szerelvény megjelenítendő nevével minősített típus nevét.
Equals(Object)	Meghatározza, hogy ez a szerelvény és a megadott objektum egyenlő-e.
GetAssembly(Type)	Lekéri azt a jelenleg betöltött szerelvényt, amelyben a megadott típus definiálva van.
GetCallingAssembly()	Assembly A jelenleg végrehajtó metódust meghívó metódus értékét adja vissza.
GetCustomAttributes(Boolean)	Lekéri a szerelvény összes egyéni attribútumát.
GetCustomAttributes(Type, Boolean)	Lekéri a szerelvény egyéni attribútumait a típus szerint megadott módon.
GetCustomAttributesData()	Az aktuálisra Assemblyalkalmazott attribútumokra vonatkozó információkat adja vissza objektumként CustomAttributeData kifejezve.
GetEntryAssembly()	Lekéri a futó alkalmazás belépési szerelvényét.
GetExecutingAssembly()	Lekéri az éppen futó kódot tartalmazó szerelvényt.
GetExportedTypes()	Lekéri az ebben a szerelvényben definiált nyilvános típusokat, amelyek a szerelvényen kívül láthatók.
GetFile(String)	FileStream Lekéri a megadott fájlt a szerelvény jegyzékfájljának fájltáblájában.
GetFiles()	Lekéri a fájlokat egy szerelvényjegyzék fájltáblájában.
GetFiles(Boolean)	Lekéri a fájlokat egy szerelvényjegyzék fájltáblájában, megadva, hogy az erőforrásmodulokat is tartalmazza-e.
GetForwardedTypes()	Olyan szerelvényt jelöl, amely egy közös nyelvi futtatókörnyezeti alkalmazás újrafelhasználható, verziószámozható és önleíró építőeleme.
GetHashCode()	A példány kivonatkódját adja vissza.
GetLoadedModules()	Lekéri a szerelvény részét képező összes betöltött modult.
GetLoadedModules(Boolean)	Lekéri a szerelvény részét képező összes betöltött modult, megadva, hogy az erőforrásmodulokat is belefoglalja-e.
GetManifestResourceInfo(String)	Az adott erőforrás megőrzésének módját adja vissza.
GetManifestResourceNames()	A szerelvény összes erőforrásának nevét adja vissza.
GetManifestResourceStream(String)	Betölti a megadott jegyzékerőforrást ebből a szerelvényből.
GetManifestResourceStream(Type, String)	Betölti a megadott jegyzékerőforrást, amely a megadott típus névtere szerint van meghatározva ebből a szerelvényből.
GetModule(String)	Lekéri a megadott modult ebben a szerelvényben.
GetModules()	Lekéri a szerelvény részét képező összes modult.
GetModules(Boolean)	Lekéri a szerelvény részét képező összes modult, megadva, hogy az erőforrásmodulokat is belefoglalja-e.
GetName()	Kap egy ilyen AssemblyName szerelvényt.
GetName(Boolean)	Lekéri a szerelvényt AssemblyName , és a kódbázist a megadott módon állítja copiedNamebe.
GetObjectData(SerializationInfo, StreamingContext)	Elavult. Lekéri a szerializálási adatokat a szerelvény újbóli létrehozásához szükséges összes adattal.
GetReferencedAssemblies()	Lekéri a AssemblyName szerelvény által hivatkozott összes szerelvény objektumait.
GetSatelliteAssembly(CultureInfo, Version)	Lekéri a műholdas szerelvény megadott verzióját a megadott kultúrához.
GetSatelliteAssembly(CultureInfo)	Lekéri a megadott kultúrához tartozó műholdas szerelvényt.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetType(String, Boolean, Boolean)	Lekéri az Type objektumot a szerelvénypéldányban megadott névvel, az eset figyelmen kívül hagyásának lehetőségeivel, és kivételt ad, ha a típus nem található.
GetType(String, Boolean)	Lekéri a Type megadott nevű objektumot a szerelvénypéldányban, és opcionálisan kivételt ad, ha a típus nem található.
GetType(String)	Lekéri az Type objektumot a megadott névvel a szerelvénypéldányban.
GetTypes()	Lekéri a szerelvényben definiált összes típust.
IsDefined(Type, Boolean)	Azt jelzi, hogy egy megadott attribútum lett-e alkalmazva a szerelvényre.
Load(AssemblyName)	Betölti a szerelvényt a sajátja AssemblyNamealapján.
Load(Byte[], Byte[])	Betölti a szerelvényt egy közös objektumfájlformátumú (COFF)-alapú képpel, amely egy kibocsátott szerelvényt tartalmaz, opcionálisan a szerelvény szimbólumait is beleértve.
Load(Byte[])	Betölti a szerelvényt egy közös objektumfájlformátumú (COFF)-alapú képpel, amely egy kibocsátott szerelvényt tartalmaz.
Load(String)	Betölt egy szerelvényt a megadott névvel.
LoadFile(String)	Betölti egy szerelvényfájl tartalmát a megadott elérési úton.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Elavult. Betölt egy szerelvényt a fájlnév vagy elérési út, a kivonatérték és a kivonatoló algoritmus alapján.
LoadFrom(String)	Betölt egy szerelvényt a fájlnév vagy elérési út alapján.
LoadModule(String, Byte[], Byte[])	Betölti a modult a szerelvényen belül egy közös objektumfájl-formátummal (COFF)-alapú képpel, amely egy kibocsátott modult vagy egy erőforrásfájlt tartalmaz. A modul szimbólumait jelképező nyers bájtok is betöltésre kerülnek.
LoadModule(String, Byte[])	Betölti a modult a szerelvényen belül egy közös objektumfájl-formátummal (COFF)-alapú képpel, amely egy kibocsátott modult vagy egy erőforrásfájlt tartalmaz.
LoadWithPartialName(String)	Elavult. Betölt egy szerelvényt az alkalmazáskönyvtárból vagy a globális szerelvény-gyorsítótárból részleges névvel.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ReflectionOnlyLoad(Byte[])	Elavult. Betölti a szerelvényt egy közös objektumfájlformátumú (COFF)-alapú rendszerképből, amely egy kibocsátott szerelvényt tartalmaz. A rendszer betölti a szerelvényt a hívó alkalmazástartományának csak tükröződésalapú környezetébe.
ReflectionOnlyLoad(String)	Elavult. Betölt egy szerelvényt a csak tükrözési környezetbe a megjelenítendő név alapján.
ReflectionOnlyLoadFrom(String)	Elavult. Betölt egy szerelvényt a csak tükrözési környezetbe, az elérési útnak köszönhetően.
SetEntryAssembly(Assembly)	Az alkalmazás belépési szerelvényét a megadott szerelvényobjektumra állítja.
ToString()	A szerelvény teljes nevét adja vissza, más néven a megjelenítendő nevet.
UnsafeLoadFrom(String)	Betölt egy szerelvényt a betöltési környezetbe, elkerülve néhány biztonsági ellenőrzést.

Operátorok

Name	Description
Equality(Assembly, Assembly)	Azt jelzi, hogy két Assembly objektum egyenlő-e.
Inequality(Assembly, Assembly)	Azt jelzi, hogy két Assembly objektum nem egyenlő-e.

esemény

Name	Description
ModuleResolve	Akkor fordul elő, ha a közös nyelvi futtatókörnyezeti osztálybetöltő normál módon nem tudja feloldani a szerelvény belső moduljára mutató hivatkozást.

Bővítő metódusok

Name	Description
GetCustomAttribute(Assembly, Type)	Lekéri a megadott típusú egyéni attribútumot, amelyet egy adott szerelvényre alkalmaz.
GetCustomAttribute<T>(Assembly)	Lekéri a megadott típusú egyéni attribútumot, amelyet egy adott szerelvényre alkalmaz.
GetCustomAttributes(Assembly, Type)	Egy megadott típusú egyéni attribútumok gyűjteményét kéri le, amelyek egy adott szerelvényre lesznek alkalmazva.
GetCustomAttributes(Assembly)	Egy adott szerelvényre alkalmazott egyéni attribútumok gyűjteményét kéri le.
GetCustomAttributes<T>(Assembly)	Egy megadott típusú egyéni attribútumok gyűjteményét kéri le, amelyek egy adott szerelvényre lesznek alkalmazva.
GetExportedTypes(Assembly)	Olyan szerelvényt jelöl, amely egy közös nyelvi futtatókörnyezeti alkalmazás újrafelhasználható, verziószámozható és önleíró építőeleme.
GetModules(Assembly)	Olyan szerelvényt jelöl, amely egy közös nyelvi futtatókörnyezeti alkalmazás újrafelhasználható, verziószámozható és önleíró építőeleme.
GetTypes(Assembly)	Olyan szerelvényt jelöl, amely egy közös nyelvi futtatókörnyezeti alkalmazás újrafelhasználható, verziószámozható és önleíró építőeleme.
IsDefined(Assembly, Type)	Azt jelzi, hogy a megadott típusú egyéni attribútumok alkalmazhatók-e egy adott szerelvényre.
TryGetRawMetadata(Assembly, Byte*, Int32)	Lekéri a szerelvény metaadatszakaszát a következővel MetadataReadervaló használatra: .

Szálbiztonság

Ez a típus szálbiztos.

Lásd még

• AppDomain
• AssemblyName
• Alkalmazástartományok