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 -> unitPublic 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 -> unitPublic Sub DeleteValue (name As String, throwOnMissingValue As Boolean)Параметры
- name
- String
Имя удаляемого значения.
- throwOnMissingValue
- Boolean
Показывает, должно ли вызываться исключение, если заданное значение найти невозможно. Если этот аргумент равен true, а заданное значение не существует, создается исключение. Если этот аргумент равен false, а заданное значение не существует, никакие действия не предпринимаются.
Исключения
Значение name не является допустимой ссылкой на значение и throwOnMissingValue равно true.
-или-
name имеет значение null.
У пользователя отсутствуют разрешения, необходимые для удаления значения.
Объект RegistryKey, с которым выполняются действия, закрыт (доступ к закрытым разделам отсутствует).
Объект RegistryKey доступен только для чтения.
Комментарии
Если throwOnMissingValue имеет значение false, невозможно определить, было ли удаление успешным, без последующей попытки получить доступ к только что удаленному значению. Поэтому следует соблюдать осторожность при удалении значений из реестра таким образом.
