RegistryKey.OpenSubKey Yöntem

Tanım

Ad Alanı:

Microsoft.Win32

Bütünleştirilmiş Kod:

Microsoft.Win32.Registry.dll

Belirtilen alt anahtarı alır.

Aşırı Yüklemeler

OpenSubKey(String, Boolean)	Belirtilen alt anahtarı alır ve yazma erişiminin anahtara uygulanıp uygulanmayacağını belirtir.
OpenSubKey(String, RegistryKeyPermissionCheck, RegistryRights)	Belirtilen erişim haklarını isteyerek okuma veya okuma/yazma erişimi için belirtilen alt anahtarı alır.
OpenSubKey(String, RegistryRights)	Belirtilen ad ve erişim haklarına sahip bir alt anahtar alır. .NET Framework 4.6'dan itibaren kullanılabilir.
OpenSubKey(String)	Bir alt anahtarı salt okunur olarak alır.
OpenSubKey(String, RegistryKeyPermissionCheck)	Okuma veya okuma/yazma erişimi için belirtilen alt anahtarı alır.

OpenSubKey(String, Boolean)

Belirtilen alt anahtarı alır ve yazma erişiminin anahtara uygulanıp uygulanmayacağını belirtir.

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

Parametreler

name

String

Açılacak alt anahtarın adı veya yolu.

writable

Boolean

Anahtara true yazma erişimine ihtiyacınız varsa olarak ayarlayın.

Döndürülenler

RegistryKey

Alt anahtar istendi veya null işlem başarısız olduysa.

Özel durumlar

ArgumentNullException

name, null değeridir.

ObjectDisposedException

RegistryKey kapalıdır (kapalı anahtarlara erişilemez).

SecurityException

Kullanıcının belirtilen modda kayıt defteri anahtarına erişmek için gereken izinleri yok.

Örnekler

Aşağıdaki kod örneği bir test anahtarı oluşturur ve bunu açmak için yöntemini kullanır OpenSubKey ve yöntemin her iki aşırı yüklemesini gösterir.

#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

Açıklamalar

İstenen anahtar yoksa, bu yöntem bir özel durum atmak yerine döndürür null .

ise writabletrue, anahtar okuma ve yazma için açılır, aksi takdirde anahtar salt okunur olarak açılır.

yöntemini kullanmak için yönteminin OpenSubKey bir örneğine RegistryKey sahip olmanız gerekir. örneğini RegistryKeyalmak için sınıfının statik üyelerinden Registry birini kullanın.

Ayrıca bkz.

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

OpenSubKey(String, RegistryKeyPermissionCheck, RegistryRights)

Belirtilen erişim haklarını isteyerek okuma veya okuma/yazma erişimi için belirtilen alt anahtarı alır.

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

Parametreler

name

String

Oluşturulacak veya açılacak alt anahtar adı veya yolu

permissionCheck

RegistryKeyPermissionCheck

Anahtarın okuma veya okuma/yazma erişimi için açılıp açılmayacağını belirten numaralandırma değerlerinden biri.

rights

RegistryRights

İstenen güvenlik erişimini belirten sabit listesi değerlerinin bit düzeyinde birleşimi.

Döndürülenler

RegistryKey

Alt anahtar istendi veya null işlem başarısız olduysa.

Özel durumlar

ArgumentNullException

namenull

ArgumentException

permissionCheck geçersiz bir değer içeriyor.

ObjectDisposedException

RegistryKey kapalıdır (kapalı anahtarlara erişilemez).

SecurityException

rights geçersiz kayıt defteri hakları değerleri içerir.

-veya-

Kullanıcının istenen izinleri yok.

Açıklamalar

Bu yöntem, bir özel durum atmak yerine istenen anahtar yoksa döndürür null .

ise permissionCheckRegistryKeyPermissionCheck.ReadWriteSubTree, anahtar okuma ve yazma için açılır; veya RegistryKeyPermissionCheck.Defaultise permissionCheckRegistryKeyPermissionCheck.ReadSubTree, üst anahtar ile RegistryKeyPermissionCheck.ReadWriteSubTreeaçılmadığı sürece anahtar okuma için açılır.

için belirtilen erişim, için permissionCheckrightsbelirtilen erişimden önceliklidir. Örneğin, ve için permissionCheckRegistryRights.WriteKeyrightsbelirtirsenizRegistryKeyPermissionCheck.ReadSubTree, alt anahtara yazma girişimi bir özel durum oluşturur.

yöntemini kullanmak OpenSubKey için sınıfının bir örneğine RegistryKey sahip olmanız gerekir. örneğini RegistryKeyalmak için sınıfının statik üyelerinden Registry birini kullanın.

Ayrıca bkz.

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

OpenSubKey(String, RegistryRights)

Belirtilen ad ve erişim haklarına sahip bir alt anahtar alır. .NET Framework 4.6'dan itibaren kullanılabilir.

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

Parametreler

name

String

Oluşturulacak veya açılacak alt anahtar adı veya yolu

rights

RegistryRights

Kayıt defteri anahtarının hakları.

Döndürülenler

RegistryKey

Alt anahtar istendi veya null işlem başarısız olduysa.

Özel durumlar

ArgumentNullException

name, null değeridir.

ObjectDisposedException

RegistryKey kapalıdır (kapalı anahtarlara erişilemez).

SecurityException

Kullanıcının belirtilen modda kayıt defteri anahtarına erişmek için gereken izinleri yok.

Açıklamalar

Anahtarın diğer yöntemler ve özelliklerle işlenebilmesi için önce anahtarı açmanız gerekir. Bir anahtarı değiştirmek için yazma erişimini belirtmenize olanak tanıyan yöntemin OpenSubKey aşırı yüklemesiyle açmanız gerekir.

OpenSubKey(String)

Bir alt anahtarı salt okunur olarak alır.

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

Parametreler

name

String

Salt okunur olarak açılacak alt anahtarın adı veya yolu.

Döndürülenler

RegistryKey

Alt anahtar istendi veya null işlem başarısız olduysa.

Özel durumlar

ArgumentNullException

namenull

ObjectDisposedException

RegistryKey kapalıdır (kapalı anahtarlara erişilemez).

SecurityException

Kullanıcının kayıt defteri anahtarını okumak için gereken izinleri yok.

Örnekler

Aşağıdaki kod örneği bir test anahtarı oluşturur ve bunu açmak için yöntemini kullanır OpenSubKey ve yöntemin her iki aşırı yüklemesini gösterir.

#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

Açıklamalar

Anahtarın diğer yöntemler ve özelliklerle işlenebilmesi için önce anahtarı açmanız gerekir. Bir anahtarı değiştirmek için, aşırı yükleme veya aşırı yükleme OpenSubKey gibi yazma erişimi belirtmenize olanak tanıyan yönteminin OpenSubKey(String, RegistryKeyPermissionCheck) aşırı yüklemesiyle OpenSubKey(String, Boolean) açmanız gerekir.

Belirtilen alt anahtar bulunamazsa döndürülür null .

yöntemini kullanmak OpenSubKey için bir örneğine RegistryKeysahip olmanız gerekir. bir örneğini RegistryKeyalmak için sınıfının statik üyelerinden Registry birini kullanın.

Ayrıca bkz.

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

OpenSubKey(String, RegistryKeyPermissionCheck)

Okuma veya okuma/yazma erişimi için belirtilen alt anahtarı alır.

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

Parametreler

name

String

Oluşturulacak veya açılacak alt anahtar adı veya yolu

permissionCheck

RegistryKeyPermissionCheck

Anahtarın okuma veya okuma/yazma erişimi için açılıp açılmayacağını belirten numaralandırma değerlerinden biri.

Döndürülenler

RegistryKey

Alt anahtar istendi veya null işlem başarısız olduysa.

Özel durumlar

ArgumentNullException

namenull

ArgumentException

permissionCheck geçersiz bir değer içeriyor.

ObjectDisposedException

RegistryKey kapalıdır (kapalı anahtarlara erişilemez).

SecurityException

Kullanıcının kayıt defteri anahtarını okumak için gereken izinleri yok.

Örnekler

Aşağıdaki kod örneği, 100 anahtar/değer çifti içeren bir alt anahtar oluşturur ve bunu kapatır. Örnek ile Defaultalt anahtarı açar, tüm değerleri okumak için gereken süreyi kaydeder ve alt anahtarı kapatır. Örnek ile ReadSubTree alt anahtarı açar ve tüm değerleri okumak için gereken süreyi kaydeder. Son olarak örnek, yüzde iyileştirmesini hesaplar ve görüntüler.

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

Açıklamalar

Bu yöntem, bir özel durum atmak yerine istenen anahtar yoksa döndürür null .

ise permissionCheckRegistryKeyPermissionCheck.ReadWriteSubTree, anahtar okuma ve yazma için açılır; veya RegistryKeyPermissionCheck.Defaultise permissionCheckRegistryKeyPermissionCheck.ReadSubTree, üst anahtar ile RegistryKeyPermissionCheck.ReadWriteSubTreeaçılmadığı sürece anahtar okuma için açılır.

yöntemini kullanmak OpenSubKey için sınıfının bir örneğine RegistryKey sahip olmanız gerekir. örneğini RegistryKeyalmak için sınıfının statik üyelerinden Registry birini kullanın.

Ayrıca bkz.

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