Assembly Classe

Definição

Namespace:

System.Reflection

Assembly:

System.Runtime.dll

Source:

Assembly.cs

Representa um assembly, que é um bloco de construção autodescritivo, versátil e reutilizável de 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 GetName método para obter um AssemblyName objeto que pode ser usado para analisar o nome completo do assembly. O exemplo exibe o número de versão do assembly, da CodeBase propriedade e da EntryPoint propriedade .

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 Assembly classe para carregar assemblies, explorar os metadados e as partes constituintes dos assemblies, descobrir os tipos contidos em assemblies e criar instâncias desses tipos.

Para obter uma matriz de Assembly objetos 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 AppDomain.GetAssemblies método .

Para carregar assemblies dinamicamente, a Assembly classe fornece os seguintes métodos estáticos (Shared métodos 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 Load método , 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 para o assembly segue as regras descritas em Como o Runtime localiza assemblies.

• Os ReflectionOnlyLoad métodos 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 por código em execução em uma plataforma de 32 bits.

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

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

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

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

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

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

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

O GetTypes método lista todos os tipos no assembly. O GetExportedTypes método lista os tipos visíveis para os chamadores fora do assembly. O GetType método pode ser usado para pesquisar um tipo específico no assembly. O CreateInstance método 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 como especificado originalmente, por exemplo, em um objeto AssemblyName.
CustomAttributes	Obtém uma coleção que contém os atributos personalizados deste assembly.
DefinedTypes	Obtém uma coleção dos tipos definidos nesse assembly.
EntryPoint	Obtém o ponto de entrada desse 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 nesse assembly 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 .NET Framework).
HostContext	Obtém o contexto de 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 este assembly é mantido em uma coleção AssemblyLoadContext.
IsDynamic	Obtém um valor que indica se o assembly atual foi gerado dinamicamente no processo atual através da emissão de reflexo.
IsFullyTrusted	Obtém um valor que indica se o assembly atual é carregado com confiança total.
Location	Obtém o caminho completo ou uma localização 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 que indica se esse assembly foi carregado no contexto de somente reflexão.
SecurityRuleSet	Obtém um valor que indica qual conjunto de regras de segurança o CLR (Common Language Runtime) impõe a este assembly.

Métodos

CreateInstance(String)	Localiza o tipo especificado desse assembly e cria uma instância dele usando o ativador de 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 de sistema, com pesquisa que diferencia maiúsculas de minúsculas opcional.
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 a pesquisa opcional que diferencia maiúsculas de minúsculas e com a cultura especificada, os argumentos e os atributos de associação e ativação.
CreateQualifiedName(String, String)	Cria o nome de um tipo, qualificado pelo nome de exibição do seu assembly.
Equals(Object)	Determina se este assembly e o objeto especificado são iguais.
GetAssembly(Type)	Obtém o assembly carregado no momento em que o tipo especificado é definido.
GetCallingAssembly()	Retorna o Assembly do método que invocou o método atualmente em execução.
GetCustomAttributes(Boolean)	Obtém todos os atributos personalizados para esse assembly.
GetCustomAttributes(Type, Boolean)	Obtém os atributos personalizados para esse assembly conforme especificado pelo tipo.
GetCustomAttributesData()	Retorna informações sobre os atributos que foram aplicados ao Assemblyatual, expressos como objetos CustomAttributeData .
GetEntryAssembly()	Obtém o processo executável no domínio de aplicativo padrão. Em outros domínios de aplicativo, é o primeiro executável que foi executado por ExecuteAssembly(String).
GetExecutingAssembly()	Obtém o assembly que contém o código executado no momento.
GetExportedTypes()	Obtém os tipos públicos definidos nesse assembly que são visíveis fora do assembly.
GetFile(String)	Obtém um FileStream para o arquivo especificado na tabela de arquivo do manifesto desse assembly.
GetFiles()	Obtém os arquivos na tabela de arquivo de um manifesto do assembly.
GetFiles(Boolean)	Obtém os arquivos na tabela de arquivos de um manifesto do assembly, especificando se deseja-se incluir os módulos de recursos.
GetForwardedTypes()	Representa um assembly, que é um bloco de construção autodescritivo, versátil e reutilizável de um aplicativo de common language runtime.
GetHashCode()	Retorna o código hash para a instância.
GetLoadedModules()	Obtém todos os módulos carregados que fazem parte desse assembly.
GetLoadedModules(Boolean)	Obtém todos os módulos carregados que fazem parte desse assembly, especificando se os módulos de recursos devem ser incluídos.
GetManifestResourceInfo(String)	Retorna informações sobre como o recurso em questão foi persistido.
GetManifestResourceNames()	Retorna os nomes de todos os recursos nesse assembly.
GetManifestResourceStream(String)	Carrega o recurso de manifesto especificado desse assembly.
GetManifestResourceStream(Type, String)	Carrega o recurso de manifesto especificado, o escopo pelo namespace do tipo especificado, desse assembly.
GetModule(String)	Obtém o módulo especificado nesse assembly.
GetModules()	Obtém todos os módulos que fazem parte desse assembly.
GetModules(Boolean)	Obtém todos os módulos que fazem parte desse assembly, especificando se os módulos de recursos devem ser incluídos.
GetName()	Obtém um AssemblyName para esse assembly.
GetName(Boolean)	Obtém um AssemblyName para esse assembly, definindo a base de código como especificado por copiedName.
GetObjectData(SerializationInfo, StreamingContext)	Obsoleto. Obtém informações de serialização com todos os dados necessários para recriar uma instância desse assembly.
GetReferencedAssemblies()	Obtém os objetos AssemblyName para todos os assemblies referenciados por esse 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, lança 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 a opção de ignorar a diferença entre maiúsculas e minúsculas 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 foi aplicado ao assembly.
Load(AssemblyName)	Carrega um assembly de acordo com seu AssemblyName.
Load(Byte[])	Carrega o assembly com uma imagem baseada em formato COFF, contendo um assembly emitido.
Load(Byte[], Byte[])	Carrega o assembly com uma imagem baseada em formato COFF, contendo um assembly emitido e com a opção de incluir símbolos para o assembly.
Load(String)	Carrega um assembly com o nome especificado.
LoadFile(String)	Carrega o conteúdo de um arquivo do assembly no caminho especificado.
LoadFrom(String)	Carrega um assembly de acordo com o nome de arquivo ou caminho.
LoadFrom(String, Byte[], AssemblyHashAlgorithm)	Carrega um assembly de acordo com o nome de arquivo ou caminho, valor e algoritmo de hash.
LoadModule(String, Byte[])	Carrega o módulo, interno a esse assembly, com uma imagem baseada no formato COFF que contém um módulo emitido ou um arquivo de recurso.
LoadModule(String, Byte[], Byte[])	Carrega o módulo, interno a esse assembly, com uma imagem baseada no formato COFF que contém um módulo emitido ou um arquivo de recurso. Os bytes brutos que representam os símbolos para o 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 Object atual. (Herdado de Object)
ReflectionOnlyLoad(Byte[])	Obsoleto. Carrega o assembly de uma imagem baseada em formato COFF contendo um assembly emitido. O assembly é carregado no contexto de somente reflexão do domínio do aplicativo do chamador.
ReflectionOnlyLoad(String)	Obsoleto. Carrega um assembly no contexto somente de reflexão, dado seu nome de exibição.
ReflectionOnlyLoadFrom(String)	Obsoleto. Carrega um assembly no contexto somente de reflexão, dado 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 carga, 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 do Common Language Runtime não é capaz de resolver uma referência a um módulo interno de um assembly por meios normais.

Métodos de Extensão

GetExportedTypes(Assembly)	Representa um assembly, que é um bloco de construção autodescritivo, versátil e reutilizável de um aplicativo de common language runtime.
GetModules(Assembly)	Representa um assembly, que é um bloco de construção autodescritivo, versátil e reutilizável de um aplicativo de common language runtime.
GetTypes(Assembly)	Representa um assembly, que é um bloco de construção autodescritivo, versátil e reutilizável de um aplicativo de common language runtime.
GetCustomAttribute(Assembly, Type)	Recupera um atributo personalizado de um tipo especificado aplicado a um assembly especificado.
GetCustomAttribute<T>(Assembly)	Recupera um atributo personalizado de um tipo especificado 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 os atributos personalizados de um tipo especificados 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

Este tipo é thread-safe.

Confira também

• AppDomain
• AssemblyName
• Domínios do aplicativo