Asignaciones de tipos de WinRT en .NET con C#/WinRT

En este artículo se enumeran las asignaciones que realiza C#/WinRT entre los tipos de Windows Runtime (WinRT) y los tipos de .NET en aplicaciones de escritorio destinadas a .NET 6 (o posterior). En estas aplicaciones, Visual Studio IntelliSense muestra el tipo .NET en lugar del tipo Windows Runtime. Por ejemplo, si un método Windows Runtime toma un parámetro de tipo IVector<string> a continuación, IntelliSense muestra un parámetro de tipo IList<string>. Del mismo modo, en un componente de WinRT creado con C#/WinRT, se usa el tipo .NET en las firmas de miembro. Cuando se usa C#/WinRT para generar un componente de Windows Runtime, el tipo de .NET se traduce en el tipo winRT correspondiente.

Las asignaciones de tipos personalizados de C#/WinRT se clasifican por tipos en el SDK de Windows o en WinUI 3 (WinUI forma parte del SDK de Aplicaciones para Windows). Los tipos de WinRT para las asignaciones del SDK de Windows residen en los espacios de nombres Windows.*, y los tipos de WinRT para las asignaciones de WinUI residen en los espacios de nombres Microsoft.UI.Xaml.*. Hay dos motivos para las asignaciones de tipos personalizados que C#/WinRT realiza para los tipos de WinRT:

• Tipos de WinRT que se asignan a tipos de .NET con un nombre o un espacio de nombres diferente. Estas asignaciones personalizadas son para asignar tipos de WinRT a los tipos de .NET equivalentes existentes. También hay casos en los que la asignación es a un tipo diferente (por ejemplo, un tipo de valor se asigna a un tipo de clase).

• Tipos de WinRT que se asignan a tipos de .NET con el mismo nombre y espacio de nombres. Estas asignaciones personalizadas suelen realizarse por motivos de rendimiento o mejora, y se implementan directamente en C#. La mayoría de los tipos que tienen el mismo nombre de espacio de nombres y nombre de tipo en WinRT y .NET son estructuras (o tipos asociados a estructuras, como enumeraciones). En WinRT, las estructuras no tienen miembros distintos de los campos y requieren tipos auxiliares, que .NET ocultan. Las versiones .NET de estas estructuras tienen propiedades y métodos que proporcionan la funcionalidad de los tipos auxiliares ocultos (por ejemplo, Windows. Interfaz de usuario. Color).

Asignaciones para tipos de WinRT en el SDK de Windows

Tipos con un nombre o un espacio de nombres diferente

Tipos con el mismo nombre y espacio de nombres

Mapeos para tipos de WinRT en WinUI

Tipos con un nombre o un espacio de nombres diferente

Tipos con el mismo nombre y espacio de nombres