Procedura: Firmare un assembly con un nome sicuroHow to: Sign an Assembly with a Strong Name

Sono disponibili diversi modi per firmare un assembly con un nome sicuro:There are a number of ways to sign an assembly with a strong name:

  • Utilizzando la scheda di Firma nella finestra di dialogo Proprietà di un progetto in Visual Studio.By using the Signing tab in a project's Properties dialog box in Visual Studio. Questo è il modo più semplice e più pratico per firmare un assembly con un nome sicuro.This is the easiest and most convenient way to sign an assembly with a strong name.

  • Usando Assembly Linker (Al.exe) per collegare un modulo di codice di .NET Framework (un file con estensione netmodule) con un file di chiave.By using the Assembly Linker (Al.exe) to link a .NET Framework code module (a .netmodule file) with a key file.

  • Utilizzando attributi dell'assembly per inserire le informazioni relative al nome sicuro nel codice.By using assembly attributes to insert the strong name information into your code. È possibile utilizzare l'attributo AssemblyKeyFileAttribute o AssemblyKeyNameAttribute , a seconda della posizione del file di chiave da utilizzare.You can use either the AssemblyKeyFileAttribute or the AssemblyKeyNameAttribute attribute, depending on where the key file to be used is located.

  • Utilizzando le opzioni del compilatore.By using compiler options.

Per firmare un assembly con un nome sicuro, è necessario disporre di una coppia di chiavi crittografiche.You must have a cryptographic key pair to sign an assembly with a strong name. Per altre informazioni sulla creazione di una coppia di chiavi, vedere Procedura: Creare una coppia di chiavi pubblica/privata.For more information about creating a key pair, see How to: Create a Public-Private Key Pair.

Per creare e firmare un assembly con un nome sicuro utilizzando Visual StudioTo create and sign an assembly with a strong name by using Visual Studio

  1. In Esplora soluzioniaprire il menu di scelta rapida per il progetto, quindi scegliere Proprietà.In Solution Explorer, open the shortcut menu for the project, and then choose Properties.

  2. Scegliere la scheda Firma .Choose the Signing tab.

  3. Selezionare la casella Firma assembly .Select the Sign the assembly box.

  4. Nella casella Scegli un file chiave con nome sicuro scegliere <Sfoglia>, quindi passare al file di chiave.In the Choose a strong name key file box, choose <Browse…>, and then navigate to the key file. Per creare un nuovo file di chiave, scegliere <Nuovo> e immettere il nome nella finestra di dialogo Crea chiave con nome sicuro.To create a new key file, choose <New…> and enter its name in the Create Strong Name Key dialog box.

Nota

Per ritardare la firma di un assembly, scegliere un file di chiave pubblica.In order to delay sign an assembly, choose a public key file.

Per creare e firmare un assembly con un nome sicuro utilizzando Assembly LinkerTo create and sign an assembly with a strong name by using the Assembly Linker

  • Al prompt dei comandi per gli sviluppatori per Visual Studio, digitare il comando seguente:At the Developer Command Prompt for Visual Studio, type the following command:

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

    dove:where:

    assemblyNameassemblyName
    Nome sicuro di assembly con firma (file .dll o .exe) che verrà generato da Assembly Linker.The name of the strongly signed assembly (a .dll or .exe file) that Assembly Linker will emit.

    moduleNamemoduleName
    Nome di un modulo di codice di .NET Framework (file con estensione netmodule) che include uno o più tipi.The name of a .NET Framework code module (a .netmodule file) that includes one or more types. È possibile creare un file .netmodule durante la compilazione del codice con l'opzione /target:module in C# o Visual Basic.You can create a .netmodule file by compiling your code with the /target:module switch in C# or Visual Basic.

    keyfileNamekeyfileName
    Nome del contenitore o del file che contiene la coppia di chiavi.The name of the container or file that contains the key pair. Assembly Linker interpreta un percorso relativo in relazione alla directory corrente.Assembly Linker interprets a relative path in relationship to the current directory.

L'esempio seguente consente di firmare l'assembly MyAssembly.dll con un nome sicuro utilizzando il file di chiave 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  

Per ulteriori informazioni sull'utilizzo di questo strumento, vedere Assembly Linker.For more information about this tool, see Assembly Linker.

Per firmare un assembly con un nome sicuro utilizzando attributiTo sign an assembly with a strong name by using attributes

  1. Aggiungere l'attributo System.Reflection.AssemblyKeyFileAttribute o AssemblyKeyNameAttribute al file del codice sorgente, specificando il nome del file o del contenitore contenente la coppia di chiavi da utilizzare per la firma dell'assembly con un nome sicuro.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. Compilare normalmente il file del codice sorgente.Compile the source code file normally.

Nota

Nei compilatori C# e Visual Basic vengono pubblicati avvisi del compilatore (rispettivamente CS1699 e BC41008) quando viene rilevato l'attributo AssemblyKeyFileAttribute o AssemblyKeyNameAttribute nel codice sorgente.The C# and Visual Basic compilers issue compiler warnings (CS1699 and BC41008, respectively) when they encounter the AssemblyKeyFileAttribute or AssemblyKeyNameAttribute attribute in source code. È possibile ignorare gli avvisi.You can ignore the warnings.

Nell'esempio di codice riportato di seguito viene utilizzato l'attributo AssemblyKeyFileAttribute con un file di chiave denominato keyfile.snk, che si trova nella directory in cui viene compilato l'assembly.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")>

È inoltre possibile ritardare la firma di un assembly durante la compilazione del file del codice sorgente.You can also delay sign an assembly when compiling your source file. Per ulteriori informazioni, vedere Ritardo della firma di un assembly.For more information, see Delay Signing an Assembly.

Per firmare un assembly con un nome sicuro utilizzando il compilatoreTo sign an assembly with a strong name by using the compiler

  • Compilare il file o i file del codice sorgente con l'opzione del compilatore /keyfile o /delaysign in C# e Visual Basic o con l'opzione del linker /KEYFILE o /DELAYSIGN in 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++. Dopo il nome di opzione, aggiungere due punti e il nome del file di chiave.After the option name, add a colon and the name of the key file. Se si utilizzano compilatori della riga di comando, è possibile copiare il file di chiave nella directory contenente i file del codice sorgente.When using command-line compilers, you can copy the key file to the directory that contains your source code files.

    Per informazioni sulla firma ritardata, vedere Delay Signing an Assembly.For information on delay signing, see Delay Signing an Assembly.

    Nell'esempio riportato di seguito viene utilizzato il compilatore C# e viene firmato l'assembly UtilityLibrary.dll con un nome sicuro, utilizzando il file di chiave 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  
    

Vedere ancheSee also