Elementos comunes de proyectos de MSBuild
En MSBuild, un elemento es una referencia con nombre a uno o varios archivos. Los elementos contienen metadatos como nombres de archivo, rutas de acceso y números de versión. Todos los tipos de proyecto de Visual Studio tienen varios elementos en común. Estos elementos se definen en el archivo microsoft.build.commontypes.xsd.
Elementos comunes
A continuación, se muestra una lista de todos los elementos de proyecto comunes.
Referencia
Representa una referencia de ensamblado (administrada) del proyecto.
Nombre del atributo del elemento |
Descripción |
|---|---|
HintPath |
Cadena opcional. Ruta de acceso absoluta o relativa del ensamblado. |
Name |
Cadena opcional. Nombre para mostrar del ensamblado, por ejemplo, "System.Windows.Forms". |
FusionName |
Cadena opcional. Especifica el nombre de fusión sencillo o seguro del elemento. Cuando este atributo está presente se ahorra tiempo porque no es necesario abrir el archivo de ensamblado para obtener el nombre de fusión. |
SpecificVersion |
Opcional booleano. Especifica si sólo se debe hacer referencia a la versión del nombre de fusión. |
Aliases |
Cadena opcional. Cualquier alias de la referencia. |
Private |
Opcional booleano. Especifica si la referencia debe copiarse en la carpeta de salida. |
COMReference
Representa una referencia a un componente COM (no administrado) del proyecto.
Nombre del atributo del elemento |
Descripción |
|---|---|
Name |
Cadena opcional. El nombre para mostrar del componente. |
Guid |
Cadena opcional. GUID del componente, con el formato {12345678-1234-1234-1234-1234567891234}. |
VersionMajor |
Cadena opcional. Parte principal del número de versión del componente. Por ejemplo, "5" si el número de versión completo es "5.46". |
VersionMinor |
Cadena opcional. Parte secundaria del número de versión del componente. Por ejemplo, "46" si el número de versión completo es "5.46". |
LCID |
Cadena opcional. LocaleID del componente. |
WrapperTool |
Cadena opcional. Nombre de la herramienta de contenedor que se utiliza en el componente, por ejemplo, "tlbimp". |
Isolated |
Opcional booleano. Especifica si se trata de un componente sin registro. |
COMFileReference
Representa una lista de las bibliotecas de tipos que se pasan al destino ResolvedComreference.
Nombre del atributo del elemento |
Descripción |
|---|---|
WrapperTool |
Cadena opcional. Nombre de la herramienta de contenedor que se utiliza en el componente, por ejemplo, "tlbimp". |
NativeReference
Representa un archivo de manifiesto nativo o una referencia a este archivo.
Nombre del atributo del elemento |
Descripción |
|---|---|
Name |
Cadena necesaria. Nombre base del archivo de manifiesto. |
HintPath |
Cadena necesaria. Ruta de acceso relativa del archivo de manifiesto. |
ProjectReference
Representa una referencia a otro proyecto.
Nombre del atributo del elemento |
Descripción |
|---|---|
Name |
Cadena opcional. Nombre para mostrar de la referencia. |
Proyecto |
Cadena opcional. GUID de la referencia, con el formato {12345678-1234-1234-1234-1234567891234}. |
Package |
Cadena opcional. Ruta de acceso del archivo de proyecto al que se hace referencia. |
Compile
Representa los archivos de código fuente para el compilador.
Nombre del atributo del elemento |
Descripción |
|---|---|
DependentUpon |
Opcional booleano. Indica si el archivo depende de otro archivo para compilarse correctamente. |
AutoGen |
Opcional booleano. Indica si el entorno de desarrollo integrado (IDE) de Visual Studio generó el archivo para el proyecto. |
Vínculo |
Cadena opcional. Ruta de acceso notacional que se va a mostrar cuando el archivo se encuentre físicamente fuera de la influencia del archivo de proyecto. |
Visible |
Opcional booleano. Indica si se va a mostrar el archivo en el Explorador de soluciones de Visual Studio. |
CopyToOutputDirectory |
Opcional booleano. Valor predeterminado = false. Especifica si el archivo se va a copiar en el directorio de resultados. |
EmbeddedResource
Representa los recursos que se van a incrustar en el ensamblado generado.
Nombre del atributo del elemento |
Descripción |
|---|---|
DependentUpon |
Opcional booleano. Indica si el archivo depende de otro archivo para compilarse correctamente. |
Generador |
Cadena necesaria. Nombre de cualquier generador de archivos que se ejecute en este elemento. |
LastGenOutput |
Cadena necesaria. Nombre del archivo creado por cualquier generador de archivos que se ejecutó en este elemento. |
CustomToolNamespace |
Cadena necesaria. Espacio de nombres en el que cualquier generador de archivos que se ejecute en este elemento debe crear código. |
Vínculo |
Cadena opcional. La ruta de acceso notacional se muestra si el archivo se encuentra físicamente fuera de la influencia del proyecto. |
Visible |
Opcional booleano. Indica si se va a mostrar el archivo en el Explorador de soluciones de Visual Studio. |
CopyToOutputDirectory |
Opcional booleano. Valor predeterminado = false. Especifica si el archivo se va a copiar en el directorio de resultados. |
LogicalName |
Cadena necesaria. Nombre lógico del recurso incrustado. |
Content
Representa archivos que no están compilados en el proyecto pero que podrían incrustarse o publicarse junto con él.
Nombre del atributo del elemento |
Descripción |
|---|---|
DependentUpon |
Opcional booleano. Indica si el archivo depende de otro archivo para incrustarse o publicarse correctamente. |
Generador |
Cadena necesaria. Nombre de cualquier generador de archivos que se ejecute en este elemento. |
LastGenOutput |
Cadena necesaria. Nombre del archivo creado por cualquier generador de archivos que se ejecutó en este elemento. |
CustomToolNamespace |
Cadena necesaria. Espacio de nombres en el que cualquier generador de archivos que se ejecute en este elemento debe crear código. |
Vínculo |
Opcional booleano. Indica si se va a mostrar el archivo en el Explorador de soluciones de Visual Studio. |
PublishState |
Cadena necesaria. El estado de publicación del contenido:
|
IsAssembly |
Opcional booleano. Especifica si el archivo es un ensamblado. |
Visible |
Opcional booleano. Indica si se va a mostrar el archivo en el Explorador de soluciones de Visual Studio. |
CopyToOutputDirectory |
Opcional booleano. Valor predeterminado = false. Especifica si el archivo se va a copiar en el directorio de resultados. |
None
Representa archivos que no deberían tener ninguna función en el proceso de compilación.
Nombre del atributo del elemento |
Descripción |
|---|---|
DependentUpon |
Opcional booleano. Indica si el archivo depende de otro archivo para incrustarse o publicarse correctamente. |
Generador |
Cadena necesaria. Nombre de cualquier generador de archivos que se ejecute en este elemento. |
LastGenOutput |
Cadena necesaria. Nombre del archivo creado por cualquier generador de archivos que se ejecutó en este elemento. |
CustomToolNamespace |
Cadena necesaria. Espacio de nombres en el que cualquier generador de archivos que se ejecute en este elemento debe crear código. |
Vínculo |
Cadena opcional. Ruta de acceso notacional que se mostrará si el archivo se encuentra físicamente fuera de la influencia del proyecto. |
Visible |
Opcional booleano. Indica si se va a mostrar el archivo en el Explorador de soluciones de Visual Studio. |
CopyToOutputDirectory |
Opcional booleano. Valor predeterminado = false. Especifica si el archivo se va a copiar en el directorio de resultados. |
BaseApplicationManifest
Representa el manifiesto de aplicación base de la compilación y contiene información de seguridad de implementación de ClickOnce.
CodeAnalysisImport
Representa el proyecto FxCop para importar.
Import
Representa los ensamblados cuyos espacios de nombres debe importar el compilador Visual Basic.