Como determinar se um arquivo é um assembly

  • Artigo

Um arquivo será um assembly somente se ele for gerenciado e se contiver uma entrada de assembly em seus metadados. Para obter mais informações sobre metadados e assemblies, confira Manifesto do assembly.

Como determinar manualmente se um arquivo é um assembly

  1. Inicie a ferramenta Ildasm.exe (Desmontador IL).

  2. Carregue o arquivo que você deseja testar.

  3. Se o ILDASM relatar que o arquivo não é um arquivo PE (executável portátil), então ele não será um assembly. Para obter mais informações, consulte o tópico Como exibir o conteúdo de um assembly.

Como determinar programaticamente se um arquivo é um assembly

Usando a classe AssemblyName

  1. Chame o método AssemblyName.GetAssemblyName, passando o caminho do arquivo completo e o nome do arquivo que você está testando.

  2. Se uma exceção BadImageFormatException é gerada, o arquivo não é um assembly.

Este exemplo testa uma DLL para verificar se ela é um assembly.

using System;
using System.IO;
using System.Reflection;
using System.Runtime.InteropServices;

static class ExampleAssemblyName
{
    public static void CheckAssembly()
    {
        try
        {
            string path = Path.Combine(
                RuntimeEnvironment.GetRuntimeDirectory(),
                "System.Net.dll");

            AssemblyName testAssembly = AssemblyName.GetAssemblyName(path);
            Console.WriteLine("Yes, the file is an assembly.");
        }
        catch (FileNotFoundException)
        {
            Console.WriteLine("The file cannot be found.");
        }
        catch (BadImageFormatException)
        {
            Console.WriteLine("The file is not an assembly.");
        }
        catch (FileLoadException)
        {
            Console.WriteLine("The assembly has already been loaded.");
        }
    }

    /* Output: 
    Yes, the file is an assembly.  
    */
}

Imports System
Imports System.IO
Imports System.Reflection
Imports System.Runtime.InteropServices

Module ExampleAssemblyName
    Sub CheckAssembly()
        Try
            Dim filePath As String = Path.Combine(
                RuntimeEnvironment.GetRuntimeDirectory(),
                "System.Net.dll")

            Dim testAssembly As AssemblyName =
                                AssemblyName.GetAssemblyName(filePath)
            Console.WriteLine("Yes, the file is an Assembly.")
        Catch ex As FileNotFoundException
            Console.WriteLine("The file cannot be found.")
        Catch ex As BadImageFormatException
            Console.WriteLine("The file is not an Assembly.")
        Catch ex As FileLoadException
            Console.WriteLine("The Assembly has already been loaded.")
        End Try
    End Sub
End Module
' Output:  
' Yes, the file is an Assembly.

O método GetAssemblyName carrega o arquivo de teste e o libera quando a informação é lida.

Usando a classe PEReader

  1. Se você tiver como alvo o .NET Standard ou o .NET Framework, instale o pacote NuGet System.Reflection.Metadata. (Quando o alvo é o .NET Core ou o .NET 5+, essa etapa não é necessária porque a biblioteca está incluída na estrutura compartilhada.)

  2. Crie uma instância System.IO.FileStream para ler dados do arquivo que você está testando.

  3. Crie uma instânciaSystem.Reflection.PortableExecutable.PEReader, passando o fluxo de arquivos para o construtor.

  4. Verifique o valor da propriedade HasMetadata. Se o valor for false, o arquivo não é um assembly.

  5. Chame o método GetMetadataReader na instância de leitor de PE para criar um leitor de metadados.

  6. Verifique o valor da propriedade IsAssembly. Se o valor for true, o arquivo é um assembly.

Ao contrário do método GetAssemblyName, a classe PEReader não gera uma exceção em arquivos PE (executáveis portáteis) nativos. Isso permite evitar o custo extra de desempenho causado por exceções quando você precisa verificar esses arquivos. Você ainda precisa lidar com exceções caso o arquivo não exista ou não seja um arquivo PE.

Este exemplo mostra como determinar se um arquivo é um assembly usando a classe PEReader.

using System;
using System.Collections.Generic;
using System.IO;
using System.Reflection.Metadata;
using System.Reflection.PortableExecutable;
using System.Runtime.InteropServices;

static class ExamplePeReader
{
    static bool IsAssembly(string path)
    {
        using var fs = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.ReadWrite);

        // Try to read CLI metadata from the PE file.
        using var peReader = new PEReader(fs);

        if (!peReader.HasMetadata)
        {
            return false; // File does not have CLI metadata.
        }

        // Check that file has an assembly manifest.
        MetadataReader reader = peReader.GetMetadataReader();
        return reader.IsAssembly;
    }

    public static void CheckAssembly()
    {
        string path = Path.Combine(
                RuntimeEnvironment.GetRuntimeDirectory(),
                "System.Net.dll");

        try
        {
            if (IsAssembly(path))
            {
                Console.WriteLine("Yes, the file is an assembly.");
            }
            else
            {
                Console.WriteLine("The file is not an assembly.");
            }
        }
        catch (BadImageFormatException)
        {
            Console.WriteLine("The file is not an executable.");
        }
        catch (FileNotFoundException)
        {
            Console.WriteLine("The file cannot be found.");
        }
    }

    /* Output: 
    Yes, the file is an assembly.  
    */
}

Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Reflection.Metadata
Imports System.Reflection.PortableExecutable
Imports System.Runtime.InteropServices

Module ExamplePeReader
    Function IsAssembly(path As String) As Boolean

        Dim fs As FileStream = New FileStream(path, FileMode.Open, FileAccess.Read, FileShare.ReadWrite)

        ' Try to read CLI metadata from the PE file.
        Dim peReader As PEReader = New PEReader(fs)
        Using (peReader)
            If Not peReader.HasMetadata Then
                Return False ' File does Not have CLI metadata.
            End If

            ' Check that file has an assembly manifest.
            Dim reader As MetadataReader = peReader.GetMetadataReader()
            Return reader.IsAssembly
        End Using
    End Function

    Sub CheckAssembly()
        Dim filePath As String = Path.Combine(
                RuntimeEnvironment.GetRuntimeDirectory(),
                "System.Net.dll")

        Try
            If IsAssembly(filePath) Then
                Console.WriteLine("Yes, the file is an assembly.")
            Else
                Console.WriteLine("The file is not an assembly.")
            End If
        Catch ex As BadImageFormatException
            Console.WriteLine("The file is not an executable.")
        Catch ex As FileNotFoundException
            Console.WriteLine("The file cannot be found.")
        End Try
    End Sub
End Module
' Output:  
' Yes, the file is an Assembly.

Confira também