RegistryKey.CreateSubKey Metoda

Definice

Obor názvů:

Microsoft.Win32

Sestavení:

Microsoft.Win32.Registry.dll

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

Přetížení

CreateSubKey(String)	Vytvoří nový podklíč nebo otevře existující podklíč pro přístup pro zápis.
CreateSubKey(String, RegistryKeyPermissionCheck)	Vytvoří nový podklíč nebo otevře existující podklíč pro přístup pro zápis 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, RegistrySecurity)	Vytvoří nový podklíč nebo otevře existující podklíč pro přístup pro zápis 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)	Vytvoří podklíč nebo otevře podklíč pro přístup pro zápis pomocí zadané kontroly oprávnění a možností registru.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)	Vytvoří podklíč nebo otevře podklíč pro přístup pro zápis pomocí zadané možnosti kontroly oprávnění, možnosti registru a zabezpečení registru.

CreateSubKey(String)

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

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 k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

Návraty

RegistryKey

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

Výjimky

ArgumentNullException

subkey je null.

SecurityException

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

ObjectDisposedException

Objekt RegistryKey , na kterém je tato metoda vyvolána, je uzavřen (uzavřené klíče nelze získat přístup).

UnauthorizedAccessException

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

IOException

Úroveň vnoření překračuje 510.

-nebo-

Došlo k systémové chybě, například k odstranění klíče nebo pokusu 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íč pod HKEY_CURRENT_USER, manipulovat s jeho obsahem a poté podklíč odstranit.

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

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

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce nesmyslných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

Viz také

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)

CreateSubKey(String, RegistryKeyPermissionCheck)

Vytvoří nový podklíč nebo otevře existující podklíč pro přístup pro zápis 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);

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 k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

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

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

Výjimky

ArgumentNullException

subkey je null.

SecurityException

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

ArgumentException

permissionCheck obsahuje neplatnou hodnotu.

ObjectDisposedException

Objekt RegistryKey , na kterém je tato metoda vyvolána, je uzavřen (uzavřené klíče nelze získat přístup).

UnauthorizedAccessException

Do objektu RegistryKey nelze zapisovat. Například nebyl otevřen jako zapisovatelný klíč nebo uživatel nemá potřebná přístupová práva.

IOException

Úroveň vnoření překračuje 510.

-nebo-

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

Poznámky

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

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce nesmyslných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

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é

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)

CreateSubKey(String, Boolean)

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);

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 k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

writable

Boolean

trueoznačující, ž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 řetězec nulové délky pro subkey, RegistryKey aktuální objekt se vrátí.

Výjimky

ArgumentNullException

subkey je null.

SecurityException

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

UnauthorizedAccessException

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

IOException

Úroveň vnoření překračuje 510.

-nebo-

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

Poznámky

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

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce nesmyslných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

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 .

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.

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);

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 k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

permissionCheck

RegistryKeyPermissionCheck

Jedna z hodnot výčtu, které určuje, zda je klíč je otevřen pro čtení nebo pro čtení a 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 řetězec nulové délky pro subkey, RegistryKey aktuální objekt se vrátí.

Výjimky

ArgumentNullException

subkey je null.

SecurityException

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

ArgumentException

permissionCheck obsahuje neplatnou hodnotu.

ObjectDisposedException

Objekt RegistryKey , na kterém je tato metoda vyvolána, je uzavřen (uzavřené klíče nelze získat přístup).

UnauthorizedAccessException

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

IOException

Úroveň vnoření překračuje 510.

-nebo-

Došlo k systémové chybě, například k odstranění klíče nebo pokusu 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 je RegistryKeyPermissionCheck.ReadWriteSubTree, klíč se otevře pro přístup pro čtení i zápis. Pokud permissionCheck je RegistryKeyPermissionCheck.ReadSubTree, klíč se otevře pro přístup pro čtení.

Z důvodu zpětné kompatibility 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í, stav čtení a zápisu se řídí nastavením nadřazeného klíče.

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

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce nesmyslných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

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é

• DeleteSubKey(String)
• OpenSubKey(String, Boolean)

CreateSubKey(String, Boolean, RegistryOptions)

Vytvoří nový podklíč nebo otevře existující podklíč se zadaným přístupem. K dispozici od verze .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);

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 k podklíči, který má být vytvořen nebo otevřen. Tento řetězec neodlišuje velká a malá písmena.

writable

Boolean

trueoznačující, ž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 řetězec nulové délky pro subkey, RegistryKey aktuální objekt se vrátí.

Výjimky

ArgumentNullException

subkey je null.

ArgumentException

options nezadá platnou možnost.

SecurityException

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

UnauthorizedAccessException

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

IOException

Úroveň vnoření překračuje 510.

-nebo-

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

Poznámky

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

Upozornění

Nevystavujte RegistryKey objekty takovým způsobem, aby škodlivý program mohl vytvořit tisíce bezvýznamných podklíčů nebo párů klíč/hodnota. Například neumožňují volajícím vstupovat do libovolného klíče nebo hodnoty.

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.

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.

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

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ý (nelze získat přístup k uzavřeným klíčům).

UnauthorizedAccessException

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

IOException

Úroveň vnoření překračuje 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í nutná k vytvoření nebo otevření klíče registru.

Poznámky

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

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.

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);

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

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.

Výjimky

ArgumentNullException

subkey je null.

ObjectDisposedException

Aktuální RegistryKey objekt je zavřený. K uzavřeným klíčům nelze získat přístup.

UnauthorizedAccessException

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

IOException

Úroveň vnoření překračuje 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í nutná k vytvoření nebo otevření klíče registru.

Poznámky

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