Propriedades de projeto comuns do MSBuild
A tabela a seguir lista frequentemente usado propriedades que são definidas nos arquivos de projeto do Visual Studio ou incluído nos arquivos. targets fornecidos pelo MSBuild.
Arquivos de projeto no Visual Studio (. csproj,. vbproj, vcxproj e outros) contêm código de XML do MSBuild que é executado quando você cria um projeto usando o IDE. Projetos normalmente importem um ou mais arquivos. targets para definir o processo de criação. Para obter mais informações, consulte Arquivos .targets do MSBuild.
Lista de Propriedades Comuns e Parâmetros
Propriedade ou o nome do parâmetro |
Descrição |
|---|---|
AdditionalLibPaths |
Especifica as pastas adicionais no qual compiladores devem procurar assemblies de referência. |
AddModules |
Faz com que o compilador verifique todos os tipos de arquivos disponíveis para o projeto que você está compilando informações especificado. Esta propriedade é equivalente de /addModules opção de compilador. |
ALToolPath |
O caminho onde AL.exe pode ser encontrado. Essa propriedade substitui a versão atual do AL.exe para habilitar o uso de uma versão diferente. |
ApplicationIcon |
O arquivo de ícone. ico para passar para o compilador para inserir como um ícone de Win32. A propriedade é equivalente de /win32icon opção de compilador. |
ApplicationManifest |
Especifica o caminho do arquivo que é usado para gerar informações de manifesto externas User Account Control (UAC). Aplica-se somente a projetos do Visual Studio destinado Windows Vista. Na maioria dos casos, o manifesto é incorporado. No entanto, se você usar registro gratuito COM ou ClickOnce implantação, o manifesto pode ser um arquivo externo que é instalado junto com seus assemblies de aplicativo. Para obter mais informações, consulte a propriedade NoWin32Manifest neste tópico. |
AssemblyOriginatorKeyFile |
Especifica o arquivo que é usado para assinar o assembly (. snk ou. pfx) e que é passado para o Tarefa ResolveKeySource para gerar a chave real que é usada para assinar o assembly. |
AssemblySearchPaths |
Uma lista de locais para pesquisa durante a resolução de assembly de referência em tempo de compilação. A ordem na qual os caminhos aparecem nesta lista é significativa porque caminhos listados anteriormente tem precedência sobre entradas posteriores. |
AssemblyName |
O nome do assembly de saída final depois que o projeto é criado. |
BaseAddress |
Especifica o endereço base do assembly de saída principal. Esta propriedade é equivalente de /baseaddress opção de compilador. |
BaseOutputPath |
Especifica o caminho base para o arquivo de saída. Se estiver definido, MSBuild usará OutputPath = $(BaseOutputPath)\$(Configuration)\. Exemplo de sintaxe:<BaseOutputPath>c:\xyz\bin\</BaseOutputPath> |
BaseIntermediateOutputPath |
A pasta de nível superior onde todas as pastas de saída intermediária específicos da configuração 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 criadas ou limpos quando paralelo Proc múltiplo MSBuild é usado. O valor padrão é true, que significa que projetos serão compilados em paralelo se o sistema tiver vários processadores ou núcleos. |
BuildProjectReferences |
Um valor booleano que indica se as referências do projeto são criadas por MSBuild. Definir false se você estiver criando o projeto Visual Studio ambiente de desenvolvimento integrado (IDE), true se contrário. |
CleanFile |
O nome do arquivo que será usado como o "cache limpo". Limpar cache é uma lista dos arquivos gerados sejam excluídos durante a operação de limpeza. O arquivo é colocado no caminho de saída intermediária pelo processo de compilação. Esta propriedade especifica apenas os nomes de arquivo que não possuem informações de caminho. |
Página de código |
Especifica a página de código a ser usado para todos os arquivos de código-fonte na compilação. Esta propriedade é equivalente de /codepage opção de compilador. |
CompilerResponseFile |
Um arquivo de resposta opcional que pode ser passado para as tarefas do compilador. |
Configuração |
A configuração que você está criando, "Debug" ou "Versão". |
CscToolPath |
O caminho do csc.exe, o Visual C# compilador. |
CustomBeforeMicrosoftCommonTargets |
O nome de um arquivo de projeto ou arquivo de destinos que deve ser importados automaticamente antes da importação de destinos comuns. |
DebugSymbols |
Um valor booliano que indica se os símbolos são gerados pela compilação. Definindo /p:DebugSymbols=false na linha de comando desabilita a geração de arquivos de símbolo (. PDB) de banco de dados de programa. |
DefineConstants |
Define as constantes de compilador condicional. Símbolo/valor pares são separados por ponto e vírgula e são especificadas usando a sintaxe a seguir: symbol1 = value1; symbol2 = valor2 A propriedade é equivalente de /define opção de compilador. |
DefineDebug |
Um valor booliano que indica se você deseja que a constante de depuração definida. |
DefineTrace |
Um valor booliano que indica se você deseja que a constante de rastreamento definida. |
Tipo_de_depuração |
Define o nível de informações de depuração que você deseja que seja gerado. Os valores válidos são "total", "somente pdb" e "none". |
DelaySign |
Um valor booliano que indica se você deseja atrasar a assinatura do assembly em vez de sinal completo-lo. |
DisabledWarnings |
Suprime os avisos especificados. Somente a parte numérica do identificador de aviso deve ser especificada. Vários avisos são separados por ponto e vírgula. Esse parâmetro corresponde do /nowarn opção do compilador vbc.exe. |
DisableFastUpToDateCheck |
Um valor booleano que se aplica a Visual Studio somente. O Visual Studio criar manager usa um processo chamado FastUpToDateCheck para determinar se um projeto deve ser reconstruído para ser atualizado. Esse processo é mais rápido que usar MSBuild para determinar isso. Definindo a propriedade DisableFastUpToDateCheck para true permite ignorar o Visual Studio criar gerenciador e forçá-lo a usar MSBuild para determinar se o projeto é atualizado. |
DocumentationFile |
O nome do arquivo que é gerado como o arquivo de documentação XML. Esse nome inclui o nome de arquivo e não tem nenhuma informação de caminho. |
ErrorReport |
Especifica como a tarefa de compilador deve relatar erros do compilador interno. Os valores válidos são "prompts", "Enviar" ou "none". Esta propriedade é equivalente de /errorreport opção de compilador. |
ExcludeDeploymentUrl |
O Tarefa GenerateDeploymentManifest adiciona uma marca deploymentProvider no 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 deploymentProvider que está sendo adicionado ao manifesto de implantação, mesmo se qualquer uma das URLs anteriores forem especificados. Para fazer isso, adicione a propriedade a seguir ao arquivo de projeto: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Dica ExcludeDeploymentUrl não é exposta no Visual Studio IDE e pode ser definida apenas editando manualmente o arquivo de projeto. A definição dessa propriedade não afeta a publicação em Visual Studio; ou seja, a marca deploymentProvider ainda será adicionada para a URL especificada pelo 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 de /filealignment opção de compilador. |
FrameworkPathOverride |
Especifica o local de mscorlib. dll e microsoft.visualbasic.dll. Este parâmetro é equivalente de /sdkpath opção do compilador vbc.exe. |
GenerateDocumentation |
Um parâmetro booleano 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, junto com o nome do arquivo executável ou biblioteca que criou a tarefa de compilação. |
IntermediateOutputPath |
O caminho de saída completo intermediários conforme derivado de BaseIntermediateOutputPath, se nenhum caminho for especificado. Por exemplo, \obj\debug\. Se essa propriedade for substituída, definindo BaseIntermediateOutputPath não tem nenhum efeito. |
KeyContainerName |
O nome do contêiner de chave de nome forte. |
KeyOriginatorFile |
O nome do arquivo de chave de nome forte. |
NoWin32Manifest |
Determina se o compilador gera o manifesto Win32 padrão no assembly de saída. O valor padrão de false significa que o manifesto Win32 padrão é gerado para todos os aplicativos. Esta propriedade é equivalente de /nowin32manifest opção de compilador de vbc.exe. |
/Moduleassemblyname |
O nome do assembly que o módulo compilado deve ser incorporado. A propriedade é equivalente de /moduleassemblyname opção de compilador. |
/Nologo |
Um valor booliano que indica se você deseja que o logotipo do compilador para ser desligado. Esta propriedade é equivalente de /nologo opção de compilador. |
/Nostdlib |
Um valor booliano que indica se deve evitar fazem referência à biblioteca padrão (mscorlib. dll). O valor padrão é false. |
NoVBRuntimeReference |
Um valor booleano que indica se o Visual Basic tempo de execução (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 User Account Control (UAC) serão incorporadas no aplicativo executável da. Aplica-se somente a projetos do Visual Studio destinado Windows Vista. Em projetos implantados usando ClickOnce e COM sem registro, esse elemento será ignorado. False (o valor padrão) Especifica que as informações de manifesto User Account Control (UAC) ser incorporado no executável do aplicativo. TrueEspecifica que as informações de manifesto UAC não ser inserido. Essa propriedade se aplica somente ao Visual Studio projetos direcionamento Windows Vista. Em projetos implantados usando ClickOnce e COM sem registro, essa propriedade será ignorada. Você deve adicionar NoWin32Manifest somente se você não quiser Visual Studio para qualquer manifesto incorporado no aplicativo do executável; Esse processo é chamado virtualização. Para usar a virtualização, defina <ApplicationManifest> em conjunto com <NoWin32Manifest> da seguinte forma:
|
Otimizar |
Um valor booleano que, quando definido como true, permite otimizações do compilador. Esta propriedade é equivalente de /optimize opção de compilador. |
/Optioncompare |
Especifica como são feitas comparações de cadeia de caracteres. Os valores válidos são "binário" ou "text". Esta propriedade é equivalente de /optioncompare opção de compilador de vbc.exe. |
/Optionexplicit |
Um valor booleano que, quando definido como true, exige a declaração explícita de variáveis no código-fonte. Esta propriedade é equivalente de /optionexplicit opção de compilador. |
OptionInfer |
Um valor booleano que, quando definido como true, permite inferência de tipos de variáveis. Esta propriedade é equivalente de /optioninfer opção de compilador. |
OptionStrict |
Um valor booleano que, quando definido como true, faz com que a tarefa de compilação para impor semânticas de tipo rígidas para restringir a conversões de tipo implícito. Esta propriedade é equivalente de /optionstrict opção do compilador vbc.exe. |
OutputPath |
Especifica o caminho para o diretório de saída, relativo ao diretório do projeto, por exemplo, "bin". |
OutputType |
Especifica o formato de arquivo do arquivo de saída. Este parâmetro pode ter um dos seguintes valores:
Esta propriedade é equivalente de /target opção do compilador vbc.exe. |
OverwriteReadOnlyFiles |
Um valor booliano que indica se você deseja habilitar a compilação substituir os arquivos somente leitura ou acionar um erro. |
PdbFile |
O nome do arquivo do arquivo. PDB que estão emitindo. Esta propriedade é equivalente de /pdb opção do compilador csc.exe. |
Plataforma |
O sistema operacional que você estiver criando para. Os valores válidos são "Qualquer CPU", "x86" e "x64". |
RemoveIntegerChecks |
Um valor booliano que indica se deve desabilitar a verificação de erro de estouro de inteiro. O valor padrão é false. Esta propriedade é equivalente de /removeintchecks opção do compilador vbc.exe. |
SGenUseProxyTypes |
Um valor booliano que indica se os tipos de proxy devem ser gerados por SGen.exe. O destino SGen usa esta propriedade para definir o sinalizador UseProxyTypes. Essa propriedade assume true como padrão e não há nenhuma interface do usuário para alterar isso. Para gerar o assembly de serialização para tipos não webservice, adicione essa propriedade ao arquivo de projeto e defini-lo como false antes de importar o Microsoft.Common.Targets ou o C#/VB.targets. |
SGenToolPath |
Um caminho de ferramenta opcional que indica onde obter SGen.exe quando a versão atual do SGen.exe é substituída. |
StartupObject |
Especifica a classe ou módulo que contém o método Main ou o procedimento Sub Main. Esta propriedade é equivalente de /main opção de compilador. |
ProcessorArchitecture |
A arquitetura do processador é usada quando as referências de assembly são resolvidas. Os valores válidos são "msil", "computador x86", "amd64" ou "ia64". |
RootNamespace |
O namespace raiz para usar ao nomear um recurso incorporado. Este namespace é parte do nome de manifesto do recurso inserido. |
Satellite_AlgorithmId |
A ID do algoritmo de hash AL.exe usar quando assemblies satélite são criados. |
Satellite_BaseAddress |
O endereço base a ser usado ao assemblies satélites específicas de cultura são criados usando o CreateSatelliteAssemblies destino. |
Satellite_CompanyName |
O nome da empresa para passar para AL.exe durante a geração do assembly satélite. |
Satellite_Configuration |
O nome da configuração de passar para AL.exe durante a geração do assembly satélite. |
Satellite_Description |
O texto de descrição para passar para AL.exe durante a geração do assembly satélite. |
Satellite_EvidenceFile |
Incorpora o arquivo especificado no assembly satélite que tem o nome do recurso "Evidence." |
Satellite_FileVersion |
Especifica uma cadeia de caracteres para o campo de versão do arquivo no assembly satélite. |
Satellite_Flags |
Especifica um valor para o campo de sinalizadores no assembly satélite. |
Satellite_GenerateFullPaths |
Faz com que a tarefa de compilação usar caminhos absolutos para arquivos relatados em uma mensagem de erro. |
Satellite_LinkResource |
Vincula os arquivos de recurso especificado em um assembly satélite. |
Satellite_MainEntryPoint |
Especifica o nome totalmente qualificado (ou seja, class.method) do método a ser usado como um ponto de entrada quando um módulo é convertido em um arquivo executável durante a geração do assembly satélite. |
Satellite_ProductName |
Especifica uma cadeia de caracteres para o campo Product no assembly satélite. |
Satellite_ProductVersion |
Especifica uma cadeia de caracteres do campo ProductVersion no assembly satélite. |
Satellite_TargetType |
Especifica o formato de arquivo do arquivo de saída do assembly satélite como "biblioteca", "exe" ou "win." O valor padrão é a "biblioteca". |
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 as informações de versão do assembly satélite. |
Satellite_Win32Icon |
Insere um arquivo de ícone. ico no assembly satélite. |
Satellite_Win32Resource |
Insere um recurso do Win32 (arquivo. res) no assembly satélite. |
SubsystemVersion |
Especifica a versão mínima do subsistema que pode usar o arquivo executável gerado. Esta propriedade é equivalente de /subsystemversion opção de compilador. Para obter informações sobre o valor padrão desta propriedade, consulte /subsystemversion (Visual Basic) ou /subsystemversion (opções do compilador C#). |
TargetCompactFramework |
A versão do .NET Compact Framework que é necessário para executar o aplicativo que você está criando. Especificar isso, você poderá fazer referência a determinados assemblies do framework que você não poderá fazer referência a outra forma. |
TargetFrameworkVersion |
A versão dos .NET Framework que é necessário para executar o aplicativo que você está criando. Especificar isso, você poderá fazer referência a determinados assemblies do framework que você não poderá fazer referência a outra forma. |
TreatWarningsAsErrors |
Um parâmetro booleano que, se true, faz com que todos os avisos a serem tratados como erros. Este parâmetro é equivalente de /nowarn opção de compilador. |
UseHostCompilerIfAvailable |
Um parâmetro booleano que, se true, faz com que a tarefa de compilação usar o objeto do compilador em processo, se ele estiver disponível. Esse parâmetro é usado somente por Visual Studio. |
Utf8Output |
Um parâmetro booleano que, se true, registra a saída do compilador usando a codificação UTF-8. Este parâmetro é equivalente de /utf8Output opção de compilador. |
VbcToolPath |
Um caminho opcional que indica a outro local para vbc.exe quando a versão atual do vbc.exe é substituída. |
VbcVerbosity |
Especifica a verbosidade do Visual Basic de saída do compilador. Os valores válidos são "Silencioso", "Normal" (o valor padrão) ou "Detalhado". |
VisualStudioVersion |
Especifica a versão do Visual Studio sob a qual este projeto deve ser considerado para estar em execução. Se esta propriedade não for especificada, o MSBuild a define como um valor de padrão razoáveis. Esta propriedade é usada em vários tipos de projetos para especificar o conjunto de destinos que são usados para a compilação. Se ToolsVersion é definido como 4.0 ou superior para um projeto, VisualStudioVersion é usada para especificar qual subconjunto de ferramentas para usar. Para obter mais informações, consulte MSBuild Toolset (ToolsVersion). |
WarningsAsErrors |
Especifica uma lista de avisos a serem tratados como erros. Este parâmetro é equivalente de /warnaserror opção de compilador. |
WarningsNotAsErrors |
Especifica uma lista de avisos que não são tratados como erros. Este parâmetro é equivalente de /warnaserror opção de compilador. |
Win32Manifest |
O nome do arquivo de manifesto deve ser incorporado no assembly final. Este parâmetro é equivalente de /win32Manifest opção de compilador. |
Win32Resource |
O nome do arquivo de recurso Win32 a ser inserido no assembly final. Este parâmetro é equivalente de /win32resource opção de compilador. |