Compartilhar via


Propriedades comuns de projeto MSBuild

A seguinte tabela lista as propriedades geralmente usados que são definidas nos arquivos de projeto do Visual Studio ou incluídas em arquivos .targets que fornece o MSBuild.

Os arquivos do no Visual Studio (.csproj, .vbproj, vcxproj, e outro) contêm o código do MSBuild XML que executa quando você cria um projeto usando o IDE.Importar projetos geralmente um ou mais arquivos .targets para definir o processo de compilação.Para obter mais informações, consulte MSBuild.Arquivos de destinos.

Lista de propriedades comuns e de parâmetros

Nome da propriedade ou de parâmetro

Descrição

AdditionalLibPaths

Especifica as pastas adicionais em que os compiladores devem procurar os assemblies de referência.

AddModules

Faz com que o compilador torne todas as informações do tipo dos arquivos especificados disponíveis para o projeto que você está criando.Esta propriedade é equivalente a opção do compilador de /addModules .

ALToolPath

O caminho onde AL.exe pode ser encontrado.Essa propriedade substitui a versão atual do AL.exe para ativar o uso de uma versão diferente.

ApplicationIcon

O arquivo de ícone .ico o passe para o compilador para inserir como um ícone Win32.A propriedade é equivalente a opção do compilador de /win32icon .

ApplicationManifest

Especifica o caminho do arquivo que é usado para gerar informações externo de manifesto de Controle de Conta de Usuário (UAC).Se aplica somente a projetos do Visual Studio que direcionam Windows Vista.

Na maioria dos casos, o manifesto é inserido.No entanto, se você usar o registro COM livre ou implantação de ClickOnce , o manifesto pode ser um arquivo externo que está instalado junto com os assemblies do aplicativo.Para obter mais informações, consulte a propriedade de NoWin32Manifest neste tópico.

AssemblyOriginatorKeyFile

Especifica o arquivo que são usados para assinar o assembly (.snk ou .pfx) e que é passado para Tarefa ResolveKeySource para gerar a chave real que é usada para assinar o assembly.

AssemblySearchPaths

Uma lista de locais para pesquisar na resolução dos assemblies de referência de tempo hora.A ordem em que os caminhos aparecem na lista é útil porque os caminhos listaram anterior tem precedência sobre as entradas posteriores.

AssemblyName

O nome do assembly final de saída após o projeto é criado.

BaseAddress

Especifica o endereço básico do assembly principal de saída.Esta propriedade é equivalente a opção do compilador de /baseaddress .

BaseOutputPath

Especifica o caminho base para o arquivo de saída.Se estiver definido, MSBuild usará OutputPath = $(BaseOutputPath)\$(Configuration)\.Sintaxe de exemplo: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath>

BaseIntermediateOutputPath

A pasta de nível superior onde todas as pastas intermediários configuração específicas de saída são criadas.O valor padrão é obj\.O código a seguir é um exemplo: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath>

BuildInParallel

Um valor booleano que indica se as referências de projeto são compiladas ou limpadas paralelamente quando o proc várias MSBuild é usado.O valor padrão é true, o que significa que os projetos serão criados paralelamente se o sistema tiver vários processadores ou núcleos.

BuildProjectReferences

Um valor booleano que indica se as referências de projeto são compiladas por MSBuild.Definir false se você estiver criando seu projeto no ambiente de desenvolvimento integrado Visual Studio (IDE), se true caso contrário.

CleanFile

O nome do arquivo que será usado como “limpa o cache.” O cache é limpo uma lista de arquivos excluídos a ser gerados durante a operação de limpeza.O arquivo é colocado no caminho intermediário de saída pelo processo de compilação.

Esta propriedade especifica somente os nomes de arquivo que não têm informações de caminho.

Página de código

Especifica o página de código a ser usada para todos os arquivos de código fonte em uma compilação.Esta propriedade é equivalente a opção do compilador de /codepage .

CompilerResponseFile

Um arquivo opcional de resposta que pode ser passado para o compilador tarefas.

Configuração

A configuração que você está criando, “depuração” ou “versão”.

CscToolPath

O caminho de csc.exe, o compilador de Visual C# .

CustomBeforeMicrosoftCommonTargets

O nome de um arquivo de projeto ou arquivo de destino que estão ser importados automaticamente antes que a importação destinos comuns.

DebugSymbols

Um valor booleano que indica se símbolos são gerados pela compilação.

A configuração /p:DebugSymbols=false na linha de comando desativa a geração de arquivos de símbolo de banco de dados do programa (.pdb).

DefineConstants

Define constantes condicionais de compilador.Os pares do símbolo/valor são separadas por ponto-e-vírgula e especificados usando a seguinte sintaxe:

symbol1; = value1 symbol2 = valor2

A propriedade é equivalente a opção do compilador de /define .

DefineDebug

Um valor booleano que indica se você desejar que a constante debug definida.

DefineTrace

Um valor booleano que indica se você desejar que a constante trace definida.

DebugType

Define o nível de informações de depuração que você deseja gerado.Os valores válidos são completamente “,” pdbonly “,” e “nenhum”.

DelaySign

Um valor booleano que indica se você desejar que o atraso - sinal o assembly em vez do sinal completos ele.

DisabledWarnings

Suprime os avisos específicos.Somente a parte numérica do identificador de aviso deve ser especificada.Vários avisos são separadas por ponto-e-vírgula.Este parâmetro corresponde ao de /nowarn opção de compilador vbc.exe.

DisableFastUpToDateCheck

Um valor booleano que se aplica a Visual Studio somente.O gerenciador de compilação de Visual Studio usar um processo chamado FastUpToDateCheck para determinar se um projeto deve ser reconstruído para ser atualizado.Esse processo é mais rápido do que usar MSBuild para determinar isso.Defina a propriedade de DisableFastUpToDateCheck a true permite que você ignorar o gerenciador de compilação de Visual Studio e força para usar MSBuild para determinar se o projeto é atualizado.

DocumentationFile

O nome do arquivo que é gerado como o arquivo de documentação XML.Este nome inclui somente o nome de arquivo e não possui informações de caminho.

ErrorReport

Especifica como a tarefa de compilador deve relatar erros do compilador interno.Os valores válidos são aviso “,” enviar “,” ou “nenhum”. Esta propriedade é equivalente a opção do compilador de /errorreport .

ExcludeDeploymentUrl

Tarefa GenerateDeploymentManifest adiciona uma marca de deploymentProvider o manifesto de implantação se o arquivo de projeto inclui qualquer um dos seguintes elementos:

  • UpdateUrl

  • InstallUrl

  • PublishUrl

Usando ExcludeDeploymentUrl, no entanto, você pode impedir que a marca de deploymentProvider seja adicionada ao manifesto de implantação mesmo se qualquer um de URL acima são especificados. Para fazer isso, adicione a propriedade a seguir para o arquivo de projeto:

<ExcludeDeploymentUrl>true</ExcludeDeploymentUrl>

ObservaçãoObservação
ExcludeDeploymentUrl não é exposta em Visual Studio IDE e pode ser definido somente editando manualmente o arquivo de projeto. Defina essa propriedade não afeta a publicação dentro de Visual Studio; ou seja, a marca de deploymentProvider ainda será adicionada à URL especificado por PublishUrl.

FileAlignment

Especifica, em bytes, onde alinhar as seções do arquivo de saída.Os valores válidos são 512, 1024, 2048, 4096, 8192.Esta propriedade é equivalente a opção do compilador de /filealignment .

FrameworkPathOverride

Especifica o local mscorlib.dll e microsoft.visualbasic.dll.Este parâmetro é equivalente a opção de /sdkpath de compilador vbc.exe.

GenerateDocumentation

Um parâmetro boolean que indica se a documentação é gerada pela compilação.Se true, a compilação gera informações sobre a documentação e o coloca em um arquivo .xml juntamente com o nome do arquivo executável ou biblioteca que a tarefa de compilação criou.

IntermediateOutputPath

O caminho completo de saída como intermediário derivado de BaseIntermediateOutputPath, se nenhum caminho é especificado.Por exemplo, \ obj \ debug \.Se essa propriedade é substituída, então definir BaseIntermediateOutputPath não tem efeito.

KeyContainerName

O nome do contêiner de chave de nome forte.

KeyOriginatorFile

O nome da chave de nome forte.

NoWin32Manifest

Determina se o compilador gera o manifesto Win32 padrão no conjunto de saída.O valor padrão de false significa que o manifesto Win32 de opção é gerado para todos os aplicativos.Esta propriedade é equivalente a opção do compilador de /nowin32manifest vbc.exe.

ModuleAssemblyName

O nome do assembly que o módulo compilado deve ser inserido em.A propriedade é equivalente a opção do compilador de /moduleassemblyname .

NoLogo

Um valor booleano que indica se você desejar que o logotipo do compilador para ser desativado.Esta propriedade é equivalente a opção do compilador de /nologo .

NoStdLib

Um valor booleano que indica se evitar fazer referência à biblioteca padrão (mscorlib.dll).O valor padrão é false.

NoVBRuntimeReference

Um valor booleano que indica se o tempo de execução de Visual Basic (Microsoft.VisualBasic.dll) deve ser incluído como uma referência no projeto.

NoWin32Manifest

Um valor booleano que indica se as informações de manifesto de Controle de Conta de Usuário (UAC) será inserida no aplicativo executável.Se aplica somente a projetos do Visual Studio que direcionam Windows Vista.Em projetos implantados usando ClickOnce e registration-free COM, este elemento será ignorado. False (o valor padrão) especifica que as informações do manifesto de Controle de Conta de Usuário (UAC) está inserida no aplicativo executável.True especifica quais informações do manifesto de UAC não seja inserido.

Esta propriedade se aplica somente a projetos de Visual Studio que direcionam Windows Vista.Em projetos implantados usando ClickOnce e registration-free COM, essa propriedade é ignorada.

Você deve adicionar NoWin32Manifest somente se você não deseja Visual Studio para inserir as informações do manifesto do aplicativo executável; esse processo é chamado virtualização.Para usar a virtualização, defina <ApplicationManifest> em conjunto com <NoWin32Manifest> como segue:

  • Para projetos de Visual Basic , remova o nó de <ApplicationManifest> .(Em Visual Basic se projetos, <NoWin32Manifest> é ignorado quando um nó de <ApplicationManifest> existir.)

  • Para projetos de Visual C# , defina <ApplicationManifest> a False e <NoWin32Manifest> a True.(Em Visual C# se projetos, substitui <NoWin32Manifest>de <ApplicationManifest> .)

Otimizar

Um valor booleano que quando definida como, trueativar otimizações de compilador.Esta propriedade é equivalente a opção do compilador de /optimize .

OptionCompare

Especifica como são feitas comparações de cadeias de caracteres.Os valores válidos são “binária” ou “texto”. Esta propriedade é equivalente a opção do compilador de /optioncompare vbc.exe.

OptionExplicit

Um valor booleano que quando definida como, truerequisitar declarações explícitas de variáveis no código-fonte.Esta propriedade é equivalente a opção do compilador de /optionexplicit .

OptionInfer

Um valor booleano que quando definida como, trueativar a inferência de tipos de variáveis.Esta propriedade é equivalente a opção do compilador de /optioninfer .

OptionStrict

Um valor booleano que quando definida como true, faz com que a tarefa de compilação aplica semânticas de tipo rígidas para restringir conversões implícitas de tipo.Esta propriedade é equivalente a opção de /optionstrict de compilador vbc.exe.

OutputPath

Especifica o caminho para o diretório de saída, relativo ao diretório do projeto, por exemplo, “bin \ debug”.

OutputType

Especifica o formato do arquivo de saída.Este parâmetro pode ter um dos seguintes valores:

  • Biblioteca.Cria uma biblioteca de códigos.(Valor padrão.)

  • Exe.Cria um aplicativo de console.

  • Módulo.Cria um módulo.

  • Winexe.Crie um programa baseado no Windows.

Esta propriedade é equivalente a opção de /target de compilador vbc.exe.

OverwriteReadOnlyFiles

Um valor booleano que indica se você deseja ativar a compilação para substituir arquivos somente leitura ou disparar um erro.

PdbFile

O nome do arquivo de .pdb que você está emitindo.Esta propriedade é equivalente a opção de /pdb de compilador csc.exe.

Plataforma

O sistema operacional que você está criando para.Os valores válidos são AnyCPU “,” x “,” x64 “,” ou “Itanium”.

RemoveIntegerChecks

Um valor booleano que indica se desativar verificações de erro de excedentes inteiro.O valor padrão é false.Esta propriedade é equivalente a opção de /removeintchecks de compilador vbc.exe.

SGenUseProxyTypes

Um valor booleano que indica se os tipos de proxy devem ser gerados por SGen.exe.

O destino de SGen usa essa propriedade para definir o sinalizador de UseProxyTypes.Esta propriedade padrão como true, e não há nenhuma interface de usuário para alterar isso.Para gerar o conjunto de serialização para tipos de non-webservice, adicionar essa propriedade para o arquivo de projeto e defina-a como false antes de importar o Microsoft.Common.Targets ou o C#/VB.targets.

SGenToolPath

Um caminho opcional de ferramenta que indica onde obter SGen.exe quando a versão atual de SGen.exe é substituída.

StartupObject

Especifica a classe ou módulo que contém o método principal ou o procedimento main da sub-rotina.Esta propriedade é equivalente a opção do compilador de /main .

ProcessorArchitecture

A arquitetura do processador que é usada quando as referências assembly são resolvidas.Os valores válidos são “MSIL”, “x”, “amd64,” ou “ia64”.

RootNamespace

O namespace raiz para utilizar quando você nomear um recurso inserido.Este namespace é parte do nome de recurso de manifesto inserido.

Satellite_AlgorithmId

A identificação de O algoritmo de hash do AL.exe para usar ao satellite assemblies são criados.

Satellite_BaseAddress

O endereço básico para usar quando módulos satélite específicos de cultura são criados usando o destino de CreateSatelliteAssemblies .

Satellite_CompanyName

O nome da empresa para passar em AL.exe durante a geração de assembly satélite.

Satellite_Configuration

O nome de configuração para passar em AL.exe durante a geração de assembly satélite.

Satellite_Description

A descrição para passar em AL.exe durante a geração de assembly satélite.

Satellite_EvidenceFile

Insere o arquivo especificado no assembly satélite que tem o nome “Security.Evidence de recurso.”

Satellite_FileVersion

Especifica uma cadeia de caracteres para o campo de versão de um Arquivo no assembly satélite.

Satellite_Flags

Especifica um valor para os sinalizadores colocados no assembly satélite.

Satellite_GenerateFullPaths

Faz com que a tarefa de compilação usar caminhos absolutos para todos os arquivos reportados em uma mensagem de erro.

Satellite_LinkResource

Vincula os arquivos de recursos especificados para um assembly satélite.

Satellite_MainEntryPoint

Especifica o nome totalmente qualificado (isto é, class.method) do método para usar como um ponto de entrada quando um módulo é convertido em um arquivo executável durante a geração de assembly satélite.

Satellite_ProductName

Especifica uma cadeia de caracteres para o campo de produto no assembly satélite.

Satellite_ProductVersion

Especifica uma cadeia de caracteres para o campo de ProductVersion no assembly satélite.

Satellite_TargetType

Especifica o formato do arquivo de saída de assembly satélite como “library”, “exe”, ou “vitória”. O valor padrão é “library.”

Satellite_Title

Especifica uma cadeia de caracteres para o campo título no assembly satélite.

Satellite_Trademark

Especifica uma cadeia de caracteres para o campo de marca registrada no assembly satélite.

Satellite_Version

Especifica informações de versão para o assembly satélite.

Satellite_Win32Icon

Insere um arquivo de ícone .ico no assembly satélite.

Satellite_Win32Resource

Insere um recurso Win32 (arquivo de .res) no assembly satélite.

SubsystemVersion

Especifica a versão mínima do subsistema que o arquivo executável gerado pode usar.Esta propriedade é equivalente a opção do compilador de /subsystemversion .Para obter informações sobre o valor padrão da propriedade, consulte /subsystemversion (Visual Basic) ou /subsystemversion (Opções do compilador de C#).

TargetCompactFramework

A versão do.NET Compact Framework necessárias para executar o aplicativo que você está criando.Isso permite que você especifique determinados referenciar assemblies de estrutura que você não poderá fazer referência ao contrário.

TargetFrameworkVersion

A versão de .NET Framework que é necessária para executar o aplicativo que você está criando.Isso permite que você especifique determinados referenciar assemblies de estrutura que você não poderá fazer referência ao contrário.

TreatWarningsAsErrors

Um parâmetro boolean que, se true, que todos os avisos ser tratado como erros.Este parâmetro é equivalente a opção do compilador de /nowarn .

UseHostCompilerIfAvailable

Um parâmetro boolean que, se true, que a tarefa de compilação usar o objeto para processo de compilador, se disponível.Esse parâmetro é usado somente por Visual Studio.

Utf8Output

Um parâmetro boolean que, se true, registra saída de log de compilador usando a codificação UTF-8.Este parâmetro é equivalente a opção do compilador de /utf8Output .

VbcToolPath

Um caminho opcional que indica um local para outro vbc.exe quando a versão atual vbc.exe é substituída.

VbcVerbosity

Especifica a verbosidade de saída do compilador de Visual Basic .Os valores válidos são silêncio “,” “normal” (o valor padrão), ou “detalhado.”

VisualStudioVersion

Especifica a versão do Visual Studio sob que este projeto deve ser sendo executado.Se esta propriedade não for especificada, o MSBuild configure-o para um valor padrão razoável.

Essa propriedade é usada em vários tipos de projeto para especificar o conjunto de destino que são usados para compilação.Se ToolsVersion é definido como 4,0 ou mais alto para um projeto, VisualStudioVersion é usado para especificar que subelemento conjunto de ferramentas para usar.Para obter mais informações, consulte MSBuild Toolset (ToolsVersion).

WarningsAsErrors

Especifica uma lista de tratar avisos como erros.Este parâmetro é equivalente a opção do compilador de /warnaserror .

WarningsNotAsErrors

Especifica uma lista de avisos que não são tratados como erros.Este parâmetro é equivalente a opção do compilador de /warnaserror .

Win32Manifest

O nome do arquivo de manifesto que deve ser inserido no assembly final.Este parâmetro é equivalente a opção do compilador de /win32Manifest .

Wint32Resource

O nome do arquivo de recurso Win32 a ser inserido no assembly final.Este parâmetro é equivalente a opção do compilador de /win32resource .

Consulte também

Referência

Itens de projeto MSBuild comuns