EntryPointNotFoundException 类

定义

命名空间:: System

程序集:: netstandard.dll, System.Runtime.dll

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

Source:: EntryPointNotFoundException.cs

Source:: EntryPointNotFoundException.cs

Source:: EntryPointNotFoundException.cs

Source:: EntryPointNotFoundException.cs

Source:: EntryPointNotFoundException.cs

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

尝试加载类时引发的异常因缺少条目方法而失败。

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

继承: Object

Exception

SystemException

TypeLoadException
EntryPointNotFoundException

属性: SerializableAttribute ComVisibleAttribute

注解

EntryPointNotFoundException当公共语言运行时无法加载程序集时，将引发异常，因为它无法标识程序集的入口点。在以下情况下，可能会引发此异常：

公共语言运行时无法在可执行程序集中找到应用程序入口点（通常是 Main 方法）。应用程序入口点必须是没有参数或字符串数组作为其唯一参数的全局或 static 方法。入口点可以返回 void，也可以返回 Int32 或 UInt32 退出代码。应用程序程序集不能定义多个入口点。

无法解析对 Windows DLL 中的函数的调用，因为找不到该函数。在以下示例中， EntryPointNotFoundException 由于 User32.dll 不包含名为 GetMyNumber 的函数，因此引发异常。

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'.

无法解析对 Windows DLL 中的函数的调用，因为方法调用中使用的名称与程序集中找到的名称不匹配。这种情况经常发生，因为 DllImportAttribute.ExactSpelling 字段是隐式或显式设置为 true的，调用的方法包括一个或多个字符串参数，并且同时具有 ANSI 和 Unicode 版本，并且方法调用中使用的名称与此 ANSI 或 Unicode 版本的名称不对应。以下示例通过尝试在 User32.dll中调用 Windows MessageBox 函数来提供插图。由于第一个方法定义指定 CharSet.Unicode 字符串封送，因此公共语言查找函数的宽字符版本， MessageBoxW而不是方法调用 MessageBox中使用的名称。第二个方法定义通过调用 MessageBoxW 而不是 MessageBox 函数来更正此问题。

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

你正尝试通过其简单名称而不是修饰名称调用动态链接库中的函数。通常，C++ 编译器为 DLL 函数生成修饰名称。例如，以下 C++ 代码定义一个名为 TestDll.dll的库中命名 Double 的函数。

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

当以下示例中的代码尝试调用函数时， EntryPointNotFoundException 将引发异常，因为找不到该 Double 函数。

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()

但是，如果使用函数的修饰名称（在本例 ?Double@@YAHH@Z中为），则函数调用成功，如以下示例所示。

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

可以使用实用工具（如 Dumpbin.exe）找到 DLL 导出的函数的修饰名称。

尝试在托管程序集中调用方法，就像它是非托管动态链接库一样。若要查看此操作，请将以下示例编译为名为 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

然后编译并执行以下示例，该示例尝试调用 StringUtilities.SayGoodMorning StringUtilities.dll 动态链接库中的方法，就好像它是非托管代码一样。结果是一个 EntryPointNotFoundException 异常。

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()

若要消除异常，请添加对托管程序集的引用，并像在托管代码中访问任何其他方法一样访问 StringUtilities.SayGoodMorning 该方法，如以下示例所示。

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!

尝试在 COM DLL 中调用方法，就像它是Windows DLL 一样。若要访问 COM DLL，请在 Visual Studio 中选择 Add Reference 选项以添加对项目的引用，然后从 COM 选项卡中选择类型库。

有关实例 EntryPointNotFoundException的初始属性值列表，请参阅 EntryPointNotFoundException 构造函数。

构造函数

名称	说明
EntryPointNotFoundException()	初始化 EntryPointNotFoundException 类的新实例。
EntryPointNotFoundException(SerializationInfo, StreamingContext)	已过时. 使用序列化的数据初始化 EntryPointNotFoundException 类的新实例。
EntryPointNotFoundException(String, Exception)	使用指定的错误消息和对作为此异常原因的内部异常的引用初始化 EntryPointNotFoundException 类的新实例。
EntryPointNotFoundException(String)	使用指定的错误消息初始化类的新实例 EntryPointNotFoundException 。

属性

名称	说明
Data	获取键/值对的集合，这些键/值对提供有关异常的其他用户定义的信息。 (继承自 Exception)
HelpLink	获取或设置与此异常关联的帮助文件的链接。 (继承自 Exception)
HResult	获取或设置 HRESULT，它是分配给特定异常的编码数值。 (继承自 Exception)
InnerException	Exception获取导致当前异常的实例。 (继承自 Exception)
Message	获取此异常的错误消息。 (继承自 TypeLoadException)
Source	获取或设置导致错误的应用程序或对象的名称。 (继承自 Exception)
StackTrace	获取调用堆栈上即时帧的字符串表示形式。 (继承自 Exception)
TargetSite	获取引发当前异常的方法。 (继承自 Exception)
TypeName	获取导致异常的类型的完全限定名称。 (继承自 TypeLoadException)

方法

名称	说明
Equals(Object)	确定指定的对象是否等于当前对象。 (继承自 Object)
GetBaseException()	在派生类中重写时，返回 Exception 一个或多个后续异常的根本原因。 (继承自 Exception)
GetHashCode()	用作默认哈希函数。 (继承自 Object)
GetObjectData(SerializationInfo, StreamingContext)	已过时. SerializationInfo使用类名、方法名称、资源 ID 和其他异常信息设置对象。 (继承自 TypeLoadException)
GetType()	获取当前实例的运行时类型。 (继承自 Exception)
MemberwiseClone()	创建当前 Object的浅表副本。 (继承自 Object)
ToString()	创建并返回当前异常的字符串表示形式。 (继承自 Exception)

活动

名称	说明
SerializeObjectState	已过时. 序列化异常以创建包含有关异常的序列化数据的异常状态对象时发生。 (继承自 Exception)

适用于

另请参阅

反馈

此页面是否有帮助？