Propiedades de archivo

Artículo
08/10/2011

Puede utilizar las propiedades de archivo para indicar qué acciones debe ejecutar sobre los archivos el sistema del proyecto. Por ejemplo, puede establecer propiedades de archivo para indicar si un archivo debe compilarse o incrustarse en los resultados de la generación como recurso.

Puede seleccionar cualquier archivo en el Explorador de soluciones y, a continuación, examinar sus propiedades en la ventana Propiedades. Los archivos de Visual Basic y Visual C# tienen cuatro propiedades: Nombre de archivo, Acción de compilación, Herramienta personalizada y Espacio de nombres de la herramienta personalizada.

Nota

Las propiedades Acción de compilación, Herramienta personalizada y Espacio de nombres de la herramienta personalizada se proporcionan para escenarios avanzados. Habitualmente, los valores predeterminados son suficientes y no es necesario cambiarlos.

Nombre de archivo (Propiedad)

Para cambiar el nombre de un archivo, haga clic en la propiedad Nombre de archivo en la ventana Propiedades y escriba el nuevo nombre. Observe que si cambia el nombre del archivo, Visual Studio cambiará automáticamente el nombre de los archivos .vb o .resx que estén asociados a él.

Acción de compilación (Propiedad)

La propiedad Acción de compilación indica lo que hace Visual Studio con un archivo cuando se ejecuta una compilación. Acción de compilación puede tener uno o varios valores:

None: el archivo no está incluido en el grupo de resultados del proyecto, ni se compila en el proceso de generación. Un ejemplo es un archivo de texto que contenga documentación, como un archivo Léame.
Compile: el archivo está compilado en el resultado de la compilación. Este valor se utiliza para los archivos de códigos.
Contenido: el archivo no está compilado, pero se incluye en el grupo de resultados del contenido. Por ejemplo, este valor es el predeterminado de un archivo .htm o cualquier otro tipo de archivo Web.
Recurso incrustado: este archivo está incrustado en el resultado de la generación del proyecto principal como un DLL o ejecutable. Este valor se utiliza normalmente para los archivos de recursos.

Nota

La propiedad Acción de compilación es extensible. En consecuencia, pueden mostrarse para esta propiedad opciones adicionales agregadas por otros productos y características.

El valor predeterminado de Acción de compilación depende de la extensión del archivo que agregue a la solución. Por ejemplo, si agrega un proyecto de Visual Basic al Explorador de soluciones, el valor predeterminado de Acción de compilación es Compilar. Esto se debe a que la extensión .vb indica que se trata de un archivo de código que se puede compilar. Los nombres y las extensiones de archivo aparecen en el Explorador de soluciones.

Observe que el nombre del archivo del proyecto no será el identificador para el recurso administrado en el manifiesto del ensamblado (vea Manifiesto del ensamblado para obtener más información). El identificador será espacio de nombres.nombre de archivo.extensión, donde espacio de nombres es el valor de la propiedad DefaultNamespace en un proyecto de Visual C# o de la propiedad RootNamespace en un proyecto de Visual Basic. nombre de archivo y extensión mantienen su designación original. Si el archivo es un archivo .resx, el sistema del proyecto ejecutará el resgen.exe en el archivo, creando un archivo de recursos. El archivo .resource se incrustará en el ensamblado. Por consiguiente, el manifiesto del ensamblado hará referencia al archivo .resources, y no al archivo .resx.

Por ejemplo, si agrega el archivo MyFile.bmp a un proyecto cuyo espacio de nombres predeterminado sea MyProj y establece la acción de generación en Recurso incrustado, MyProj.MyFile.bmp será el identificador en el manifiesto del ensamblado. Si posteriormente agrega el archivo MyFile.resx al proyecto, la acción de compilación predeterminada será Recurso incrustado y MyProj.MyFile.resources será el identificador del manifiesto del ensamblado.

Tenga en cuenta que cuando el editor de recursos agrega una imagen, establece Acción de generación en Ninguno, porque el archivo .resx hace referencia al archivo de imagen. En tiempo de generación, la imagen se extrae en el archivo .resources creado fuera del archivo .resx. A continuación, se puede tener acceso fácilmente a la imagen a través de la clase con establecimiento inflexible de tipos generada automáticamente para el archivo .resx. Por consiguiente, no debería cambiar esta configuración a Recurso incrustado, porque al hacerlo incluiría la imagen dos veces en el ensamblado.

Para obtener más información acerca del acceso a los archivos de recursos (compilados a partir de archivos .resx) en tiempo de ejecución, vea ResourceManager. Para obtener más información sobre el acceso en tiempo de ejecución a todos los demás archivos y recursos incrustados, vea GetManifestResourceStream.

Copiar en el directorio de resultados (Propiedad)

Esta propiedad especifica las condiciones en las que el archivo de código fuente seleccionado se copiará en el directorio de salida. Seleccione No copiar si el archivo nunca se va a copiar en el directorio de resultados. Seleccione Copiar siempre si el archivo siempre se copiará en el directorio de resultados. Seleccione Copiar si es posterior si el archivo sólo se copiará cuando sea más reciente que un archivo con el mismo nombre que esté presente en el directorio de resultados.

Para obtener información sobre cómo cambiar el directorio de salida, vea Generar (Página, Diseñador de proyectos) (C#) o Página Compilación, Diseñador de proyectos (Visual Basic).

Nota

En los proyectos para dispositivos inteligentes, la novedad de un archivo .dll o .exe se determina mediante la comparación de las versiones de Win32 de la siguiente forma:

Si la versión del dispositivo es anterior a la del escritorio, se copia el archivo.

Si la versión del dispositivo es posterior a la del escritorio, no se copia el archivo.

Si las versiones son iguales, se realiza una comparación de la suma de comprobación. Si las sumas de comprobación son iguales, no se copia el archivo y si son diferentes, se copia el archivo.

La novedad de los archivos que no sean .dll ni .exe se basa únicamente en la suma de comprobación.

Nota

Los archivos de datos se copiarán en una subcarpeta denominada Archivos de los Datos en el directorio de resultados.

Herramienta personalizada (Propiedad)

Las herramientas personalizadas son componentes que se pueden utilizar para transformar archivos de un tipo a otro en tiempo de diseño. Por ejemplo, una herramienta personalizada puede ser un generador de código de conjunto de datos que lee un archivo de esquema XML (.xsd), y genera clases en un archivo de código que expone sus tablas y columnas mediante programación. En el producto se dispone de una lista predefinida de las herramientas personalizadas disponibles; esta propiedad permite ver la herramienta personalizada que se aplica a un archivo. En raras ocasiones, quizá deba cambiar el valor de esta propiedad. El valor de esta propiedad debe estar en blanco o ser una de las herramientas personalizadas integradas.

Para establecer o cambiar la herramienta personalizada, haga clic en la propiedad CustomTool en la ventana Propiedades y escriba el nombre de una herramienta personalizada.

Espacio de nombres de la herramienta personalizada (Propiedad)

Si ha asignado una herramienta personalizada al proyecto, la propiedad Espacio de nombres de la herramienta personalizada permite especificar el espacio de nombres que desea asignar al código generado por la herramienta personalizada. Al especificar un valor para la propiedad Espacio de nombres de la herramienta personalizada, el código generado por la herramienta se colocará en el espacio de nombres especificado. Si la propiedad está vacía, el código generado se coloca en el espacio de nombres predeterminado para la carpeta en la que se encuentra el archivo convertido. Para Visual Basic, se trata del espacio de nombres raíz del proyecto; para Visual C#, corresponde al valor de la propiedad DefaultNamespace de la carpeta.