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:
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> .gif "Observação") 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:
|
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:
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 . |