Compartilhar via


/INCREMENTAL (vincular de maneira incremental)

/INCREMENTAL[:NO]

Comentários

Controla como o vinculador manipula a vinculação incremental.

Por padrão, o vinculador é executado no modo incremental. Para substituir um link incremental padrão, especifique /INCREMENTAL:NO.

Um programa incrementalmente vinculado é funcionalmente equivalente a um programa vinculado de forma não incremental. No entanto, como é preparado para links incrementais subsequentes, um arquivo executável vinculado incrementalmente (.exe) ou biblioteca de vínculo dinâmico (DLL):

  • É maior do que um programa vinculado não incrementalmente devido ao preenchimento de código e dados. (O preenchimento permite que o vinculador aumente o tamanho das funções e dos dados sem recriar o arquivo .exe.)

  • Pode conter conversões de atalho para manipular a realocação de funções para novos endereços.

    Dica

    Para garantir que a compilação da versão final não tenha preenchimento ou conversões, vincule seu programa de maneira não incremental.

Para vincular de maneira incremental independentemente do padrão, especifique /INCREMENTAL. Quando essa opção está selecionada, o vinculador emite um aviso se não pode vincular incrementalmente e vincula o programa de maneira não incremental. Determinadas opções e situações substituem /INCREMENTAL.

A maioria dos programas pode ser vinculada incrementalmente. Entretanto, algumas alterações são muito grandes e algumas opções são incompatíveis com a vinculação incremental. O LINK executa uma vinculação completa se qualquer uma das seguintes opções for especificada:

  • Vincular Incrementalmente não está selecionado (/INCREMENTAL:NO)

  • /OPT:REF está selecionado

  • /OPT:ICF está selecionado

  • /OPT:LBR está selecionado

  • /ORDER está selecionado

/INCREMENTAL é inferido quando /DEBUG é especificado.

Além disso, o LINK executa uma vinculação completa se qualquer uma das seguintes situações ocorrer:

  • Está faltando o arquivo de status incremental (.ilk). (O LINK cria um novo arquivo .ilk em preparação para a vinculação incremental subsequente.)

  • Não há permissão de gravação para o arquivo .ilk. (O LINK ignora o arquivo .ilk e o vincula de forma não incremental.)

  • Está faltando o arquivo de saída .exe ou .dll.

  • O carimbo de data/hora de .ilk, .exe ou .dll foi alterado.

  • Uma opção LINK foi modificada. A maioria das opções LINK, quando alteradas entre as compilações, causa uma vinculação completa.

  • Um arquivo de objeto (.obj) foi adicionado ou omitido.

Para definir esta opção do vinculador no ambiente de desenvolvimento do Visual Studio

  1. Abra a caixa de diálogo Páginas de Propriedades do projeto. Para obter detalhes, consulte Trabalhando com propriedades do projeto.

  2. Selecione a pasta Vinculador.

  3. Selecione a página de propriedades Geral.

  4. Modifique a propriedade Habilitar Vinculação Incremental.

Para definir esta opção do vinculador por meio de programação

Consulte também

Referência

Definindo opções de vinculador

Opções de vinculador