Elementos comunes de proyectos de MSBuildCommon MSBuild project items

En MSBuildMSBuild, un elemento es una referencia con nombre a uno o varios archivos.In MSBuildMSBuild, an item is a named reference to one or more files. Los elementos contienen metadatos como nombres de archivo, rutas de acceso y números de versión.Items contain metadata such as file names, paths, and version numbers. Todos los tipos de proyecto de Programa para la mejoraVisual Studio tienen varios elementos en común.All project types in Programa para la mejoraVisual Studio have several items in common. Estos elementos se definen en el archivo Microsoft.Build.CommonTypes.xsd.These items are defined in the file Microsoft.Build.CommonTypes.xsd.

Elementos comunesCommon items

A continuación, se muestra una lista de todos los elementos de proyecto comunes.The following is a list of all the common project items.

ReferenciaReference

Representa una referencia de ensamblado (administrada) del proyecto.Represents an assembly (managed) reference in the project.

Nombre de metadatos de elementosItem metadata name DescripciónDescription
HintPathHintPath Cadena opcional.Optional string. Ruta de acceso absoluta o relativa del ensamblado.Relative or absolute path of the assembly.
NOMBREName Cadena opcional.Optional string. Nombre para mostrar del ensamblado, por ejemplo, "System.Windows.Forms".The display name of the assembly, for example, "System.Windows.Forms."
FusionNameFusionName Cadena opcional.Optional string. Especifica el nombre de fusión sencillo o seguro del elemento.Specifies the simple or strong fusion name for the item.

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.When this attribute is present, it can save time because the assembly file does not have to be opened to obtain the fusion name.
SpecificVersionSpecificVersion Booleano opcional.Optional boolean. Especifica si solo se debe hacer referencia a la versión del nombre de fusión.Specifies whether only the version in the fusion name should be referenced.
AliasAliases Cadena opcional.Optional string. Cualquier alias de la referencia.Any aliases for the reference.
PrivatePrivate Booleano opcional.Optional boolean. Especifica si la referencia debe copiarse en la carpeta de salida.Specifies whether the reference should be copied to the output folder. Este atributo coincide con la propiedad Copia local de la referencia que está en el IDE de Visual Studio.This attribute matches the Copy Local property of the reference that's in the Visual Studio IDE.

COMReferenceCOMReference

Representa una referencia a un componente COM (no administrado) del proyecto.Represents a COM (unmanaged) component reference in the project. Este elemento solo se aplica a los proyectos de .NET.This item applies only to .NET projects.

Nombre de metadatos de elementosItem metadata name DescripciónDescription
NOMBREName Cadena opcional.Optional string. El nombre para mostrar del componente.The display name of the component.
GUIDGuid Cadena necesaria.Required string. GUID del componente, con el formato {12345678-1234-1234-1234-1234567891234}.A GUID for the component, in the form {12345678-1234-1234-1234-1234567891234}.
VersionMajorVersionMajor Cadena necesaria.Required string. Parte principal del número de versión del componente.The major part of the version number of the component. Por ejemplo, "5" si el número de versión completo es "5.46".For example, "5" if the full version number is "5.46."
VersionMinorVersionMinor Cadena necesaria.Required string. Parte secundaria del número de versión del componente.The minor part of the version number of the component. Por ejemplo, "46" si el número de versión completo es "5.46".For example, "46" if the full version number is "5.46."
LCIDLCID Cadena opcional.Optional string. LocaleID del componente.The LocaleID for the component.
WrapperToolWrapperTool Cadena opcional.Optional string. Nombre de la herramienta contenedor que se usa en el componente, por ejemplo, "tlbimp".The name of the wrapper tool that is used on the component, for example, "tlbimp."
IsolatedIsolated Booleano opcional.Optional boolean. Especifica si se trata de un componente sin registro.Specifies whether the component is a reg-free component.

COMFileReferenceCOMFileReference

Representa una lista de las bibliotecas de tipos que se pasan al parámetro TypeLibFiles del destino ResolveComReference.Represents a list of type libraries that are passed to the TypeLibFiles parameter of the ResolveComReference target. Este elemento solo se aplica a los proyectos de .NET.This item applies only to .NET projects.

Nombre de metadatos de elementosItem metadata name DescripciónDescription
WrapperToolWrapperTool Cadena opcional.Optional string. Nombre de la herramienta contenedor que se usa en el componente, por ejemplo, "tlbimp".The name of the wrapper tool that is used on the component, for example, "tlbimp."

NativeReferenceNativeReference

Representa un archivo de manifiesto nativo o una referencia a este archivo.Represents a native manifest file or a reference to such a file.

Nombre de metadatos de elementosItem metadata name DescripciónDescription
NOMBREName Cadena necesaria.Required string. Nombre base del archivo de manifiesto.The base name of the manifest file.
HintPathHintPath Cadena necesaria.Required string. Ruta de acceso relativa del archivo de manifiesto.The relative path of the manifest file.

ProjectReferenceProjectReference

Representa una referencia a otro proyecto.Represents a reference to another project.

Nombre de metadatos de elementosItem metadata name DescripciónDescription
NOMBREName Cadena opcional.Optional string. Nombre para mostrar de la referencia.The display name of the reference.
ProyectoProject Cadena opcional.Optional string. GUID de la referencia, con el formato {12345678-1234-1234-1234-1234567891234}.A GUID for the reference, in the form {12345678-1234-1234-1234-1234567891234}.
PackagePackage Cadena opcional.Optional string. Ruta de acceso del archivo de proyecto al que se hace referencia.The path of the project file that is being referenced.
ReferenceOutputAssemblyReferenceOutputAssembly Booleano opcional.Optional boolean. Si se establece en false, no incluye la salida del proyecto al que se hace referencia como una Referencia de este proyecto, pero garantiza que el otro proyecto realice compilaciones antes que este.If set to false, does not include the output of the referenced project as a Reference of this project, but still ensures that the other project builds before this one. Tiene como valor predeterminado true.Defaults to true.

CompileCompile

Representa los archivos de código fuente para el compilador.Represents the source files for the compiler.

Nombre de metadatos de elementosItem metadata name DescripciónDescription
DependentUponDependentUpon Cadena opcional.Optional string. Especifica el archivo del que depende este archivo para compilarse correctamente.Specifies the file this file depends on to compile correctly.
AutoGenAutoGen Booleano opcional.Optional boolean. Indica si el entorno de desarrollo integrado (IDE) de Programa para la mejoraVisual Studio ha generado el archivo para el proyecto.Indicates whether the file was generated for the project by the Programa para la mejoraVisual Studio integrated development environment (IDE).
LinkLink Cadena opcional.Optional string. Ruta de acceso notacional que se va a mostrar cuando el archivo se encuentre físicamente fuera de la influencia del archivo de proyecto.The notational path to be displayed when the file is physically located outside the influence of the project file.
VisibleVisible Booleano opcional.Optional boolean. Indica si se va a mostrar el archivo en el Explorador de soluciones de Programa para la mejoraVisual Studio.Indicates whether to display the file in Solution Explorer in Programa para la mejoraVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Cadena opcional.Optional string. Determina si el archivo se va a copiar en el directorio de resultados.Determines whether to copy the file to the output directory. Los valores son:Values are:

1. Nunca1. Never
2. Siempre2. Always
3. PreserveNewest3. PreserveNewest

EmbeddedResourceEmbeddedResource

Representa los recursos que se van a incrustar en el ensamblado generado.Represents resources to be embedded in the generated assembly.

Nombre de metadatos de elementosItem metadata name DescripciónDescription
DependentUponDependentUpon Cadena opcional.Optional string. Especifica el archivo del que depende este archivo para compilarse correctamente.Specifies the file this file depends on to compile correctly
GeneratorGenerator Cadena necesaria.Required string. Nombre de cualquier generador de archivos que se ejecute en este elemento.The name of any file generator that is run on this item.
LastGenOutputLastGenOutput Cadena necesaria.Required string. Nombre del archivo creado por cualquier generador de archivos que se ejecutó en este elemento.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace Cadena necesaria.Required string. Espacio de nombres en el que cualquier generador de archivos que se ejecute en este elemento debe crear código.The namespace in which any file generator that runs on this item should create code.
LinkLink Cadena opcional.Optional string. La ruta de acceso notacional se muestra si el archivo se encuentra físicamente fuera de la influencia del proyecto.The notational path is displayed if the file is physically located outside the influence of the project.
VisibleVisible Booleano opcional.Optional boolean. Indica si se va a mostrar el archivo en el Explorador de soluciones de Programa para la mejoraVisual Studio.Indicates whether to display the file in Solution Explorer in Programa para la mejoraVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Cadena opcional.Optional string. Determina si el archivo se va a copiar en el directorio de resultados.Determines whether to copy the file to the output directory. Los valores son:Values are:

1. Nunca1. Never
2. Siempre2. Always
3. PreserveNewest3. PreserveNewest
LogicalNameLogicalName Cadena necesaria.Required string. Nombre lógico del recurso incrustado.The logical name of the embedded resource.

ContenidoContent

Representa archivos que no están compilados en el proyecto pero que podrían incrustarse o publicarse junto con él.Represents files that are not compiled into the project, but may be embedded or published together with it.

Nombre de metadatos de elementosItem metadata name DescripciónDescription
DependentUponDependentUpon Cadena opcional.Optional string. Especifica el archivo del que depende este archivo para compilarse correctamente.Specifies the file this file depends on to compile correctly.
GeneratorGenerator Cadena necesaria.Required string. Nombre de cualquier generador de archivos que se ejecute en este elemento.The name of any file generator that runs on this item.
LastGenOutputLastGenOutput Cadena necesaria.Required string. Nombre del archivo creado por cualquier generador de archivos que se ejecutó en este elemento.The name of the file that was created by any file generator that was run on this item.
CustomToolNamespaceCustomToolNamespace Cadena necesaria.Required string. Espacio de nombres en el que cualquier generador de archivos que se ejecute en este elemento debe crear código.The namespace in which any file generator that runs on this item should create code.
LinkLink Cadena opcional.Optional string. Ruta de acceso notacional que se mostrará si el archivo se encuentra físicamente fuera de la influencia del proyecto.The notational path to be displayed if the file is physically located outside the influence of the project.
PublishStatePublishState Cadena necesaria.Required string. El estado de publicación del contenido:The publish state of the content, either:

- Predeterminado- Default
- Incluido- Included
- Excluido- Excluded
- Archivo de datos- DataFile
- Requisito previo- Prerequisite
IsAssemblyIsAssembly Booleano opcional.Optional boolean. Especifica si el archivo es un ensamblado.Specifies whether the file is an assembly.
VisibleVisible Booleano opcional.Optional boolean. Indica si se va a mostrar el archivo en el Explorador de soluciones de Programa para la mejoraVisual Studio.Indicates whether to display the file in Solution Explorer in Programa para la mejoraVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Cadena opcional.Optional string. Determina si el archivo se va a copiar en el directorio de resultados.Determines whether to copy the file to the output directory. Los valores son:Values are:

1. Nunca1. Never
2. Siempre2. Always
3. PreserveNewest3. PreserveNewest

NoneNone

Representa archivos que no deberían tener ningún rol en el proceso de compilación.Represents files that should have no role in the build process.

Nombre de metadatos de elementosItem metadata name DescripciónDescription
DependentUponDependentUpon Cadena opcional.Optional string. Especifica el archivo del que depende este archivo para compilarse correctamente.Specifies the file this file depends on to compile correctly.
GeneratorGenerator Cadena necesaria.Required string. Nombre de cualquier generador de archivos que se ejecute en este elemento.The name of any file generator that is run on this item.
LastGenOutputLastGenOutput Cadena necesaria.Required string. Nombre del archivo creado por cualquier generador de archivos que se ejecutó en este elemento.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace Cadena necesaria.Required string. Espacio de nombres en el que cualquier generador de archivos que se ejecute en este elemento debe crear código.The namespace in which any file generator that runs on this item should create code.
LinkLink Cadena opcional.Optional string. Ruta de acceso notacional que se mostrará si el archivo se encuentra físicamente fuera de la influencia del proyecto.The notational path to be displayed if the file is physically located outside the influence of the project.
VisibleVisible Booleano opcional.Optional boolean. Indica si se va a mostrar el archivo en el Explorador de soluciones de Programa para la mejoraVisual Studio.Indicates whether to display the file in Solution Explorer in Programa para la mejoraVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Cadena opcional.Optional string. Determina si el archivo se va a copiar en el directorio de resultados.Determines whether to copy the file to the output directory. Los valores son:Values are:

1. Nunca1. Never
2. Siempre2. Always
3. PreserveNewest3. PreserveNewest

AssemblyMetadataAssemblyMetadata

Representa los atributos de ensamblado que se van a generar como [AssemblyMetadata(key, value)].Represents assembly attributes to be generated as [AssemblyMetadata(key, value)].

Nombre de metadatos de elementosItem metadata name DescripciónDescription
IncluirInclude Se convierte en el primer parámetro (la clave) del constructor de atributo AssemblyMetadataAttribute.Becomes the first parameter (the key) in the AssemblyMetadataAttribute attribute constructor.
ValorValue Cadena necesaria.Required string. Se convierte en el segundo parámetro (el valor) del constructor de atributo AssemblyMetadataAttribute.Becomes the second parameter (the value) in the AssemblyMetadataAttribute attribute constructor.

Note

Esto solo se aplica a los proyectos que usan el SDK de .NET Core.This applies to projects using the .NET Core SDK only.

BaseApplicationManifestBaseApplicationManifest

Representa el manifiesto de aplicación base de la compilación y contiene información de seguridad de implementación de ClickOnceClickOnce.Represents the base application manifest for the build, and contains ClickOnceClickOnce deployment security information.

CodeAnalysisImportCodeAnalysisImport

Representa el proyecto FxCop que se importará.Represents the FxCop project to import.

ImportarImport

Representa los ensamblados cuyos espacios de nombres debe importar el compilador Visual BasicVisual Basic.Represents assemblies whose namespaces should be imported by the Visual BasicVisual Basic compiler.

Vea tambiénSee also