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çã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