Assembly Classe

Definizione

public ref class Assembly abstract

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::Serialization::ISerializable

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider

public ref class Assembly : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory

public ref class Assembly abstract : System::Reflection::ICustomAttributeProvider, System::Runtime::InteropServices::_Assembly, System::Runtime::Serialization::ISerializable, System::Security::IEvidenceFactory

public abstract class Assembly

public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.Serialization.ISerializable

public abstract class Assembly : System.Reflection.ICustomAttributeProvider

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Assembly : System.Reflection.ICustomAttributeProvider, System.Runtime.InteropServices._Assembly, System.Runtime.Serialization.ISerializable, System.Security.IEvidenceFactory

type Assembly = class

type Assembly = class
    interface ICustomAttributeProvider
    interface ISerializable

type Assembly = class
    interface ICustomAttributeProvider

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
type Assembly = class
    interface _Assembly
    interface IEvidenceFactory
    interface ICustomAttributeProvider
    interface ISerializable

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Assembly = class
    interface _Assembly
    interface IEvidenceFactory
    interface ICustomAttributeProvider
    interface ISerializable

Public MustInherit Class Assembly

Public MustInherit Class Assembly
Implements ICustomAttributeProvider, ISerializable

Public MustInherit Class Assembly
Implements ICustomAttributeProvider

Public Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable

Public MustInherit Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable

Ereditarietà

Object

Assembly

Derivato

System.Reflection.Emit.AssemblyBuilder

Attributi

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementazioni

ICustomAttributeProvider ISerializable _Assembly IEvidenceFactory

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

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 Assembly classe per caricare assembly, per 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 Assembly oggetti che rappresentano gli assembly attualmente caricati in un dominio applicazione (ad esempio, il dominio applicazione predefinito di un progetto semplice), usare il AppDomain.GetAssemblies metodo .

Per caricare gli assembly in modo dinamico, la Assembly classe 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 Load metodo , 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 ReflectionOnlyLoad metodi 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 LoadFile metodi e LoadFrom vengono forniti per rari scenari in cui un assembly deve essere identificato dal percorso.

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

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

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

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

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

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

Il GetTypes metodo elenca tutti i tipi nell'assembly. Il GetExportedTypes metodo elenca i tipi visibili ai chiamanti esterni all'assembly. Il GetType metodo può essere utilizzato per cercare un particolare tipo nell'assembly. Il CreateInstance metodo 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 .

Thread safety

Questo tipo è thread-safe.

Vedi anche

• AppDomain
• AssemblyName
• Domini di applicazione