Partilhar via


Propriedades comuns de projeto MSBuild

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

Lista de parâmetros e propriedades comuns

Propriedade ou o nome do parâmetro

Descrição

AdditionalLibPaths

Especifica as pastas adicionais no qual os compiladores devem procurar por assemblies de referência.

AddModules

Faz com que o compilador tornar o tipo de todos os arquivos disponível para o projeto está compilando informações do especificado. Esta propriedade é equivalente a /addModules comutador de compilador.

ALToolPath

O caminho onde AL.exe pode ser encontrado. Esta propriedade substitui a versão corrente do AL.exe Ativar uso de uma versão diferente.

ApplicationIcon

O arquivo de ícone .ico para passar para o compilador para incorporar sistema autônomo um ícone de Win32. A propriedade é equivalente a /win32icon comutador de compilador.

ApplicationManifest

Especifica o caminho do arquivo que é usado para gerar informações externas de manifesto UAC (controle de conta de usuário). Aplica-se somente a projetos do Visual Studio direcionamento Windows Vista.

Na maioria dos casos, o manifesto é incorporado. No entanto, se você usar o inscrição disponível COM ou ClickOnce implantação e, em seguida, o manifesto pode ser um arquivo externo que é instalado junto com seus conjuntos de aplicativos. Para obter mais informações, consulte a propriedade NoWin32Manifest neste tópico.

AssemblySearchPaths

Uma lista de locais Pesquisar durante a resolução de assembly de referência de time de compilação. A ordem na qual 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 depois que o projeto é construído.

BaseAddress

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

BaseOutputPath

Especifica o caminho base para o arquivo de saída. Se for conjunto, 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 booliano 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, que significa que projetos serão compilados paralela se o sistema tiver vários núcleos ou processadores.

BuildProjectReferences

Um valor booliano que indica se as referências de projeto são criadas por MSBuild. conjunto false Se você estiver criando o projeto Visual Studio ambiente de desenvolvimento integrado (IDE) true Caso contrário.

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\.

CleanFile

O nome do arquivo que será usado sistema autônomo "cache limpo". Limpo o cache é uma lista de 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 somente nomes de arquivo que não possuem informações de caminho.

Página de códigos

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 comutador de compilador.

CompilerResponseFile

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

Configuração

A configuração que você está criando, "depurar" ou "versão."

CscToolPath

O caminho do csc.exe, a Visual C# compilador.

CustomBeforeMicrosoftCommonTargets

O nome de um arquivo de projeto ou arquivo de destinos a serem importados automaticamente antes da importação de destinos comuns.

DebugSymbols

Um valor booliano que indica se os símbolos são gerados por compilação.

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

DefineConstants

Define constantes de compilador condicional. Pares de símbolo/valor são separados por ponto-e-vírgula e são especificados usando a seguinte sintaxe:

symbol1 = valor1; symbol2 = valor2

A propriedade é equivalente a /define comutador de compilador.

DefineDebug

Um valor booliano que indica se você deseja que a constante depurar definida.

DefineTrace

Um valor booliano que indica se você deseja que a constante TRACE definida.

DebugType

Define o nível de informações de depurar que você deseja gerado. Os valores válido são "total", "pdbonly" e "none".

DelaySign

Um valor booliano que indica se você deseja a assinatura atrasada do assembly em vez de sinal completo-lo.

DisabledWarnings

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

DisableFastUpToDateCheck

Um valor booliano que se aplica a Visual Studio somente. The Visual Studio compilação Gerenciador usa um processo chamado FastUpToDateCheck para determinar se um projeto deve ser recriado para ser atualizado. Esse processo é mais rápido do que usar MSBuild para determinar isso. A configuração da propriedade DisableFastUpToDateCheck como true permite que você ignore o Visual Studio Criar Gerenciador e forçá-lo a usar MSBuild para determinar se o projeto é atualizado.

DocumentationFile

O nome do arquivo que será gerado sistema autônomo arquivo de documentação XML. Esse nome inclui apenas 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álido são "prompts", "enviar" ou "nenhum". Esta propriedade é equivalente a /errorreport comutador de compilador.

ExcludeDeploymentUrl

The Tarefa GenerateDeploymentManifest Adiciona uma marca deploymentProvider para 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 evitar que a marca deploymentProvider sejam adicionados para o manifesto de implantação, mesmo se qualquer um dos URLs acima forem especificados. Para fazer isso, adicione a seguinte propriedade ao seu arquivo de projeto:

<ExcludeDeploymentUrl>true</ExcludeDeploymentUrl>

ObservaçãoObservação:
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 à URL especificada pela PublishUrl.

FileAlignment

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

FrameworkPathOverride

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

GenerateDocumentation

Um parâmetro booliano que indica se a documentação é gerada pela compilação. If 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 total intermediário conforme derivado de BaseIntermediateOutputPath, se nenhum caminho for especificado. Por exemplo, \obj\depurar\. Se essa propriedade for substituída, em seguida, definir BaseIntermediateOutputPath não tem efeito.

Nome_do_recipiente_de_chaves

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

KeyOriginatorFile

O nome da strong name chave arquivo.

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 a /nowin32manifest comutador de compilador de vbc.exe.

ModuleAssemblyName

O nome do assembly que o módulo compilado é sejam incorporados. A propriedade é equivalente a /moduleassemblyname comutador de compilador.

NoLogo

Um valor booliano que indica se você deseja que o compilador logotipo para ser desligado. Esta propriedade é equivalente a /nologo comutador de compilador.

NoStdLib

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

NoVBRuntimeReference

Um valor booliano que indica se o Visual Basic tempo de execução (Microsoft.VisualBasic.dll) deve ser incluído sistema autônomo referência em que o projeto.

NoWin32Manifest

Um valor booliano que indica se as informações de manifesto UAC (controle de conta de usuário) serão incorporadas no aplicativo 's executável. Aplica-se somente a projetos do Visual Studio direcionamento Windows Vista. Em projetos implantados usando ClickOnce e inscrição-disponível COM, esse elemento será ignorado. False (o valor padrão) Especifica que informações do manifesto UAC (controle de conta de usuário) ser incorporadas executável do aplicativo. True Especifica que informações do manifesto UAC não ser incorporadas.

Esta propriedade se aplica somente a Visual Studio direcionamento de projetos Windows Vista. Em projetos implantados usando ClickOnce e COM sem inscrição, essa propriedade é ignorada.

Você deve adicionar NoWin32Manifest apenas se você não deseja Visual Studio Para incorporar qualquer manifesto informações no aplicativo do executável; esse processo é chamado virtualização. Para usar a virtualização, definir <ApplicationManifest> em conjunto com <NoWin32Manifest> sistema autônomo a seguir:

  • For Visual Basic projetos, remova o <ApplicationManifest> nó. (In Visual Basic projetos, <NoWin32Manifest> é ignorado quando um <ApplicationManifest> nó existe.)

  • For Visual C# conjunto projetos, <ApplicationManifest> para False e <NoWin32Manifest> para True. (In Visual C# projetos, <ApplicationManifest> substituições <NoWin32Manifest>.)

Otimizar

Valor de um booliano que, quando conjunto para true, permite que otimizações de compilador. Esta propriedade é equivalente a /optimize comutador de compilador.

OptionCompare

Especifica como são feitas comparações de cadeias de caracteres. Os valores válido são "binário" ou "texto". Esta propriedade é equivalente a /optioncompare comutador de compilador de vbc.exe.

OptionExplicit

Valor de um booliano que, quando conjunto para true, requer declaração explícita de variáveis no código-fonte. Esta propriedade é equivalente a /optionexplicit comutador de compilador.

OptionInfer

Valor de um booliano que, quando conjunto para true, permite digitar inferência de tipos de variáveis. Esta propriedade é equivalente a /optioninfer comutador de compilador.

OptionStrict

Um booliano valor quando definido como true, faz com que a tarefa de compilação para impor a semântica do tipo estrito para restringir conversões implícitas de tipo. Esta propriedade é equivalente a /optionstrict comutador do compilador vbc.exe.

OutputPath

Essa propriedade normalmente é especificada no arquivo de projeto e é semelhante a OutDir. OutputPath foi substituída e OutDir deve ser usado sempre que possível.

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ódigos. (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 comutador do compilador vbc.exe.

OverwriteReadOnlyFiles

Um valor booliano que indica se você deseja habilitar a compilação substituir arquivos somente leitura ou acionar um erro.

PdbFile

O nome de arquivo do arquivo .pdb que estão emitindo. Esta propriedade é equivalente a /pdb comutador do compilador csc.exe.

Plataforma

O sistema operacional . que você está criando. Os valores válido são "AnyCPU," "x86", "x64" ou "Itanium".

RemoveIntegerChecks

Um valor booliano que indica se deve desabilitar verificações de erro de estouro de inteiro. O valor padrão é false. Esta propriedade é equivalente a /removeintchecks comutador do compilador vbc.exe.

SGenUseProxyTypes

Um valor booliano que indica se os tipos de proxy devem ser gerados pelo SGen.exe.

SGenToolPath

Um caminho de ferramenta opcional que indica onde obter SGen.exe quando a versão corrente do SGen.exe será 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 comutador de compilador.

ProcessorArchitecture

A arquitetura do processador que será usada quando referências de assembly são resolvidas. Os valores válido são "msil", "x86", "amd64" ou "ia64".

RootNamespace

O namespace raiz para usar ao nomear um recurso inserido. Este namespace é parte do nome de manifesto do recurso inserido.

Satellite_AlgorithmId

A ID do algoritmo de hash AL.exe para usar quando assemblies satélites serão criados.

Satellite_BaseAddress

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

Satellite_CompanyName

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

Satellite_Configuration

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

Satellite_Description

O texto de descrição de passar para AL.exe durante satélite assembly geração.

Satellite_EvidenceFile

Incorpora o arquivo especificado no satélite assembly que tem o nome de recurso "segurança.evidência."

Satellite_FileVersion

Especifica uma seqüência de caracteres para o campo de versão do arquivo no satélite assembly.

Satellite_Flags

Especifica um valor para o campo de sinalizadores no satélite assembly.

Satellite_GenerateFullPaths

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

Satellite_LinkResource

Vincula os arquivos de recurso especificado a um satélite assembly.

Satellite_MainEntryPoint

Especifica o nome totalmente qualificado (ou seja, classe.method) do método para usar sistema autônomo um ponto de entrada quando um módulo é convertido em um arquivo executável durante satélite assembly geração.

Satellite_ProductName

Especifica uma seqüência de caracteres para o campo produto no satélite assembly.

Satellite_ProductVersion

Especifica uma seqüência de caracteres para o campo ProductVersion no satélite assembly.

Satellite_TargetType

Especifica o formato de arquivo do satélite assembly arquivo de saída sistema autônomo "biblioteca", "exe" ou "vence". O valor padrão é "biblioteca".

Satellite_Title

Especifica uma seqüência de caracteres para o campo Cargo no satélite assembly.

Satellite_Trademark

Especifica uma seqüência de caracteres para o campo de marcas no satélite assembly.

Satellite_Version

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

Satellite_Win32Icon

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

Satellite_Win32Resource

Insere um recurso do Win32 (. res arquivo) no asssembly satélite.

TargetCompactFramework

A versão do .NET Compact estrutura que é necessária para executar o aplicativo que você está criando. Especificar isso permite fazer referência a determinados assemblies do estrutura que podem não ser capaz de fazer referência a outra forma.

TargetFrameworkVersion

A versão do .NET Framework que é necessário para executar o aplicativo que você está criando. Especificar isso permite fazer referência a determinados assemblies do estrutura que podem não ser capaz de fazer referência a outra forma.

TreatWarningsAsErrors

Um parâmetro booliano que, se true, faz com que todos sistema autônomo avisos a serem tratados sistema autônomo erros. Este parâmetro é equivalente a /nowarn comutador de compilador.

UseHostCompilerIfAvailable

Um parâmetro booliano que, se true, faz com que a tarefa de compilação usar o objeto de compilador em processo, se estiver disponível. Este parâmetro é usado somente por Visual Studio.

Utf8Output

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

VbcToolPath

Um caminho opcional que indica a outro local para vbc.exe quando a versão corrente do vbc.exe será substituída.

VbcVerbosity

Especifica a verbosidade do Visual Basic saída de compilador. Os valores válido são "Silencioso", "Normal" (o valor padrão) ou "Verbose."

WarningsAsErrors

Especifica uma lista de avisos para tratar sistema autônomo erros. Este parâmetro é equivalente a /warnaserror comutador de compilador.

WarningsNotAsErrors

Especifica uma lista de avisos que não são tratados sistema autônomo erros. Este parâmetro é equivalente a /warnaserror comutador de compilador.

Win32Manifest

O nome do arquivo de manifesto deve ser incorporado no assembly final. Este parâmetro é equivalente a /win32Manifest comutador de compilador.

Wint32Resource

O nome de arquivo do recurso Win32 a ser incorporado no assembly final. Este parâmetro é equivalente a /win32resource comutador de compilador.

Consulte também

Referência

Itens de projeto MSBuild comuns