Criar componentes Windows Runtime com C#/WinRT

Observação

Há suporte para a criação de componentes Windows Runtime com C#/WinRT no .NET 6 e posterior.

O pacote NuGet do C#/WinRT oferece suporte para criar seus próprios tipos e componentes Windows Runtime em C#e consumi-los de qualquer linguagem compatível com Windows Runtime, como C++/WinRT ou Rust. O suporte de criação e hospedagem do C#/WinRT requer .NET 6 ou posteriores e Visual Studio 2022 ou posteriores e destina-se a dar suporte a cenários de aplicativos da área de trabalho, incluindo o SDK do Aplicativo Windows e WinUI3.

Para obter um passo a passo mostrando como criar um componente Windows Runtime com .NET 6 ou posterior e como consumi-lo de um aplicativo de console C++/WinRT, consulte Walkthrough: Criar um componente C#/WinRT e consumi-lo do C++/WinRT.

Para obter mais detalhes e pesquisar ou arquivar quaisquer problemas, consulte o repositório C#/WinRT GitHub e Authoring C#/WinRT Components.

Declarando tipos em componentes Windows Runtime

Ao criar seu componente Windows Runtime, siga as diretrizes e restrições de tipo descritas na documentação UWP existente sobre componentes Windows Runtime (consulte Windows Runtime componentes com C# e Visual Basic). O componente pode, na maior parte do tempo, ser implementado como qualquer outra biblioteca C#. No entanto, há restrições aos tipos públicos no componente que serão expostas à Windows Runtime e declaradas no .winmd gerado para que outras pessoas consumam.

Externamente, você pode expor apenas tipos Windows Runtime para parâmetros e valores de retorno. Você pode usar tipos internos do C# como parte da superfície pública do componente, desde que haja um mapeamento do tipo .NET para o WinRT (consulte Mapeamentos do .NET para tipos WinRT em C#/WinRT) e eles aparecerão para os usuários do componente como os tipos correspondentes do Windows Runtime. Os tipos do Windows Runtime de outros componentes do Windows Runtime e do SDK do Windows também podem ser usados como parte da implementação pública do componente, tais como parâmetros in, tipos de retorno e herança de classe.

Observação

Há alguns tipos de Windows Runtime mapeados para tipos de .NET (consulte .NET mapeamentos de tipos WinRT em C#/WinRT). Esses tipos de .NET podem ser usados na interface pública do componente Windows Runtime e aparecerão para os usuários do componente como os tipos de Windows Runtime correspondentes.

  • Last updated on