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 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, ya que no es necesario abrir el archivo de ensamblado para obtener el nombre de fusión. |
SpecificVersion |
Booleano opcional. Especifica si solo se debe hacer referencia a la versión del nombre de fusión. |
Alias |
Cadena opcional. Cualquier alias de la referencia. |
Private |
Cadena opcional. Determina si el archivo se va a copiar en el directorio de resultados. Los valores son:
|
COMReference
Representa una referencia a un componente COM (no administrado) del proyecto.
Nombre 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 contenedor que se usa en el componente, por ejemplo, "tlbimp". |
Isolated |
Booleano opcional. 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 elemento |
Descripción |
|---|---|
WrapperTool |
Cadena opcional. Nombre de la herramienta contenedor que se usa en el componente, por ejemplo, "tlbimp". |
NativeReference
Representa un archivo de manifiesto nativo o una referencia a este archivo.
Nombre 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 elemento |
Descripción |
|---|---|
Name |
Cadena opcional. Nombre para mostrar de la referencia. |
Project |
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 elemento |
Descripción |
|---|---|
DependentUpon |
Cadena opcional. Especifica el archivo del que depende este archivo para compilarse correctamente. |
AutoGen |
Booleano opcional. Indica si el entorno de desarrollo integrado (IDE) de Visual Studio generó el archivo para el proyecto. |
Link |
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 |
Booleano opcional. Indica si se va a mostrar el archivo en el Explorador de soluciones de Visual Studio. |
CopyToOutputDirectory |
Cadena opcional. Determina si el archivo se va a copiar en el directorio de resultados. Los valores son:
|
EmbeddedResource
Representa los recursos que se van a incrustar en el ensamblado generado.
Nombre del elemento |
Descripción |
|---|---|
DependentUpon |
Cadena opcional. Especifica el archivo del que depende este archivo para compilarse correctamente. |
Generator |
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. |
Link |
Cadena opcional. La ruta de acceso notacional se muestra si el archivo se encuentra físicamente fuera de la influencia del proyecto. |
Visible |
Booleano opcional. Indica si se va a mostrar el archivo en el Explorador de soluciones de Visual Studio. |
CopyToOutputDirectory |
Cadena opcional. Determina si el archivo se va a copiar en el directorio de resultados. Los valores son:
|
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 elemento |
Descripción |
|---|---|
DependentUpon |
Cadena opcional. Especifica el archivo del que depende este archivo para compilarse correctamente. |
Generator |
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. |
Link |
Booleano opcional. 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 |
Booleano opcional. Especifica si el archivo es un ensamblado. |
Visible |
Booleano opcional. Indica si se va a mostrar el archivo en el Explorador de soluciones de Visual Studio. |
CopyToOutputDirectory |
Cadena opcional. Determina si el archivo se va a copiar en el directorio de resultados. Los valores son:
|
Ninguna
Representa archivos que no deberían tener ningún rol en el proceso de compilación.
Nombre del elemento |
Descripción |
|---|---|
DependentUpon |
Cadena opcional. Especifica el archivo del que depende este archivo para compilarse correctamente. |
Generator |
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. |
Link |
Cadena opcional. Ruta de acceso notacional que se mostrará si el archivo se encuentra físicamente fuera de la influencia del proyecto. |
Visible |
Booleano opcional. Indica si se va a mostrar el archivo en el Explorador de soluciones de Visual Studio. |
CopyToOutputDirectory |
Cadena opcional. Determina si el archivo se va a copiar en el directorio de resultados. Los valores son:
|
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 que se importará.
Importar
Representa los ensamblados cuyos espacios de nombres debe importar el compilador Visual Basic.