RegistryKey.DeleteValue Metoda

  • Reference

Definice

Obor názvů:
Microsoft.Win32
Sestavení:
Microsoft.Win32.Registry.dll
Sestavení:
mscorlib.dll

Odstraní zadanou hodnotu z tohoto klíče a vyvolá výjimku, pokud se hodnota nenajde.

Přetížení

DeleteValue(String)

Odstraní zadanou hodnotu z tohoto klíče.
DeleteValue(String, Boolean)

Odstraní zadanou hodnotu z tohoto klíče a určuje, jestli je vyvolána výjimka, pokud se hodnota nenajde.

DeleteValue(String)

Zdroj:
RegistryKey.cs

Odstraní zadanou hodnotu z tohoto klíče.

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

Parametry

name
String

Název hodnoty, která se má odstranit.

Výjimky

ArgumentException

name není platný odkaz na hodnotu.

SecurityException

Uživatel nemá oprávnění potřebná k odstranění hodnoty.

ObjectDisposedException

Manipulovaný RegistryKey objekt je zavřený (nelze získat přístup k uzavřeným klíčům).

UnauthorizedAccessException

Manipulované RegistryKey je jen pro čtení.

Příklady

Tento příklad kódu je součástí většího příkladu RegistryKey pro třídu .

// 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()

Viz také

Platí pro

DeleteValue(String, Boolean)

Zdroj:
RegistryKey.cs

Odstraní zadanou hodnotu z tohoto klíče a určuje, jestli je vyvolána výjimka, pokud se hodnota nenajde.

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)

Parametry

name
String

Název hodnoty, která se má odstranit.

throwOnMissingValue
Boolean

Určuje, zda má být vyvolána výjimka, pokud zadaná hodnota nebyla nalezena. Pokud je true tento argument a zadaná hodnota neexistuje, je vyvolána výjimka. Pokud je false tento argument a zadaná hodnota neexistuje, neprovede se žádná akce.

Výjimky

ArgumentException

name není platný odkaz na hodnotu a throwOnMissingValue je true.

-nebo-

name je null.

SecurityException

Uživatel nemá oprávnění potřebná k odstranění hodnoty.

ObjectDisposedException

Manipulovaný RegistryKey objekt je zavřený (nelze získat přístup k uzavřeným klíčům).

UnauthorizedAccessException

Manipulované RegistryKey je jen pro čtení.

Poznámky

Pokud throwOnMissingValue je false, neexistuje žádný způsob, jak zjistit, jestli bylo odstranění úspěšné, aniž byste se následně pokusili získat přístup k právě odstraněné hodnotě. Proto při odstraňování hodnot z registru tímto způsobem buďte opatrní.

Viz také

Platí pro