Extensiones de componentes de .NET y UWP

  • Artículo
  • 6 minutos para leer

El estándar C++ permite a los proveedores de compiladores proporcionar extensiones no estándar al lenguaje. Microsoft proporciona extensiones para ayudar a conectar código C++ nativo a código que se ejecuta en .NET Framework o la Plataforma universal de Windows (UWP). A las extensiones .NET se les llama C++/CLI y producen código que se ejecuta en el entorno de ejecución administrado de .NET denominado Common Language Runtime (CLR). A las extensiones UWP se les llama C++/CX y producen código máquina nativo.

Nota

Para nuevas aplicaciones, recomendamos usar C++/WinRT en lugar de C++/CX. C++/WinRT es una proyección de lenguaje C++17 nueva y estándar para las API de Windows Runtime. Seguiremos admitiendo C++/CX y WRL, pero recomendamos encarecidamente que las nuevas aplicaciones usen C++/WinRT. Para obtener más información, consulte C++/WinRT.

Dos runtime, un conjunto de extensiones

C++/CLI extiende el estándar C++ de ANSI/ISO y se define en la norma ECMA de C++/CLI. Par obtener más información, consulte el artículo sobre la programación de .NET con C++/CLI (Visual C++).

Las extensiones para C++/CX son un subconjunto de C++/CLI. Aunque la sintaxis de extensiones es idéntica en la mayoría de los casos, el código que se genera depende de si especifica la opción del compilador /ZW para establecer UWP como destino o la opción /clr para establecer .NET como destino. Estos modificadores se establecen automáticamente cuando se usa Visual Studio para crear un proyecto.

Palabras clave de tipo de datos

Las extensiones de lenguaje incluyen palabras clave agregadas, que constan de dos tokens separados por espacios en blanco. Los tokens pueden tener un significado cuando se usan por separado, y otro significado cuando se usan juntos. Por ejemplo, la palabra “ref” es un identificador normal, y la palabra “clase” es una palabra clave que declara una clase nativa. Pero cuando estas palabras se combinan para formar ref class, la palabra clave agregada resultante declara una entidad denominada clase en tiempo de ejecución.

Las extensiones también incluyen palabras clave contextuales. Una palabra clave se trata como contextual en función del tipo de instrucción que la contenga, y de su posición en esa instrucción. Por ejemplo, el token “property” puede ser un identificador, o puede declarar una clase especial de miembro de clase pública.

En la tabla siguiente se enumeran las palabras clave en la extensión del lenguaje C++.

Palabra clave Contextual Finalidad Referencia
ref class

ref struct		 No Declara una clase. Clases y structs
value class

value struct		 No Declara una clase de valor. Clases y structs
interface class

interface struct		 No Declara una interfaz. interface class
enum class

enum struct		 No Declara una enumeración. enum class
property Yes Declara una propiedad. property
delegate Yes Declara un delegado. delegate (C++/CLI y C++/CX)
event Yes Declara un evento. event

Especificadores de invalidación

Puede usar las palabras clave siguientes para calificar el comportamiento de invalidación de la derivación. Aunque la new palabra clave no es una extensión de C++, se muestra aquí porque se puede usar en un contexto adicional. Algunos especificadores también son válidos para la programación nativa. Para obtener más información, vea Cómo: Declarar especificadores de invalidación en compilaciones nativas (C++/CLI).

Palabra clave Contextual Finalidad Referencia
abstract Yes Indica que las funciones o las clases son abstractas. abstract
new No Indica que una función no es una invalidación de una versión de la clase base. new (Nueva ranura en vtable)
override Yes Indica que un método debe ser una invalidación de una versión de la clase base. override
sealed Yes Evita que las clases se usen como clases base. sealed

Palabras clave para genéricos

Las palabras clave siguientes se han agregado para admitir tipos genéricos. Para más información, vea Genéricos.

Palabra clave Contextual Finalidad
Genérico No Declara un tipo genérico.
where Yes Especifica las restricciones que se aplican a un parámetro de tipo genérico.

Palabras clave varias

Las palabras clave siguientes se han agregado a las extensiones de C++.

Palabra clave Contextual Finalidad Referencia
finally Yes Indica el comportamiento predeterminado de los controles de excepciones. Control de excepciones
for each, in No Enumera los elementos de una colección. for each, in
gcnew No Asigna tipos en el montón de recolección de elementos no utilizados. Use en lugar de new y delete . ref new, gcnew
ref new Yes Asigna un tipo de Windows Runtime. Use en lugar de new y delete . ref new, gcnew
initonly Yes Indica que un miembro solo se puede inicializar en la declaración o en un constructor estático. initonly (C++/CLI)
literal Yes Crea una variable literal. literal
nullptr No Indica que un identificador o un puntero no señalan un objeto. nullptr

Construcciones de plantilla

Las construcciones de lenguaje siguientes se implementan como plantillas, en lugar de como palabras clave. Si especifica la opción del compilador /ZW, se definen en el espacio de nombres lang. Si especifica la opción del compilador /clr, se definen en el espacio de nombres cli.

Palabra clave Finalidad Referencia
array Declara una matriz. Matrices
interior_ptr (solo CLR) Apunta a los datos de un tipo de referencia. interior_ptr (C++/CLI)
pin_ptr (solo CLR) Apunta a los tipos de referencia CLR para suprimir temporalmente el sistema de recolección de elementos no utilizados. pin_ptr (C++/CLI)
safe_cast Determina y ejecuta el método óptimo de conversión para un tipo de runtime. safe_cast
typeid (solo CLR) Recupera un objeto System.Type que describe el tipo o objeto especificados. typeid

Declaradores

Los declaradores de tipo siguientes indican al runtime que debe administrar automáticamente la duración y eliminación de los objetos asignados.

Operador Propósito Referencia
^ Declara un identificador a un objeto; es decir, un puntero a un objeto Windows Runtime o CLR que se elimina automáticamente cuando ya no se usa. Operador Handle to Object (^)
% Declara una referencia de seguimiento; es decir, una referencia a un objeto Windows Runtime o CLR que se elimina automáticamente cuando ya no se usa. Operador de referencia de seguimiento

En esta sección se muestran construcciones de programación adicionales y temas que pertenecen a CLR.

Tema Descripción
__identifier (C++/CLI) (Windows Runtime y CLR) Habilita el uso de palabras clave como identificadores.
Listas de argumentos variables (...) (C++/CLI) (Windows Runtime y CLR) Permite que una función tome un número variable de argumentos.
.NET Framework equivalentes a los tipos nativos de C++ (C++/CLI) Enumera los tipos CLR que se usan en lugar de los tipos enteros de C++.
appdomain Modificador __declspec modificador que exige que existan variables estáticas y globales por appdomain.
Conversión de estilo C con /clr (C++/CLI) Describe cómo se interpretan las conversiones de tipo C.
Convención de llamada __clrcall Indica la convención de llamada compatible con CLR.
__cplusplus_cli Macros predefinidas
Atributos personalizados Describe cómo definir sus propios atributos de CLR.
Control de excepciones Proporciona información general sobre el control de excepciones.
Invalidaciones explícitas Muestra cómo las funciones miembro pueden invalidar miembros arbitrarios.
Ensamblados de confianza (C++) Explica cómo un ensamblado de cliente puede tener acceso a todos los tipos de un componente de ensamblado.
Boxing Muestra las condiciones en las que a los tipos de valores se les aplica la conversión boxing.
Compatibilidad del compilador con rasgos de tipo Explica cómo detectar características de tipos en tiempo de compilación.
pragmas administradas y no administradas Muestra cómo las funciones administradas y no administradas pueden coexistir en el mismo módulo.
Proceso Modificador __declspec modificador que exige que existan variables estáticas y globales por proceso.
Reflexión (C++-CLI) Muestra la versión de CLR de la información de tipo en tiempo de ejecución.
String Describe la conversión del compilador de literales de cadena en String.
Reenvío de tipos (C++/CLI) Habilita el movimiento de un tipo en un ensamblado de envío a otro ensamblado de modo que no es necesario volver a compilar el código de cliente.
Atributos definidos por el usuario Muestra atributos definidos por el usuario.
#using directiva Importa ensamblados externos.
Documentación de XML Explica la documentación de código basada en XML mediante el uso de /doc (procesar comentarios de documentación) (C/C++)

Vea también

Programación de .NET con C++/CLI (Visual C++)
Interoperabilidad nativa y .NET