RegistryKey.DeleteValue Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.Win32
Assembly:
Microsoft.Win32.Registry.dll
Assembly:
mscorlib.dll

Elimina il valore specificato da questa chiave e genera un'eccezione se il valore non viene trovato.

Overload

DeleteValue(String)

Elimina il valore specificato dalla chiave.
DeleteValue(String, Boolean)

Elimina il valore specificato da questa chiave e specifica se generare un'eccezione se il valore non viene trovato.

DeleteValue(String)

Source:
RegistryKey.cs

Elimina il valore specificato dalla chiave.

public:
 void DeleteValue(System::String ^ name);
public void DeleteValue (string name);
member this.DeleteValue : string -> unit
Public Sub DeleteValue (name As String)

Parametri

name
String

Nome del valore da eliminare.

Eccezioni

ArgumentException

name non è un riferimento valido a un valore.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eliminare il valore.

ObjectDisposedException

La chiave RegistryKey da modificare è chiusa, pertanto non è possibile accedere ad essa.

UnauthorizedAccessException

L'oggetto RegistryKey modificato è in sola lettura.

Esempio

Questo esempio di codice fa parte di un esempio più grande fornito per la RegistryKey classe.

// Delete the ID value.
testSettings = test9999->OpenSubKey( "TestSettings", true );
testSettings->DeleteValue( "id" );

// Verify the deletion.
Console::WriteLine( dynamic_cast<String^>(testSettings->GetValue(  "id", "ID not found." )) );
testSettings->Close();

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 the ID value.
testSettings = test9999.OpenSubKey("TestSettings", True)
testSettings.DeleteValue("id")

' Verify the deletion.
Console.WriteLine(CType(testSettings.GetValue( _
    "id", "ID not found."), String))
testSettings.Close()

Vedi anche

Si applica a

DeleteValue(String, Boolean)

Source:
RegistryKey.cs

Elimina il valore specificato da questa chiave e specifica se generare un'eccezione se il valore non viene trovato.

public:
 void DeleteValue(System::String ^ name, bool throwOnMissingValue);
public void DeleteValue (string name, bool throwOnMissingValue);
member this.DeleteValue : string * bool -> unit
Public Sub DeleteValue (name As String, throwOnMissingValue As Boolean)

Parametri

name
String

Nome del valore da eliminare.

throwOnMissingValue
Boolean

Indica se deve essere generata un'eccezione qualora non venisse trovato il valore specificato. Se questo argomento è true e il valore specificato non esiste, viene generata un'eccezione. Se l'argomento è false e il valore specificato non esiste, non viene eseguita alcuna azione.

Eccezioni

ArgumentException

name non è un riferimento valido a un valore e throwOnMissingValue è true.

-oppure-

name è null.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per eliminare il valore.

ObjectDisposedException

La chiave RegistryKey da modificare è chiusa, pertanto non è possibile accedere ad essa.

UnauthorizedAccessException

L'oggetto RegistryKey modificato è in sola lettura.

Commenti

Se throwOnMissingValue è false, non è possibile stabilire se l'eliminazione è riuscita, senza successivamente tentare di accedere al valore appena eliminato. Pertanto, prestare attenzione quando si eliminano i valori dal Registro di sistema in questo modo.

Vedi anche

Si applica a