LibraryImport & P/Invoke Dijana daripada Kod Sumber
Gunakan [LibraryImport] (C# 11+) untuk marshaling yang serasi dengan AOT dan dijana daripada kod sumber, yang lebih pantas daripada DllImport.
LibraryImport & P/Invoke Dijana daripada Kod Sumber ialah pelajaran Akademi C# percuma di CoddyKit. Ini ialah pelajaran 2 daripada 4. Anda boleh membaca keseluruhan pelajaran di bawah secara percuma — kemudian berlatih secara praktikal dalam pelayar menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Akademi C#, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.
Mengapa LibraryImport?
[LibraryImport] diperkenalkan dalam .NET 7 (C# 11) sebagai pengganti [DllImport] yang dijana daripada kod sumber dan serasi dengan AOT. DllImport klasik bergantung pada pemarshalan masa jalan melalui refleksi — keadaan ini bermasalah untuk Native AOT. LibraryImport menjana semua kod pemarshalan pada masa kompilasi.
Mengisytiharkan Kaedah LibraryImport
Tandakan kaedah static partial dengan [LibraryImport]. Penjana kod sumber akan mengisi pelaksanaannya. Anda juga mesti menandakan kelas yang mengandunginya sebagai partial.
using System.Runtime.InteropServices;
internal static partial class NativeMethods
{
// Source generator creates the P/Invoke body at compile time
[LibraryImport("mylib", EntryPoint = "add_integers")]
internal static partial int AddIntegers(int a, int b);
// String marshaling must be explicit in LibraryImport
[LibraryImport("mylib", StringMarshalling = StringMarshalling.Utf8)]
internal static partial int ProcessString(string text);
}Pemarshalan Rentetan dalam LibraryImport
Tidak seperti DllImport, LibraryImport memerlukan anda menentukan pemarshalan rentetan secara eksplisit. Anda boleh menggunakan enum StringMarshalling atau atribut MarshalAs, supaya kos pemarshalan dapat dilihat dan dikawal.
// Option 1: StringMarshalling enum (all strings in method)
[LibraryImport("kernel32", StringMarshalling = StringMarshalling.Utf16)]
static partial bool CreateDirectory(string lpPathName, nint lpSecurityAttributes);
// Option 2: Per-parameter MarshalAs
[LibraryImport("libc")]
static partial int Open(
[MarshalAs(UnmanagedType.LPUTF8Str)] string path,
int flags);
// Option 3: MarshalUsing for custom marshalers
[LibraryImport("mylib")]
static partial void Process(
[MarshalUsing(typeof(Utf8StringMarshaller))] string name);Pemarshalan Struktur
Untuk struktur, tambahkan [NativeMarshalling] bagi menentukan cara jenis terurus dipetakan kepada perwakilan natifnya. Penjana kod sumber menggunakan jenis pemarshalan untuk menjana kod yang selamat dan meminimumkan peruntukan memori.
[NativeMarshalling(typeof(PointMarshaller))]
public struct Point
{
public int X;
public int Y;
}
[CustomMarshaller(typeof(Point), MarshalMode.Default, typeof(PointMarshaller))]
public static class PointMarshaller
{
public static Point ConvertToManaged(NativePoint native)
=> new Point { X = native.X, Y = native.Y };
public static NativePoint ConvertToUnmanaged(Point managed)
=> new NativePoint { X = managed.X, Y = managed.Y };
[StructLayout(LayoutKind.Sequential)]
public struct NativePoint { public int X, Y; }
}Perbandingan DllImport dan LibraryImport
DllImport ditafsirkan pada masa jalan — permulaan lambat, berasaskan refleksi dan tidak serasi dengan pemangkasan AOT. LibraryImport menjana kod C# yang dioptimumkan pada masa binaan: tiada refleksi masa jalan, selamat untuk pemangkasan dan terbukti lebih pantas dalam penanda aras.
// Old — DllImport (still works, but avoid for new AOT code)
[DllImport("kernel32", CharSet = CharSet.Unicode, SetLastError = true)]
static extern bool MoveFile(string src, string dst);
// New — LibraryImport (AOT-safe, source-generated)
[LibraryImport("kernel32", StringMarshalling = StringMarshalling.Utf16,
SetLastError = true)]
static partial bool MoveFile(string src, string dst);
// The compiler generates the actual P/Invoke wrapper bodySetLastError dan Pengendalian Ralat
Tetapkan SetLastError = true dalam [LibraryImport] untuk menangkap kod ralat OS. Gunakan Marshal.GetLastPInvokeError() (disyorkan) atau Marshal.GetLastWin32Error() untuk mendapatkannya semula selepas panggilan.
[LibraryImport("kernel32", StringMarshalling = StringMarshalling.Utf16,
SetLastError = true)]
static partial bool CreateDirectory(string path, nint secAttr);
bool ok = CreateDirectory(@"C:\Temp\NewDir", 0);
if (!ok)
{
int err = Marshal.GetLastPInvokeError();
// err is ERROR_ALREADY_EXISTS (183) if folder exists
throw new Win32Exception(err);
}Span<T> dan Pemarshalan Memori
Salah satu kelebihan P/Invoke yang dijana daripada kod sumber ialah sokongan kelas pertama untuk Span<T>. Menghantar ReadOnlySpan<byte> mengelakkan pemincangan dan peruntukan memori yang diperlukan oleh DllImport bersama tatasusunan.
[LibraryImport("mylib")]
static partial int ProcessBuffer(
ReadOnlySpan<byte> data,
int length);
// Usage — no fixed or GCHandle needed
byte[] buffer = Encoding.UTF8.GetBytes("hello");
int result = ProcessBuffer(buffer, buffer.Length);
// For output buffers use Span<byte>
[LibraryImport("mylib")]
static partial int FillBuffer(Span<byte> output, int maxLen);Mendayakan Penjanaan Kod Sumber
Penjanaan kod sumber didayakan secara automatik apabila anda merujuk ruang nama System.Runtime.InteropServices dalam projek yang menyasarkan .NET 7+. Untuk sasaran yang lebih lama, anda memerlukan pakej penganalisis Microsoft.Interop.SourceGeneration.
<!-- In your .csproj — no extra package needed on .NET 7+ -->
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net9.0</TargetFramework>
<!-- Enable Roslyn analyzers and source generators -->
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
<!-- AllowUnsafeBlocks may be needed for some marshalers -->
<AllowUnsafeBlocks>true</AllowUnsafeBlocks>
</PropertyGroup>
</Project>Memeriksa Kod yang Dijana
Tambahkan <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles> pada csproj anda untuk menulis fail yang dijana ke obj/. Ini membolehkan anda memeriksa dengan tepat perkara yang dihasilkan oleh penjana kod sumber — satu latihan pembelajaran yang sangat baik.
// The generator emits something like this for a LibraryImport method:
// (simplified view of generated stub)
internal static partial int AddIntegers(int a, int b)
{
// Direct call — no reflection, no boxing, fully inlineable
return __PInvoke(a, b);
[System.Runtime.InteropServices.DllImportAttribute(
"mylib",
EntryPoint = "add_integers",
ExactSpelling = true)]
static extern int __PInvoke(int a, int b);
}Dunia Sebenar: Membungkus Pustaka C
Corak yang biasa digunakan ialah mentakrifkan kelas pembungkus statik dengan semua pengisytiharan LibraryImport, kemudian mendedahkan API selamat aras tinggi di atasnya. Jadikan pengisytiharan partial itu dalaman atau persendirian, dan dedahkan hanya pembungkus selamat kepada umum.
internal static partial class LibSodiumNative
{
private const string LibName = "libsodium";
[LibraryImport(LibName, EntryPoint = "crypto_secretbox_keybytes")]
internal static partial nuint KeyBytes();
[LibraryImport(LibName, EntryPoint = "crypto_secretbox_easy")]
internal static partial int SecretBoxEasy(
Span<byte> ciphertext,
ReadOnlySpan<byte> message,
ulong mlen,
ReadOnlySpan<byte> nonce,
ReadOnlySpan<byte> key);
}
// Public safe wrapper hides the native signature
public static byte[] Encrypt(byte[] message, byte[] key, byte[] nonce)
{
var cipher = new byte[message.Length + 16];
LibSodiumNative.SecretBoxEasy(cipher, message, (ulong)message.Length, nonce, key);
return cipher;
}Semakan Pantas
Apakah kelebihan utama [LibraryImport] berbanding [DllImport]?
Imbas Kembali: LibraryImport dan P/Invoke Dijana daripada Kod Sumber
Kesimpulan utama:
[LibraryImport]menggantikan[DllImport]untuk P/Invoke yang selamat bagi AOT- Pemarshalan dijana pada masa kompilasi — tiada refleksi masa jalan
- Memerlukan kaedah
static partialdan kelaspartial - Pemarshalan rentetan mesti dinyatakan secara eksplisit melalui
StringMarshallingatauMarshalAs - Sokongan kelas pertama untuk
Span<T>tanpa overhed pemincangan - Periksa kod yang dijana dengan
EmitCompilerGeneratedFiles
Pelajari C# dengan tutor kecerdasan buatan — percuma
Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.
- Kursus
- 93
- Pelajaran
- 346
Soalan Lazim
Adakah pelajaran “LibraryImport & P/Invoke Dijana daripada Kod Sumber” percuma?
Ya — teks penuh “LibraryImport & P/Invoke Dijana daripada Kod Sumber” boleh dibaca secara percuma di web ini. Untuk berlatih secara interaktif menggunakan penyunting kod terbina dalam dan tutor kecerdasan buatan 24/7, serta membuka kunci baki kursus Akademi C#, tingkat taraf kepada CoddyKit PRO. Kursus Akademi C# merangkumi sejumlah 4 pelajaran.
Apakah yang akan saya pelajari dalam “LibraryImport & P/Invoke Dijana daripada Kod Sumber”?
Gunakan [LibraryImport] (C# 11+) untuk marshaling yang serasi dengan AOT dan dijana daripada kod sumber, yang lebih pantas daripada DllImport. Anda berlatih Akademi C# menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.
Adakah saya memerlukan pengalaman untuk memulakan Akademi C#?
Tiada pengalaman terdahulu diperlukan. Pembelajaran Akademi C# di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 2 daripada 4.
Berapa lamakah pelajaran “LibraryImport & P/Invoke Dijana daripada Kod Sumber” diambil?
Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.
Bolehkah saya menulis dan menjalankan kod dalam pelajaran Akademi C# ini?
Ya. Setiap pelajaran Akademi C# menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.
Semua pelajaran dalam kursus ini
- Asas P/Invoke
- LibraryImport & P/Invoke Dijana daripada Kod Sumber
- Kod Tidak Selamat, Penuding & Penimbal Tetap
- Saling Kendali COM & Pembalut Boleh Panggil Masa Jalan