Assembly Classe

Definição

public ref class Assembly abstract

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 ref class Assembly abstract : System::Reflection::ICustomAttributeProvider

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

public abstract class Assembly

[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

public abstract class Assembly : System.Reflection.ICustomAttributeProvider

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

type Assembly = class

[<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

type Assembly = class
    interface ICustomAttributeProvider

type Assembly = class
    interface ICustomAttributeProvider
    interface ISerializable

Public MustInherit Class Assembly

Public Class Assembly
Implements _Assembly, ICustomAttributeProvider, IEvidenceFactory, ISerializable

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

Public MustInherit Class Assembly
Implements ICustomAttributeProvider

Public MustInherit Class Assembly
Implements ICustomAttributeProvider, ISerializable

Herança

Object

Assembly

Derivado

System.Reflection.Emit.AssemblyBuilder

Atributos

ClassInterfaceAttribute SerializableAttribute ComVisibleAttribute

Implementações

ICustomAttributeProvider _Assembly ISerializable IEvidenceFactory

Exemplos

O exemplo de código seguinte mostra como obter o assembly em execução atual, criar uma instância de um tipo contido nesse assembly e invocar um dos métodos do tipo com late binding. Para este efeito, o exemplo de código define uma classe chamada Example, com um método chamado SampleMethod. O construtor da classe aceita um inteiro, que é usado para calcular o valor de retorno do método.

O exemplo do código também demonstra a utilização do GetName método para obter um AssemblyName objeto que pode ser usado para analisar o nome completo da assembleia. O exemplo mostra o número de versão da assembleia, a CodeBase propriedade e a EntryPoint propriedade.

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

Observações

Use a Assembly classe para carregar assemblies, explorar os metadados e as partes constituintes dos assemblies, descobrir os tipos contidos nas assemblies e criar instâncias desses tipos.

Para obter um array de Assembly objetos que representam os assemblies atualmente carregados num domínio de aplicação (por exemplo, o domínio de aplicação padrão de um projeto simples), use o AppDomain.GetAssemblies método.

Para carregar assemblies dinamicamente, a classe Assembly fornece os seguintes métodos estáticos (Shared métodos em Visual Basic). Os assemblies são carregados no domínio da aplicação onde ocorre a operação de carga.

• A forma recomendada de carregar assemblies é usar o método Load, que identifica o assembly a ser carregado pelo seu nome de exibição (por exemplo, "System.Windows. Forms, Version=2.0.0.0, Culture=neutro, PublicKeyToken=b77a5c561934e089"). A pesquisa pelo assembly segue as regras descritas em Como o Runtime Localiza Assemblies.

• Os ReflectionOnlyLoad métodos and ReflectionOnlyLoadFrom permitem-lhe carregar um assembly para reflexão, mas não para execução. Por exemplo, um assembly que tem como alvo uma plataforma de 64 bits pode ser examinado por código que está a correr numa plataforma de 32 bits.

• Os LoadFile métodos e LoadFrom são fornecidos para cenários raros em que uma montagem deve ser identificada por caminho.

Para obter um Assembly objeto para a montagem em execução, use o GetExecutingAssembly método.

Muitos membros da Assembly turma fornecem informações sobre uma assembleia. Por exemplo:

• O GetName método devolve um AssemblyName objeto que fornece acesso às partes do nome de exibição da montagem.

• O GetCustomAttributes método lista os atributos aplicados à montagem.

• O GetFiles método fornece acesso aos ficheiros no manifesto assembly.

• O GetManifestResourceNames método fornece os nomes dos recursos no manifesto de assembleia.

O GetTypes método lista todos os tipos na montagem. O GetExportedTypes método lista os tipos que são visíveis para os chamadores fora da assembleia. O GetType método pode ser usado para procurar um tipo específico no conjunto. O CreateInstance método pode ser usado para procurar e criar instâncias de tipos na montagem.

Para mais informações sobre assemblies, consulte a secção "Domínios de Aplicação e Assemblies" no tópico Domínios de Aplicação .

Segurança de Thread

Este tipo é seguro para fios.

Ver também

• AppDomain
• AssemblyName
• Domínios de Aplicação