RegistryKey.DeleteValue メソッド (String, Boolean)
指定した値をこのキーから削除します。
Overloads Public Sub DeleteValue( _
ByVal name As String, _ ByVal throwOnMissingValue As Boolean _)
[C#]
public void DeleteValue(stringname,boolthrowOnMissingValue);
[C++]
public: void DeleteValue(String* name,boolthrowOnMissingValue);
[JScript]
public function DeleteValue(
name : String,throwOnMissingValue : Boolean);
パラメータ
- name
削除する値の名前。 - throwOnMissingValue
指定した値が見つからない場合に例外を発生させるかどうかを示します。この引数が true であり、指定した値が見つからない場合は、例外が発生します。この引数が false であり、指定した値が見つからない場合は、何も実行されません。
例外
例外の種類 | 条件 |
---|---|
ArgumentException | name が有効な値参照ではなく、throwOnMissingValue が true であるか、または name が null 参照 (Visual Basic では Nothing) です。 |
SecurityException | このユーザーには、RegistryPermission.SetInclude(delete, currentKey) アクセス許可がありません。 |
ObjectDisposedException | 操作対象の RegistryKey が閉じています。閉じられたキーにはアクセスできません。 |
UnauthorizedAccessException | 操作しようとした RegistryKey が読み取り専用です。 |
解説
throwOnMissingValue が false の場合、削除直後にこの値へ実際にアクセスする方法以外に、値が削除されていることを確認できません。この方法でレジストリから値を削除する場合には十分注意してください。
必要条件
プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ
.NET Framework セキュリティ:
- RegistryPermission (指定したレジストリ キーを削除するために必要なアクセス許可) Write (関連する列挙体)
参照
RegistryKey クラス | RegistryKey メンバ | Microsoft.Win32 名前空間 | RegistryKey.DeleteValue オーバーロードの一覧 | DeleteSubKey | OpenSubKey | GetValue | GetValueNames | ValueCount