Propriedades comuns de projeto MSBuild

Todos os Visual Studio projetos, independentemente de seu tipo de projeto têm determinados MSBuild Propriedades em comum. Além disso, algumas outras propriedades são usadas com freqüência. Veja a seguir uma lista das propriedades comuns e usados com freqüência.

Lista de propriedades e parâmetros comuns

Propriedade ou o nome do parâmetro	Descrição
AdditionalLibPaths	Especifica as pastas adicionais no qual compiladores devem procurar os assemblies de referência.
AddModules	Faz o compilador tornar o tipo de todas as informações de especificado arquivos disponíveis para o projeto que você está compilando. Esta propriedade é equivalente a /addModules opção de compilador.
ALToolPath	O caminho onde o AL.exe pode ser encontrado. Esta 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 incorporação como um ícone do Win32. A propriedade é equivalente a /win32icon opção de compilador.
ApplicationManifest	Especifica o caminho do arquivo que é usado para gerar informações externas de manifesto de controle de conta de usuário (UAC). Se aplica somente ao direcionamento de projetos de Visual Studio Windows Vista. Na maioria dos casos, o manifesto é incorporado. No entanto, se você usar COM livre de registro ou ClickOnce implantação, e em seguida, o manifesto pode ser um arquivo externo que é instalado junto com seus assemblies do aplicativo. Para obter mais informações, consulte a propriedade NoWin32Manifest neste tópico.
AssemblySearchPaths	Uma lista de locais para pesquisa durante a resolução do assembly de referência de tempo de compilação. A ordem na qual os caminhos aparecem nesta lista é significativa porque os caminhos listados anteriormente tem precedência sobre as entradas mais recentes.
AssemblyName	O nome do assembly de saída final, após o projeto é construído.
BaseAddress	Especifica o endereço base do assembly de saída principal. Esta propriedade é equivalente a /baseaddress opção de compilador.
BaseOutputPath	Especifica o caminho de base para o arquivo de saída. Se for definido, MSBuild usará OutputPath = $(BaseOutputPath)\$(Configuration)\. Exemplo de sintaxe: <BaseOutputPath>c:\xyz\bin\</BaseOutputPath>
BaseIntermediateOutputPath	Especifica o caminho base intermediário para o arquivo de saída. Exemplo de sintaxe: <BaseIntermediateOutputPath>c:\xyz\obj\</BaseIntermediateOutputPath>
BuildInParallel	Um valor boolean que indica se as referências de projeto são criadas ou limpo em paralelo quando Multi Proc MSBuild é usado. O valor padrão é true, o que significa que projetos serão compilados em paralelo se o sistema tiver vários núcleos ou processadores.
BuildProjectReferences	Um valor boolean que indica se as referências de projeto são criadas por MSBuild. Definir false se você está construindo seu projeto na Visual Studio o ambiente de desenvolvimento integrado (IDE), true se contrário.
BaseIntermediateOutputPath	A pasta de nível superior onde todas as pastas de saída intermediária de configuração específicos são criadas. O valor padrão é obj\.
CleanFile	O nome do arquivo que será usado como "cache limpo". O cache de limpo é 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 que somente os nomes de arquivo que não possuem 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 /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 "Liberar".
CscToolPath	O caminho do CSC. exe, o Visual C# compilador.
CustomBeforeMicrosoftCommonTargets	O nome de um arquivo de projeto ou de um arquivo de destinos a serem importados automaticamente antes da importação de destinos comuns.
DebugSymbols	Um valor booleano que indica se os símbolos são gerados por compilação. Definindo /p:DebugSymbols=false na linha de comando desativa a geração de arquivos de símbolo do programa (. PDB) de banco de dados.
DefineConstants	Define constantes de compilador condicional. Símbolo/valor pares são separados por ponto e vírgula e são especificados usando a seguinte sintaxe: symbol1 = valor1; símbolo2 = valor2 A propriedade é equivalente a /define opção de compilador.
DefineDebug	Um valor booleano que indica se você deseja que a constante de depuração definida.
DefineTrace	Um valor booleano que indica se você deseja que a constante de rastreamento definida.
DebugType	Define o nível de informações de depuração que deseja gerado. Os valores válidos são "total" "pdbonly", e "none".
DelaySign	Um valor booleano que indica se você deseja para o assembly de sinal de atraso, em vez de sinal full-lo.
DisabledWarnings	Suprime os avisos especificados. Apenas a parte numérica do identificador de aviso deve ser especificada. Vários avisos são separados por ponto e vírgula. Este parâmetro corresponde do /nowarn Alternar do compilador Vbc. exe.
DisableFastUpToDateCheck	Um valor booleano que se aplica a Visual Studio somente. O Visual Studio build manager usa um processo chamado FastUpToDateCheck para determinar se um projeto deve ser recriado para ser atualizados. Esse processo é mais rápido que usar MSBuild para determinar isso. Definindo a propriedade DisableFastUpToDateCheck para true lhe permite ignorar o Visual Studio build manager e forçá-lo a usar MSBuild para determinar se o projeto é atualizados.
DocumentationFile	O nome do arquivo que será gerado como um 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 a /errorreport opção de compilador.
ExcludeDeploymentUrl	O Tarefa de GenerateDeploymentManifest adiciona uma marca de deploymentProvider para o manifesto de implantação, se o arquivo de projeto inclui qualquer um dos seguintes elementos: UpdateUrl InstallUrl PublishUrl Usando o ExcludeDeploymentUrl, no entanto, você pode impedir que a marca de deploymentProvider sendo adicionado para o manifesto de implantação, mesmo se qualquer uma das URLs acima são especificados. Para fazer isso, adicione a propriedade a seguir ao arquivo do projeto: <ExcludeDeploymentUrl>true</ExcludeDeploymentUrl> Observação ExcludeDeploymentUrl não é exposta na 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 à 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 a /filealignment opção de compilador.
FrameworkPathOverride	Especifica a localização do mscorlib. dll e microsoft.visualbasic.dll. Este parâmetro é equivalente a /sdkpath Alternar do compilador Vbc. exe.
GenerateDocumentation	Um parâmetro booleano que indica se a documentação é gerada por compilação. Se true, a compilação gera informações de documentação e coloca-o 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 intermediária completo conforme derivado do BaseIntermediateOutputPath, se nenhum caminho for especificado. Por exemplo, \obj\debug\. Se esta propriedade é substituída, definindo BaseIntermediateOutputPath tem nenhum efeito.
KeyContainerName	O nome do recipiente 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 para o 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 a /nowin32manifest Alternar do compilador Vbc. exe.
ModuleAssemblyName	O nome do assembly que o módulo compilado deve ser incorporadas. A propriedade é equivalente a /moduleassemblyname opção de compilador.
/Nologo	Um valor booleano que indica se você deseja que o logotipo do compilador para ser desligado. Esta propriedade é equivalente a /nologo opção de compilador.
/Nostdlib	Um valor booleano que indica se evitem fazer referência a biblioteca padrão (mscorlib. dll). O valor padrão é false.
NoVBRuntimeReference	Um valor boolean que indica se o Visual Basic o tempo de execução (Microsoft.VisualBasic.dll) deve ser incluído como uma referência no projeto.
NoWin32Manifest	Um valor boolean que indica se as informações do manifesto de controle de conta de usuário (UAC) serão incorporadas no aplicativo executável da normal. Se aplica somente ao direcionamento de projetos de Visual Studio Windows Vista. Em projetos implantados usando ClickOnce e COM sem registro, esse elemento será ignorado. False (o valor padrão) Especifica que informações de manifesto do controle de conta de usuário (UAC) ser incorporadas executável. do aplicativo TrueEspecifica que as informações de manifesto UAC não ser incorporadas. Esta propriedade se aplica somente ao Visual Studio o direcionamento de projetos Windows Vista. Em projetos implantados usando ClickOnce e COM sem registro, essa propriedade será ignorada. Você deve adicionar NoWin32Manifest somente se você não deseja Visual Studio para incorporar qualquer informação de manifesto no executável do aplicativo; Esse processo é chamado de virtualização. Para utilizar a virtualização, defina <ApplicationManifest> em conjunto com <NoWin32Manifest> da seguinte maneira: Para Visual Basic projetos, remover o <ApplicationManifest> nó. (Em Visual Basic projetos, <NoWin32Manifest> é ignorada quando uma <ApplicationManifest> o nó existe.) For Visual C# projects, set <ApplicationManifest> to False and <NoWin32Manifest> to True. (Em Visual C# projetos, <ApplicationManifest> substitui <NoWin32Manifest>.)
Otimizar	Um valor booleano que, quando definido como true, permite otimizações do compilador. Esta propriedade é equivalente a /optimize opção de compilador.
OptionCompare	Especifica como são feitas comparações de cadeias de caracteres. Os valores válidos são "binários" ou "texto". Esta propriedade é equivalente a /optioncompare Alternar do compilador Vbc. exe.
OptionExplicit	Um valor booleano que, quando definido como true, requer declaração explícita de variáveis no código fonte. Esta propriedade é equivalente a /optionexplicit opção de compilador.
OptionInfer	Um valor booleano que, quando definido como true, que permite que a inferência de tipos de variáveis. Esta propriedade é equivalente a /optioninfer opção de compilador.
OptionStrict	Um valor booleano que, quando definido como true, faz com que a tarefa de compilação para impor a semântica do tipo estrito para restringir as conversões de tipo implícito. Esta propriedade é equivalente a /optionstrict Alternar do 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 de arquivo do arquivo de saída. Este parâmetro pode ter um dos seguintes valores: Biblioteca. Cria uma biblioteca de código. (Valor padrão). Exe. Cria um aplicativo de console. Módulo. Cria um módulo. Winexe. Cria um programa baseado no Windows. Esta propriedade é equivalente a /target Alternar do compilador Vbc. exe.
OverwriteReadOnlyFiles	Um valor booleano que indica se você deseja habilitar compilação para sobrescrever arquivos somente leitura ou acionar um erro.
PdbFile	O nome do arquivo. PDB que você está emitindo. Esta propriedade é equivalente a /pdb Alternar do compilador CSC. exe.
Plataforma	O criação de para o sistema operacional. Os valores válidos são "anycpu,". "x86", "x64", ou "itanium".
RemoveIntegerChecks	Um valor booleano que indica se deve desativar as verificações de erro de estouro de inteiro. O valor padrão é false. Esta propriedade é equivalente a /removeintchecks Alternar do compilador Vbc. exe.
SGenUseProxyTypes	Um valor booleano que indica se os tipos de proxy devem ser gerados pelo Sgen. exe. O destino SGen usa essa propriedade para definir o sinalizador UseProxyTypes. Essa propriedade assume true e não há nenhuma interface do usuário para alterar isso. Para gerar o assembly de serialização de tipos de não webservice, adicionar essa propriedade para o arquivo de projeto e defini-la como false antes de importar o Microsoft.Common.Targets ou o C#/VB.targets.
SGenToolPath	Um caminho da 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 um procedimento Sub Main. Esta propriedade é equivalente a /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,". "x86", "amd64" ou "ia64".
RootNamespace	O namespace raiz para usar ao nomear um recurso incorporado. Este namespace é parte do nome do manifesto do recurso incorporado.
Satellite_AlgorithmId	A identificação do algoritmo de hash AL.exe para usar quando assemblies satélite são criados.
Satellite_BaseAddress	O endereço base para usar quando culture-specific satélite é criados usando o CreateSatelliteAssemblies de destino.
Satellite_CompanyName	O nome da empresa para passar no AL.exe durante a geração de assembly satélite.
Satellite_Configuration	O nome da configuração passar em AL.exe durante a geração de assembly satélite.
Satellite_Description	O texto de descrição passar em AL.exe durante a geração de assembly satélite.
Satellite_EvidenceFile	Incorpora o arquivo especificado no assembly satélite que tem o nome do recurso "Security.Evidence".
Satellite_FileVersion	Especifica uma seqüência 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 para usar caminhos absolutos para arquivos relatados em uma mensagem de erro.
Satellite_LinkResource	Vincula os arquivos de recurso especificado para um assembly satélite.
Satellite_MainEntryPoint	Especifica o nome totalmente qualificado (ou seja, class.method) do método para usar como um ponto de entrada, quando um módulo é convertido para um arquivo executável durante a geração de assembly satélite.
Satellite_ProductName	Especifica uma seqüência de caracteres para o campo Product no assembly satélite.
Satellite_ProductVersion	Especifica uma seqüência de caracteres para o campo ProductVersion no assembly satélite.
Satellite_TargetType	Especifica o formato de arquivo do arquivo de saída do assembly satélite como "library" "exe" ou "win". O valor padrão é "library".
Satellite_Title	Especifica uma seqüência de caracteres para o campo Title no assembly satélite.
Satellite_Trademark	Especifica uma seqüência 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.
TargetCompactFramework	A versão do.NET Compact Framework é necessário para executar o aplicativo que você está criando. Especificar isso permite que determinados assemblies do framework que pode não ser capaz de fazer referência a outra forma de referência.
TargetFrameworkVersion	A versão do .NET Framework que é necessário para executar o aplicativo que você está criando. Especificar isso permite que determinados assemblies do framework que pode não ser capaz de fazer referência a outra forma de referência.
TreatWarningsAsErrors	Um parâmetro booleano que, se true, faz com que todos os avisos a serem tratados como erros. Este parâmetro é equivalente a /nowarn opção de compilador.
UseHostCompilerIfAvailable	Um parâmetro booleano que, se true, faz com que a tarefa de compilação para usar o objeto do compilador em processo, se estiver disponível. Este 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 a /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 da Visual Basic de saída. do compilador Os valores válidos são "Silencioso", "Normal" (o valor padrão), ou "Verbose".
WarningsAsErrors	Especifica uma lista de avisos para tratar como erros. Este parâmetro é equivalente a /warnaserror opção de compilador.
WarningsNotAsErrors	Especifica uma lista de avisos que não são tratados como erros. Este parâmetro é equivalente a /warnaserror opção de compilador.
/Win32manifest	O nome do arquivo de manifesto que deve ser incorporado na montagem final. Este parâmetro é equivalente a /win32Manifest opção de compilador.
Wint32Resource	O nome do arquivo de recurso Win32 a ser incorporado no assembly final. Este parâmetro é equivalente a /win32resource opção de compilador.

Consulte também

Referência

Itens de projeto MSBuild comuns