RegistryKey.OpenSubKey 메서드

정의

네임스페이스:

Microsoft.Win32

어셈블리:

Microsoft.Win32.Registry.dll

지정된 하위 키를 검색합니다.

오버로드

OpenSubKey(String, Boolean)	지정된 하위 키를 검색하고 키에 쓰기 액세스를 적용할지 여부를 지정합니다.
OpenSubKey(String, RegistryKeyPermissionCheck, RegistryRights)	지정된 액세스 권한을 요청하여 읽기 또는 읽기/쓰기 권한으로 지정된 하위 키를 검색합니다.
OpenSubKey(String, RegistryRights)	지정된 이름 및 액세스 권한으로 하위 키를 검색합니다. .NET Framework 4.6부터 사용할 수 있습니다.
OpenSubKey(String)	하위 키를 읽기 전용으로 검색합니다.
OpenSubKey(String, RegistryKeyPermissionCheck)	읽기 또는 읽기/쓰기 권한으로 지정된 하위 키를 검색합니다.

OpenSubKey(String, Boolean)

지정된 하위 키를 검색하고 키에 쓰기 액세스를 적용할지 여부를 지정합니다.

public:
 Microsoft::Win32::RegistryKey ^ OpenSubKey(System::String ^ name, bool writable);

public Microsoft.Win32.RegistryKey? OpenSubKey (string name, bool writable);

member this.OpenSubKey : string * bool -> Microsoft.Win32.RegistryKey

Public Function OpenSubKey (name As String, writable As Boolean) As RegistryKey

매개 변수

name

String

열려는 하위 키의 이름 또는 경로입니다.

writable

Boolean

키에 대한 쓰기 권한이 필요하면 true로 설정합니다.

반환

RegistryKey

요청된 하위 키이거나, 작업에 실패하면 null입니다.

예외

ArgumentNullException

name이(가) null인 경우

ObjectDisposedException

RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

SecurityException

사용자에게 지정된 모드에서 레지스트리 키에 액세스하는 데 필요한 권한이 없는 경우

예제

다음 코드 예제에서는 테스트 키를 만들고 메서드를 OpenSubKey 사용하여 메서드의 오버로드를 모두 보여 줍니다.

#using <Microsoft.VisualBasic.dll>

using namespace System;
using namespace Microsoft::Win32;
using namespace Microsoft::VisualBasic;

int main()
{
    // Delete and recreate the test key.
    Registry::CurrentUser->DeleteSubKey( L"RegistryOpenSubKeyExample", false );
    RegistryKey ^ rk = Registry::CurrentUser->CreateSubKey( L"RegistryOpenSubKeyExample" );
    rk->Close();

    // Obtain an instance of RegistryKey for the CurrentUser registry
    // root.
    RegistryKey ^ rkCurrentUser = Registry::CurrentUser;

    // Obtain the test key (read-only) and display it.
    RegistryKey ^ rkTest = rkCurrentUser->OpenSubKey( L"RegistryOpenSubKeyExample" );
    Console::WriteLine( L"Test key: {0}", rkTest );
    rkTest->Close();
    rkCurrentUser->Close();

    // Obtain the test key in one step, using the CurrentUser registry
    // root.
    rkTest = Registry::CurrentUser->OpenSubKey( L"RegistryOpenSubKeyExample" );
    Console::WriteLine( L"Test key: {0}", rkTest );
    rkTest->Close();

    // Open the test key in read/write mode.
    rkTest = Registry::CurrentUser->OpenSubKey( L"RegistryOpenSubKeyExample", true );
    rkTest->SetValue( L"TestName", L"TestValue" );
    Console::WriteLine( L"Test value for TestName: {0}", rkTest->GetValue( L"TestName" ) );
    rkTest->Close();

    return 0;
} //Main

using System;
using Microsoft.Win32;
using Microsoft.VisualBasic;

public class Example
{
    public static void Main()
    {
        // Delete and recreate the test key.
        Registry.CurrentUser.DeleteSubKey("RegistryOpenSubKeyExample", false);
        RegistryKey rk = Registry.CurrentUser.CreateSubKey("RegistryOpenSubKeyExample");
        rk.Close();

        // Obtain an instance of RegistryKey for the CurrentUser registry
        // root.
        RegistryKey rkCurrentUser = Registry.CurrentUser;

        // Obtain the test key (read-only) and display it.
        RegistryKey rkTest = rkCurrentUser.OpenSubKey("RegistryOpenSubKeyExample");
        Console.WriteLine("Test key: {0}", rkTest);
        rkTest.Close();
        rkCurrentUser.Close();

        // Obtain the test key in one step, using the CurrentUser registry
        // root.
        rkTest = Registry.CurrentUser.OpenSubKey("RegistryOpenSubKeyExample");
        Console.WriteLine("Test key: {0}", rkTest);
        rkTest.Close();

        // Open the test key in read/write mode.
        rkTest = Registry.CurrentUser.OpenSubKey("RegistryOpenSubKeyExample", true);
        rkTest.SetValue("TestName", "TestValue");
        Console.WriteLine("Test value for TestName: {0}", rkTest.GetValue("TestName"));
        rkTest.Close();
    } //Main
} //Example

Imports Microsoft.Win32

Public Class Example
    Public Shared Sub Main()
        ' Delete and recreate the test key.
        Registry.CurrentUser.DeleteSubKey("RegistryOpenSubKeyExample", False)
        Dim rk As RegistryKey = Registry.CurrentUser.CreateSubKey("RegistryOpenSubKeyExample")
        rk.Close

        ' Obtain an instance of RegistryKey for the CurrentUser registry 
        ' root. 
        Dim rkCurrentUser As RegistryKey = Registry.CurrentUser

        ' Obtain the test key (read-only) and display it.
        Dim rkTest As RegistryKey = rkCurrentUser.OpenSubKey("RegistryOpenSubKeyExample")
        Console.WriteLine("Test key: {0}", rkTest)
        rkTest.Close
        rkCurrentUser.Close

        ' Obtain the test key in one step, using the CurrentUser registry 
        ' root.
        rkTest = Registry.CurrentUser.OpenSubKey("RegistryOpenSubKeyExample")
        Console.WriteLine("Test key: {0}", rkTest)
        rkTest.Close

        ' Obtain the test key in read/write mode.
        rkTest = Registry.CurrentUser.OpenSubKey("RegistryOpenSubKeyExample", True)
        rkTest.SetValue("TestName", "TestValue")
        Console.WriteLine("Test value for TestName: {0}", rkTest.GetValue("TestName"))
        rkTest.Close
    End Sub
End Class

설명

요청된 키가 없으면 이 메서드는 예외를 throw하는 대신 를 반환 null 합니다.

이 이true면 writable 읽기 및 쓰기를 위해 키가 열리고, 그렇지 않으면 키가 읽기 전용으로 열립니다.

메서드를 OpenSubKey 사용하려면 메서드의 RegistryKey instance 있어야 합니다. 의 RegistryKeyinstance 얻으려면 클래스의 정적 멤버 Registry 중 하나를 사용합니다.

추가 정보

• CreateSubKey(String)
• DeleteSubKey(String)
• DeleteSubKeyTree(String)
• GetSubKeyNames()
• OpenRemoteBaseKey(RegistryHive, String)
• SubKeyCount
• Registry

OpenSubKey(String, RegistryKeyPermissionCheck, RegistryRights)

지정된 액세스 권한을 요청하여 읽기 또는 읽기/쓰기 권한으로 지정된 하위 키를 검색합니다.

public:
 Microsoft::Win32::RegistryKey ^ OpenSubKey(System::String ^ name, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, System::Security::AccessControl::RegistryRights rights);

public Microsoft.Win32.RegistryKey? OpenSubKey (string name, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistryRights rights);

member this.OpenSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * System.Security.AccessControl.RegistryRights -> Microsoft.Win32.RegistryKey

Public Function OpenSubKey (name As String, permissionCheck As RegistryKeyPermissionCheck, rights As RegistryRights) As RegistryKey

매개 변수

name

String

만들거나 열 하위 키의 이름 또는 경로입니다.

permissionCheck

RegistryKeyPermissionCheck

키가 읽기 또는 읽기/쓰기 권한으로 열려 있는지를 지정하는 열거형 값 중 하나입니다.

rights

RegistryRights

원하는 보안 액세스를 지정하는 열거형 값의 비트 조합입니다.

반환

RegistryKey

요청된 하위 키이거나, 작업에 실패하면 null입니다.

예외

ArgumentNullException

name가 null인 경우

ArgumentException

permissionCheck에 잘못된 값이 포함된 경우

ObjectDisposedException

RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

SecurityException

rights에 잘못된 레지스트리 권한 값이 포함된 경우

또는

사용자에게 요청된 권한이 없는 경우

설명

이 메서드는 예외를 throw하는 대신 요청된 키가 없으면 를 반환 null 합니다.

가 이면 읽기 및 쓰기를 위해 키가 열립니다. 가 RegistryKeyPermissionCheck.ReadSubTree 또는 RegistryKeyPermissionCheck.Default이면 permissionCheck 부모 키를 로 열지 않는 한 키가 읽기 위해 열립니다RegistryKeyPermissionCheck.ReadWriteSubTree.permissionCheckRegistryKeyPermissionCheck.ReadWriteSubTree

에 지정된 액세스가 에 permissionCheck 지정된 액세스보다 우선합니다 rights. 예를 들어 에 및 RegistryRights.WriteKey 를 permissionCheckrights지정 RegistryKeyPermissionCheck.ReadSubTree 하면 하위 키에 쓰려는 시도가 예외를 throw합니다.

메서드를 OpenSubKey 사용하려면 클래스의 RegistryKey instance 있어야 합니다. 의 RegistryKeyinstance 얻으려면 클래스의 정적 멤버 Registry 중 하나를 사용합니다.

추가 정보

• CreateSubKey(String)
• DeleteSubKey(String)
• DeleteSubKeyTree(String)
• GetSubKeyNames()
• OpenRemoteBaseKey(RegistryHive, String)
• SubKeyCount
• Registry

OpenSubKey(String, RegistryRights)

지정된 이름 및 액세스 권한으로 하위 키를 검색합니다. .NET Framework 4.6부터 사용할 수 있습니다.

public:
 Microsoft::Win32::RegistryKey ^ OpenSubKey(System::String ^ name, System::Security::AccessControl::RegistryRights rights);

public Microsoft.Win32.RegistryKey? OpenSubKey (string name, System.Security.AccessControl.RegistryRights rights);

member this.OpenSubKey : string * System.Security.AccessControl.RegistryRights -> Microsoft.Win32.RegistryKey

Public Function OpenSubKey (name As String, rights As RegistryRights) As RegistryKey

매개 변수

name

String

만들거나 열 하위 키의 이름 또는 경로입니다.

rights

RegistryRights

레지스트리 키의 권한입니다.

반환

RegistryKey

요청된 하위 키이거나, 작업에 실패하면 null입니다.

예외

ArgumentNullException

name이(가) null인 경우

ObjectDisposedException

RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

SecurityException

사용자에게 지정된 모드에서 레지스트리 키에 액세스하는 데 필요한 권한이 없는 경우

설명

다른 메서드 및 속성으로 조작하려면 먼저 키를 열어야 합니다. 키를 수정하려면 쓰기 액세스를 지정할 수 있는 메서드의 OpenSubKey 오버로드를 사용하여 열어야 합니다.

OpenSubKey(String)

하위 키를 읽기 전용으로 검색합니다.

public:
 Microsoft::Win32::RegistryKey ^ OpenSubKey(System::String ^ name);

public Microsoft.Win32.RegistryKey? OpenSubKey (string name);

member this.OpenSubKey : string -> Microsoft.Win32.RegistryKey

Public Function OpenSubKey (name As String) As RegistryKey

매개 변수

name

String

읽기 전용으로 열려는 하위 키의 이름 또는 경로입니다.

반환

RegistryKey

요청된 하위 키이거나, 작업에 실패하면 null입니다.

예외

ArgumentNullException

name가 null인 경우

ObjectDisposedException

RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

SecurityException

사용자에게 레지스트리 키를 읽는 데 필요한 권한이 없는 경우

예제

다음 코드 예제에서는 테스트 키를 만들고 메서드를 OpenSubKey 사용하여 메서드의 오버로드를 모두 보여 줍니다.

#using <Microsoft.VisualBasic.dll>

using namespace System;
using namespace Microsoft::Win32;
using namespace Microsoft::VisualBasic;

int main()
{
    // Delete and recreate the test key.
    Registry::CurrentUser->DeleteSubKey( L"RegistryOpenSubKeyExample", false );
    RegistryKey ^ rk = Registry::CurrentUser->CreateSubKey( L"RegistryOpenSubKeyExample" );
    rk->Close();

    // Obtain an instance of RegistryKey for the CurrentUser registry
    // root.
    RegistryKey ^ rkCurrentUser = Registry::CurrentUser;

    // Obtain the test key (read-only) and display it.
    RegistryKey ^ rkTest = rkCurrentUser->OpenSubKey( L"RegistryOpenSubKeyExample" );
    Console::WriteLine( L"Test key: {0}", rkTest );
    rkTest->Close();
    rkCurrentUser->Close();

    // Obtain the test key in one step, using the CurrentUser registry
    // root.
    rkTest = Registry::CurrentUser->OpenSubKey( L"RegistryOpenSubKeyExample" );
    Console::WriteLine( L"Test key: {0}", rkTest );
    rkTest->Close();

    // Open the test key in read/write mode.
    rkTest = Registry::CurrentUser->OpenSubKey( L"RegistryOpenSubKeyExample", true );
    rkTest->SetValue( L"TestName", L"TestValue" );
    Console::WriteLine( L"Test value for TestName: {0}", rkTest->GetValue( L"TestName" ) );
    rkTest->Close();

    return 0;
} //Main

using System;
using Microsoft.Win32;
using Microsoft.VisualBasic;

public class Example
{
    public static void Main()
    {
        // Delete and recreate the test key.
        Registry.CurrentUser.DeleteSubKey("RegistryOpenSubKeyExample", false);
        RegistryKey rk = Registry.CurrentUser.CreateSubKey("RegistryOpenSubKeyExample");
        rk.Close();

        // Obtain an instance of RegistryKey for the CurrentUser registry
        // root.
        RegistryKey rkCurrentUser = Registry.CurrentUser;

        // Obtain the test key (read-only) and display it.
        RegistryKey rkTest = rkCurrentUser.OpenSubKey("RegistryOpenSubKeyExample");
        Console.WriteLine("Test key: {0}", rkTest);
        rkTest.Close();
        rkCurrentUser.Close();

        // Obtain the test key in one step, using the CurrentUser registry
        // root.
        rkTest = Registry.CurrentUser.OpenSubKey("RegistryOpenSubKeyExample");
        Console.WriteLine("Test key: {0}", rkTest);
        rkTest.Close();

        // Open the test key in read/write mode.
        rkTest = Registry.CurrentUser.OpenSubKey("RegistryOpenSubKeyExample", true);
        rkTest.SetValue("TestName", "TestValue");
        Console.WriteLine("Test value for TestName: {0}", rkTest.GetValue("TestName"));
        rkTest.Close();
    } //Main
} //Example

Imports Microsoft.Win32

Public Class Example
    Public Shared Sub Main()
        ' Delete and recreate the test key.
        Registry.CurrentUser.DeleteSubKey("RegistryOpenSubKeyExample", False)
        Dim rk As RegistryKey = Registry.CurrentUser.CreateSubKey("RegistryOpenSubKeyExample")
        rk.Close

        ' Obtain an instance of RegistryKey for the CurrentUser registry 
        ' root. 
        Dim rkCurrentUser As RegistryKey = Registry.CurrentUser

        ' Obtain the test key (read-only) and display it.
        Dim rkTest As RegistryKey = rkCurrentUser.OpenSubKey("RegistryOpenSubKeyExample")
        Console.WriteLine("Test key: {0}", rkTest)
        rkTest.Close
        rkCurrentUser.Close

        ' Obtain the test key in one step, using the CurrentUser registry 
        ' root.
        rkTest = Registry.CurrentUser.OpenSubKey("RegistryOpenSubKeyExample")
        Console.WriteLine("Test key: {0}", rkTest)
        rkTest.Close

        ' Obtain the test key in read/write mode.
        rkTest = Registry.CurrentUser.OpenSubKey("RegistryOpenSubKeyExample", True)
        rkTest.SetValue("TestName", "TestValue")
        Console.WriteLine("Test value for TestName: {0}", rkTest.GetValue("TestName"))
        rkTest.Close
    End Sub
End Class

설명

다른 메서드 및 속성으로 조작하려면 먼저 키를 열어야 합니다. 키를 수정하려면 오버로드 또는 OpenSubKey(String, Boolean) 오버로드와 같은 쓰기 액세스를 지정할 수 있는 메서드의 OpenSubKey 오버로드를 OpenSubKey(String, RegistryKeyPermissionCheck) 사용하여 열어야 합니다.

지정된 하위 키를 찾을 null 수 없으면 가 반환됩니다.

메서드를 OpenSubKey 사용하려면 의 instance RegistryKey있어야 합니다. 의 RegistryKeyinstance 얻으려면 클래스의 정적 멤버 Registry 중 하나를 사용합니다.

추가 정보

• CreateSubKey(String)
• DeleteSubKey(String)
• DeleteSubKeyTree(String)
• GetSubKeyNames()
• OpenRemoteBaseKey(RegistryHive, String)
• SubKeyCount
• Registry

OpenSubKey(String, RegistryKeyPermissionCheck)

읽기 또는 읽기/쓰기 권한으로 지정된 하위 키를 검색합니다.

public:
 Microsoft::Win32::RegistryKey ^ OpenSubKey(System::String ^ name, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck);

public Microsoft.Win32.RegistryKey? OpenSubKey (string name, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck);

member this.OpenSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck -> Microsoft.Win32.RegistryKey

Public Function OpenSubKey (name As String, permissionCheck As RegistryKeyPermissionCheck) As RegistryKey

매개 변수

name

String

만들거나 열 하위 키의 이름 또는 경로입니다.

permissionCheck

RegistryKeyPermissionCheck

키가 읽기 또는 읽기/쓰기 권한으로 열려 있는지를 지정하는 열거형 값 중 하나입니다.

반환

RegistryKey

요청된 하위 키이거나, 작업에 실패하면 null입니다.

예외

ArgumentNullException

name가 null인 경우

ArgumentException

permissionCheck에 잘못된 값이 포함된 경우

ObjectDisposedException

RegistryKey가 닫힌 경우. 닫힌 키는 액세스할 수 없습니다.

SecurityException

사용자에게 레지스트리 키를 읽는 데 필요한 권한이 없는 경우

예제

다음 코드 예제에서는 100개의 키/값 쌍을 포함하는 하위 키를 만들고 닫습니다. 이 예제에서는 를 사용하여 하위 키를 Default열고 모든 값을 읽는 데 걸리는 시간을 기록하고 하위 키를 닫습니다. 이 예제에서는 를 ReadSubTree 사용하여 하위 키를 열고 모든 값을 읽는 데 걸리는 시간을 기록합니다. 마지막으로 예제에서는 백분율 향상을 계산하고 표시합니다.

using System;
using Microsoft.Win32;
using System.Diagnostics;

public class Example
{
    public static void Main()
    {
        const int LIMIT = 100;
        RegistryKey cu = Registry.CurrentUser;
        const string testKey = "RegistryKeyPermissionCheckExample";

        Console.WriteLine("Generating {0} key/value pairs.", LIMIT);
        RegistryKey rk = cu.CreateSubKey(testKey);
        for (int i = 0; i < LIMIT; i++)
        {
            rk.SetValue("Key" + i, i);
        }

        rk.Close();

        Stopwatch s = new Stopwatch();

        // On the default setting, security is checked every time
        // a key/value pair is read.
        rk = cu.OpenSubKey(testKey, RegistryKeyPermissionCheck.Default);

        s.Start();
        for (int i = 0; i < LIMIT; i++)
        {
            rk.GetValue("Key" + i, i);
        }
        s.Stop();
        rk.Close();
        long delta1 = s.ElapsedTicks;

        s.Reset();

        // When the key is opened with ReadSubTree, security is
        // not checked when the values are read.
        rk = cu.OpenSubKey(testKey, RegistryKeyPermissionCheck.ReadSubTree);

        s.Start();
        for (int i = 0; i < LIMIT; i++)
        {
            rk.GetValue("Key" + i, i);
        }
        s.Stop();
        rk.Close();
        long delta2 = s.ElapsedTicks;

        double faster = (double) (delta1 - delta2) / (double) delta1;
        Console.WriteLine("ReadSubTree is {0}% faster for {1} values.",
            (faster * 100).ToString("0.0"), LIMIT);

        cu.DeleteSubKey(testKey);
    }
}

/* This code example produces output similar to the following:

Generating 100 key/value pairs.
ReadSubTree is 23.4% faster for 100 values.
 */

Imports Microsoft.Win32
Imports System.Diagnostics

Public Class Example
    
    Public Shared Sub Main() 

        Const LIMIT As Integer = 100
        Dim cu As RegistryKey = Registry.CurrentUser
        Const testKey As String = "RegistryKeyPermissionCheckExample"
        
        Console.WriteLine("Generating {0} key/value pairs.", LIMIT)
        Dim rk As RegistryKey = cu.CreateSubKey(testKey)

        For i As Integer = 0 To LIMIT
            rk.SetValue("Key" & i, i)
        Next i
        
        rk.Close()
        
        Dim s As New Stopwatch()
        
        ' On the default setting, security is checked every time
        ' a key/value pair is read.
        rk = cu.OpenSubKey(testKey, _
            RegistryKeyPermissionCheck.Default)
        
        s.Start()
        For i As Integer = 0 To LIMIT
            rk.GetValue("Key" & i, i)
        Next i
        s.Stop()
        rk.Close()
        Dim delta1 As Long = s.ElapsedTicks
        
        s.Reset()
        
        ' When the key is opened with ReadSubTree, security is 
        ' not checked when the values are read.
        rk = cu.OpenSubKey(testKey, _
            RegistryKeyPermissionCheck.ReadSubTree)
        
        s.Start()
        For i As Integer = 0 To LIMIT
            rk.GetValue("Key" & i, i)
        Next i
        s.Stop()
        rk.Close()
        Dim delta2 As Long = s.ElapsedTicks
        
        Dim faster As Double = _
            CDbl(delta1 - delta2) * 100.0 / CDbl(delta1)
        Console.WriteLine("ReadSubTree is {0}% faster for {1} values.", _
            faster.ToString("0.0"), LIMIT)
        
        cu.DeleteSubKey(testKey)
    
    End Sub 
End Class 

' This code example produces output similar to the following:
'
'Generating 100 key/value pairs.
'ReadSubTree is 23.4% faster for 100 values.
'

설명

이 메서드는 예외를 throw하는 대신 요청된 키가 없으면 를 반환 null 합니다.

가 이면 읽기 및 쓰기를 위해 키가 열립니다. 가 RegistryKeyPermissionCheck.ReadSubTree 또는 RegistryKeyPermissionCheck.Default이면 permissionCheck 부모 키를 로 열지 않는 한 키가 읽기 위해 열립니다RegistryKeyPermissionCheck.ReadWriteSubTree.permissionCheckRegistryKeyPermissionCheck.ReadWriteSubTree

메서드를 OpenSubKey 사용하려면 클래스의 RegistryKey instance 있어야 합니다. 의 RegistryKeyinstance 얻으려면 클래스의 정적 멤버 Registry 중 하나를 사용합니다.

추가 정보

• CreateSubKey(String)
• DeleteSubKey(String)
• DeleteSubKeyTree(String)
• GetSubKeyNames()
• OpenRemoteBaseKey(RegistryHive, String)
• SubKeyCount
• Registry