Extensiones de componentes de .NET y UWP

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	Fin	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
clase de interfaz interface struct	No	Declara una interfaz.	clase de interfaz
enum class enum struct	No	Declara una enumeración.	enum class
property	Sí	Declara una propiedad.	property
delegate	Sí	Declara un delegado.	delegate (C++/CLI y C++/CX)
event	Sí	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 palabra clave new 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 Procedimientos para declarar especificadores de reemplazo en compilaciones nativas (C++/CLI).

Palabra clave	Contextual	Fin	Referencia
abstract	Sí	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	Sí	Indica que un método debe ser una invalidación de una versión de la clase base.	override
sealed	Sí	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	Fin
generic	No	Declara un tipo genérico.
where	Sí	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	Fin	Referencia
finally	Sí	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. Úselo en lugar de new y delete.	ref new, gcnew
ref new	Sí	Asigna un tipo de Windows Runtime. Úselo en lugar de new y delete.	ref new, gcnew
initonly	Sí	Indica que un miembro solo se puede inicializar en la declaración o en un constructor estático.	initonly (C++/CLI)
literal	Sí	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	Fin	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 el objeto especificado.	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	Fin	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.	Identificador a un operador de objeto (^)
%	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

Construcciones adicionales y temas relacionados

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 de variables (...) (C++/CLI)	(Windows Runtime y CLR) Permite que una función tome un número variable de argumentos.
Equivalentes de .NET Framework para tipos nativos de C++ (C++/CLI)	Enumera los tipos CLR que se usan en lugar de los tipos enteros de C++.
Modificador appdomain __declspec	El modificador __declspec que requiere la existencia de variables static y globales por appdomain.
Conversiones 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 conforme a 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.
Conversión boxing	Muestra las condiciones en las que a los tipos de valores se les aplica la conversión boxing.
Compatibilidad de compilador para type traits	Explica cómo detectar características de tipos en tiempo de compilación.
Pragmas managed, unmanaged	Muestra cómo las funciones administradas y no administradas pueden coexistir en el mismo módulo.
Modificador process __declspec	El modificador __declspec que requiere la existencia de variables static 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 a 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++)

Consulte también

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