Itens de projeto comuns do MSBuildCommon MSBuild project items

Em MSBuildMSBuild, um item é uma referência nomeada a um ou mais arquivos.In MSBuildMSBuild, an item is a named reference to one or more files. Itens contêm metadados, como nomes de arquivos, caminhos e números de versão.Items contain metadata such as file names, paths, and version numbers. Todos os tipos de projeto em Visual StudioVisual Studio têm vários itens em comum.All project types in Visual StudioVisual Studio have several items in common. Esses itens são definidos no arquivo Microsoft.Build.CommonTypes.xsd.These items are defined in the file Microsoft.Build.CommonTypes.xsd.

Itens comunsCommon items

Esta é uma lista de todos os itens de projeto em comum.The following is a list of all the common project items.

ReferênciaReference

Representa uma referência de assembly (gerenciado) no projeto.Represents an assembly (managed) reference in the project.

Nome de metadados de itemItem metadata name DescriçãoDescription
HintPathHintPath Cadeia de caracteres opcional.Optional string. O caminho relativo ou absoluto do assembly.Relative or absolute path of the assembly.
NameName Cadeia de caracteres opcional.Optional string. O nome de exibição do assembly, por exemplo, “System.Windows.Forms.”The display name of the assembly, for example, "System.Windows.Forms."
FusionNameFusionName Cadeia de caracteres opcional.Optional string. Especifica o nome de fusão simples ou forte para o item.Specifies the simple or strong fusion name for the item.

Quando esse atributo estiver presente, é possível economizar tempo, pois o arquivo do assembly não precisa ser aberto para obter o nome de fusão.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 Booliano opcional.Optional boolean. Especifica se apenas a versão no nome de fusão deve ser referenciada.Specifies whether only the version in the fusion name should be referenced.
AliasesAliases Cadeia de caracteres opcional.Optional string. Quaisquer aliases da referência.Any aliases for the reference.
ParticularPrivate Booliano opcional.Optional boolean. Especifica se a referência deve ser copiada para a pasta de saída.Specifies whether the reference should be copied to the output folder. Esse atributo corresponde à propriedade Copiar Local da referência que está no Visual Studio IDE.This attribute matches the Copy Local property of the reference that's in the Visual Studio IDE.

COMReferenceCOMReference

Representa uma referência a um componente COM (não gerenciado) no projeto.Represents a COM (unmanaged) component reference in the project. Este item se aplica somente a projetos .NET.This item applies only to .NET projects.

Nome de metadados de itemItem metadata name DescriçãoDescription
NameName Cadeia de caracteres opcional.Optional string. O nome de exibição do componente.The display name of the component.
{1>Guid<1}Guid Cadeia de caracteres obrigatória.Required string. Um GUID para o componente, no formato {12345678-1234-1234-1234-1234567891234}.A GUID for the component, in the form {12345678-1234-1234-1234-1234567891234}.
VersionMajorVersionMajor Cadeia de caracteres obrigatória.Required string. A parte principal do número de versão do componente.The major part of the version number of the component. Por exemplo, “5” se o número de versão completo for “5,46”.For example, "5" if the full version number is "5.46."
VersionMinorVersionMinor Cadeia de caracteres obrigatória.Required string. A parte secundária do número de versão do componente.The minor part of the version number of the component. Por exemplo, “46” se o número de versão completo for “5,46”.For example, "46" if the full version number is "5.46."
LCIDLCID Cadeia de caracteres opcional.Optional string. O LocaleID do componente.The LocaleID for the component.
WrapperToolWrapperTool Cadeia de caracteres opcional.Optional string. O nome da ferramenta wrapper usada no componente, por exemplo, “tlbimp”.The name of the wrapper tool that is used on the component, for example, "tlbimp."
IsoladaIsolated Booliano opcional.Optional boolean. Especifica se o componente é um componente sem registro.Specifies whether the component is a reg-free component.

COMFileReferenceCOMFileReference

Representa uma lista de bibliotecas de tipos que alimentam o parâmetro TypeLibFiles do destino ResolveComReference.Represents a list of type libraries that are passed to the TypeLibFiles parameter of the ResolveComReference target. Este item se aplica somente a projetos .NET.This item applies only to .NET projects.

Nome de metadados de itemItem metadata name DescriçãoDescription
WrapperToolWrapperTool Cadeia de caracteres opcional.Optional string. O nome da ferramenta wrapper usada no componente, por exemplo, “tlbimp”.The name of the wrapper tool that is used on the component, for example, "tlbimp."

NativeReferenceNativeReference

Representa um arquivo de manifesto nativo ou uma referência a esse arquivo.Represents a native manifest file or a reference to such a file.

Nome de metadados de itemItem metadata name DescriçãoDescription
NameName Cadeia de caracteres obrigatória.Required string. O nome de base do arquivo de manifesto.The base name of the manifest file.
HintPathHintPath Cadeia de caracteres obrigatória.Required string. O caminho relativo do arquivo de manifesto.The relative path of the manifest file.

ProjectReferenceProjectReference

Representa uma referência a outro projeto.Represents a reference to another project.

Nome de metadados de itemItem metadata name DescriçãoDescription
NameName Cadeia de caracteres opcional.Optional string. O nome de exibição da referência.The display name of the reference.
Projeto doProject Cadeia de caracteres opcional.Optional string. Um GUID para a referência, no formato {12345678-1234-1234-1234-1234567891234}.A GUID for the reference, in the form {12345678-1234-1234-1234-1234567891234}.
PacotePackage Cadeia de caracteres opcional.Optional string. O caminho do arquivo de projeto que está sendo referenciado.The path of the project file that is being referenced.
ReferenceOutputAssemblyReferenceOutputAssembly Booliano opcional.Optional boolean. Se estiver definido como false, não inclui a saída do projeto referenciado como uma referência deste projeto, mas ainda garante que o outro projeto seja compilado antes desse.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. Assume o padrão de true.Defaults to true.

CompilarCompile

Representa os arquivos de origem do compilador.Represents the source files for the compiler.

Nome de metadados de itemItem metadata name DescriçãoDescription
DependentUponDependentUpon Cadeia de caracteres opcional.Optional string. Especifica o arquivo do qual esse arquivo depende para compilar corretamente.Specifies the file this file depends on to compile correctly.
AutoGenAutoGen Booliano opcional.Optional boolean. Indica se o arquivo foi gerado para o projeto pelo ambiente de desenvolvimento integrado (IDE) Visual StudioVisual Studio.Indicates whether the file was generated for the project by the Visual StudioVisual Studio integrated development environment (IDE).
LinkLink Cadeia de caracteres opcional.Optional string. O caminho de notação a ser exibido quando o arquivo está fisicamente fora da influência do arquivo de projeto.The notational path to be displayed when the file is physically located outside the influence of the project file.
VisívelVisible Booliano opcional.Optional boolean. Indica se o arquivo no Gerenciador de Soluções deve ser exibido no Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Cadeia de caracteres opcional.Optional string. Determina se o arquivo deve ser copiado para o diretório de saída.Determines whether to copy the file to the output directory. Os valores são:Values are:

1. nunca1. Never
2. sempre2. Always
3. PreserveNewest3. PreserveNewest

EmbeddedResourceEmbeddedResource

Representa os recursos a serem inseridos no assembly gerado.Represents resources to be embedded in the generated assembly.

Nome de metadados de itemItem metadata name DescriçãoDescription
DependentUponDependentUpon Cadeia de caracteres opcional.Optional string. Especifica o arquivo do qual esse arquivo depende para compilar corretamenteSpecifies the file this file depends on to compile correctly
GeradorGenerator Cadeia de caracteres obrigatória.Required string. O nome de qualquer gerador de arquivo executado nesse item.The name of any file generator that is run on this item.
LastGenOutputLastGenOutput Cadeia de caracteres obrigatória.Required string. O nome do arquivo criado por qualquer gerador de arquivo executado nesse item.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace Cadeia de caracteres obrigatória.Required string. O namespace no qual qualquer gerador de arquivo executado nesse item deve criar código.The namespace in which any file generator that runs on this item should create code.
LinkLink Cadeia de caracteres opcional.Optional string. O caminho de notação será exibido se o arquivo estiver localizado fisicamente fora da influência do projeto.The notational path is displayed if the file is physically located outside the influence of the project.
VisívelVisible Booliano opcional.Optional boolean. Indica se o arquivo no Gerenciador de Soluções deve ser exibido no Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Cadeia de caracteres opcional.Optional string. Determina se o arquivo deve ser copiado para o diretório de saída.Determines whether to copy the file to the output directory. Os valores são:Values are:

1. nunca1. Never
2. sempre2. Always
3. PreserveNewest3. PreserveNewest
LogicalNameLogicalName Cadeia de caracteres obrigatória.Required string. O nome lógico do recurso inserido.The logical name of the embedded resource.

ConteúdoContent

Representa os arquivos não compilados no projeto, mas pode ser inserido ou publicado junto com ele.Represents files that are not compiled into the project, but may be embedded or published together with it.

Nome de metadados de itemItem metadata name DescriçãoDescription
DependentUponDependentUpon Cadeia de caracteres opcional.Optional string. Especifica o arquivo do qual esse arquivo depende para compilar corretamente.Specifies the file this file depends on to compile correctly.
GeradorGenerator Cadeia de caracteres obrigatória.Required string. O nome de qualquer gerador de arquivo executado nesse item.The name of any file generator that runs on this item.
LastGenOutputLastGenOutput Cadeia de caracteres obrigatória.Required string. O nome do arquivo criado por qualquer gerador de arquivo executado nesse item.The name of the file that was created by any file generator that was run on this item.
CustomToolNamespaceCustomToolNamespace Cadeia de caracteres obrigatória.Required string. O namespace no qual qualquer gerador de arquivo executado nesse item deve criar código.The namespace in which any file generator that runs on this item should create code.
LinkLink Cadeia de caracteres opcional.Optional string. O caminho de notação a ser exibido se o arquivo estiver localizado fisicamente fora da influência do projeto.The notational path to be displayed if the file is physically located outside the influence of the project.
PublishStatePublishState Cadeia de caracteres obrigatória.Required string. O estado de publicação do conteúdo, seja:The publish state of the content, either:

- Padrão- Default
- Incluído- Included
- Excluído- Excluded
- DataFile- DataFile
- Pré-requisito- Prerequisite
IsAssemblyIsAssembly Booliano opcional.Optional boolean. Especifica se o arquivo é um assembly.Specifies whether the file is an assembly.
VisívelVisible Booliano opcional.Optional boolean. Indica se o arquivo no Gerenciador de Soluções deve ser exibido no Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Cadeia de caracteres opcional.Optional string. Determina se o arquivo deve ser copiado para o diretório de saída.Determines whether to copy the file to the output directory. Os valores são:Values are:

1. nunca1. Never
2. sempre2. Always
3. PreserveNewest3. PreserveNewest

{1>Nenhum<1}None

Representa arquivos que não devem ter função no processo de build.Represents files that should have no role in the build process.

Nome de metadados de itemItem metadata name DescriçãoDescription
DependentUponDependentUpon Cadeia de caracteres opcional.Optional string. Especifica o arquivo do qual esse arquivo depende para compilar corretamente.Specifies the file this file depends on to compile correctly.
GeradorGenerator Cadeia de caracteres obrigatória.Required string. O nome de qualquer gerador de arquivo executado nesse item.The name of any file generator that is run on this item.
LastGenOutputLastGenOutput Cadeia de caracteres obrigatória.Required string. O nome do arquivo criado por qualquer gerador de arquivo executado nesse item.The name of the file that was created by any file generator that ran on this item.
CustomToolNamespaceCustomToolNamespace Cadeia de caracteres obrigatória.Required string. O namespace no qual qualquer gerador de arquivo executado nesse item deve criar código.The namespace in which any file generator that runs on this item should create code.
LinkLink Cadeia de caracteres opcional.Optional string. O caminho de notação a ser exibido se o arquivo estiver localizado fisicamente fora da influência do projeto.The notational path to be displayed if the file is physically located outside the influence of the project.
VisívelVisible Booliano opcional.Optional boolean. Indica se o arquivo no Gerenciador de Soluções deve ser exibido no Visual StudioVisual Studio.Indicates whether to display the file in Solution Explorer in Visual StudioVisual Studio.
CopyToOutputDirectoryCopyToOutputDirectory Cadeia de caracteres opcional.Optional string. Determina se o arquivo deve ser copiado para o diretório de saída.Determines whether to copy the file to the output directory. Os valores são:Values are:

1. nunca1. Never
2. sempre2. Always
3. PreserveNewest3. PreserveNewest

AssemblyMetadataAssemblyMetadata

Representa os atributos de assembly a serem gerados como [AssemblyMetadata(key, value)].Represents assembly attributes to be generated as [AssemblyMetadata(key, value)].

Nome de metadados de itemItem metadata name DescriçãoDescription
IncluirInclude Torna-se o primeiro parâmetro (a chave) no construtor de atributo AssemblyMetadataAttribute.Becomes the first parameter (the key) in the AssemblyMetadataAttribute attribute constructor.
ValueValue Cadeia de caracteres obrigatória.Required string. Torna-se o segundo parâmetro (o valor) no construtor de atributo AssemblyMetadataAttribute.Becomes the second parameter (the value) in the AssemblyMetadataAttribute attribute constructor.

Note

Isso se aplica a projetos usando apenas o SDK do .NET Core.This applies to projects using the .NET Core SDK only.

BaseApplicationManifestBaseApplicationManifest

Representa o manifesto do aplicativo base do build e contém ClickOnceClickOnce informações de segurança de implantação.Represents the base application manifest for the build, and contains ClickOnceClickOnce deployment security information.

CodeAnalysisImportCodeAnalysisImport

Representa o projeto do FxCop a ser importado.Represents the FxCop project to import.

ImportarImport

Representa assemblies cujos namespaces devem ser importados pelo compilador Visual BasicVisual Basic.Represents assemblies whose namespaces should be imported by the Visual BasicVisual Basic compiler.

Veja tambémSee also