RegistryKey.DeleteValue 方法

定义

命名空间:: Microsoft.Win32

程序集:: Microsoft.Win32.Registry.dll

程序集:: mscorlib.dll

包:: Microsoft.Win32.Registry v5.0.0

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

从此键中删除指定的值，如果未找到该值，则会引发异常。

重载

名称	说明
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 不是对值的有效引用，是 throwOnMissingValuetrue。

-或-

name 是 null。