Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
No MSBuild, um item é uma referência nomeada a uma ou mais cadeias de caracteres, como nomes de arquivos. Os itens contêm metadados, como nomes de arquivos, caminhos e números de versão. Todos os tipos de projeto no Visual Studio têm vários itens em comum. Esses itens são definidos no arquivo Microsoft.Build.CommonTypes.xsd.
Este artigo lista todos os itens de projeto comuns definidos no próprio MSBuild. Itens e propriedades fornecidos pelo SDK do .NET estão documentados na referência do MSBuild para Microsoft.Net.Sdk.
O próprio MSBuild não define nenhum valor para metadados opcionais e metadados não definidos são equivalentes a uma cadeia de caracteres vazia. Portanto, o valor padrão para metadados opcionais é a cadeia de caracteres vazia. No entanto, os valores de metadados às vezes são definidos em arquivos SDK que são importados implicitamente. Os valores dependem do SDK que está sendo referenciado.
Reference
Representa uma referência de assembly .NET (gerenciado) no projeto.
| Nome dos metadados do item | Description |
|---|---|
| HintPath | Cadeia de caracteres opcional. Caminho relativo ou absoluto da montagem. |
| Name | Cadeia de caracteres opcional. O nome para exibição do assembly, por exemplo, "System.Windows.Forms". |
| FusionName | Cadeia de caracteres opcional. Especifica o nome de fusão simples ou forte para o item. Quando esse atributo está presente, ele pode economizar tempo porque o arquivo assembly não precisa ser aberto para obter o nome de fusão. |
| SpecificVersion | Booleano opcional. Especifica se apenas a versão no nome de fusão deve ser referenciada. |
| Aliases | Cadeia de caracteres opcional. Quaisquer aliases para a referência. |
| Private | Booleano opcional. Especifica se a referência deve ser copiada para a pasta de saída. Esse atributo corresponde à propriedade Copy Local da referência que está no IDE do Visual Studio. O padrão é false. |
Note
O Reference tipo de item também pode ser usado para fazer referência a assemblies wrapper pré-gerados para objetos COM nativos, por exemplo, se você usou tlbimp.exe para gerar um PIA (Primary Interop Assembly). Esse tipo de referência é uma opção apropriada quando você deseja pré-gerar os assemblies do wrapper COM com entradas conhecidas, em vez de depender do algoritmo do MSBuild para gerar wrappers COM no momento da compilação, o que introduz uma dependência no estado do registro do sistema na máquina de compilação onde o MSBuild é executado.
COMReference
Representa uma referência de componente COM (não gerenciado) no projeto. Este item é usado pela tarefa ResolveComReference, que gera os assemblies wrapper ou, se EmbedInteropTypes for usado, incorpora os tipos de interoperabilidade em seu assembly. O uso desse tipo de referência introduz uma dependência no registro do sistema na máquina de compilação, que é usada para procurar o objeto COM referenciado. Os artefatos COM e as entradas COM no Registro podem mudar quando os produtos são instalados, atualizados ou desinstalados na máquina (ou quando você executa a mesma compilação em uma máquina diferente), potencialmente produzindo um conjunto de wrapper diferente, mesmo que a lógica de compilação não tenha sido alterada.
Este item não se aplica a projetos non-.NET.
| Nome dos metadados do item | Description |
|---|---|
| Name | Cadeia de caracteres opcional. O nome para exibição do componente. |
| Guid | Cadeia de caracteres necessária. Um GUID para o componente, no formato {12345678-1234-1234-1234-123456781234}. |
| VersionMajor | Cadeia de caracteres necessária. A maior parte do número da versão do componente. Por exemplo, "5" se o número da versão completa for "5.46". |
| VersionMinor | Cadeia de caracteres necessária. A parte secundária do número da versão do componente. Por exemplo, "46" se o número da versão completa for "5.46". |
| EmbedInteropTypes | Booleano opcional. Se verdadeiro, incorpore os tipos de interoperabilidade dessa referência diretamente em seu assembly em vez de gerar uma DLL de interoperabilidade. |
| Lcid | Cadeia de caracteres opcional. O LocaleID para o componente. |
| WrapperTool | Cadeia de caracteres opcional. O nome da ferramenta wrapper que é usada no componente. Os valores são: 1. primário 2. TLBIMP 3. primário ortlbimp 4. aximp |
| Plano Isolado | Booleano opcional. Especifica se o componente é um componente livre de reg. O padrão é false. |
Consulte Solucionar problemas de referências COM.
COMFileReference
Representa uma lista de bibliotecas de tipos para referência por caminho de arquivo, em vez de usar o registro do sistema. Esse tipo de referência pode ser uma boa alternativa ao COMReference nos casos em que você deseja evitar uma dependência do registro da máquina de compilação, seja porque a conta que executa a compilação não tem privilégios elevados para editar o registro no servidor de compilação, ou porque você não quer que a compilação tenha uma dependência do estado do registro. Se você usar COMFileReference para fazer referência a um artefato em um caminho do sistema, então sua compilação tem uma dependência no estado do sistema. Se o artefato do sistema for alterado devido a uma alteração no estado do sistema, como quando os produtos são instalados, atualizados ou desinstalados (ou se você executar a mesma compilação em uma máquina diferente), o conjunto do wrapper poderá ser alterado, mesmo que a lógica de compilação não tenha sido alterada. Para garantir um resultado de compilação consistente, você pode armazenar em cache uma cópia conhecida do artefato COM em um local controlado, como na pasta do projeto ou da solução, e fazer referência a isso em vez do artefato do sistema.
Este item não se aplica a projetos non-.NET.
| Nome dos metadados do item | Description |
|---|---|
| EmbedInteropTypes | Booleano opcional. Se verdadeiro, incorpore os tipos de interoperabilidade dessa referência diretamente em seu assembly em vez de gerar uma DLL de interoperabilidade. O valor padrão é falso. |
| WrapperTool | Cadeia de caracteres opcional. O nome da ferramenta wrapper que é usada no componente. Os valores são: 1. primário 2. TLBIMP 3. primário ortlbimp 4. aximp |
Consulte Solucionar problemas de referências COM.
NativeReference
Representa um arquivo de manifesto nativo ou uma referência a esse arquivo.
| Nome dos metadados do item | Description |
|---|---|
| Name | Cadeia de caracteres necessária. O nome base do arquivo de manifesto. |
| HintPath | Cadeia de caracteres necessária. O caminho relativo do arquivo de manifesto. |
ProjectReference
Representa uma referência a outro projeto.
ProjectReferenceitens são transformados em itens ResolveProjectReferences pelo destino, portanto, quaisquer metadados válidos em uma Referência podem ser válidos em ProjectReference, se o processo de transformação não os substituir.
| Nome dos metadados do item | Description |
|---|---|
| Name | Cadeia de caracteres opcional. O nome para exibição da referência. |
| GlobalPropertiesToRemove | Opcional string[]. Nomes de propriedades a serem removidas ao criar o projeto referenciado, por exemplo, RuntimeIdentifier;PackOnBuild. O padrão é vazio. |
| Project | Cadeia de caracteres opcional. Um GUID para a referência, no formato {12345678-1234-1234-1234-123456781234}. |
| OutputItemType | Cadeia de caracteres opcional. Tipo de item para o qual emitir saídas de destino. O padrão está em branco. Se os metadados de referência estiverem definidos como "true" (padrão), as saídas de destino se tornarão referências para o compilador. |
| ReferenceOutputAssembly | Booleano opcional. Se 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 deste. O padrão é true. |
| BuildReference | Booleano opcional. O padrão é true. Se definido como false, este ProjectReference não será criado pelo MSBuild. As suas metas por defeito (ver «Metas» abaixo) não serão de todo chamadas. |
| Private | Booleano opcional. Especifica se a referência deve ser copiada para a pasta de saída. Esse atributo corresponde à propriedade Copy Local da referência que está no IDE do Visual Studio. |
| SetConfiguration | Cadeia de caracteres opcional. Define a propriedade global Configuration para o projeto referenciado, por exemplo, Configuration=Release. |
| SetPlatform | Cadeia de caracteres opcional. Define a propriedade global Platform para o projeto referenciado, por exemplo, Platform=AnyCPU. |
| SetTargetFramework | Cadeia de caracteres opcional. Define a propriedade global TargetFramework para o projeto referenciado, por exemplo, TargetFramework=netstandard2.0. |
| SkipGetTargetFrameworkProperties | Booleano opcional. Se true, constrói o projeto referenciado sem negociar o valor de TargetFramework mais compatível. O padrão é false. |
| Targets | Opcional string[]. Lista separada por ponto-e-vírgula de destinos nos projetos referenciados que devem ser construídos. Padrão é o valor de $(ProjectReferenceBuildTargets), que assume como padrão vazio, indicando os destinos padrão. Ao criar no Visual Studio (ao contrário de MSBuild.exe ou dotnet build), especificar isso não impede que o Visual Studio crie os destinos padrão do projeto referenciado. |
Note
Há uma diferença entre como as referências de projeto funcionam entre o .NET Framework e o .NET Core (incluindo o .NET 5 e posterior). Em projetos do .NET Framework, as referências de projeto não são transitivas. Ou seja, se Project1 faz referência a Project2 e Project2 faz referência a Project3, você não pode codificar contra Project3 de Project1. No entanto, no .NET Core (incluindo o .NET 5 e posterior), as referências de projeto são transitivas. Você pode codificar contra Project3 em Project1.
Compile
Representa os arquivos de origem para o compilador.
| Nome dos metadados do item | Description |
|---|---|
| DependentUpon | Cadeia de caracteres opcional. Especifica o arquivo do qual esse arquivo depende para compilar corretamente. |
| AutoGen | Booleano opcional. Indica se o arquivo foi gerado para o projeto pelo ambiente de desenvolvimento integrado (IDE) do Visual Studio. O padrão é false. |
| Link | Cadeia de caracteres opcional. O caminho notacional a ser exibido quando o arquivo está fisicamente localizado fora da influência do arquivo de projeto. |
| Visible | Booleano opcional. Indica se o arquivo deve ser exibido no Gerenciador de Soluções no Visual Studio. O padrão é true. |
| CopyToOutputDirectory | Cadeia de caracteres opcional. Determina se o arquivo deve ser copiado para o diretório de saída. Os valores são: 1. Nunca 2. Sempre 3. PreservarMais recente 4. SeDiferente O padrão é Never se DefineExplicitDefaults é definido como true; caso contrário, o padrão é a cadeia de caracteres vazia. |
EmbeddedResource
Representa os recursos a serem incorporados no assembly gerado.
| Nome dos metadados do item | Description |
|---|---|
| Culture | Cadeia de caracteres opcional. Especifica a cultura do arquivo de recurso. Se especificado, o processo de compilação não infere automaticamente a cultura com base na extensão de arquivo (que depende das culturas disponíveis para o .NET/OS na máquina que hospeda a compilação). É altamente recomendável definir metadados Culture={culture identifier} ou WithCulture=false. |
| WithCulture | Bool opcional. Especifica que o arquivo é neutro em termos de cultura e que a deteção de cultura por AssignCulture tarefa deve ser ignorada. É altamente recomendável definir metadados Culture={culture identifier} ou WithCulture=false. |
| DependentUpon | Cadeia de caracteres opcional. Especifica o arquivo do qual esse arquivo depende para compilar corretamente |
| Generator | Cadeia de caracteres opcional. O nome de qualquer gerador de arquivos que é executado neste item. |
| LastGenOutput | Cadeia de caracteres opcional. O nome do arquivo que foi criado por qualquer gerador de arquivos executado neste item. |
| CustomToolNamespace | Cadeia de caracteres opcional. O namespace no qual qualquer gerador de arquivos executado neste item deve criar código. |
| Link | Cadeia de caracteres opcional. O caminho notacional é exibido se o arquivo estiver fisicamente localizado fora da influência do projeto. |
| Visible | Booleano opcional. Indica se o arquivo deve ser exibido no Gerenciador de Soluções no Visual Studio. |
| CopyToOutputDirectory | Cadeia de caracteres opcional. Determina se o arquivo deve ser copiado para o diretório de saída. Os valores são: 1. Nunca 2. Sempre 3. PreservarMais recente 4. SeDiferente O padrão é Never se DefineExplicitDefaults é definido como true; caso contrário, o padrão é a cadeia de caracteres vazia. |
| LogicalName | Cadeia de caracteres necessária. O nome lógico do recurso incorporado. |
Content
Representa arquivos que não são compilados no projeto, mas podem ser incorporados ou publicados junto com ele.
| Nome dos metadados do item | Description |
|---|---|
| DependentUpon | Cadeia de caracteres opcional. Especifica o arquivo do qual esse arquivo depende para compilar corretamente. |
| Generator | Cadeia de caracteres opcional. O nome de qualquer gerador de arquivos executado neste item. |
| LastGenOutput | Cadeia de caracteres opcional. O nome do arquivo que foi criado por qualquer gerador de arquivos que foi executado neste item. |
| CustomToolNamespace | Cadeia de caracteres opcional. O namespace no qual qualquer gerador de arquivos executado neste item deve criar código. |
| Link | Cadeia de caracteres opcional. O caminho notacional a ser exibido se o arquivo estiver fisicamente localizado fora da influência do projeto. |
| PublishState | Cadeia de caracteres necessária. O estado de publicação do conteúdo: - Inadimplência - Incluído - Excluído - Ficheiro de Dados - Pré-requisito |
| IsAssembly | Booleano opcional. Especifica se o arquivo é um assembly. |
| Visible | Booleano opcional. Indica se o arquivo deve ser exibido no Gerenciador de Soluções no Visual Studio. |
| CopyToOutputDirectory | Cadeia de caracteres opcional. Determina se o arquivo deve ser copiado para o diretório de saída. Os valores são: 1. Nunca 2. Sempre 3. PreservarMais recente 4. SeDiferente O padrão é Never se DefineExplicitDefaults é definido como true; caso contrário, o padrão é a cadeia de caracteres vazia. |
| TargetPath | Cadeia de caracteres opcional. O caminho de saída (relativo ao diretório de saída específico da configuração e/ou plataforma) de um item, incluindo o nome do arquivo. Isso respeita os metadados Link, se fornecidos. Se o TargetPath não for fornecido, ele será calculado durante o processo de compilação. Consulte AssignTargetPath. |
None
Representa arquivos que não devem ter nenhuma função no processo de compilação.
| Nome dos metadados do item | Description |
|---|---|
| DependentUpon | Cadeia de caracteres opcional. Especifica o arquivo do qual esse arquivo depende para compilar corretamente. |
| Generator | Cadeia de caracteres opcional. O nome de qualquer gerador de arquivos que é executado neste item. |
| LastGenOutput | Cadeia de caracteres opcional. O nome do arquivo que foi criado por qualquer gerador de arquivos executado neste item. |
| CustomToolNamespace | Cadeia de caracteres opcional. O namespace no qual qualquer gerador de arquivos executado neste item deve criar código. |
| Link | Cadeia de caracteres opcional. O caminho notacional a ser exibido se o arquivo estiver fisicamente localizado fora da influência do projeto. |
| Visible | Booleano opcional. Indica se o arquivo deve ser exibido no Gerenciador de Soluções no Visual Studio. |
| CopyToOutputDirectory | Cadeia de caracteres opcional. Determina se o arquivo deve ser copiado para o diretório de saída. Os valores são: 1. Nunca 2. Sempre 3. PreservarMais recente 4. SeDiferente O padrão é Never se DefineExplicitDefaults é definido como true; caso contrário, o padrão é a cadeia de caracteres vazia. |
AssemblyMetadata
Representa atributos de assembly a serem gerados como [AssemblyMetadata(key, value)].
| Nome dos metadados do item | Description |
|---|---|
| Include | Torna-se o primeiro parâmetro (a chave) no construtor de atributo AssemblyMetadataAttribute. |
| Value | Cadeia de caracteres necessária. Torna-se o segundo parâmetro (o valor) no construtor do atributo AssemblyMetadataAttribute. |
Note
Este item se aplica a projetos que usam o SDK para .NET 5 (e .NET Core) e versões posteriores.
InternalsVisibleTo
Especifica assemblies a serem emitidos como atributos de assembly [InternalsVisibleTo(..)].
| Nome dos metadados do item | Description |
|---|---|
| Include | O nome do assembly. |
| Key | Cadeia de caracteres opcional. A chave pública da assembleia. |
Note
Este item se aplica a projetos que usam o SDK para .NET 5 (e .NET Core) e versões posteriores.
BaseApplicationManifest
Representa o manifesto do aplicativo base para a compilação e contém informações de segurança de implantação do ClickOnce.
CodeAnalysisImport
Representa o projeto FxCop a ser importado.
Import
Representa assemblies cujos namespaces devem ser importados pelo compilador do Visual Basic.
Folder
Este elemento só é usado pelo Visual Studio como um espaço reservado para uma pasta vazia. Quando a pasta é preenchida, ela é substituída por outro elemento.