Udostępnij za pośrednictwem


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

Notatka

Tworzenie składników środowiska uruchomieniowego systemu Windows za pomocą języka C#/WinRT jest obsługiwane na platformie .NET 6 i nowszych wersjach.

Pakiet NuGet języka C#/WinRT zapewnia obsługę tworzenia własnych typów i składników środowiska uruchomieniowego systemu Windows w języku C# oraz korzystania z nich z dowolnego języka zgodnego ze środowiskiem uruchomieniowym systemu Windows, takiego jak C++/WinRT lub Rust. Obsługa tworzenia i hostowania języka C#/WinRT wymaga platformy .NET 6 i programu Visual Studio 2022. Ma ona obsługiwać scenariusze aplikacji klasycznych, w tym zestaw SDK aplikacji systemu Windowsi WinUI3.

Aby zapoznać się z przewodnikiem pokazującym, jak utworzyć składnik środowiska uruchomieniowego systemu Windows za pomocą platformy .NET 6 i jak korzystać z niego z poziomu aplikacji konsolowej C++/WinRT, zobacz Przewodnik: tworzenie składnika C#/WinRT i korzystanie z niego z poziomu języka C++/WinRT.

Aby uzyskać więcej informacji i wyszukać lub zgłosić wszelkie problemy, zapoznaj się z repozytorium C#/WinRT Github i Authoring C#/WinRT Components.

Deklarowanie typów w składnikach środowiska uruchomieniowego systemu Windows

Podczas tworzenia składnika środowiska uruchomieniowego 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 środowiska uruchomieniowego systemu Windows (zobacz Składniki środowiska uruchomieniowego systemu Windows w językach 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ą udostępnione środowisku wykonawczemu systemu Windows i zadeklarowane w generowanym .winmd do użytku przez innych.

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

Notatka

Istnieją niektóre typy Windows Runtime, które mają swoje odpowiedniki w typach platformy .NET (zobacz .NET odpowiedniki typów WinRT w języku C#/WinRT). Te typy platformy .NET mogą być używane w interfejsie publicznym składnika Środowiska uruchomieniowego systemu Windows i będą wyświetlane użytkownikom składnika jako odpowiednie typy środowiska uruchomieniowego systemu Windows.