RegistryKey.DeleteValue Метод

Определение

Пространство имен:

Microsoft.Win32

Сборка:

Microsoft.Win32.Registry.dll

Удаляет указанное значение из данного раздела и создает исключение, если значение не найдено.

Перегрузки

DeleteValue(String)	Удаляет заданное значение из этого раздела.
DeleteValue(String, Boolean)	Удаляет указанное значение из данного раздела и определяет, нужно ли создавать исключение, если значение на найдено.

DeleteValue(String)

Удаляет заданное значение из этого раздела.

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

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

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)
• GetValue(String)
• GetValueNames()
• ValueCount

DeleteValue(String, Boolean)

Удаляет указанное значение из данного раздела и определяет, нужно ли создавать исключение, если значение на найдено.

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, невозможно определить, было ли удаление успешным, без последующей попытки получить доступ к только что удаленному значению. Поэтому следует соблюдать осторожность при удалении значений из реестра таким образом.

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

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)
• GetValue(String)
• GetValueNames()
• ValueCount