RegistryKey.DeleteSubKey メソッド (String, Boolean)
指定したサブキーを削除します。文字列サブキーでは大文字と小文字が区別されません。
Overloads Public Sub DeleteSubKey( _
ByVal subkey As String, _ ByVal throwOnMissingSubKey As Boolean _)
[C#]
public void DeleteSubKey(stringsubkey,boolthrowOnMissingSubKey);
[C++]
public: void DeleteSubKey(String* subkey,boolthrowOnMissingSubKey);
[JScript]
public function DeleteSubKey(
subkey : String,throwOnMissingSubKey : Boolean);
パラメータ
- subkey
削除するサブキーの名前。 - throwOnMissingSubKey
指定したサブキーが見つからない場合に例外を発生させるかどうかを示します。この引数が true であり、指定したサブキーが見つからない場合は、例外が発生します。この引数が false であり、指定したサブキーが見つからない場合は、何も実行されません。
例外
例外の種類 | 条件 |
---|---|
InvalidOperationException | サブキーに子サブキーがあります。 |
ArgumentException | 指定したサブキーは、レジストリ キーへの有効な参照ではありません。throwOnMissingSubKey が true です。 |
ArgumentNullException | サブキーが null 参照 (Visual Basic では Nothing) です。 |
SecurityException | このユーザーには、RegistryPermission.SetInclude(delete, currentKey) アクセス許可がありません。 |
解説
Windows 98/ME と Windows 2000 でこの関数の動作が同じである必要があるため、子サブキーの明示的なチェックを実行してください。Windows 98/ME では子サブキーの明示的なチェックは有効です。
子サブキーを削除するには、 DeleteSubKeyTree を使用します。
RegistryKey を削除する場合には十分注意してください。
使用例
必要条件
プラットフォーム: 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 (関連する列挙体)
- SecurityPermission (指定したレジストリ キーがリモート キーである場合にアンマネージ コードにアクセスするために必要なアクセス許可) UnmanagedCode (関連する列挙体)
参照
RegistryKey クラス | RegistryKey メンバ | Microsoft.Win32 名前空間 | RegistryKey.DeleteSubKey オーバーロードの一覧 | DeleteSubKeyTree | CreateSubKey | DeleteValue | GetSubKeyNames