EntryPointNotFoundException Sınıf

Tanım

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

Devralma

Object

Exception

SystemException

TypeLoadException

EntryPointNotFoundException

Öznitelikler

SerializableAttribute ComVisibleAttribute

Açıklamalar

EntryPointNotFoundException Ortak dil çalışma zamanı derlemenin giriş noktasını tanımlayamadığı için bir derlemeyi yükleyemediğinde bir özel durum oluşur. Bu özel durum aşağıdaki koşullarda oluşturulabilir:

• Ortak dil çalışma zamanı yürütülebilir bir derlemede uygulama giriş noktasını (genellikle bir Main yöntem) bulamıyor. Uygulama giriş noktası, parametresi olmayan bir genel veya static yöntem ya da tek parametresi olarak dize dizisi olmalıdır. Giriş noktası döndürebilir voidveya ya Int32 da UInt32 çıkış kodu döndürebilir. Uygulama derlemesi birden fazla giriş noktası tanımlayamaz.

• İşlev bulunamadığından, Windows DLL'deki bir işleve yapılan çağrı çözümlenemiyor. Aşağıdaki örnekte, User32.dll adlı GetMyNumberbir EntryPointNotFoundException işlev içermediğinden bir özel durum oluşturulur.

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

• Yöntem çağrısında kullanılan ad derlemede bulunan bir adla eşleşmediğinden, Windows DLL'deki bir işleve yapılan çağrı çözümlenemiyor. Bu durum genellikle alanın örtük olarak veya açıkça olarak olarak ayarlanmasından DllImportAttribute.ExactSpellingtrueve çağrılan yöntemin bir veya daha fazla dize parametresi içermesi ve hem ANSI hem de Unicode sürümüne sahip olması ve yöntem çağrısında kullanılan adın bu ANSI veya Unicode sürümünün adıyla aynı olmamasından kaynaklanır. Aşağıdaki örnek, User32.dll'de Windows MessageBox işlevini çağırmayı deneyerek bir çizim sağlar. İlk yöntem tanımı dize hazırlamayı belirttiğindenCharSet.Unicode, ortak dil yöntemi çağrısında MessageBoxkullanılan ad yerine işlevinin MessageBoxWgeniş karakterli sürümünü arar. İkinci yöntem tanımı, işlevi yerine öğesini MessageBoxW çağırarak bu sorunu düzeltmektedir 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
  

• Dinamik bağlantı kitaplığındaki bir işlevi süslü adı yerine basit adıyla çağırmaya çalışıyorsunuz. Genellikle, C++ derleyicisi DLL işlevleri için süslü bir ad oluşturur. Örneğin, aşağıdaki C++ kodu TestDll.dll adlı bir kitaplıkta adlı Double bir işlevi tanımlar.

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

  Aşağıdaki örnekteki kod işlevi çağırmaya çalıştığında, işlev bulunamadığından Double bir EntryPointNotFoundException özel durum oluşturulur.

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

  Ancak, işlev süslü adı kullanılarak çağrılırsa (bu durumda), ?Double@@YAHH@Zaşağıdaki örnekte gösterildiği gibi işlev çağrısı başarılı olur.

  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 gibi bir yardımcı program kullanarak DLL tarafından dışarı aktarılan işlevlerin süslü adlarını bulabilirsiniz.

• Yönetilen derlemedeki bir yöntemi yönetilmeyen dinamik bağlantı kitaplığı gibi çağırmaya çalışıyorsunuz. Bunu uygulamada görmek için aşağıdaki örneği StringUtilities.dll adlı bir derlemeye derleyin.

  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
  

  Ardından, StringUtilities.dll dinamik bağlantı kitaplığında yöntemini yönetilmeyen kod gibi çağırmaya StringUtilities.SayGoodMorning çalışan aşağıdaki örneği derleyip yürütür. Sonuç bir EntryPointNotFoundException özel durumdur.

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

  Özel durumu ortadan kaldırmak için yönetilen derlemeye bir başvuru ekleyin ve StringUtilities.SayGoodMorning aşağıdaki örnekte olduğu gibi yönetilen koddaki diğer yöntemlere erişdiğiniz gibi yöntemine erişin.

  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'sindeki bir yöntemi bir Windows DLL'siymiş gibi çağırmaya çalışıyorsunuz. COM DLL'sine erişmek için Visual Studio'da Başvuru Ekle seçeneğini belirleyerek projeye başvuru ekleyin ve ardından COM sekmesinden tür kitaplığını seçin.

örneğinin ilk özellik değerlerinin EntryPointNotFoundExceptionlistesi için oluşturuculara EntryPointNotFoundException bakın.

Oluşturucular

Özellikler

Yöntemler

Ekinlikler

Şunlara uygulanır

Ayrıca bkz.

• Exception
• Özel Durumları İşleme ve Oluşturma