RegistryKey.OpenSubKey Metoda

Definice

Obor názvů:

Microsoft.Win32

Sestavení:

Microsoft.Win32.Registry.dll

Načte zadaný podklíč.

Přetížení

OpenSubKey(String, Boolean)	Načte zadaný podklíč a určuje, zda má být pro klíč použit přístup pro zápis.
OpenSubKey(String, RegistryKeyPermissionCheck, RegistryRights)	Načte zadaný podklíč pro přístup pro čtení nebo čtení/zápis a vyžádá si zadaná přístupová práva.
OpenSubKey(String, RegistryRights)	Načte podklíč se zadaným názvem a přístupovými právy. K dispozici od .NET Framework 4.6.
OpenSubKey(String)	Načte podklíč jen pro čtení.
OpenSubKey(String, RegistryKeyPermissionCheck)	Načte zadaný podklíč pro přístup pro čtení nebo čtení/zápis.

OpenSubKey(String, Boolean)

Načte zadaný podklíč a určuje, zda má být pro klíč použit přístup pro zápis.

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

Parametry

name

String

Název nebo cesta k podklíči, který se má otevřít.

writable

Boolean

Pokud ke klíči potřebujete přístup pro zápis, nastavte na true hodnotu .

Návraty

RegistryKey

Požadovaný podklíč nebo null pokud operace selhala.

Výjimky

ArgumentNullException

name je null.

ObjectDisposedException

Je RegistryKey zavřený (zavřené klíče nelze získat přístup).

SecurityException

Uživatel nemá oprávnění požadovaná pro přístup ke klíči registru v zadaném režimu.

Příklady

Následující příklad kódu vytvoří testovací klíč a použije metodu OpenSubKey k jeho otevření, což demonstruje obě přetížení metody.

#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

Poznámky

Pokud požadovaný klíč neexistuje, vrátí null tato metoda místo vyvolání výjimky.

Pokud writable je true, klíč se otevře pro čtení a zápis, jinak se klíč otevře jen pro čtení.

Pokud chcete použít metodu OpenSubKey , musíte mít instanci RegistryKey metody . Pokud chcete získat instanci RegistryKey, použijte jeden ze statických Registry členů třídy .

Viz také

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

OpenSubKey(String, RegistryKeyPermissionCheck, RegistryRights)

Načte zadaný podklíč pro přístup pro čtení nebo čtení/zápis a vyžádá si zadaná přístupová práva.

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

Parametry

name

String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen.

permissionCheck

RegistryKeyPermissionCheck

Jedna z hodnot výčtu, které určuje, zda je klíč je otevřen pro čtení nebo pro čtení a zápis.

rights

RegistryRights

Bitová kombinace hodnot výčtu, která určuje požadovaný přístup zabezpečení.

Návraty

RegistryKey

Požadovaný podklíč nebo null pokud operace selhala.

Výjimky

ArgumentNullException

name je null

ArgumentException

permissionCheck obsahuje neplatnou hodnotu.

ObjectDisposedException

Je RegistryKey zavřený (zavřené klíče nelze získat přístup).

SecurityException

rights obsahuje neplatné hodnoty práv registru.

-nebo-

Uživatel nemá požadovaná oprávnění.

Poznámky

Místo vyvolání výjimky tato metoda vrátí null , pokud požadovaný klíč neexistuje.

Pokud permissionCheck je RegistryKeyPermissionCheck.ReadWriteSubTree, klíč se otevře pro čtení a zápis; pokud permissionCheck je RegistryKeyPermissionCheck.ReadSubTree nebo RegistryKeyPermissionCheck.Default, klíč se otevře pro čtení, pokud nebyl nadřazený klíč otevřen pomocí RegistryKeyPermissionCheck.ReadWriteSubTree.

Zadaný přístup má permissionCheck přednost před přístupem zadaným pro rights. Pokud například zadáte RegistryKeyPermissionCheck.ReadSubTree pro permissionCheck a RegistryRights.WriteKey pro rights, vyvolá pokus o zápis do podklíče výjimku.

Chcete-li použít metodu OpenSubKey , musíte mít instanci RegistryKey třídy . Pokud chcete získat instanci RegistryKey, použijte jeden ze statických Registry členů třídy .

Viz také

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

OpenSubKey(String, RegistryRights)

Načte podklíč se zadaným názvem a přístupovými právy. K dispozici od .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

Parametry

name

String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen.

rights

RegistryRights

Práva pro klíč registru.

Návraty

RegistryKey

Požadovaný podklíč nebo null pokud operace selhala.

Výjimky

ArgumentNullException

name je null.

ObjectDisposedException

Je RegistryKey zavřený (zavřené klíče nelze získat přístup).

SecurityException

Uživatel nemá oprávnění požadovaná pro přístup ke klíči registru v zadaném režimu.

Poznámky

Před manipulací s jinými metodami a vlastnostmi musíte klíč otevřít. Chcete-li upravit klíč, musíte jej otevřít s přetížením OpenSubKey metody, která umožňuje zadat přístup pro zápis.

OpenSubKey(String)

Načte podklíč jen pro čtení.

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

Parametry

name

String

Název nebo cesta k podklíči, který se má otevřít jen pro čtení.

Návraty

RegistryKey

Požadovaný podklíč nebo null pokud operace selhala.

Výjimky

ArgumentNullException

name je null

ObjectDisposedException

Je RegistryKey zavřený (zavřené klíče nelze získat přístup).

SecurityException

Uživatel nemá oprávnění potřebná ke čtení klíče registru.

Příklady

Následující příklad kódu vytvoří testovací klíč a použije metodu OpenSubKey k jeho otevření, což demonstruje obě přetížení metody.

#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

Poznámky

Před manipulací s jinými metodami a vlastnostmi musíte klíč otevřít. Chcete-li upravit klíč, musíte jej otevřít s přetížením OpenSubKey metody, která umožňuje zadat přístup pro zápis, jako OpenSubKey(String, RegistryKeyPermissionCheck) je přetížení nebo OpenSubKey(String, Boolean) přetížení.

Pokud zadaný podklíč nelze najít, null vrátí se příkaz .

Abyste mohli použít metodu OpenSubKey , musíte mít instanci RegistryKey. Pokud chcete získat instanci RegistryKey, použijte jeden ze statických Registry členů třídy .

Viz také

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

OpenSubKey(String, RegistryKeyPermissionCheck)

Načte zadaný podklíč pro přístup pro čtení nebo čtení/zápis.

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

Parametry

name

String

Název nebo cesta k podklíči, který má být vytvořen nebo otevřen.

permissionCheck

RegistryKeyPermissionCheck

Jedna z hodnot výčtu, které určuje, zda je klíč je otevřen pro čtení nebo pro čtení a zápis.

Návraty

RegistryKey

Požadovaný podklíč nebo null pokud operace selhala.

Výjimky

ArgumentNullException

name je null

ArgumentException

permissionCheck obsahuje neplatnou hodnotu.

ObjectDisposedException

Je RegistryKey zavřený (zavřené klíče nelze získat přístup).

SecurityException

Uživatel nemá oprávnění potřebná ke čtení klíče registru.

Příklady

Následující příklad kódu vytvoří podklíč obsahující 100 párů klíč/hodnota a zavře ho. V příkladu se otevře podklíč s příkazem Default, zaznamená dobu potřebnou ke čtení všech hodnot a zavře podklíč. V příkladu se otevře podklíč a ReadSubTree zaznamená se doba potřebná ke čtení všech hodnot. Nakonec příklad vypočítá a zobrazí procentuální zlepšení.

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

Poznámky

Místo vyvolání výjimky tato metoda vrátí null , pokud požadovaný klíč neexistuje.

Pokud permissionCheck je RegistryKeyPermissionCheck.ReadWriteSubTree, klíč se otevře pro čtení a zápis; pokud permissionCheck je RegistryKeyPermissionCheck.ReadSubTree nebo RegistryKeyPermissionCheck.Default, klíč se otevře pro čtení, pokud nebyl nadřazený klíč otevřen pomocí RegistryKeyPermissionCheck.ReadWriteSubTree.

Chcete-li použít metodu OpenSubKey , musíte mít instanci RegistryKey třídy . Pokud chcete získat instanci RegistryKey, použijte jeden ze statických Registry členů třídy .

Viz také

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