EntryPointNotFoundException Klas

Definitie

public ref class EntryPointNotFoundException : TypeLoadException

public class EntryPointNotFoundException : TypeLoadException

[System.Serializable]
public class EntryPointNotFoundException : TypeLoadException

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class EntryPointNotFoundException : TypeLoadException

type EntryPointNotFoundException = class
    inherit TypeLoadException

[<System.Serializable>]
type EntryPointNotFoundException = class
    inherit TypeLoadException

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type EntryPointNotFoundException = class
    inherit TypeLoadException

Public Class EntryPointNotFoundException
Inherits TypeLoadException

Overname

Object

Exception

SystemException

TypeLoadException

EntryPointNotFoundException

Kenmerken

SerializableAttribute ComVisibleAttribute

Opmerkingen

Er EntryPointNotFoundException wordt een uitzondering gegenereerd wanneer de algemene taalruntime een assembly niet kan laden omdat het toegangspunt van de assembly niet kan worden geïdentificeerd. Deze uitzondering kan worden gegenereerd onder de volgende omstandigheden:

• De algemene taalruntime kan geen toepassingsinvoerpunt (meestal een Main methode) vinden in een uitvoerbare assembly. Het invoerpunt van de toepassing moet een globale of static methode zijn die geen parameters of een tekenreeksmatrix als enige parameter heeft. Het ingangspunt kan worden geretourneerd voidof kan een Int32 of UInt32 afsluitcode retourneren. Een toepassingsassembly kan niet meer dan één toegangspunt definiëren.

• De aanroep van een functie in een Windows DLL kan niet worden opgelost omdat de functie niet kan worden gevonden. In het volgende voorbeeld wordt een EntryPointNotFoundException uitzondering gegenereerd omdat User32.dll geen functie met de naam GetMyNumberbevat.

  using System;
  using System.Runtime.InteropServices;
  
  public class Example
  {
     [DllImport("user32.dll")]
     public static extern int GetMyNumber();
  
     public static void Main()
     {
        try {
           int number = GetMyNumber();
        }
        catch (EntryPointNotFoundException e) {
           Console.WriteLine("{0}:\n   {1}", e.GetType().Name,
                             e.Message);
        }
     }
  }
  // The example displays the following output:
  //    EntryPointNotFoundException:
  //       Unable to find an entry point named 'GetMyNumber' in DLL 'User32.dll'.
  

  open System
  open System.Runtime.InteropServices
  
  [<DllImport "user32.dll">]
  extern int GetMyNumber()
  
  try
      let number = GetMyNumber()
      ()
  with :? EntryPointNotFoundException as e ->
      printfn $"{e.GetType().Name}:\n   {e.Message}"
  
  // The example displays the following output:
  //    EntryPointNotFoundException:
  //       Unable to find an entry point named 'GetMyNumber' in DLL 'User32.dll'.
  

  Module Example
      Declare Auto Function GetMyNumber Lib "User32.dll" () As Integer
  
     Public Sub Main()
        Try
           Dim number As Integer = GetMyNumber()
        Catch e As EntryPointNotFoundException
           Console.WriteLine("{0}:{2}   {1}", e.GetType().Name,  
                             e.Message, vbCrLf)
        End Try   
     End Sub
  End Module
  ' The example displays the following output:
  '    EntryPointNotFoundException:
  '       Unable to find an entry point named 'GetMyNumber' in DLL 'User32.dll'.
  

• De aanroep van een functie in een Windows DLL kan niet worden omgezet omdat de naam die in de methode-aanroep wordt gebruikt, niet overeenkomt met een naam die in de assembly is gevonden. Dit gebeurt vaak omdat het DllImportAttribute.ExactSpelling veld impliciet of expliciet is ingesteld trueop, de aangeroepen methode een of meer tekenreeksparameters bevat en zowel een ANSI als een Unicode-versie heeft en de naam die in de methodeaanroep wordt gebruikt, niet overeenkomt met de naam van deze ANSI- of Unicode-versie. In het volgende voorbeeld ziet u een afbeelding door de functie Windows MessageBox aan te roepen in User32.dll. Omdat de eerste methodedefinitie aangeeft CharSet.Unicode voor tekenreeks marshaling, zoekt de algemene taal naar de brede tekenversie van de functie, MessageBoxWin plaats van de naam die wordt gebruikt in de methode-aanroep, MessageBox. Met de tweede methodedefinitie wordt dit probleem opgelost door de MessageBoxW in plaats van de MessageBox functie aan te roepen.

  using System;
  using System.Runtime.InteropServices;
  
  public class Example
  {
     [DllImport("user32.dll", CharSet = CharSet.Unicode, ExactSpelling = true )]
     public static extern int MessageBox(IntPtr hwnd, String text, String caption, uint type);
  
     [DllImport("user32.dll", CharSet = CharSet.Unicode, ExactSpelling = true )]
     public static extern int MessageBoxW(IntPtr hwnd, String text, String caption, uint type);
  
     public static void Main()
     {
        try {
           MessageBox(new IntPtr(0), "Calling the MessageBox Function", "Example", 0);
        }
        catch (EntryPointNotFoundException e) {
           Console.WriteLine("{0}:\n   {1}", e.GetType().Name,
                             e.Message);
        }
  
        try {
           MessageBoxW(new IntPtr(0), "Calling the MessageBox Function", "Example", 0);
        }
        catch (EntryPointNotFoundException e) {
           Console.WriteLine("{0}:\n   {1}", e.GetType().Name,
                             e.Message);
        }
     }
  }
  

  open System
  open System.Runtime.InteropServices
  
  [<DllImport("user32.dll", CharSet = CharSet.Unicode, ExactSpelling = true )>]
  extern int MessageBox(IntPtr hwnd, String text, String caption, uint ``type``)
  
  [<DllImport("user32.dll", CharSet = CharSet.Unicode, ExactSpelling = true )>]
  extern int MessageBoxW(IntPtr hwnd, String text, String caption, uint ``type``)
  
  try
      MessageBox(IntPtr 0, "Calling the MessageBox Function", "Example", 0u)
      |> ignore
  with :? EntryPointNotFoundException as e ->
      printfn $"{e.GetType().Name}:\n   {e.Message}"
  
  try
      MessageBoxW(IntPtr 0, "Calling the MessageBox Function", "Example", 0u)
      |> ignore
  with :? EntryPointNotFoundException as e ->
      printfn $"{e.GetType().Name}:\n   {e.Message}"
  

  Module Example
     Declare Unicode Function MessageBox Lib "User32.dll" Alias "MessageBox" (
        ByVal hWnd As IntPtr, ByVal txt As String, ByVal caption As String, 
        ByVal typ As UInteger) As Integer  
  
     Declare Unicode Function MessageBox2 Lib "User32.dll" Alias "MessageBoxW" (  
        ByVal hWnd As IntPtr, ByVal txt As String, ByVal caption As String, 
        ByVal typ As UInteger) As Integer  
        
     Public Sub Main()
        Try
           MessageBox(IntPtr.Zero, "Calling the MessageBox Function", "Example", 0 )
        Catch e As EntryPointNotFoundException
           Console.WriteLine("{0}:{2}   {1}", e.GetType().Name,  
                             e.Message, vbCrLf)
        End Try
  
        Try
           MessageBox2(IntPtr.Zero, "Calling the MessageBox Function", "Example", 0 )
        Catch e As EntryPointNotFoundException
           Console.WriteLine("{0}:{2}   {1}", e.GetType().Name,  
                             e.Message, vbCrLf)
        End Try
  
     End Sub
  End Module
  

• U probeert een functie in een dynamische koppelingsbibliotheek aan te roepen op basis van de eenvoudige naam in plaats van de versierde naam. Normaal gesproken genereert de C++-compiler een versierde naam voor DLL-functies. Met de volgende C++-code wordt bijvoorbeeld een functie gedefinieerd die wordt genoemd Double in een bibliotheek met de naam TestDll.dll.

  __declspec(dllexport) int Double(int number)
  {
      return number * 2;
  }
  

  Wanneer de code in het volgende voorbeeld de functie probeert aan te roepen, wordt er een EntryPointNotFoundException uitzondering gegenereerd omdat de Double functie niet kan worden gevonden.

  using System;
  using System.Runtime.InteropServices;
  
  public class Example
  {
     [DllImport("TestDll.dll")]
     public static extern int Double(int number);
  
     public static void Main()
     {
        Console.WriteLine(Double(10));
     }
  }
  // The example displays the following output:
  //    Unhandled Exception: System.EntryPointNotFoundException: Unable to find
  //    an entry point named 'Double' in DLL '.\TestDll.dll'.
  //       at Example.Double(Int32 number)
  //       at Example.Main()
  

  open System
  open System.Runtime.InteropServices
  
  [<DllImport "TestDll.dll">]
  extern int Double(int number)
  
  printfn $"{Double 10}"
  // The example displays the following output:
  //    Unhandled Exception: System.EntryPointNotFoundException: Unable to find
  //    an entry point named 'Double' in DLL '.\TestDll.dll'.
  //       at Example.Double(Int32 number)
  //       at Example.Main()
  

  Module Example
     Public Declare Function DoubleNum Lib ".\TestDll.dll" Alias "Double" _
                    (ByVal number As Integer) As Integer
     
     Public Sub Main()
        Console.WriteLine(DoubleNum(10))
     End Sub
  End Module
  ' The example displays the following output:
  '    Unhandled Exception: System.EntryPointNotFoundException: Unable to find an 
  '    entry point named 'Double' in DLL '.\TestDll.dll'.
  '       at Example.Double(Int32 number)
  '       at Example.Main()
  

  Als de functie echter wordt aangeroepen met behulp van de versieringsnaam (in dit geval ?Double@@YAHH@Z), slaagt de functie-aanroep, zoals in het volgende voorbeeld wordt weergegeven.

  using System;
  using System.Runtime.InteropServices;
  
  public class Example
  {
     [DllImport("TestDll.dll", EntryPoint = "?Double@@YAHH@Z")]
     public static extern int Double(int number);
  
     public static void Main()
     {
        Console.WriteLine(Double(10));
     }
  }
  // The example displays the following output:
  //    20
  

  open System
  open System.Runtime.InteropServices
  
  [<DllImport("TestDll.dll", EntryPoint = "?Double@@YAHH@Z")>]
  extern int Double(int number)
  
  printfn $"{Double 10}"
  // The example displays the following output:
  //    20
  

  Module Example
     Public Declare Function DoubleNum Lib ".\TestDll.dll" Alias "?Double@@YAHH@Z" _
                    (ByVal number As Integer) As Integer
     
     Public Sub Main()
        Console.WriteLine(DoubleNum(10))
     End Sub
  End Module
  ' The example displays the following output:
  '    20
  

  U vindt de versierde namen van functies die door een DLL worden geëxporteerd met behulp van een hulpprogramma zoals Dumpbin.exe.

• U probeert een methode aan te roepen in een beheerde assembly alsof het een niet-beheerde dynamische koppelingsbibliotheek is. Als u dit in actie wilt zien, compileert u het volgende voorbeeld naar een assembly met de naam StringUtilities.dll.

  using System;
  
  public static class StringUtilities
  {
     public static String SayGoodMorning(String name)
     {
        return String.Format("A top of the morning to you, {0}!", name);
     }
  }
  

  module StringUtilities
  
  let SayGoodMorning name =
      $"A top of the morning to you, %s{name}!"
  

  Module StringUtilities
     Public Function SayGoodMorning(name As String) As String
        Return String.Format("A top of the morning to you, {0}!", name)
     End Function
  End Module
  

  Compileer en voer vervolgens het volgende voorbeeld uit, waarmee de StringUtilities.SayGoodMorning methode in de StringUtilities.dll dynamische koppelingsbibliotheek wordt aangeroepen alsof deze niet-beheerde code is. Het resultaat is een EntryPointNotFoundException uitzondering.

  using System;
  using System.Runtime.InteropServices;
  
  public class Example
  {
     [DllImport("StringUtilities.dll", CharSet = CharSet.Unicode )]
     public static extern String SayGoodMorning(String name);
  
     public static void Main()
     {
        Console.WriteLine(SayGoodMorning("Dakota"));
     }
  }
  // The example displays the following output:
  //    Unhandled Exception: System.EntryPointNotFoundException: Unable to find an entry point
  //    named 'GoodMorning' in DLL 'StringUtilities.dll'.
  //       at Example.GoodMorning(String& name)
  //       at Example.Main()
  

  open System
  open System.Runtime.InteropServices
  
  [<DllImport("StringUtilities.dll", CharSet = CharSet.Unicode )>]
  extern String SayGoodMorning(String name)
  
  printfn $"""{SayGoodMorning "Dakota"}"""
  // The example displays the following output:
  //    Unhandled Exception: System.EntryPointNotFoundException: Unable to find an entry point
  //    named 'GoodMorning' in DLL 'StringUtilities.dll'.
  //       at Example.GoodMorning(String& name)
  //       at Example.Main()
  

  Module Example
     Declare Unicode Function GoodMorning Lib "StringUtilities.dll" (
        ByVal name As String) As String  
  
     Public Sub Main()
        Console.WriteLine(SayGoodMorning("Dakota"))
     End Sub
  End Module
  ' The example displays the following output:
  '    Unhandled Exception: System.EntryPointNotFoundException: Unable to find an entry point 
  '    named 'GoodMorning' in DLL 'StringUtilities.dll'.
  '       at Example.GoodMorning(String& name)
  '       at Example.Main()
  

  Als u de uitzondering wilt elimineren, voegt u een verwijzing toe naar de beheerde assembly en opent u de StringUtilities.SayGoodMorning methode, net zoals bij elke andere methode in beheerde code, zoals in het volgende voorbeeld.

  using System;
  
  public class Example
  {
     public static void Main()
     {
         Console.WriteLine(StringUtilities.SayGoodMorning("Dakota"));
     }
  }
  // The example displays the following output:
  //        A top of the morning to you, Dakota!
  

  printfn $"""{StringUtilities.SayGoodMorning "Dakota"}"""
  // The example displays the following output:
  //        A top of the morning to you, Dakota!
  

  Module Example
     Public Sub Main()
        Console.WriteLine(StringUtilities.SayGoodMorning("Dakota"))
     End Sub
  End Module
  ' The example displays the following output:
  '       A top of the morning to you, Dakota!
  

• U probeert een methode aan te roepen in een COM-DLL alsof het een Windows DLL was. Als u toegang wilt krijgen tot een COM-DLL, selecteert u de optie Toevoeging in Visual Studio om een verwijzing naar het project toe te voegen en selecteert u vervolgens de typebibliotheek op het tabblad COM.

Voor een lijst van initiële eigenschapswaarden voor een exemplaar van EntryPointNotFoundException, zie de EntryPointNotFoundException-constructoren.

Zie ook

• Exception
• Uitzonderingen verwerken en opwerpen