RegistryKey.DeleteValue 方法

  • 参考

定义

命名空间:
Microsoft.Win32
程序集:
Microsoft.Win32.Registry.dll
程序集:
mscorlib.dll

从此项中删除指定的值，并在找不到该值时引发异常。

重载

DeleteValue(String)

从此项中删除指定值。
DeleteValue(String, Boolean)

从此项中删除指定的值，并指定在找不到该值时是否引发异常。

DeleteValue(String)

Source:
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)

Source:
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，则无法判断删除是否成功，随后不尝试访问刚刚删除的值。 因此，以这种方式从注册表中删除值时要小心。

另请参阅

适用于