/KEYFILE (especificar chave ou par de chaves para assinar um assembly)

  • Artigo
/KEYFILE:filename

Argumentos

filename
Arquivo que contém a chave. Coloque a cadeia de caracteres entre aspas duplas (" "), se ela contiver um espaço.

Comentários

O vinculador insere a chave pública no manifesto do assembly e, em seguida, assina o assembly final com a chave privada. Para gerar um arquivo de chave, digite sn -k filename na linha de comando. Um assembly assinado é conhecido por ter um nome forte.

Se você compilar com /LN, o nome do arquivo de chave será mantido no módulo e incorporado ao assembly que é criado quando você compila um assembly que inclui uma referência explícita ao módulo, por meio de #using ou ao vincular com /ASSEMBLYMODULE.

Você também pode passar informações de criptografia para o vinculador com /KEYCONTAINER. Use /DELAYSIGN se quiser um assembly parcialmente assinado. Para obter mais informações sobre como assinar um assembly, confira Assemblies de Nome Forte (Assinatura de Assembly) (C++/CLI) e Criar e usar assemblies com nome forte.

Caso /KEYFILE e /KEYCONTAINER sejam especificadas (pela opção da linha de comando ou pelo atributo personalizado), o vinculador tentará primeiro o contêiner de chaves. Se isso ocorrer, o assembly será assinado com as informações no contêiner de chaves. Se o vinculador não localizar o contêiner de chaves, ele tentará o arquivo especificado com /KEYFILE. Se isso ocorrer, o assembly será assinado com as informações no arquivo de chave e as informações da chave serão instaladas no contêiner de chaves (semelhante a sn -i), de forma que, na próxima compilação, o contêiner de chaves será válido.

Um arquivo de chave pode conter apenas a chave pública.

Outras opções do vinculador que afetam a geração de assembly são:

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, confira Definir as propriedades de build e do compilador do C++ no Visual Studio.

  2. Selecione a página de propriedades Propriedades da Configuração>Vinculador>Linha de Comando.

  3. Insira a opção na caixa Opções Adicionais.

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

Confira também

Referência de vinculador MSVC
Opções de vinculador MSVC