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