RegistryKey.OpenSubKey メソッド (String, Boolean)

指定したサブキーを取得します。

Overloads Public Function OpenSubKey( _
   ByVal name As String, _   ByVal writable As Boolean _) As RegistryKey
[C#]
public RegistryKey OpenSubKey(stringname,boolwritable);
[C++]
public: RegistryKey* OpenSubKey(String* name,boolwritable);
[JScript]
public function OpenSubKey(
   name : String,writable : Boolean) : RegistryKey;

パラメータ

• name
  開くサブキーの名前またはパス。
• writable
  キーへの書き込みアクセスが必要な場合には true に設定してください。

戻り値

要求されたサブキー。操作が失敗した場合は null。

例外

例外の種類	条件
ArgumentNullException	name が null です。
ArgumentException	指定したサブキーの長さが、許容される最大値 (255 文字) を超えています。
ObjectDisposedException	削除対象の RegistryKey が閉じています。閉じられたキーにはアクセスできません。
SecurityException	このユーザーには、RegistryPermission.SetInclude(delete, currentKey) アクセス許可がありません。

解説

要求されたキーが存在しない場合、例外はスローされず、null 値が返されます。

writable が true の場合、キーは読み書きできる状態で開かれます。それ以外の場合、キーは読み取り専用で開かれます。

使用例

[Visual Basic, C#, C++] 次のコード例は RegistryKey クラスの例の一部です。

 
' Delete the non-secure password value.
testSettings = test9999.OpenSubKey("TestSettings", True)
testSettings.DeleteValue("password")

' Verify the deletion.
Console.WriteLine(CType(testSettings.GetValue( _
    "password", "Password not found."), String))
testSettings.Close()

[C#] 
using(RegistryKey 
    testSettings = test9999.OpenSubKey("TestSettings", true))
{
    // Delete the non-secure password value.
    testSettings.DeleteValue("password");

    // Verify the deletion.
    Console.WriteLine((string)testSettings.GetValue(
        "password", "Password not found."));
}

[C++] 
// Delete the non-secure password value.
testSettings = test9999->OpenSubKey(S"TestSettings", true);
testSettings->DeleteValue(S"password");

// Verify the deletion.
Console::WriteLine(dynamic_cast<String*>(
    testSettings->GetValue("password", S"Password not found.")));
testSettings->Close();

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

.NET Framework セキュリティ:

• RegistryPermission (指定したレジストリ キーを読み取るために必要なアクセス許可) Read (関連する列挙体)
• SecurityPermission (指定したレジストリ キーがリモート キーである場合にアンマネージ コードにアクセスするために必要なアクセス許可) UnmanagedCode (関連する列挙体)

参照

RegistryKey クラス | RegistryKey メンバ | Microsoft.Win32 名前空間 | RegistryKey.OpenSubKey オーバーロードの一覧 | CreateSubKey | DeleteSubKey | DeleteSubKeyTree | GetSubKeyNames | OpenRemoteBaseKey | SubKeyCount | Registry