Menulis komponen Windows Runtime dengan C#/WinRT

Nota

Penulisan komponen Windows Runtime dengan C#/WinRT didukung pada .NET 6 dan yang lebih baru.

Paket C#/WinRT NuGet menyediakan dukungan untuk menulis jenis dan komponen Windows Runtime Anda sendiri di C#, dan mengkonsumsinya dari bahasa yang kompatibel dengan Windows Runtime seperti C++/WinRT atau Rust. Dukungan penulisan dan hosting C#/WinRT memerlukan .NET 6 atau yang lebih baru dan Visual Studio 2022 atau yang lebih baru, dan dimaksudkan untuk mendukung skenario aplikasi desktop termasuk SDK Aplikasi Windows, dan WinUI3.

Untuk panduan yang menunjukkan cara menulis komponen Windows Runtime dengan .NET 6 atau yang lebih baru, dan cara menggunakannya dari aplikasi konsol C++/WinRT, lihat Walkthrough: Membuat komponen C#/WinRT dan menggunakannya dari C++/WinRT.

Untuk detail selengkapnya, dan untuk mencari atau mengajukan masalah apa pun, lihat repositori C#/WinRT GitHub dan Komponen C#/WinRT.

Mendeklarasikan jenis dalam komponen Windows Runtime

Saat menulis komponen Windows Runtime Anda, ikuti panduan dan batasan jenis yang diuraikan dalam dokumentasi UWP yang ada tentang komponen Windows Runtime (lihat komponen Windows Runtime dengan C# dan Visual Basic). Komponen dapat sebagian besar diimplementasikan seperti pustaka C# lainnya. Namun, ada batasan pada jenis publik dalam komponen yang akan diekspos ke Windows Runtime dan dideklarasikan dalam .winmd yang dihasilkan bagi orang lain untuk dikonsumsi.

Secara eksternal, Anda dapat mengekspos hanya tipe Windows Runtime untuk parameter dan nilai pengembalian. Anda dapat menggunakan jenis C# bawaan sebagai bagian dari permukaan publik komponen selama ada pemetaan dari jenis .NET ke WinRT (lihat pemetaan .NET jenis WinRT di C#/WinRT), dan mereka akan muncul kepada pengguna komponen sebagai jenis Windows Runtime yang sesuai. Windows Runtime jenis-jenis dari komponen Windows Runtime lainnya dan SDK Windows juga dapat digunakan sebagai bagian dari implementasi publik pada komponen, seperti parameter in, tipe pengembalian, dan pewarisan kelas.

Nota

Ada beberapa jenis Windows Runtime yang dipetakan ke jenis .NET (lihat pemetaan .NET jenis WinRT di C#/WinRT). Jenis .NET ini dapat digunakan dalam antarmuka publik komponen Windows Runtime Anda, dan mereka akan muncul kepada pengguna komponen sebagai jenis Windows Runtime yang sesuai.

  • Last updated on