RegistryKey.OpenSubKey Metode

Definisi

Ruang nama:

Microsoft.Win32

Rakitan:

Microsoft.Win32.Registry.dll

Mengambil subkunjud yang ditentukan.

Overload

OpenSubKey(String, Boolean)	Mengambil subkunjud yang ditentukan, dan menentukan apakah akses tulis akan diterapkan ke kunci.
OpenSubKey(String, RegistryKeyPermissionCheck, RegistryRights)	Mengambil subkuntangan yang ditentukan untuk akses baca atau baca/tulis, yang meminta hak akses yang ditentukan.
OpenSubKey(String, RegistryRights)	Mengambil subkunjud dengan nama dan hak akses yang ditentukan. Tersedia mulai dari .NET Framework 4.6.
OpenSubKey(String)	Mengambil subkunjud sebagai baca-saja.
OpenSubKey(String, RegistryKeyPermissionCheck)	Mengambil subkuncar yang ditentukan untuk akses baca atau baca/tulis.

OpenSubKey(String, Boolean)

Mengambil subkunjud yang ditentukan, dan menentukan apakah akses tulis akan diterapkan ke kunci.

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

Parameter

name

String

Nama atau jalur subkunjuk yang akan dibuka.

writable

Boolean

Atur ke true jika Anda memerlukan akses tulis ke kunci.

Mengembalikan

RegistryKey

Subkunjud meminta, atau null jika operasi gagal.

Pengecualian

ArgumentNullException

nameadalah null.

ObjectDisposedException

RegistryKey ditutup (kunci tertutup tidak dapat diakses).

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk mengakses kunci registri dalam mode yang ditentukan.

Contoh

Contoh kode berikut membuat kunci pengujian dan menggunakan OpenSubKey metode untuk membukanya, menunjukkan kedua kelebihan beban metode.

#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

Keterangan

Jika kunci yang diminta tidak ada, metode ini mengembalikan alih-alih null melemparkan pengecualian.

Jika writable adalah true, kunci akan dibuka untuk membaca dan menulis, jika tidak, kunci akan dibuka sebagai baca-saja.

Untuk menggunakan metode ini OpenSubKey , Anda harus memiliki instans RegistryKey metode . Untuk mendapatkan instans RegistryKey, gunakan salah satu anggota Registry statis kelas.

Lihat juga

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

OpenSubKey(String, RegistryKeyPermissionCheck, RegistryRights)

Mengambil subkuntangan yang ditentukan untuk akses baca atau baca/tulis, yang meminta hak akses yang ditentukan.

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

Parameter

name

String

Nama atau jalur subkunci yang akan dibuat atau dibuka.

permissionCheck

RegistryKeyPermissionCheck

Salah satu nilai enumerasi yang menentukan apakah kunci dibuka untuk akses baca atau baca/tulis.

rights

RegistryRights

Kombinasi bitwise dari nilai enumerasi yang menentukan akses keamanan yang diinginkan.

Mengembalikan

RegistryKey

Subkunjud meminta, atau null jika operasi gagal.

Pengecualian

ArgumentNullException

name is null

ArgumentException

permissionCheck berisi nilai yang tidak valid.

ObjectDisposedException

RegistryKey ditutup (kunci tertutup tidak dapat diakses).

SecurityException

rights menyertakan nilai hak registri yang tidak valid.

-atau-

Pengguna tidak memiliki izin yang diminta.

Keterangan

Daripada melempar pengecualian, metode ini mengembalikan null jika kunci yang diminta tidak ada.

Jika permissionCheck adalah RegistryKeyPermissionCheck.ReadWriteSubTree, kunci dibuka untuk membaca dan menulis; jika permissionCheck adalah RegistryKeyPermissionCheck.ReadSubTree atau RegistryKeyPermissionCheck.Default, kunci dibuka untuk dibaca kecuali kunci induk dibuka dengan RegistryKeyPermissionCheck.ReadWriteSubTree.

Akses yang ditentukan untuk permissionCheck lebih diutamakan daripada akses yang ditentukan untuk rights. Misalnya, jika Anda menentukan RegistryKeyPermissionCheck.ReadSubTree untuk permissionCheck dan RegistryRights.WriteKey untuk rights, upaya untuk menulis ke subkunci melemparkan pengecualian.

Untuk menggunakan metode ini OpenSubKey , Anda harus memiliki instans RegistryKey kelas . Untuk mendapatkan instans RegistryKey, gunakan salah satu anggota Registry statis kelas.

Lihat juga

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

OpenSubKey(String, RegistryRights)

Mengambil subkunjud dengan nama dan hak akses yang ditentukan. Tersedia mulai dari .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

Parameter

name

String

Nama atau jalur subkunci yang akan dibuat atau dibuka.

rights

RegistryRights

Hak untuk kunci registri.

Mengembalikan

RegistryKey

Subkunjud meminta, atau null jika operasi gagal.

Pengecualian

ArgumentNullException

nameadalah null.

ObjectDisposedException

RegistryKey ditutup (kunci tertutup tidak dapat diakses).

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk mengakses kunci registri dalam mode yang ditentukan.

Keterangan

Anda harus membuka kunci sebelum dapat dimanipulasi dengan metode dan properti lain. Untuk memodifikasi kunci, Anda harus membukanya dengan kelebihan beban OpenSubKey metode yang memungkinkan Anda menentukan akses tulis.

OpenSubKey(String)

Mengambil subkunjud sebagai baca-saja.

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

Parameter

name

String

Nama atau jalur subkunia yang akan dibuka sebagai baca-saja.

Mengembalikan

RegistryKey

Subkunjud meminta, atau null jika operasi gagal.

Pengecualian

ArgumentNullException

name is null

ObjectDisposedException

RegistryKey ditutup (kunci tertutup tidak dapat diakses).

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk membaca kunci registri.

Contoh

Contoh kode berikut membuat kunci pengujian dan menggunakan OpenSubKey metode untuk membukanya, menunjukkan kedua kelebihan beban metode.

#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

Keterangan

Anda harus membuka kunci sebelum dapat dimanipulasi dengan metode dan properti lain. Untuk memodifikasi kunci, Anda harus membukanya dengan kelebihan beban OpenSubKey metode yang memungkinkan Anda menentukan akses tulis, seperti OpenSubKey(String, RegistryKeyPermissionCheck) kelebihan beban atau OpenSubKey(String, Boolean) kelebihan beban.

Jika subkuntangan yang ditentukan tidak dapat ditemukan, maka null dikembalikan.

Untuk menggunakan metode ini OpenSubKey , Anda harus memiliki instans RegistryKey. Untuk mendapatkan instans RegistryKey, gunakan salah satu anggota Registry statis kelas.

Lihat juga

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

OpenSubKey(String, RegistryKeyPermissionCheck)

Mengambil subkuncar yang ditentukan untuk akses baca atau baca/tulis.

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

Parameter

name

String

Nama atau jalur subkunci yang akan dibuat atau dibuka.

permissionCheck

RegistryKeyPermissionCheck

Salah satu nilai enumerasi yang menentukan apakah kunci dibuka untuk akses baca atau baca/tulis.

Mengembalikan

RegistryKey

Subkunjud meminta, atau null jika operasi gagal.

Pengecualian

ArgumentNullException

name is null

ArgumentException

permissionCheck berisi nilai yang tidak valid.

ObjectDisposedException

RegistryKey ditutup (kunci tertutup tidak dapat diakses).

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk membaca kunci registri.

Contoh

Contoh kode berikut membuat subkunci yang berisi 100 pasangan kunci/nilai dan menutupnya. Contoh membuka subkunjuk dengan Default, merekam waktu yang diperlukan untuk membaca semua nilai, dan menutup subkunjud. Contoh membuka subkunjud dengan ReadSubTree dan merekam waktu yang diperlukan untuk membaca semua nilai. Terakhir, contoh menghitung dan menampilkan peningkatan persentase.

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.
'

Keterangan

Daripada melempar pengecualian, metode ini mengembalikan null jika kunci yang diminta tidak ada.

Jika permissionCheck adalah RegistryKeyPermissionCheck.ReadWriteSubTree, kunci dibuka untuk membaca dan menulis; jika permissionCheck adalah RegistryKeyPermissionCheck.ReadSubTree atau RegistryKeyPermissionCheck.Default, kunci dibuka untuk dibaca kecuali kunci induk dibuka dengan RegistryKeyPermissionCheck.ReadWriteSubTree.

Untuk menggunakan metode ini OpenSubKey , Anda harus memiliki instans RegistryKey kelas . Untuk mendapatkan instans RegistryKey, gunakan salah satu anggota Registry statis kelas.

Lihat juga

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