共用方式為


RegistryKey.DeleteValue 方法

定義

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

多載

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

要刪除的值的名稱。

例外狀況

name 不是值的有效參考。

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

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

管理中的 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,而指定的值不存在時,則不採取任何動作。

例外狀況

name 不是值的有效參考,而且 throwOnMissingValuetrue

-或-

namenull

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

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

管理中的 RegistryKey 是唯讀的。

備註

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

另請參閱

適用於