Como: assinar um assembly com um nome forteHow to: Sign an Assembly with a Strong Name

Há vários modos de assinar um assembly com um nome forte:There are a number of ways to sign an assembly with a strong name:

  • Usando a guia Assinatura na caixa de diálogo Propriedades de um projeto no Visual Studio.By using the Signing tab in a project's Properties dialog box in Visual Studio. Esta é a forma mais fácil e conveniente de assinar um assembly com um nome forte.This is the easiest and most convenient way to sign an assembly with a strong name.

  • Usando o Vinculador de Assembly (Al.exe) para vincular um módulo de código do .NET Framework (um arquivo .netmodule) com um arquivo de chave.By using the Assembly Linker (Al.exe) to link a .NET Framework code module (a .netmodule file) with a key file.

  • Usando atributos de assembly para inserir as informações do nome forte no seu código.By using assembly attributes to insert the strong name information into your code. Você pode usar o atributo AssemblyKeyFileAttribute ou AssemblyKeyNameAttribute, dependendo do local em que o arquivo de chave a ser usado se encontra.You can use either the AssemblyKeyFileAttribute or the AssemblyKeyNameAttribute attribute, depending on where the key file to be used is located.

  • Usando opções do compilador.By using compiler options.

Você deve ter um par de chaves de criptografia para assinar um assembly com um nome forte.You must have a cryptographic key pair to sign an assembly with a strong name. Para obter mais informações de como criar um par de chaves, confira Como criar um par de chaves pública/privada.For more information about creating a key pair, see How to: Create a Public-Private Key Pair.

Para criar e assinar um assembly com um nome forte usando o Visual Studio.To create and sign an assembly with a strong name by using Visual Studio

  1. No Gerenciador de Soluções, abra o menu de atalho do projeto e, em seguida, escolha Propriedades.In Solution Explorer, open the shortcut menu for the project, and then choose Properties.

  2. Escolha a guia Assinatura.Choose the Signing tab.

  3. Marque a caixa Assinar o assembly.Select the Sign the assembly box.

  4. Na caixa Escolher um arquivo de chave com nome forte, selecione <Procurar…> e, em seguida, navegue até o arquivo de chave.In the Choose a strong name key file box, choose <Browse…>, and then navigate to the key file. Para criar um novo arquivo de chave, selecione <Novo…> e digite o nome na caixa de diálogo Criar Chave de Nome Forte.To create a new key file, choose <New…> and enter its name in the Create Strong Name Key dialog box.

Observação

Para assinar um assembly com atraso, escolha um arquivo de chave pública.In order to delay sign an assembly, choose a public key file.

Para criar e assinar um assembly com um nome forte usando o Vinculador de Assembly.To create and sign an assembly with a strong name by using the Assembly Linker

  • Com o Prompt de Comando do Desenvolvedor para Visual Studio, digite o seguinte comando:At the Developer Command Prompt for Visual Studio, type the following command:

    al /out:<assemblyName> <moduleName> /keyfile:<keyfileName>al /out:<assemblyName> <moduleName> /keyfile:<keyfileName>

    em que:where:

    assemblyNameassemblyName
    O nome forte do assembly assinado (um arquivo .dll ou .exe) que o Vinculador de Assembly emitirá.The name of the strongly signed assembly (a .dll or .exe file) that Assembly Linker will emit.

    moduleNamemoduleName
    O nome de um módulo de código do .NET Framework (um arquivo .netmodule) que inclui um ou mais tipos.The name of a .NET Framework code module (a .netmodule file) that includes one or more types. Você pode criar um arquivo .netmodule ao compilar seu código com a opção /target:module em C# ou no Visual Basic.You can create a .netmodule file by compiling your code with the /target:module switch in C# or Visual Basic.

    keyfileNamekeyfileName
    O nome do contêiner ou arquivo que contém o par de chaves.The name of the container or file that contains the key pair. O Vinculador de Assembly interpreta um caminho relativo em relação ao diretório atual.Assembly Linker interprets a relative path in relationship to the current directory.

O exemplo a seguir assina o assembly MyAssembly.dll com um nome forte usando o arquivo de chave sgKey.snk.The following example signs the assembly MyAssembly.dll with a strong name by using the key file sgKey.snk.

al /out:MyAssembly.dll MyModule.netmodule /keyfile:sgKey.snk  

Para saber mais sobre essa ferramenta, veja Vinculador de Assembly.For more information about this tool, see Assembly Linker.

Para assinar um assembly com um nome forte usando atributosTo sign an assembly with a strong name by using attributes

  1. Adicione o atributo System.Reflection.AssemblyKeyFileAttribute ou AssemblyKeyNameAttribute ao seu arquivo de código-fonte e especifique o nome do arquivo ou contêiner que contém o par de chaves a ser usado ao assinar o assembly com um nome forte.Add the System.Reflection.AssemblyKeyFileAttribute or AssemblyKeyNameAttribute attribute to your source code file, and specify the name of the file or container that contains the key pair to use when signing the assembly with a strong name.

  2. Compile o arquivo de código-fonte normalmente.Compile the source code file normally.

Observação

Os compiladores de C# e Visual Basic emitem avisos do compilador (CS1699 e BC41008, respectivamente) quando encontram o atributo AssemblyKeyFileAttribute ou AssemblyKeyNameAttribute no código-fonte.The C# and Visual Basic compilers issue compiler warnings (CS1699 and BC41008, respectively) when they encounter the AssemblyKeyFileAttribute or AssemblyKeyNameAttribute attribute in source code. Você pode ignorar os avisos.You can ignore the warnings.

O exemplo de código a seguir usa o atributo AssemblyKeyFileAttribute com um arquivo de chave chamado keyfile.snk, localizado no diretório onde o assembly é compilado.The following example uses the AssemblyKeyFileAttribute attribute with a key file called keyfile.snk, which is located in the directory where the assembly is compiled.

[assembly:AssemblyKeyFileAttribute("keyfile.snk")];
[assembly:AssemblyKeyFileAttribute("keyfile.snk")]
<Assembly:AssemblyKeyFileAttribute("keyfile.snk")>

Você também pode atrasar a assinatura de um assembly ao compilar seu arquivo de código-fonte.You can also delay sign an assembly when compiling your source file. Para obter mais informações, consulte Assinando um assembly com atraso.For more information, see Delay Signing an Assembly.

Para assinar um assembly com um nome forte usando o compiladorTo sign an assembly with a strong name by using the compiler

  • Compile seu arquivo ou arquivos de código-fonte com a opção de compilador /keyfile ou /delaysign no C# e em Visual Basic, ou a opção de vinculador /KEYFILE ou /DELAYSIGN em C++.Compile your source code file or files with the /keyfile or /delaysign compiler option in C# and Visual Basic, or the /KEYFILE or /DELAYSIGN linker option in C++. Depois do nome da opção, adicione um dois-pontos e o nome do arquivo da chave.After the option name, add a colon and the name of the key file. Ao usar compiladores de linha de comando, você pode copiar o arquivo de chave para o diretório que contém seus arquivos de código-fonte.When using command-line compilers, you can copy the key file to the directory that contains your source code files.

    Para saber mais sobre assinatura com atraso, veja Assinar um assembly com atraso.For information on delay signing, see Delay Signing an Assembly.

    O exemplo a seguir usa o compilador C# e assina o assembly UtilityLibrary.dll com um nome forte usando o arquivo de chave sgKey.snk.The following example uses the C# compiler and signs the assembly UtilityLibrary.dll with a strong name by using the key file sgKey.snk.

    csc /t:library UtilityLibrary.cs /keyfile:sgKey.snk  
    

Consulte tambémSee also