Assembly Classe

Definizione

Spazio dei nomi:

System.Reflection

Assembly:

System.Runtime.dll

Origine:

Assembly.cs

Rappresenta un assembly, che è un blocco predefinito riutilizzabile, modificabile e autodescrittura di un'applicazione 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

Ereditarietà

Object

Assembly

Derivato

System.Reflection.Emit.AssemblyBuilder

Implementazioni

ICustomAttributeProvider ISerializable

Esempio

Nell'esempio di codice seguente viene illustrato come ottenere l'assembly attualmente in esecuzione, creare un'istanza di un tipo contenuto in tale assembly e richiamare uno dei metodi del tipo con associazione tardiva. A questo scopo, l'esempio di codice definisce una classe denominata Example, con un metodo denominato SampleMethod. Il costruttore della classe accetta un numero intero, che viene usato per calcolare il valore restituito del metodo .

Nell'esempio di codice viene inoltre illustrato l'uso del metodo GetName per ottenere un oggetto AssemblyName che può essere usato per analizzare il nome completo dell'assembly. Nell'esempio viene visualizzato il numero di versione dell'assembly, la proprietà CodeBase e la proprietà 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()
'

Commenti

Usare la classe Assembly per caricare gli assembly, esplorare i metadati e le parti costitutive degli assembly, individuare i tipi contenuti negli assembly e creare istanze di tali tipi.

Per ottenere una matrice di oggetti Assembly che rappresentano gli assembly attualmente caricati in un dominio applicazione (ad esempio, il dominio applicazione predefinito di un progetto semplice), usare il metodo AppDomain.GetAssemblies.

Per caricare gli assembly in modo dinamico, la classe Assembly fornisce i metodi statici seguenti (Shared metodi in Visual Basic). Gli assembly vengono caricati nel dominio applicazione in cui si verifica l'operazione di caricamento.

• Il modo consigliato per caricare gli assembly consiste nell'usare il metodo Load, che identifica l'assembly da caricare con il nome visualizzato, ad esempio "System.Windows.Forms, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089"). La ricerca dell'assembly segue le regole descritte in Come il runtime individua gli assembly.

• I metodi ReflectionOnlyLoad e ReflectionOnlyLoadFrom consentono di caricare un assembly per la reflection, ma non per l'esecuzione. Ad esempio, un assembly destinato a una piattaforma a 64 bit può essere esaminato dal codice in esecuzione in una piattaforma a 32 bit.

• I metodi LoadFile e LoadFrom vengono forniti per rari scenari in cui un assembly deve essere identificato dal percorso.

Per ottenere un oggetto Assembly per l'assembly attualmente in esecuzione, utilizzare il metodo GetExecutingAssembly.

Molti membri della classe Assembly forniscono informazioni su un assembly. Per esempio:

• Il metodo GetName restituisce un oggetto AssemblyName che fornisce l'accesso alle parti del nome visualizzato dell'assembly.

• Il metodo GetCustomAttributes elenca gli attributi applicati all'assembly.

• Il metodo GetFiles fornisce l'accesso ai file nel manifesto dell'assembly.

• Il metodo GetManifestResourceNames fornisce i nomi delle risorse nel manifesto dell'assembly.

Il metodo GetTypes elenca tutti i tipi nell'assembly. Il metodo GetExportedTypes elenca i tipi visibili ai chiamanti esterni all'assembly. Il metodo GetType può essere utilizzato per cercare un particolare tipo nell'assembly. Il metodo CreateInstance può essere usato per cercare e creare istanze di tipi nell'assembly.

Per altre informazioni sugli assembly, vedere la sezione "Domini applicazione e assembly" nell'argomento domini applicazione .

Costruttori

Assembly()

Inizializza una nuova istanza della classe Assembly.

Proprietà

CodeBase	Obsoleti. Ottiene il percorso dell'assembly come specificato originariamente, ad esempio in un oggetto AssemblyName.
CustomAttributes	Ottiene una raccolta che contiene gli attributi personalizzati dell'assembly.
DefinedTypes	Ottiene una raccolta dei tipi definiti in questo assembly.
EntryPoint	Ottiene il punto di ingresso dell'assembly.
EscapedCodeBase	Obsoleti. Ottiene l'URI, inclusi i caratteri di escape, che rappresenta la codebase.
ExportedTypes	Ottiene una raccolta di tipi pubblici definiti in questo assembly visibili all'esterno dell'assembly.
FullName	Ottiene il nome visualizzato dell'assembly.
GlobalAssemblyCache	Obsoleti. Ottiene un valore che indica se l'assembly è stato caricato dalla Global Assembly Cache (solo .NET Framework).
HostContext	Ottiene il contesto host con cui è stato caricato l'assembly.
ImageRuntimeVersion	Ottiene una stringa che rappresenta la versione di Common Language Runtime (CLR) salvata nel file contenente il manifesto.
IsCollectible	Ottiene un valore che indica se l'assembly è contenuto in un AssemblyLoadContextraccoglibile.
IsDynamic	Ottiene un valore che indica se l'assembly corrente è stato generato dinamicamente nel processo corrente utilizzando reflection emit.
IsFullyTrusted	Ottiene un valore che indica se l'assembly corrente viene caricato con attendibilità totale.
Location	Ottiene il percorso completo o il percorso UNC del file caricato che contiene il manifesto.
ManifestModule	Ottiene il modulo che contiene il manifesto per l'assembly corrente.
Modules	Ottiene una raccolta che contiene i moduli in questo assembly.
ReflectionOnly	Ottiene un valore Boolean che indica se l'assembly è stato caricato nel contesto di sola reflection.
SecurityRuleSet	Ottiene un valore che indica il set di regole di sicurezza applicate da Common Language Runtime (CLR) per questo assembly.

Metodi

CreateInstance(String)	Individua il tipo specificato da questo assembly e ne crea un'istanza usando l'attivatore di sistema, usando la ricerca con distinzione tra maiuscole e minuscole.
CreateInstance(String, Boolean)	Individua il tipo specificato da questo assembly e ne crea un'istanza usando l'attivatore di sistema, con la ricerca facoltativa con distinzione tra maiuscole e minuscole.
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Individua il tipo specificato da questo assembly e ne crea un'istanza usando l'attivatore di sistema, con la ricerca facoltativa con distinzione tra maiuscole e minuscole e con le impostazioni cultura, gli argomenti e gli attributi di associazione e attivazione specificati.
CreateQualifiedName(String, String)	Crea il nome di un tipo qualificato dal nome visualizzato dell'assembly.
Equals(Object)	Determina se questo assembly e l'oggetto specificato sono uguali.
GetAssembly(Type)	Ottiene l'assembly attualmente caricato in cui è definito il tipo specificato.
GetCallingAssembly()	Restituisce il Assembly del metodo che ha richiamato il metodo attualmente in esecuzione.
GetCustomAttributes(Boolean)	Ottiene tutti gli attributi personalizzati per questo assembly.
GetCustomAttributes(Type, Boolean)	Ottiene gli attributi personalizzati per questo assembly come specificato dal tipo.
GetCustomAttributesData()	Restituisce informazioni sugli attributi applicati alla Assemblycorrente, espressa come oggetti CustomAttributeData.
GetEntryAssembly()	Ottiene l'assembly di immissione per l'applicazione in esecuzione.
GetExecutingAssembly()	Ottiene l'assembly che contiene il codice attualmente in esecuzione.
GetExportedTypes()	Ottiene i tipi pubblici definiti in questo assembly visibili all'esterno dell'assembly.
GetFile(String)	Ottiene un FileStream per il file specificato nella tabella file del manifesto dell'assembly.
GetFiles()	Ottiene i file nella tabella file di un manifesto dell'assembly.
GetFiles(Boolean)	Ottiene i file nella tabella file di un manifesto dell'assembly, specificando se includere i moduli delle risorse.
GetForwardedTypes()	Rappresenta un assembly, che è un blocco predefinito riutilizzabile, modificabile e autodescrittura di un'applicazione Common Language Runtime.
GetHashCode()	Restituisce il codice hash per questa istanza.
GetLoadedModules()	Ottiene tutti i moduli caricati che fanno parte di questo assembly.
GetLoadedModules(Boolean)	Ottiene tutti i moduli caricati che fanno parte di questo assembly, specificando se includere moduli di risorse.
GetManifestResourceInfo(String)	Restituisce informazioni sulla modalità di persistenza della risorsa specificata.
GetManifestResourceNames()	Restituisce i nomi di tutte le risorse in questo assembly.
GetManifestResourceStream(String)	Carica la risorsa manifesto specificata da questo assembly.
GetManifestResourceStream(Type, String)	Carica la risorsa manifesto specificata, con ambito dallo spazio dei nomi del tipo specificato, da questo assembly.
GetModule(String)	Ottiene il modulo specificato in questo assembly.
GetModules()	Ottiene tutti i moduli che fanno parte di questo assembly.
GetModules(Boolean)	Ottiene tutti i moduli che fanno parte di questo assembly, specificando se includere moduli di risorse.
GetName()	Ottiene un AssemblyName per questo assembly.
GetName(Boolean)	Ottiene un AssemblyName per questo assembly, impostando la codebase come specificato da copiedName.
GetObjectData(SerializationInfo, StreamingContext)	Obsoleti. Ottiene le informazioni di serializzazione con tutti i dati necessari per reinstantiare questo assembly.
GetReferencedAssemblies()	Ottiene l'AssemblyName oggetti per tutti gli assembly a cui fa riferimento questo assembly.
GetSatelliteAssembly(CultureInfo)	Ottiene l'assembly satellite per le impostazioni cultura specificate.
GetSatelliteAssembly(CultureInfo, Version)	Ottiene la versione specificata dell'assembly satellite per le impostazioni cultura specificate.
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
GetType(String)	Ottiene l'oggetto Type con il nome specificato nell'istanza dell'assembly.
GetType(String, Boolean)	Ottiene l'oggetto Type con il nome specificato nell'istanza dell'assembly e, facoltativamente, genera un'eccezione se il tipo non viene trovato.
GetType(String, Boolean, Boolean)	Ottiene l'oggetto Type con il nome specificato nell'istanza dell'assembly, con le opzioni di ignorare il caso e di generare un'eccezione se il tipo non viene trovato.
GetTypes()	Ottiene tutti i tipi definiti in questo assembly.
IsDefined(Type, Boolean)	Indica se all'assembly è stato applicato o meno un attributo specificato.
Load(AssemblyName)	Carica un assembly in base al relativo AssemblyName.
Load(Byte[])	Carica l'assembly con un'immagine basata su COFF (Common Object File Format) contenente un assembly generato.
Load(Byte[], Byte[])	Carica l'assembly con un'immagine basata su COFF (Common Object File Format) contenente un assembly generato, inclusi facoltativamente i simboli per l'assembly.
Load(String)	Carica un assembly con il nome specificato.
LoadFile(String)	Carica il contenuto di un file di assembly nel percorso specificato.
LoadFrom(String)	Carica un assembly in base al nome o al percorso del file.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Carica un assembly in base al nome file o al percorso, al valore hash e all'algoritmo hash.
LoadModule(String, Byte[])	Carica il modulo, interno a questo assembly, con un'immagine basata su COFF (Common Object File Format) contenente un modulo generato o un file di risorse.
LoadModule(String, Byte[], Byte[])	Carica il modulo, interno a questo assembly, con un'immagine basata su COFF (Common Object File Format) contenente un modulo generato o un file di risorse. Vengono caricati anche i byte non elaborati che rappresentano i simboli per il modulo.
LoadWithPartialName(String)	Obsoleti. Carica un assembly dalla directory dell'applicazione o dalla Global Assembly Cache usando un nome parziale.
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
ReflectionOnlyLoad(Byte[])	Obsoleti. Carica l'assembly da un'immagine basata su COFF (Common Object File Format) contenente un assembly generato. L'assembly viene caricato nel contesto di sola reflection del dominio applicazione del chiamante.
ReflectionOnlyLoad(String)	Obsoleti. Carica un assembly nel contesto di sola reflection, in base al nome visualizzato.
ReflectionOnlyLoadFrom(String)	Obsoleti. Carica un assembly nel contesto di sola reflection, in base al relativo percorso.
ToString()	Restituisce il nome completo dell'assembly, noto anche come nome visualizzato.
UnsafeLoadFrom(String)	Carica un assembly nel contesto di caricamento, ignorando alcuni controlli di sicurezza.

Operatori

Equality(Assembly, Assembly)	Indica se due oggetti Assembly sono uguali.
Inequality(Assembly, Assembly)	Indica se due oggetti Assembly non sono uguali.

Eventi

ModuleResolve

Si verifica quando il caricatore di classi Common Language Runtime non è in grado di risolvere un riferimento a un modulo interno di un assembly tramite mezzi normali.

Metodi di estensione

GetExportedTypes(Assembly)	Rappresenta un assembly, che è un blocco predefinito riutilizzabile, modificabile e autodescrittura di un'applicazione Common Language Runtime.
GetModules(Assembly)	Rappresenta un assembly, che è un blocco predefinito riutilizzabile, modificabile e autodescrittura di un'applicazione Common Language Runtime.
GetTypes(Assembly)	Rappresenta un assembly, che è un blocco predefinito riutilizzabile, modificabile e autodescrittura di un'applicazione Common Language Runtime.
GetCustomAttribute(Assembly, Type)	Recupera un attributo personalizzato di un tipo specificato applicato a un assembly specificato.
GetCustomAttribute<T>(Assembly)	Recupera un attributo personalizzato di un tipo specificato applicato a un assembly specificato.
GetCustomAttributes(Assembly)	Recupera una raccolta di attributi personalizzati applicati a un assembly specificato.
GetCustomAttributes(Assembly, Type)	Recupera una raccolta di attributi personalizzati di un tipo specificato applicato a un assembly specificato.
GetCustomAttributes<T>(Assembly)	Recupera una raccolta di attributi personalizzati di un tipo specificato applicato a un assembly specificato.
IsDefined(Assembly, Type)	Indica se gli attributi personalizzati di un tipo specificato vengono applicati a un assembly specificato.
TryGetRawMetadata(Assembly, Byte*, Int32)	Recupera la sezione dei metadati dell'assembly da usare con MetadataReader.

Thread safety

Questo tipo è thread-safe.

Vedi anche

• AppDomain
• AssemblyName
• domini applicazione