Assembly Classe

Definição

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Origem:

Assembly.cs

Representa um assembly, que é um bloco de construção reutilizável, com controle de versão e autodescrevendo um aplicativo de 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

Herança

Object

Assembly

Derivado

System.Reflection.Emit.AssemblyBuilder

Implementações

ICustomAttributeProvider ISerializable

Exemplos

O exemplo de código a seguir mostra como obter o assembly em execução no momento, criar uma instância de um tipo contido nesse assembly e invocar um dos métodos do tipo com associação tardia. Para essa finalidade, 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 retornado do método.

O exemplo de código também demonstra o uso do método GetName para obter um objeto AssemblyName que pode ser usado para analisar o nome completo do assembly. O exemplo exibe o número de versão do assembly, a propriedade CodeBase e a propriedade 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()
'

Comentários

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

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

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

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

• Os métodos ReflectionOnlyLoad e ReflectionOnlyLoadFrom permitem carregar um assembly para reflexão, mas não para execução. Por exemplo, um assembly direcionado a uma plataforma de 64 bits pode ser examinado pelo código em execução em uma plataforma de 32 bits.

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

Para obter um objeto Assembly para o assembly em execução no momento, use o método GetExecutingAssembly.

Muitos membros da classe Assembly fornecem informações sobre um assembly. Por exemplo:

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

• O método GetCustomAttributes lista os atributos aplicados ao assembly.

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

• O método GetManifestResourceNames fornece os nomes dos recursos no manifesto do assembly.

O método GetTypes lista todos os tipos no assembly. O método GetExportedTypes lista os tipos visíveis para os chamadores fora do assembly. O método GetType pode ser usado para pesquisar um tipo específico no assembly. O método CreateInstance pode ser usado para pesquisar e criar instâncias de tipos no assembly.

Para obter mais informações sobre assemblies, consulte a seção "Domínios e assemblies de aplicativo" no tópico Domínios do Aplicativo.

Construtores

Assembly()

Inicializa uma nova instância da classe Assembly.

Propriedades

CodeBase	Obsoleto. Obtém o local do assembly conforme especificado originalmente, por exemplo, em um objeto AssemblyName.
CustomAttributes	Obtém uma coleção que contém os atributos personalizados desse assembly.
DefinedTypes	Obtém uma coleção dos tipos definidos neste assembly.
EntryPoint	Obtém o ponto de entrada deste assembly.
EscapedCodeBase	Obsoleto. Obtém o URI, incluindo caracteres de escape, que representa a base de código.
ExportedTypes	Obtém uma coleção dos tipos públicos definidos neste assembly que são visíveis fora do assembly.
FullName	Obtém o nome de exibição do assembly.
GlobalAssemblyCache	Obsoleto. Obtém um valor que indica se o assembly foi carregado do cache de assembly global (somente do .NET Framework).
HostContext	Obtém o contexto do host com o qual o assembly foi carregado.
ImageRuntimeVersion	Obtém uma cadeia de caracteres que representa a versão do CLR (Common Language Runtime) salva no arquivo que contém o manifesto.
IsCollectible	Obtém um valor que indica se esse assembly é mantido em um AssemblyLoadContextcolecionável.
IsDynamic	Obtém um valor que indica se o assembly atual foi gerado dinamicamente no processo atual usando a emissão de reflexão.
IsFullyTrusted	Obtém um valor que indica se o assembly atual é carregado com confiança total.
Location	Obtém o caminho completo ou o local UNC do arquivo carregado que contém o manifesto.
ManifestModule	Obtém o módulo que contém o manifesto do assembly atual.
Modules	Obtém uma coleção que contém os módulos neste assembly.
ReflectionOnly	Obtém um valor Boolean indicando se esse assembly foi carregado no contexto somente reflexão.
SecurityRuleSet	Obtém um valor que indica qual conjunto de regras de segurança o CLR (Common Language Runtime) impõe para esse assembly.

Métodos

CreateInstance(String)	Localiza o tipo especificado desse assembly e cria uma instância dele usando o ativador do sistema, usando a pesquisa que diferencia maiúsculas de minúsculas.
CreateInstance(String, Boolean)	Localiza o tipo especificado desse assembly e cria uma instância dele usando o ativador do sistema, com pesquisa opcional que diferencia maiúsculas de minúsculas.
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Localiza o tipo especificado desse assembly e cria uma instância dele usando o ativador do sistema, com pesquisa opcional que diferencia maiúsculas de minúsculas e ter a cultura, os argumentos e os atributos de associação e ativação especificados.
CreateQualifiedName(String, String)	Cria o nome de um tipo qualificado pelo nome de exibição de seu assembly.
Equals(Object)	Determina se esse assembly e o objeto especificado são iguais.
GetAssembly(Type)	Obtém o assembly carregado no momento no qual o tipo especificado é definido.
GetCallingAssembly()	Retorna o Assembly do método que invocou o método em execução no momento.
GetCustomAttributes(Boolean)	Obtém todos os atributos personalizados para este assembly.
GetCustomAttributes(Type, Boolean)	Obtém os atributos personalizados para esse assembly conforme especificado por tipo.
GetCustomAttributesData()	Retorna informações sobre os atributos que foram aplicados ao Assemblyatual, expressos como objetos CustomAttributeData.
GetEntryAssembly()	Obtém o assembly de entrada do aplicativo em execução.
GetExecutingAssembly()	Obtém o assembly que contém o código que está sendo executado no momento.
GetExportedTypes()	Obtém os tipos públicos definidos neste assembly que são visíveis fora do assembly.
GetFile(String)	Obtém um FileStream para o arquivo especificado na tabela de arquivos do manifesto deste assembly.
GetFiles()	Obtém os arquivos na tabela de arquivos de um manifesto do assembly.
GetFiles(Boolean)	Obtém os arquivos na tabela de arquivos de um manifesto do assembly, especificando se os módulos de recurso devem ser incluídos.
GetForwardedTypes()	Representa um assembly, que é um bloco de construção reutilizável, com controle de versão e autodescrevendo um aplicativo de common language runtime.
GetHashCode()	Retorna o código hash dessa instância.
GetLoadedModules()	Obtém todos os módulos carregados que fazem parte deste assembly.
GetLoadedModules(Boolean)	Obtém todos os módulos carregados que fazem parte deste assembly, especificando se os módulos de recurso devem ser incluídos.
GetManifestResourceInfo(String)	Retorna informações sobre como o recurso determinado foi persistido.
GetManifestResourceNames()	Retorna os nomes de todos os recursos neste assembly.
GetManifestResourceStream(String)	Carrega o recurso de manifesto especificado deste assembly.
GetManifestResourceStream(Type, String)	Carrega o recurso de manifesto especificado, com escopo pelo namespace do tipo especificado, desse assembly.
GetModule(String)	Obtém o módulo especificado neste assembly.
GetModules()	Obtém todos os módulos que fazem parte deste assembly.
GetModules(Boolean)	Obtém todos os módulos que fazem parte deste assembly, especificando se os módulos de recurso devem ser incluídos.
GetName()	Obtém um AssemblyName para este assembly.
GetName(Boolean)	Obtém um AssemblyName para esse assembly, definindo a base de código conforme especificado por copiedName.
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Obtém informações de serialização com todos os dados necessários para reinstalar esse assembly.
GetReferencedAssemblies()	Obtém os objetos AssemblyName para todos os assemblies referenciados por este assembly.
GetSatelliteAssembly(CultureInfo)	Obtém o assembly satélite para a cultura especificada.
GetSatelliteAssembly(CultureInfo, Version)	Obtém a versão especificada do assembly satélite para a cultura especificada.
GetType()	Obtém o Type da instância atual. (Herdado de Object)
GetType(String)	Obtém o objeto Type com o nome especificado na instância do assembly.
GetType(String, Boolean)	Obtém o objeto Type com o nome especificado na instância do assembly e, opcionalmente, gera uma exceção se o tipo não for encontrado.
GetType(String, Boolean, Boolean)	Obtém o objeto Type com o nome especificado na instância do assembly, com as opções de ignorar o caso e de gerar uma exceção se o tipo não for encontrado.
GetTypes()	Obtém todos os tipos definidos neste assembly.
IsDefined(Type, Boolean)	Indica se um atributo especificado foi ou não aplicado ao assembly.
Load(AssemblyName)	Carrega um assembly dado seu AssemblyName.
Load(Byte[])	Carrega o assembly com uma imagem baseada em COFF (formato de arquivo de objeto comum) que contém um assembly emitido.
Load(Byte[], Byte[])	Carrega o assembly com uma imagem baseada em COFF (formato de arquivo de objeto comum) que contém um assembly emitido, opcionalmente incluindo símbolos para o assembly.
Load(String)	Carrega um assembly com o nome especificado.
LoadFile(String)	Carrega o conteúdo de um arquivo de assembly no caminho especificado.
LoadFrom(String)	Carrega um assembly dado seu nome de arquivo ou caminho.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Carrega um assembly dado seu nome de arquivo ou caminho, valor de hash e algoritmo de hash.
LoadModule(String, Byte[])	Carrega o módulo, interno para este assembly, com uma imagem baseada em COFF (formato de arquivo de objeto comum) contendo um módulo emitido ou um arquivo de recurso.
LoadModule(String, Byte[], Byte[])	Carrega o módulo, interno para este assembly, com uma imagem baseada em COFF (formato de arquivo de objeto comum) contendo um módulo emitido ou um arquivo de recurso. Os bytes brutos que representam os símbolos do módulo também são carregados.
LoadWithPartialName(String)	Obsoleto. Carrega um assembly do diretório do aplicativo ou do cache de assembly global usando um nome parcial.
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
ReflectionOnlyLoad(Byte[])	Obsoleto. Carrega o assembly de uma imagem baseada em COFF (formato de arquivo de objeto comum) que contém um assembly emitido. O assembly é carregado no contexto somente reflexão do domínio do aplicativo do chamador.
ReflectionOnlyLoad(String)	Obsoleto. Carrega um assembly no contexto somente reflexão, considerando seu nome de exibição.
ReflectionOnlyLoadFrom(String)	Obsoleto. Carrega um assembly no contexto somente reflexão, considerando seu caminho.
ToString()	Retorna o nome completo do assembly, também conhecido como o nome de exibição.
UnsafeLoadFrom(String)	Carrega um assembly no contexto de carregamento, ignorando algumas verificações de segurança.

Operadores

Equality(Assembly, Assembly)	Indica se dois objetos Assembly são iguais.
Inequality(Assembly, Assembly)	Indica se dois objetos Assembly não são iguais.

Eventos

ModuleResolve

Ocorre quando o carregador de classe common language runtime não pode resolver uma referência a um módulo interno de um assembly por meio de meios normais.

Métodos de Extensão

GetExportedTypes(Assembly)	Representa um assembly, que é um bloco de construção reutilizável, com controle de versão e autodescrevendo um aplicativo de common language runtime.
GetModules(Assembly)	Representa um assembly, que é um bloco de construção reutilizável, com controle de versão e autodescrevendo um aplicativo de common language runtime.
GetTypes(Assembly)	Representa um assembly, que é um bloco de construção reutilizável, com controle de versão e autodescrevendo um aplicativo de common language runtime.
GetCustomAttribute(Assembly, Type)	Recupera um atributo personalizado de um tipo especificado que é aplicado a um assembly especificado.
GetCustomAttribute<T>(Assembly)	Recupera um atributo personalizado de um tipo especificado que é aplicado a um assembly especificado.
GetCustomAttributes(Assembly)	Recupera uma coleção de atributos personalizados que são aplicados a um assembly especificado.
GetCustomAttributes(Assembly, Type)	Recupera uma coleção de atributos personalizados de um tipo especificado que são aplicados a um assembly especificado.
GetCustomAttributes<T>(Assembly)	Recupera uma coleção de atributos personalizados de um tipo especificado que são aplicados a um assembly especificado.
IsDefined(Assembly, Type)	Indica se atributos personalizados de um tipo especificado são aplicados a um assembly especificado.
TryGetRawMetadata(Assembly, Byte*, Int32)	Recupera a seção de metadados do assembly, para uso com MetadataReader.

Acesso thread-safe

Esse tipo é thread safe.

Confira também

• AppDomain
• AssemblyName
• domínios de aplicativo