Creare componenti Windows Runtime con C#/WinRT

Nota

La creazione di componenti Windows Runtime con C#/WinRT è supportata in .NET 6 e versioni successive.

Il pacchetto NuGet C#/WinRT offre supporto per la creazione di componenti e tipi di Windows Runtime personalizzati in C# e l'utilizzo da qualsiasi linguaggio compatibile con Windows Runtime, ad esempio C++/WinRT o Rust. Il supporto per la creazione e l'hosting di C#/WinRT richiede .NET 6 o versione successiva e Visual Studio 2022 o versione successiva ed è destinato a supportare scenari di applicazioni desktop, tra cui SDK per app di Windows e WinUI3.

Per una procedura dettagliata che illustra come creare un componente Windows Runtime con .NET 6 o versione successiva e come usarlo da un'applicazione console C++/WinRT, vedere Walkthrough: Creare un componente C#/WinRT e usarlo da C++/WinRT.

Per altri dettagli e per cercare o archiviare eventuali problemi, vedere il repository C#/WinRT GitHub e Authoring C#/WinRT Components.

Dichiarazione dei tipi nei componenti Windows Runtime

Durante la creazione del componente Windows Runtime, segui le linee guida e le restrizioni relative ai tipi descritte nella documentazione UWP esistente sui componenti Windows Runtime (vedi componenti Windows Runtime con C# e Visual Basic). Il componente può essere implementato nella maggior parte dei casi come qualsiasi altra libreria C#. Tuttavia, esistono restrizioni sui tipi pubblici nel componente che verranno esposti nel Windows Runtime e dichiarati nell'interfaccia generata per essere utilizzati da altri.

È possibile esporre esternamente solo i tipi Windows Runtime per i parametri e i valori restituiti. È possibile usare i tipi C# predefiniti come parte della superficie pubblica del componente, purché sia presente un mapping dal tipo di .NET a WinRT (vedere .NET mapping dei tipi WinRT in C#/WinRT) e appariranno agli utenti del componente come tipi di Windows Runtime corrispondenti. I tipi Runtime di Windows da altri componenti Runtime di Windows e del Windows SDK possono essere usati anche come parte dell'implementazione pubblica del componente, ad esempio come parametri in, tipi di ritorno ed ereditarietà delle classi.

Nota

Esistono alcuni tipi di Windows Runtime mappati ai tipi .NET (vedere mapping .NET dei tipi WinRT in C#/WinRT). Questi tipi di .NET possono essere usati nell'interfaccia pubblica del componente Windows Runtime e vengono visualizzati agli utenti del componente come tipi di Windows Runtime corrispondenti.

  • Last updated on