Практическое руководство. Определение того, является ли файл сборкой

Файл является сборкой, если она управляется и содержит запись сборки в метаданных. Дополнительные сведения о сборках и метаданных см. в манифесте сборки.

Как вручную определить, является ли файл сборкой

  1. Запустите средство Ildasm.exe (IL Disassembler).

  2. Загрузите файл, который требуется протестировать.

  3. Если ILDASM сообщает, что файл не является переносимым исполняемым файлом (PE), то он не является сборкой. Дополнительные сведения см. в разделе "Практическое руководство. Просмотр содержимого сборки".

Как программно определить, является ли файл сборкой

Использование класса AssemblyName

  1. AssemblyName.GetAssemblyName Вызовите метод, передав полный путь к файлу и имя тестового файла.

  2. BadImageFormatException Если выбрасывается исключение, файл не является сборкой.

В этом примере выполняется проверка библиотеки DLL, чтобы узнать, является ли она сборкой.

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.

Метод GetAssemblyName загружает тестовый файл, а затем освобождает его после чтения информации.

Использование класса PEReader

Предостережение

PEReader и библиотека System.Reflection.Metadata не предназначены для обработки ненадежных входных данных. Неправильные или вредоносные файлы PE могут привести к непредвиденному поведению, что может включать доступ к памяти за пределами допустимых границ, сбои и зависания. Используйте только эти API с доверенными сборками.

  1. Если вы нацелены на .NET Standard или .NET Framework, установите пакет NuGet system.Reflection.Metadata . (При использовании .NET Core или .NET 5+этот шаг не требуется, так как эта библиотека включена в общую платформу.)

  2. System.IO.FileStream Создайте экземпляр для чтения данных из тестового файла.

  3. System.Reflection.PortableExecutable.PEReader Создайте экземпляр, передав поток файлов в конструктор.

  4. Проверьте значение HasMetadata свойства. Если значение равно false, файл не является сборкой.

  5. Вызовите метод GetMetadataReader на экземпляре средства чтения PE, чтобы создать средство чтения метаданных.

  6. Проверьте значение IsAssembly свойства. Если значение равно true, файл является сборкой.

GetAssemblyName В отличие от метода, класс PEReader не выдает исключение для нативных PE файлов. Это позволяет избежать дополнительных затрат на производительность, вызванных исключениями, когда необходимо проверить такие файлы. Вам по-прежнему необходимо обрабатывать исключения в случае, если файл не существует или не является PE-файлом.

В этом примере показано, как определить, является ли файл сборкой с помощью 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.

См. также

  • Last updated on