Como: Determinar se um arquivo é um assembly
Um arquivo é um assembly se e somente se for gerenciado e contém uma entrada de assembly em seus metadados. Para obter mais informações sobre assemblies e metadados, consulte Manifesto do assembly.
Como determinar manualmente se um arquivo é um assembly
Carregue o arquivo que deseja testar.
Se o ILDASM informar que o arquivo não é um arquivo executável portátil (PE), então ele não é um assembly. Para obter mais informações, consulte o tópico Como: Exibir conteúdo de assembly.
Como determinar programaticamente se um arquivo é um assembly
Usando a classe AssemblyName
Chame o AssemblyName.GetAssemblyName método, passando o caminho completo do arquivo e o nome do arquivo que você está testando.
Se uma BadImageFormatException exceção for lançada, o arquivo não será um assembly.
Este exemplo testa uma DLL para ver se é 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 GetAssemblyName método carrega o arquivo de teste e, em seguida, libera-o assim que as informações são lidas.
Usando a classe PEReader
Se você estiver visando o .NET Standard ou o .NET Framework, instale o pacote NuGet System.Reflection.Metadata. (Ao direcionar o .NET Core ou o .NET 5+, esta etapa não é necessária porque essa biblioteca está incluída na estrutura compartilhada.)
Crie uma System.IO.FileStream instância para ler dados do arquivo que você está testando.
Crie uma System.Reflection.PortableExecutable.PEReader instância, passando seu fluxo de arquivos para o construtor.
Verifique o valor do HasMetadata imóvel. Se o valor for
false, o arquivo não é um assembly.Chame o GetMetadataReader método na instância do leitor PE para criar um leitor de metadados.
Verifique o valor do IsAssembly imóvel. Se o valor for
true, o arquivo é um assembly.
Ao contrário do GetAssemblyName método, a PEReader classe não lança uma exceção em arquivos executáveis portáteis (PE) nativos. Isso permite que você evite o custo de desempenho extra 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 PEReader classe.
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.
