Tutorial: Compilar un programa de C++/CLI que tiene como destino CLR en Visual Studio

Con C++/CLI puede crear programas de C++ que usan clases .NET, así como tipos nativos de C++. C++/CLI está pensado para su uso en aplicaciones de consola y en archivos DLL que encapsulan código nativo de C++ y hacen que sea accesible desde programas .NET. Para crear una interfaz Windows usuario basada en .NET, use C# o Visual Basic.

Para este procedimiento, puede escribir su propio programa de C++ o usar uno de los programas de ejemplo. En el programa de ejemplo que se usa en este procedimiento se crea un archivo de texto denominado textfile.txt y se guarda en el directorio del proyecto.

Requisitos previos

• Descripción de los fundamentos del lenguaje C++.
• En Visual Studio 2017 y versiones posteriores, la compatibilidad con C++/CLI es un componente opcional. Para instalarlo, abra el Instalador de Visual Studio desde el Windows menú Inicio. Asegúrese de que el icono Desarrollo de escritorio con C++ está activado y, en la sección Componentes opcionales, compruebe también Compatibilidad con C++/CLI.

Creación de un proyecto

Los siguientes pasos varían según la versión de Visual Studio que use. Para ver la documentación de su versión preferida de Visual Studio, use el control de selector Versión. Se encuentra en la parte superior de la tabla de contenido de esta página.

Agregar un archivo de código fuente

1. Si el Explorador de soluciones no está visible, haga clic en Explorador de soluciones en el menú Ver.

2. Agregue un archivo de código fuente nuevo al proyecto:

   • Haga clic con el botón derecho en la carpeta Archivosde origen Explorador de soluciones, seleccione Agregary haga clic en Nuevo elemento.

   • Haga clic en Archivo C++ (.cpp), escriba un nombre de archivo y, después, haga clic en Agregar.

   El archivo .cpp aparece en la carpeta Archivos de origen en Explorador de soluciones y aparece una ventana con pestañas donde se escribe el código que desea en ese archivo.

3. Haga clic en la pestaña recién creada en Visual Studio y escriba un programa de Visual C++ válido, o copie y pegue uno de los programas de ejemplo.

   Por ejemplo, puede usar el programa de ejemplo Cómo: Escribir un archivo de texto (C++/CLI) (en el nodo Control y E/S de archivos de la Guía de programación).

   Si usa el programa de ejemplo, observe que se usa la palabra clave gcnew en lugar de new al crear un objeto .NET y que gcnew devuelve un identificador (^) en lugar de un puntero (*):

   StreamWriter^ sw = gcnew StreamWriter(fileName);

   Para obtener más información sobre la sintaxis de C++/CLI, vea Component Extensions for Runtime Platforms.

4. En el menú Compilar, haga clic en Compilar solución.

   En la ventana Salida se muestra información sobre el progreso de la compilación, como la ubicación del registro de compilación y un mensaje que indica el estado de la compilación.

   Si realiza cambios y ejecuta el programa sin realizar una compilación, es posible que se indique que el proyecto no está actualizado en un cuadro de diálogo. Active la casilla de este cuadro de diálogo antes de hacer clic en Aceptar si quiere que Visual Studio use siempre las versiones actuales de los archivos en lugar de solicitárselo cada vez que se compile la aplicación.

5. En el menú Depurar, haga clic en Iniciar sin depurar.

6. Si usó el programa de ejemplo, al ejecutar el programa se muestra una ventana de comandos en la que se indica que se ha creado el archivo de texto.

   El archivo de texto textfile.txt se encuentra ahora en el directorio del proyecto. Puede abrir este archivo mediante el Bloc de notas.

   Nota:

   Al elegir la plantilla de proyecto vacío de CLR se establece automáticamente la opción del compilador /clr. Para comprobarlo, haga clic con el botón derecho en el proyecto en el Explorador de soluciones, seleccione Propiedades y, después, active la opción Compatible con Common Language Runtime en el nodo General de Propiedades de configuración.

Vea también

Referencia del lenguaje C++
Proyectos y sistemas de compilación