Delen via


Procedure: Bepalen of een bestand een assembly is

Een bestand is een assembly als en alleen als het wordt beheerd en bevat een assembly-vermelding in de metagegevens. Zie Assembly-manifest voor meer informatie over assembly's en metagegevens.

Handmatig bepalen of een bestand een assembly is

  1. Start het hulpprogramma Ildasm.exe (IL Disassembler).

  2. Laad het bestand dat u wilt testen.

  3. Als ILDASM rapporteert dat het bestand geen draagbaar uitvoerbaar (PE)-bestand is, is het geen assembly. Zie het onderwerp Procedure: Assembly-inhoud weergeven voor meer informatie.

Programmatisch bepalen of een bestand een assembly is

De AssemblyName-klasse gebruiken

  1. Roep de AssemblyName.GetAssemblyName methode aan en geef het volledige bestandspad en de naam door van het bestand dat u test.

  2. Als er een BadImageFormatException uitzondering optreedt, is het bestand geen assembly.

In dit voorbeeld wordt een DLL getest om te zien of het een assembly is.

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.  

Met GetAssemblyName de methode wordt het testbestand geladen en vervolgens vrijgegeven zodra de informatie is gelezen.

De PEReader-klasse gebruiken

  1. Als u zich richt op .NET Standard of .NET Framework, installeert u het NuGet-pakket System.Reflection.Metadata . (Als u zich richt op .NET Core of .NET 5+, is deze stap niet vereist omdat deze bibliotheek is opgenomen in het gedeelde framework.)

  2. Maak een System.IO.FileStream exemplaar om gegevens te lezen uit het bestand dat u test.

  3. Maak een System.Reflection.PortableExecutable.PEReader exemplaar, waarbij de bestandsstroom wordt doorgegeven aan de constructor.

  4. Controleer de waarde van de HasMetadata eigenschap. Als de waarde is, is falsehet bestand geen assembly.

  5. Roep de GetMetadataReader methode aan op het PE-lezerexemplaren om een metagegevenslezer te maken.

  6. Controleer de waarde van de IsAssembly eigenschap. Als de waarde is true, is het bestand een assembly.

In tegenstelling tot de GetAssemblyName methode genereert de PEReader klasse geen uitzondering op systeemeigen PE-bestanden (Portable Executable). Hierdoor kunt u de extra prestatiekosten voorkomen die worden veroorzaakt door uitzonderingen wanneer u dergelijke bestanden moet controleren. U moet nog steeds uitzonderingen afhandelen als het bestand niet bestaat of geen PE-bestand is.

In dit voorbeeld ziet u hoe u kunt bepalen of een bestand een assembly is die gebruikmaakt van de PEReader klasse.

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.

Zie ook