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

Mediante el uso de C++/CLI, puede crear programas de C++ que usen clases de .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 C++ nativo y hacen que sea accesible desde programas .NET. Para crear una interfaz de usuario de Windows basada en .NET, use C# o Visual Basic.

Para realizar 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 menú Inicio de Windows. Asegúrese de que el icono Desarrollo de escritorio con C++ esté activado y, en la sección Componentes opcionales, compruebe también la 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.

Para crear un proyecto de C++/CLI en Visual Studio

1. En el Explorador de soluciones, haga clic con el botón derecho en la parte superior para abrir el cuadro de diálogo Crear un nuevo proyecto.

2. En la parte superior del cuadro de diálogo, escriba CLR en el cuadro de búsqueda y elija Proyecto vacío de CLR (.NET Framework) en la lista de resultados.

3. Elija el botón Crear para crear el proyecto.

Adición de un archivo de origen

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 Archivos de código fuente en el Explorador de soluciones, seleccione Agregar y 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 código fuente en el Explorador de soluciones y se muestra una ventana con pestañas donde puede escribir el código que quiera 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 Extensiones de componentes para plataformas de tiempo de ejecución.

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.

Consulte también

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