RegistryKey.CreateSubKey Metoda

Definice

Obor názvů:: Microsoft.Win32

Sestavení:: Microsoft.Win32.Registry.dll

Sestavení:: mscorlib.dll

Balíček:: Microsoft.Win32.Registry v5.0.0

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vytvoří nový podklíč nebo otevře existující podklíč.

Přetížení

Name	Description
CreateSubKey(String)	Vytvoří nový podklíč nebo otevře existující podklíč pro přístup k zápisu.
CreateSubKey(String, RegistryKeyPermissionCheck)	Vytvoří nový podklíč nebo otevře existující podklíč pro přístup k zápisu pomocí zadané možnosti kontroly oprávnění.
CreateSubKey(String, Boolean)	Vytvoří nový podklíč nebo otevře existující podklíč se zadaným přístupem. K dispozici od .NET Framework 4.6.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)	Vytvoří podklíč nebo otevře podklíč pro přístup k zápisu pomocí zadané kontroly oprávnění a možností registru.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)	Vytvoří nový podklíč nebo otevře existující podklíč pro přístup k zápisu pomocí zadané možnosti kontroly oprávnění a zabezpečení registru.
CreateSubKey(String, Boolean, RegistryOptions)	Vytvoří nový podklíč nebo otevře existující podklíč se zadaným přístupem. K dispozici od .NET Framework 4.6.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)	Vytvoří podklíč nebo otevře podklíč pro přístup k zápisu pomocí zadané možnosti kontroly oprávnění, možnosti registru a zabezpečení registru.

CreateSubKey(String)

Zdroj:: RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup k zápisu.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey);

public Microsoft.Win32.RegistryKey CreateSubKey(string subkey);

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

Public Function CreateSubKey (subkey As String) As RegistryKey

Parametry

subkey: String

Název nebo cesta podklíče k vytvoření nebo otevření. Tento řetězec nerozlišuje malá a velká písmena.

Návraty

RegistryKey

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán subkeyřetězec nulové délky , vrátí se aktuální RegistryKey objekt.

Výjimky

ArgumentNullException

subkey je null.

SecurityException

Uživatel nemá oprávnění potřebná k vytvoření nebo otevření klíče registru.

ObjectDisposedException

Vyvolána RegistryKey metoda je uzavřena (uzavřené klíče nelze získat přístup).

UnauthorizedAccessException

Nelze RegistryKey jej zapsat, například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

IOException

Úroveň vnoření přesahuje 510.

nebo

Došlo k systémové chybě, například odstranění klíče nebo pokus o vytvoření klíče v kořenovém adresáři LocalMachine .

Příklady

Následující příklad kódu ukazuje, jak vytvořit podklíč v HKEY_CURRENT_USER, manipulovat s jeho obsahem a pak odstranit podklíč.

using namespace System;
using namespace System::Security::Permissions;
using namespace Microsoft::Win32;

int main()
{
   // Create a subkey named Test9999 under HKEY_CURRENT_USER.
   RegistryKey ^ test9999 = Registry::CurrentUser->CreateSubKey( "Test9999" );

   // Create two subkeys under HKEY_CURRENT_USER\Test9999.
   test9999->CreateSubKey( "TestName" )->Close();
   RegistryKey ^ testSettings = test9999->CreateSubKey( "TestSettings" );

   // Create data for the TestSettings subkey.
   testSettings->SetValue( "Language", "French" );
   testSettings->SetValue( "Level", "Intermediate" );
   testSettings->SetValue( "ID", 123 );
   testSettings->Close();

   // Print the information from the Test9999 subkey.
   Console::WriteLine( "There are {0} subkeys under Test9999.", test9999->SubKeyCount.ToString() );
   array<String^>^subKeyNames = test9999->GetSubKeyNames();
   for ( int i = 0; i < subKeyNames->Length; i++ )
   {
      RegistryKey ^ tempKey = test9999->OpenSubKey( subKeyNames[ i ] );
      Console::WriteLine( "\nThere are {0} values for {1}.", tempKey->ValueCount.ToString(), tempKey->Name );
      array<String^>^valueNames = tempKey->GetValueNames();
      for ( int j = 0; j < valueNames->Length; j++ )
      {
         Console::WriteLine( "{0,-8}: {1}", valueNames[ j ], tempKey->GetValue( valueNames[ j ] )->ToString() );

      }
   }
   
   // Delete the ID value.
   testSettings = test9999->OpenSubKey( "TestSettings", true );
   testSettings->DeleteValue( "id" );

   // Verify the deletion.
   Console::WriteLine( dynamic_cast<String^>(testSettings->GetValue(  "id", "ID not found." )) );
   testSettings->Close();

   // Delete or close the new subkey.
   Console::Write( "\nDelete newly created registry key? (Y/N) " );
   if ( Char::ToUpper( Convert::ToChar( Console::Read() ) ) == 'Y' )
   {
      Registry::CurrentUser->DeleteSubKeyTree( "Test9999" );
      Console::WriteLine( "\nRegistry key {0} deleted.", test9999->Name );
   }
   else
   {
      Console::WriteLine( "\nRegistry key {0} closed.", test9999->ToString() );
      test9999->Close();
   }
}

using System;
using System.Security.Permissions;
using Microsoft.Win32;

class RegKey
{
    static void Main()
    {
        // Create a subkey named Test9999 under HKEY_CURRENT_USER.
        RegistryKey test9999 =
            Registry.CurrentUser.CreateSubKey("Test9999");
        // Create two subkeys under HKEY_CURRENT_USER\Test9999. The
        // keys are disposed when execution exits the using statement.
        using(RegistryKey
            testName = test9999.CreateSubKey("TestName"),
            testSettings = test9999.CreateSubKey("TestSettings"))
        {
            // Create data for the TestSettings subkey.
            testSettings.SetValue("Language", "French");
            testSettings.SetValue("Level", "Intermediate");
            testSettings.SetValue("ID", 123);
        }

        // Print the information from the Test9999 subkey.
        Console.WriteLine("There are {0} subkeys under {1}.",
            test9999.SubKeyCount.ToString(), test9999.Name);
        foreach(string subKeyName in test9999.GetSubKeyNames())
        {
            using(RegistryKey
                tempKey = test9999.OpenSubKey(subKeyName))
            {
                Console.WriteLine("\nThere are {0} values for {1}.",
                    tempKey.ValueCount.ToString(), tempKey.Name);
                foreach(string valueName in tempKey.GetValueNames())
                {
                    Console.WriteLine("{0,-8}: {1}", valueName,
                        tempKey.GetValue(valueName).ToString());
                }
            }
        }

        using(RegistryKey
            testSettings = test9999.OpenSubKey("TestSettings", true))
        {
            // Delete the ID value.
            testSettings.DeleteValue("id");

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

        // Delete or close the new subkey.
        Console.Write("\nDelete newly created registry key? (Y/N) ");
        if(Char.ToUpper(Convert.ToChar(Console.Read())) == 'Y')
        {
            Registry.CurrentUser.DeleteSubKeyTree("Test9999");
            Console.WriteLine("\nRegistry key {0} deleted.",
                test9999.Name);
        }
        else
        {
            Console.WriteLine("\nRegistry key {0} closed.",
                test9999.ToString());
            test9999.Close();
        }
    }
}

Imports System.Security.Permissions
Imports Microsoft.Win32

Public Class RegKey
    Shared Sub Main()

        ' Create a subkey named Test9999 under HKEY_CURRENT_USER.
        Dim test9999 As RegistryKey = _
            Registry.CurrentUser.CreateSubKey("Test9999")

        ' Create two subkeys under HKEY_CURRENT_USER\Test9999.
        test9999.CreateSubKey("TestName").Close()
        Dim testSettings As RegistryKey = _
            test9999.CreateSubKey("TestSettings")

        ' Create data for the TestSettings subkey.
        testSettings.SetValue("Language", "French")
        testSettings.SetValue("Level", "Intermediate")
        testSettings.SetValue("ID", 123)
        testSettings.Close()

        ' Print the information from the Test9999 subkey.
        Console.WriteLine("There are {0} subkeys under Test9999.", _
            test9999.SubKeyCount.ToString())
        For Each subKeyName As String In test9999.GetSubKeyNames()
            Dim tempKey As RegistryKey = _
                test9999.OpenSubKey(subKeyName)
            Console.WriteLine(vbCrLf & "There are {0} values for " & _
                "{1}.", tempKey.ValueCount.ToString(), tempKey.Name)
            For Each valueName As String In tempKey.GetValueNames()
                Console.WriteLine("{0,-8}: {1}", valueName, _
                    tempKey.GetValue(valueName).ToString())
            Next
        Next

        ' Delete the ID value.
        testSettings = test9999.OpenSubKey("TestSettings", True)
        testSettings.DeleteValue("id")

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

        ' Delete or close the new subkey.
        Console.Write(vbCrLf & "Delete newly created " & _
            "registry key? (Y/N) ")
        If Char.ToUpper(Convert.ToChar(Console.Read())) = "Y"C Then
            Registry.CurrentUser.DeleteSubKeyTree("Test9999")
            Console.WriteLine(vbCrLf & "Registry key {0} deleted.", _
                test9999.Name)
        Else
            Console.WriteLine(vbCrLf & "Registry key {0} closed.", _
                test9999.ToString())
            test9999.Close()
        End If
   
    End Sub
End Class

Poznámky

Aby mohl uživatel tuto akci provést, musí mít oprávnění na této úrovni a níže v hierarchii registru.

Caution

Nezpřístupňujte RegistryKey objekty takovým způsobem, že by škodlivý program mohl vytvořit tisíce bezvýznamných podklíčů nebo párů klíč/hodnota. Nepovolujte například volajícím zadat libovolné klíče nebo hodnoty.

Viz také

Platí pro

CreateSubKey(String, RegistryKeyPermissionCheck)

Zdroj:: RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup k zápisu pomocí zadané možnosti kontroly oprávnění.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck);

public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck);

[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck -> Microsoft.Win32.RegistryKey

Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck) As RegistryKey

Parametry

subkey: String

Název nebo cesta podklíče k vytvoření nebo otevření. Tento řetězec nerozlišuje malá a velká písmena.

permissionCheck: RegistryKeyPermissionCheck

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

Návraty

RegistryKey

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán subkeyřetězec nulové délky , vrátí se aktuální RegistryKey objekt.

Atributy: ComVisibleAttribute

Výjimky

ArgumentNullException

subkey je null.

SecurityException

Uživatel nemá oprávnění potřebná k vytvoření nebo otevření klíče registru.

ArgumentException

permissionCheck obsahuje neplatnou hodnotu.

ObjectDisposedException

Vyvolána RegistryKey metoda je uzavřena (uzavřené klíče nelze získat přístup).

UnauthorizedAccessException

Soubor RegistryKey nelze zapsat, například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

IOException

Úroveň vnoření přesahuje 510.

nebo

Došlo k systémové chybě, například odstranění klíče nebo pokus o vytvoření klíče v kořenovém adresáři LocalMachine .

Poznámky

Aby mohl uživatel tuto akci provést, musí mít oprávnění na této úrovni a níže v hierarchii registru.

Caution

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é

Platí pro

CreateSubKey(String, Boolean)

Zdroj:: RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč se zadaným přístupem. K dispozici od .NET Framework 4.6.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, bool writable);

public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, bool writable);

[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, bool writable);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * bool -> Microsoft.Win32.RegistryKey

Public Function CreateSubKey (subkey As String, writable As Boolean) As RegistryKey

Parametry

subkey: String

Název nebo cesta podklíče k vytvoření nebo otevření. Tento řetězec nerozlišuje malá a velká písmena.

writable: Boolean

trueindikuje, že nový podklíč je zapisovatelný; v opačném případě . false

Návraty

RegistryKey

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán subkeyřetězec nulové délky , vrátí se aktuální RegistryKey objekt.

Atributy: ComVisibleAttribute

Výjimky

ArgumentNullException

subkey je null.

SecurityException

Uživatel nemá oprávnění potřebná k vytvoření nebo otevření klíče registru.

UnauthorizedAccessException

Aktuální RegistryKey soubor nelze zapsat, například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

IOException

Úroveň vnoření přesahuje 510.

nebo

Došlo k systémové chybě, například odstranění klíče nebo pokus o vytvoření klíče v kořenovém adresáři LocalMachine .

Poznámky

Aby mohl uživatel tuto akci provést, musí mít oprávnění na této úrovni a níže v hierarchii registru.

Caution

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

Platí pro

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)

Zdroj:: RegistryKey.cs

Vytvoří podklíč nebo otevře podklíč pro přístup k zápisu pomocí zadané kontroly oprávnění a možností registru.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, Microsoft::Win32::RegistryOptions registryOptions);

public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions);

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

Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, registryOptions As RegistryOptions) As RegistryKey

Parametry

subkey: String

Název nebo cesta podklíče k vytvoření nebo otevření.

permissionCheck: RegistryKeyPermissionCheck

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

registryOptions: RegistryOptions

Možnost registru, která se má použít; Například vytvoří nestálý klíč.

Návraty

RegistryKey

Nově vytvořený podklíč nebo null pokud operace selhala.

Výjimky

ArgumentNullException

subkey je null.

ObjectDisposedException

Aktuální RegistryKey objekt je zavřený (uzavřené klíče nelze získat přístup).

UnauthorizedAccessException

Aktuální RegistryKey objekt nelze zapsat, například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá požadovaná přístupová práva.

IOException

Úroveň vnoření přesahuje 510.

nebo

Došlo k systémové chybě, například odstranění klíče nebo pokus o vytvoření klíče v kořenovém adresáři LocalMachine .

SecurityException

Uživatel nemá oprávnění potřebná k vytvoření nebo otevření klíče registru.

Poznámky

Chcete-li získat aktuální RegistryKey objekt, zadejte prázdný řetězec ("") pro subkey.

Platí pro

CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)

Zdroj:: RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup k zápisu pomocí zadané možnosti kontroly oprávnění a zabezpečení registru.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, System::Security::AccessControl::RegistrySecurity ^ registrySecurity);

public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistrySecurity? registrySecurity);

[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistrySecurity registrySecurity);

public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, System.Security.AccessControl.RegistrySecurity registrySecurity);

member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey

Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, registrySecurity As RegistrySecurity) As RegistryKey

Parametry

subkey: String

Název nebo cesta podklíče k vytvoření nebo otevření. Tento řetězec nerozlišuje malá a velká písmena.

permissionCheck: RegistryKeyPermissionCheck

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

registrySecurity: RegistrySecurity

Zabezpečení řízení přístupu pro nový klíč.

Návraty

RegistryKey

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán subkeyřetězec nulové délky , vrátí se aktuální RegistryKey objekt.

Atributy: ComVisibleAttribute

Výjimky

ArgumentNullException

subkey je null.

SecurityException

Uživatel nemá oprávnění potřebná k vytvoření nebo otevření klíče registru.

ArgumentException

permissionCheck obsahuje neplatnou hodnotu.

ObjectDisposedException

Vyvolána RegistryKey metoda je uzavřena (uzavřené klíče nelze získat přístup).

UnauthorizedAccessException

Aktuální RegistryKey soubor nelze zapsat, například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

IOException

Úroveň vnoření přesahuje 510.

nebo

Došlo k systémové chybě, například odstranění klíče nebo pokus o vytvoření klíče v kořenovém adresáři LocalMachine .

Poznámky

Metoda CreateSubKey vytvoří klíč registru, který má řízení přístupu určené parametrem registrySecurity . Vrácený RegistryKey objekt představuje klíč registru, ale tento objekt není omezen řízením přístupu zadaným v parametru registrySecurity .

Pokud permissionCheck ano RegistryKeyPermissionCheck.ReadWriteSubTree, klíč se otevře pro přístup pro čtení a zápis. Pokud permissionCheck ano RegistryKeyPermissionCheck.ReadSubTree, klíč se otevře pro přístup pro čtení.

Pro zpětnou kompatibilitu je klíč otevřen pro čtení a zápis, pokud permissionCheck je RegistryKeyPermissionCheck.Default a nadřazený klíč má RegistryKeyPermissionCheck.Defaulttaké . Pokud má nadřazený klíč jiné nastavení, řídí se stav čtení a zápisu nastavením nadřazeného klíče.

K provedení této akce musí mít uživatel oprávnění na této úrovni a níže v hierarchii registru.

Caution

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é

Platí pro

CreateSubKey(String, Boolean, RegistryOptions)

Zdroj:: RegistryKey.cs

Vytvoří nový podklíč nebo otevře existující podklíč se zadaným přístupem. K dispozici od .NET Framework 4.6.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, bool writable, Microsoft::Win32::RegistryOptions options);

public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, bool writable, Microsoft.Win32.RegistryOptions options);

[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, bool writable, Microsoft.Win32.RegistryOptions options);

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

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * bool * Microsoft.Win32.RegistryOptions -> Microsoft.Win32.RegistryKey

Public Function CreateSubKey (subkey As String, writable As Boolean, options As RegistryOptions) As RegistryKey

Parametry

subkey: String

Název nebo cesta podklíče k vytvoření nebo otevření. Tento řetězec nerozlišuje malá a velká písmena.

writable: Boolean

trueindikuje, že nový podklíč je zapisovatelný; v opačném případě . false

options: RegistryOptions

Možnost registru, která se má použít.

Návraty

RegistryKey

Nově vytvořený podklíč nebo null pokud operace selhala. Pokud je zadán subkeyřetězec nulové délky , vrátí se aktuální RegistryKey objekt.

Atributy: ComVisibleAttribute

Výjimky

ArgumentNullException

subkey je null.

ArgumentException

options nezadá platnou možnost.

SecurityException

Uživatel nemá oprávnění potřebná k vytvoření nebo otevření klíče registru.

UnauthorizedAccessException

Aktuální RegistryKey soubor nelze zapsat, například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

IOException

Úroveň vnoření přesahuje 510.

nebo

Došlo k systémové chybě, například odstranění klíče nebo pokus o vytvoření klíče v kořenovém adresáři LocalMachine .

Poznámky

Aby mohl uživatel tuto akci provést, musí mít oprávnění na této úrovni a níže v hierarchii registru.

Caution

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

Platí pro

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)

Zdroj:: RegistryKey.cs

Vytvoří podklíč nebo otevře podklíč pro přístup k zápisu pomocí zadané možnosti kontroly oprávnění, možnosti registru a zabezpečení registru.

public:
 Microsoft::Win32::RegistryKey ^ CreateSubKey(System::String ^ subkey, Microsoft::Win32::RegistryKeyPermissionCheck permissionCheck, Microsoft::Win32::RegistryOptions registryOptions, System::Security::AccessControl::RegistrySecurity ^ registrySecurity);

public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions, System.Security.AccessControl.RegistrySecurity? registrySecurity);

[System.Runtime.InteropServices.ComVisible(false)]
public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions, System.Security.AccessControl.RegistrySecurity registrySecurity);

public Microsoft.Win32.RegistryKey CreateSubKey(string subkey, Microsoft.Win32.RegistryKeyPermissionCheck permissionCheck, Microsoft.Win32.RegistryOptions registryOptions, System.Security.AccessControl.RegistrySecurity registrySecurity);

member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey

[<System.Runtime.InteropServices.ComVisible(false)>]
member this.CreateSubKey : string * Microsoft.Win32.RegistryKeyPermissionCheck * Microsoft.Win32.RegistryOptions * System.Security.AccessControl.RegistrySecurity -> Microsoft.Win32.RegistryKey

Public Function CreateSubKey (subkey As String, permissionCheck As RegistryKeyPermissionCheck, registryOptions As RegistryOptions, registrySecurity As RegistrySecurity) As RegistryKey

Parametry

subkey: String

Název nebo cesta podklíče k vytvoření nebo otevření.

permissionCheck: RegistryKeyPermissionCheck

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

registryOptions: RegistryOptions

Možnost registru, která se má použít.

registrySecurity: RegistrySecurity

Zabezpečení řízení přístupu pro nový podklíč.

Návraty

RegistryKey

Nově vytvořený podklíč nebo null pokud operace selhala.

Atributy: ComVisibleAttribute

Výjimky

ArgumentNullException

subkey je null.

ObjectDisposedException

Aktuální RegistryKey objekt je uzavřen. Uzavřené klíče nelze získat přístup.

UnauthorizedAccessException

Aktuální RegistryKey objekt nelze zapsat, například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá požadovaná přístupová práva.

IOException

Úroveň vnoření přesahuje 510.

nebo

Došlo k systémové chybě, například odstranění klíče nebo pokus o vytvoření klíče v kořenovém adresáři LocalMachine .

SecurityException

Uživatel nemá oprávnění potřebná k vytvoření nebo otevření klíče registru.

Poznámky

Chcete-li získat aktuální RegistryKey objekt, zadejte prázdný řetězec ("") pro subkey.

Platí pro

Váš názor

Byla tato stránka užitečná?