Поделиться через


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 не является допустимой ссылкой на значение и throwOnMissingValue равно true.

-или-

name имеет значение null.

У пользователя отсутствуют разрешения, необходимые для удаления значения.

Объект RegistryKey, с которым выполняются действия, закрыт (доступ к закрытым разделам отсутствует).

Объект RegistryKey доступен только для чтения.

Комментарии

Если throwOnMissingValue имеет значение false, невозможно определить, было ли удаление успешным, без последующей попытки получить доступ к только что удаленному значению. Поэтому следует соблюдать осторожность при удалении значений из реестра таким образом.

См. также раздел

Применяется к