Crear un proyecto (Visual C#)

Actualización: noviembre 2007

Cuando esté listo para empezar a programar, el primer paso es preparar un proyecto. El proyecto contiene todo el material necesario para la aplicación: los archivos de código fuente, archivos de recursos, tales como iconos, referencias a archivos externos de los que depende la aplicación, y datos de configuración, tales como las opciones del compilador. Cuando se genera un proyecto, Visual C# invoca al compilador de C# y a otras herramientas internas para crear un ensamblado ejecutable con los archivos del proyecto.

Crear un proyecto nuevo

Para crear un nuevo proyecto, haga clic en el menú Archivo, elija Nuevo y haga clic en Proyecto.

Nota:

Si selecciona Sitio Web en lugar de Proyecto, se abre el entorno de desarrollo integrado (IDE) Visual Web Developer. Se trata de un entorno independiente y distinto dentro de Visual Studio para crear aplicaciones Web ASP.NET. El IDE de Visual Web Developer utiliza el editor de código de Visual C# para modificar los archivos de código subyacente en C#. Si crea aplicaciones web, debería utilizar principalmente la documentación de Visual Web Developer; sin embargo, para obtener información sobre el editor de C#, vea Editar código (Visual C#).

La ilustración siguiente muestra el cuadro de diálogo Nuevo proyecto. De forma predeterminada, Visual C# está seleccionado en la ventana a la izquierda, mientras que a la derecha aparecen plantillas de proyecto que se pueden seleccionar. Si expande y hace clic en un nodo de la izquierda, aparecerán diferentes tipos de proyectos a la derecha. La lista de plantillas de proyecto depende en parte de la versión de Visual Studio que utilice. 

Puede seleccionar la versión de .NET Framework para su proyecto en el cuadro de diálogo Nuevo proyecto. La versión de .NET Framework que seleccione en el cuadro de diálogo Nuevo proyecto es la versión que se requiere en un equipo para poder ejecutar la aplicación. Para obtener más información, vea .Información general de la característica de destinos múltiples de .NET Framework.

Después de seleccionar una plantilla de proyecto y hacer clic en Aceptar, Visual Studio crea el proyecto y todo está listo para empezar a escribir código. Los archivos de proyecto, referencias, configuración y recursos son visibles en Explorador de soluciones a la derecha.

¿Qué contiene el proyecto?

Propiedades

El nodo Propiedades representa opciones de configuración que se aplican a la totalidad del proyecto y se almacenan en el archivo .csproj de la carpeta de soluciones. Esta configuración incluye opciones de compilación, seguridad e implementación, entre muchas otras. Para modificar el proyecto, se utiliza el Diseñador de proyectos, que es un conjunto de Páginas de propiedades a las que se tiene acceso haciendo clic con el botón secundario del mouse en Propiedades, y seleccionando Abrir. Para obtener más información, vea Modificar las propiedades de un proyecto (Visual C#).

Referencias

En el contexto de un proyecto, una referencia identifica un archivo binario que la aplicación necesita para poder ejecutarse. Normalmente, una referencia identifica un archivo .dll, como puede ser uno de los archivos de la biblioteca de clases de .NET Framework. También puede hacer referencia a un ensamblado .NET (denominado shim) que permite que la aplicación llame a los métodos de un objeto COM o de un archivo DLL nativo de Win32. Si su programa crea una instancia de una clase definida en otro ensamblado, debe agregar una referencia al archivo correspondiente en el proyecto antes de compilarlo. Para agregar una referencia, haga clic en Agregar referencia en el menú Proyecto. De forma predeterminada, todos los proyectos de C# incluyen una referencia a mscorlib.dll, que contiene las clases básicas de .NET Framework. Puede agregar referencias a archivos DLL de .NET Framework adicionales, y a otros archivos, haciendo clic en el menú Proyecto y seleccionando Agregar referencia.

Nota:
No confunda el concepto de una referencia de proyecto con el concepto de tipos de referencia en C# u otros lenguajes de programación. El primero se refiere a un archivo y a su ubicación en disco. El segundo se refiere a los tipos de C# que se declaran con la palabra clave class.

Recursos

Los recursos son datos que se incluyen con la aplicación pero que se pueden almacenar de forma que pueden modificarse con independencia del resto del código fuente. Por ejemplo, puede almacenar todas las cadenas como recursos en lugar de codificarlas directamente en el código fuente. De esta forma, podrá traducir las cadenas a distintos idiomas más adelante y agregarlas a la carpeta de la aplicación que distribuye a los clientes sin necesidad de volver a compilar el ensamblado. Los cinco tipos de recursos definidos por Visual C# son: cadenas, imágenes, iconos, audio y archivos. Para agregar, quitar o modificar recursos, utilice el Diseñador de recursos, al que se puede obtener acceso en la ficha Recursos del Diseñador de proyectos.

Formularios

Cuando se crea un proyecto de formularios Windows Forms, Visual C# agrega un formulario al proyecto y lo llama Form1. Los dos archivos que representan el formulario se denominan Form1.cs y Form1.designer.cs. El código se escribe en Form1.cs; el Diseñador de Windows Forms escribe en el archivo designer.cs el código que implementa todas las acciones que se realizaron al arrastrar y colocar controles desde el Cuadro de herramientas.

Puede agregar un nuevo formulario haciendo clic en el comando Proyecto y seleccionando Agregar Windows Forms. Cada formulario tiene dos archivos asociados. Form1.cs, o como haya decido llamarlo, contiene el código fuente que se escribe para configurar el formulario y sus controles, como cuadros de lista y cuadros de texto, y responde a eventos tales como los clics en botones y las pulsaciones de teclas. En los proyectos de formularios Windows Forms simples, la mayoría o la totalidad de la codificación se hace en este archivo.

El archivo designer.cs contiene el código fuente que escribe el Diseñador de formularios cuando se arrastran controles y se colocan en el formulario, cuando se establecen las propiedades en la ventana Propiedades, etc. Normalmente, no debería modificar manualmente este archivo.

Nota:
Naturalmente, si crea un proyecto de aplicación de consola, no contendrá archivos de código fuente para formularios Windows Forms.

Otro archivos de código fuente

Un proyecto puede incluir cualquier número de archivos .cs adicionales que pueden estar asociados a un formulario Windows Forms concreto. En la ilustración anterior del Explorador de soluciones, program.cs contiene el punto de entrada para la aplicación. Un solo archivo .cs puede contener cualquier número de definiciones de clases y estructuras. Puede agregar archivos o clases nuevos o existentes al proyecto haciendo clic en Agregar nuevo elemento o Agregar elemento existente en el menú Proyecto.

Vea también

Tareas

Cómo: Crear configuraciones de compilación de soluciones y proyectos

Cómo: Crear un proyecto de aplicación para Windows

Conceptos

Introducción a soluciones, proyectos y elementos

Utilizar el Explorador de soluciones

Archivos de proyecto ocultos en el Explorador de soluciones

Controlar proyectos y soluciones

Otros recursos

Visual C#

Utilizar el entorno IDE de Visual C#