Compartir a través de


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:

  • Default

  • Included

  • Excluded

  • DataFile

  • Requisito previo

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.

Vea también

Referencia

Propiedades comunes de proyectos de MSBuild