Tworzenie składników środowisko wykonawcze systemu Windows za pomocą języka C#/WinRT

Notatka

Tworzenie składników środowisko wykonawcze systemu Windows za pomocą języka C#/WinRT jest obsługiwane w .NET 6 lub nowszych.

Pakiet NuGet języka C#/WinRT zapewnia obsługę tworzenia własnych typów i składników środowisko wykonawcze systemu Windows w języku C#oraz korzystania z nich z dowolnego języka zgodnego z środowisko wykonawcze systemu Windows, takiego jak C++/WinRT lub Rust. Obsługa tworzenia i hostowania w C#/WinRT wymaga .NET 6 lub nowszego oraz Visual Studio 2022 lub nowszego, a jej celem jest wspieranie scenariuszy aplikacji desktopowych, w tym Zestaw SDK do aplikacji systemu Windows i WinUI3.

Aby zapoznać się z przewodnikiem pokazującym, jak utworzyć składnik środowisko wykonawcze systemu Windows z .NET 6 lub nowszym oraz jak używać go z poziomu aplikacji konsolowej C++/WinRT, zobacz Walkthrough: Tworzenie składnika C#/WinRT i korzystanie z niego z poziomu C++/WinRT.

Aby uzyskać więcej szczegółów i wyszukać lub zgłosić wszelkie problemy, zobacz C#/WinRT GitHub repozytorium i Authoring C#/WinRT Components.

Deklarowanie typów w składnikach środowisko wykonawcze systemu Windows

Podczas tworzenia składnika środowisko wykonawcze systemu Windows postępuj zgodnie z wytycznymi i ograniczeniami dotyczącymi typów opisanymi w istniejącej dokumentacji platformy UWP dotyczącej składników platformy środowisko wykonawcze systemu Windows (zobacz środowisko wykonawcze systemu Windows składniki w języku C# i Visual Basic). Składnik może być zaimplementowany w większości, podobnie jak każda inna biblioteka języka C#. Istnieją jednak ograniczenia dotyczące typów publicznych w składniku, które będą dostępne dla środowisko wykonawcze systemu Windows i zadeklarowane w wygenerowanych .winmd, żeby inne komponenty mogły z nich korzystać.

Zewnętrznie można uwidocznić tylko typy środowisko wykonawcze systemu Windows dla parametrów i wartości zwracanych. Wbudowane typy języka C# można używać w ramach publicznej powierzchni składnika, o ile istnieje mapowanie typu .NET na WinRT (zobacz .NET mapowania typów WinRT w języku C#/WinRT) i będą wyświetlane użytkownikom składnika jako odpowiednie typy środowisko wykonawcze systemu Windows. Typy środowisko wykonawcze systemu Windows z innych składników środowisko wykonawcze systemu Windows oraz z zestawu SDK Windows mogą być także używane jako część publicznej implementacji składnika, takie jak in parametry, typy zwracane i dziedziczenie klas.

Notatka

Istnieją pewne typy środowisko wykonawcze systemu Windows, które są mapowane na typy .NET (zobacz mapowania typów WinRT w .NET w języku C#/WinRT). Te typy .NET mogą być używane w interfejsie publicznym składnika środowisko wykonawcze systemu Windows i będą wyświetlane użytkownikom składnika jako odpowiednie typy środowisko wykonawcze systemu Windows.