次の方法で共有


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