RegistryKey.DeleteValue Metod

Definition

Namnområde:
Microsoft.Win32
Sammansättning:
mscorlib.dll

Tar bort det angivna värdet från den här nyckeln och utlöser ett undantag om värdet inte hittas.

Överlagringar

Name Description
DeleteValue(String)

Tar bort det angivna värdet från den här nyckeln.
DeleteValue(String, Boolean)

Tar bort det angivna värdet från den här nyckeln och anger om ett undantag utlöses om värdet inte hittas.

DeleteValue(String)

Tar bort det angivna värdet från den här nyckeln.

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

Parametrar

name
String

Namnet på det värde som ska tas bort.

Undantag

ArgumentException

name är inte en giltig referens till ett värde.

SecurityException

Användaren har inte de behörigheter som krävs för att ta bort värdet.

ObjectDisposedException

Den RegistryKey som manipuleras stängs (stängda nycklar kan inte nås).

UnauthorizedAccessException

Den RegistryKey som manipuleras är skrivskyddad.

Exempel

Det här kodexemplet är en del av ett större exempel för RegistryKey klassen.

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

Se även

Gäller för

DeleteValue(String, Boolean)

Tar bort det angivna värdet från den här nyckeln och anger om ett undantag utlöses om värdet inte hittas.

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)

Parametrar

name
String

Namnet på det värde som ska tas bort.

throwOnMissingValue
Boolean

Anger om ett undantag ska utlöses om det angivna värdet inte kan hittas. Om det här argumentet är true och det angivna värdet inte finns utlöses ett undantag. Om det här argumentet är false och det angivna värdet inte finns, vidtas ingen åtgärd.

Undantag

ArgumentException

name är inte en giltig referens till ett värde och throwOnMissingValue är true.

-eller-

name är null.

SecurityException

Användaren har inte de behörigheter som krävs för att ta bort värdet.

ObjectDisposedException

Den RegistryKey som manipuleras stängs (stängda nycklar kan inte nås).

UnauthorizedAccessException

Den RegistryKey som manipuleras är skrivskyddad.

Kommentarer

Om throwOnMissingValue är falsefinns det inget sätt att avgöra om borttagningen lyckades, utan att senare försöka komma åt det värde som just har tagits bort. Var därför försiktig när du tar bort värden från registret på det här sättet.

Se även

Gäller för