RegistryKey.DeleteValue 方法

  • 參考

定義

命名空間:
Microsoft.Win32
組件:
Microsoft.Win32.Registry.dll
組件:
mscorlib.dll

刪除此機碼中的指定值，並且在找不到值時擲回例外狀況。

多載

DeleteValue(String)

從這個機碼中刪除指定值。
DeleteValue(String, Boolean)

刪除此機碼的指定值，並且指定找不到該值時是否引發例外狀況。

DeleteValue(String)

來源:
RegistryKey.cs

從這個機碼中刪除指定值。

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

參數

name
String

要刪除的值的名稱。

例外狀況

ArgumentException

name 不是值的有效參考。

SecurityException

使用者沒有刪除值所需的使用權限。

ObjectDisposedException

正接受管理的 RegistryKey 已經關閉 (關閉的機碼無法存取)。

UnauthorizedAccessException

管理中的 RegistryKey 是唯讀的。

範例

此程式代碼範例是提供給 類別之較大範例的 RegistryKey 一部分。

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

另請參閱

適用於

DeleteValue(String, Boolean)

來源:
RegistryKey.cs

刪除此機碼的指定值，並且指定找不到該值時是否引發例外狀況。

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)

參數

name
String

要刪除的值的名稱。

throwOnMissingValue
Boolean

表示如果找不到指定的值時，是否引發例外狀況。 如果這個引數為 true，而指定的值不存在時，則會引發例外狀況。 如果這個引數為 false，而指定的值不存在時，則不採取任何動作。

例外狀況

ArgumentException

name 不是值的有效參考，而且 throwOnMissingValue 為 true。

-或-

name 為 null。

SecurityException

使用者沒有刪除值所需的使用權限。

ObjectDisposedException

正接受管理的 RegistryKey 已經關閉 (關閉的機碼無法存取)。

UnauthorizedAccessException

管理中的 RegistryKey 是唯讀的。

備註

如果 throwOnMissingValue 為 false，則無法判斷刪除是否成功，而不需要後續嘗試存取剛刪除的值。 因此，以這種方式從登錄中刪除值時，請小心。

另請參閱

適用於