Classe RegistryKey

Per ottenere un'istanza dell'oggetto RegistryKey, utilizzare uno dei membri statici della classe Registry.

Il Registro di sistema agisce da repository centrale delle informazioni del sistema operativo e delle applicazioni presenti su un computer. È organizzato secondo un formato gerarchico, basato su un ordinamento logico degli elementi contenuti (per gli elementi a livello di base di questa gerarchia, vedere Registry). Al momento dell'archiviazione delle informazioni nel Registro di sistema, selezionare il percorso appropriato in base al tipo di informazioni da archiviare. Assicurarsi di non eliminare le informazioni create da altre applicazioni per non causare comportamenti imprevisti da parte delle stesse e per non influire negativamente sulla propria.

Nel Registro di sistema le chiavi costituiscono le unità base dell'organizzazione e per questo motivo possono essere paragonate alle cartelle di Esplora risorse. Una chiave può contenere sottochiavi, esattamente come una cartella può contenere sottocartelle. Ogni chiave può essere eliminata, purché si disponga delle autorizzazioni appropriate e la chiave non sia una chiave di base o non si trovi al livello direttamente inferiore alle chiavi di base. A ogni chiave possono essere associati più valori (un valore può essere paragonato a un file) che vengono utilizzati per archiviare le informazioni, ad esempio le informazioni su un'applicazione installata sul computer. Ogni valore contiene una particolare informazione che potrà essere recuperata o aggiornata al momento necessario. Ad esempio, è possibile creare un oggetto RegistryKey per la propria società nella chiave HKEY_LOCAL_MACHINE\Software e una sottochiave per ogni applicazione creata dalla società. In ogni sottochiave sono contenute le informazioni specifiche di quell'applicazione, ad esempio impostazioni dei colori, dimensioni e posizione sullo schermo delle finestre o estensioni file riconosciute.

Si noti che le informazioni archiviate nel Registro di sistema possono essere lette da altre applicazioni e da altri utenti, pertanto non devono essere utilizzate per archiviare dati di sicurezza o informazioni critiche sull'applicazione.

Attenzione
Non esporre oggetti RegistryKey per evitare che un programma dannoso crei migliaia di sottochiavi o coppie chiave/valore non significative. Ad esempio, non consentire ai chiamanti di immettere valori o chiavi arbitrarie.

A partire da .NET Framework versione 4, la lunghezza di una chiave del Registro di sistema non è più limitata a 255 caratteri.

Nell'esempio di codice riportato di seguito viene illustrato come creare una sottochiave in HKEY_CURRENT_USER, come modificarne il contenuto e come eliminarla.

using System;
using System.Security.Permissions;
using Microsoft.Win32;

class RegKey
{
    static void Main()
    {
        // Create a subkey named Test9999 under HKEY_CURRENT_USER.
        RegistryKey test9999 = 
            Registry.CurrentUser.CreateSubKey("Test9999");
        // Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        // keys are disposed when execution exits the using statement.
        using(RegistryKey 
            testName = test9999.CreateSubKey("TestName"),
            testSettings = test9999.CreateSubKey("TestSettings"))
        {
            // Create data for the TestSettings subkey.
            testSettings.SetValue("Language", "French");
            testSettings.SetValue("Level", "Intermediate");
            testSettings.SetValue("ID", 123);
        }

        // Print the information from the Test9999 subkey.
        Console.WriteLine("There are {0} subkeys under {1}.", 
            test9999.SubKeyCount.ToString(), test9999.Name);
        foreach(string subKeyName in test9999.GetSubKeyNames())
        {
            using(RegistryKey 
                tempKey = test9999.OpenSubKey(subKeyName))
            {
                Console.WriteLine("\nThere are {0} values for {1}.", 
                    tempKey.ValueCount.ToString(), tempKey.Name);
                foreach(string valueName in tempKey.GetValueNames())
                {
                    Console.WriteLine("{0,-8}: {1}", valueName, 
                        tempKey.GetValue(valueName).ToString());
                }
            }
        }

        using(RegistryKey 
            testSettings = test9999.OpenSubKey("TestSettings", true))
        {
            // Delete the ID value.
            testSettings.DeleteValue("id");

            // Verify the deletion.
            Console.WriteLine((string)testSettings.GetValue(
                "id", "ID not found."));
        }

        // Delete or close the new subkey.
        Console.Write("\nDelete newly created registry key? (Y/N) ");
        if(Char.ToUpper(Convert.ToChar(Console.Read())) == 'Y')
        {
            Registry.CurrentUser.DeleteSubKeyTree("Test9999");
            Console.WriteLine("\nRegistry key {0} deleted.", 
                test9999.Name);
        }
        else
        {
            Console.WriteLine("\nRegistry key {0} closed.", 
                test9999.ToString());
            test9999.Close();
        }
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o versione successiva, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (componenti di base del server non supportati), Windows Server 2008 R2 (componenti di base del server supportati con SP1 o versione successiva), Windows Server 2003 SP2

Riferimenti