RegistryKey.CreateSubKey Méthode

Définition

Espace de noms:

Microsoft.Win32

Assembly:

Microsoft.Win32.Registry.dll

Crée une sous-clé ou en ouvre une existante.

Surcharges

CreateSubKey(String)	Crée une sous-clé ou en ouvre une existante pour l'accès en écriture.
CreateSubKey(String, RegistryKeyPermissionCheck)	Crée une sous-clé ou en ouvre une existante pour l'accès en écriture, à l'aide de l'option de vérification des autorisations spécifiées.
CreateSubKey(String, Boolean)	Crée une sous-clé ou en ouvre une existante avec l’accès spécifié. Disponible à partir de .NET Framework 4.6.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)	Crée une sous-clé ou en ouvre une existante pour l'accès en écriture, à l'aide de l'option de vérification des autorisations spécifiées et de la sécurité du Registre.
CreateSubKey(String, Boolean, RegistryOptions)	Crée une sous-clé ou en ouvre une existante avec l’accès spécifié. Disponible à partir de .NET Framework 4.6.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)	Crée une sous-clé ou en ouvre une pour l'accès en écriture, à l'aide des options de vérification des autorisations et de registre spécifiées.
CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)	Crée une sous-clé ou en ouvre une pour l'accès en écriture, à l'aide de l'option de vérification des autorisations, de l'option de Registre et de la sécurité du Registre spécifiées.

CreateSubKey(String)

Crée une sous-clé ou en ouvre une existante pour l'accès en écriture.

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

Paramètres

subkey

String

Nom ou chemin d'accès de la sous-clé à créer ou ouvrir. Cette chaîne n'est pas sensible à la casse.

Retours

RegistryKey

Sous-clé nouvellement créée ou null si l’opération a échoué. Si une chaîne de longueur nulle est spécifiée pour subkey, l’objet RegistryKey actuel est retourné.

Exceptions

ArgumentNullException

subkey a la valeur null.

SecurityException

L’utilisateur n’a pas les autorisations requises pour créer ni ouvrir la clé de Registre.

ObjectDisposedException

Le RegistryKey sur lequel cette méthode est appelée est fermé (les clés fermées sont inaccessibles).

UnauthorizedAccessException

RegistryKey n'est pas accessible en écriture ; par exemple, il n'a pas été ouvert en tant que clé accessible en écriture ou l'utilisateur ne dispose pas des droits d'accès nécessaires.

IOException

Le niveau d’imbrication dépasse 510.

- ou -

Une erreur système s’est produite, telle que la suppression de la clé ou une tentative de création d’une clé dans la racine LocalMachine.

Exemples

L’exemple de code suivant montre comment créer une sous-clé sous HKEY_CURRENT_USER, manipuler son contenu, puis supprimer la sous-clé.

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

Remarques

Pour effectuer cette action, l’utilisateur doit disposer de l’autorisation à ce niveau et en dessous dans la hiérarchie du Registre.

Attention

N’exposez RegistryKey pas les objets de telle sorte qu’un programme malveillant puisse créer des milliers de sous-clés ou de paires clé/valeur inutiles. Par exemple, n’autorisez pas les appelants à entrer des clés ou des valeurs arbitraires.

Voir aussi

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

CreateSubKey(String, RegistryKeyPermissionCheck)

Crée une sous-clé ou en ouvre une existante pour l'accès en écriture, à l'aide de l'option de vérification des autorisations spécifiées.

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

Paramètres

subkey

String

Nom ou chemin d'accès de la sous-clé à créer ou ouvrir. Cette chaîne n'est pas sensible à la casse.

permissionCheck

RegistryKeyPermissionCheck

L'une des valeurs d'énumération qui spécifie si la clé est ouverte pour un accès en lecture ou en lecture/écriture.

Retours

RegistryKey

Sous-clé nouvellement créée ou null si l’opération a échoué. Si une chaîne de longueur nulle est spécifiée pour subkey, l’objet RegistryKey actuel est retourné.

Exceptions

ArgumentNullException

subkey a la valeur null.

SecurityException

L’utilisateur n’a pas les autorisations requises pour créer ni ouvrir la clé de Registre.

ArgumentException

permissionCheck contient une valeur non valide.

ObjectDisposedException

Le RegistryKey sur lequel cette méthode est appelée est fermé (les clés fermées sont inaccessibles).

UnauthorizedAccessException

RegistryKey n’est pas accessible en écriture ; par exemple, il n’a pas été ouvert en tant que clé accessible en écriture ou l’utilisateur ne dispose pas des droits d’accès nécessaires.

IOException

Le niveau d’imbrication dépasse 510.

- ou -

Une erreur système s’est produite, telle que la suppression de la clé ou une tentative de création d’une clé dans la racine LocalMachine.

Remarques

Pour effectuer cette action, l’utilisateur doit disposer de l’autorisation à ce niveau et en dessous dans la hiérarchie du Registre.

Attention

N’exposez RegistryKey pas les objets de telle sorte qu’un programme malveillant puisse créer des milliers de sous-clés ou de paires clé/valeur inutiles. Par exemple, n’autorisez pas les appelants à entrer des clés ou des valeurs arbitraires.

Pour pouvoir utiliser la OpenSubKey méthode , vous devez disposer d’un instance de la RegistryKey classe . Pour obtenir une instance de RegistryKey, utilisez l’un des membres statiques de la Registry classe .

Voir aussi

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

CreateSubKey(String, Boolean)

Crée une sous-clé ou en ouvre une existante avec l’accès spécifié. Disponible à partir de .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

Paramètres

subkey

String

Nom ou chemin d'accès de la sous-clé à créer ou ouvrir. Cette chaîne n'est pas sensible à la casse.

writable

Boolean

true pour indiquer que la nouvelle sous-clé est accessible en écriture ; sinon, false.

Retours

RegistryKey

Sous-clé nouvellement créée ou null si l’opération a échoué. Si une chaîne de longueur nulle est spécifiée pour subkey, l’objet RegistryKey actuel est retourné.

Exceptions

ArgumentNullException

subkey a la valeur null.

SecurityException

L’utilisateur n’a pas les autorisations requises pour créer ni ouvrir la clé de Registre.

UnauthorizedAccessException

Impossible d’écrire dans la RegistryKey actuelle ; par exemple, elle n’a pas été ouverte en tant que clé accessible en écriture ou l’utilisateur ne dispose pas des droits d’accès nécessaires.

IOException

Le niveau d’imbrication dépasse 510.

- ou -

Une erreur système s’est produite, telle que la suppression de la clé ou une tentative de création d’une clé dans la racine LocalMachine.

Remarques

Pour effectuer cette action, l’utilisateur doit disposer de l’autorisation à ce niveau et en dessous dans la hiérarchie du Registre.

Attention

N’exposez RegistryKey pas les objets de telle sorte qu’un programme malveillant puisse créer des milliers de sous-clés ou de paires clé/valeur inutiles. Par exemple, n’autorisez pas les appelants à entrer des clés ou des valeurs arbitraires.

Pour pouvoir utiliser la CreateSubKey méthode , vous devez disposer d’un instance de la RegistryKey classe . Pour obtenir une instance de RegistryKey, utilisez l’un des membres statiques de la Registry classe .

CreateSubKey(String, RegistryKeyPermissionCheck, RegistrySecurity)

Crée une sous-clé ou en ouvre une existante pour l'accès en écriture, à l'aide de l'option de vérification des autorisations spécifiées et de la sécurité du Registre.

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

Paramètres

subkey

String

Nom ou chemin d'accès de la sous-clé à créer ou ouvrir. Cette chaîne n'est pas sensible à la casse.

permissionCheck

RegistryKeyPermissionCheck

L'une des valeurs d'énumération qui spécifie si la clé est ouverte pour un accès en lecture ou en lecture/écriture.

registrySecurity

RegistrySecurity

Sécurité du contrôle d'accès pour la nouvelle clé.

Retours

RegistryKey

Sous-clé nouvellement créée ou null si l’opération a échoué. Si une chaîne de longueur nulle est spécifiée pour subkey, l’objet RegistryKey actuel est retourné.

Exceptions

ArgumentNullException

subkey a la valeur null.

SecurityException

L’utilisateur n’a pas les autorisations requises pour créer ni ouvrir la clé de Registre.

ArgumentException

permissionCheck contient une valeur non valide.

ObjectDisposedException

Le RegistryKey sur lequel cette méthode est appelée est fermé (les clés fermées sont inaccessibles).

UnauthorizedAccessException

Impossible d’écrire dans la RegistryKey actuelle ; par exemple, elle n’a pas été ouverte en tant que clé accessible en écriture ou l’utilisateur ne dispose pas des droits d’accès nécessaires.

IOException

Le niveau d’imbrication dépasse 510.

- ou -

Une erreur système s’est produite, telle que la suppression de la clé ou une tentative de création d’une clé dans la racine LocalMachine.

Remarques

La CreateSubKey méthode crée une clé de Registre dont le contrôle d’accès est spécifié par le registrySecurity paramètre . L’objet RegistryKey retourné représente la clé de Registre, mais cet objet n’est pas limité par le contrôle d’accès spécifié dans le registrySecurity paramètre .

Si permissionCheck a la valeur RegistryKeyPermissionCheck.ReadWriteSubTree, la clé est ouverte pour l’accès en lecture/écriture. Si permissionCheck a la valeur RegistryKeyPermissionCheck.ReadSubTree, la clé est ouverte pour l’accès en lecture.

Pour la compatibilité descendante, la clé est ouverte pour la lecture et l’écriture si permissionCheck est RegistryKeyPermissionCheck.Default et si la clé parent a RegistryKeyPermissionCheck.Defaultégalement . Si la clé parente a un autre paramètre, la status en lecture/écriture est contrôlée par le paramètre de la clé parente.

Pour effectuer cette action, l’utilisateur doit disposer d’autorisations à ce niveau et en dessous dans la hiérarchie du Registre.

Attention

N’exposez RegistryKey pas les objets de telle sorte qu’un programme malveillant puisse créer des milliers de sous-clés ou de paires clé/valeur inutiles. Par exemple, n’autorisez pas les appelants à entrer des clés ou des valeurs arbitraires.

Pour utiliser la OpenSubKey méthode, vous devez disposer d’une instance de la RegistryKey classe . Pour obtenir une instance de RegistryKey, utilisez l’un des membres statiques de la Registry classe .

Voir aussi

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

CreateSubKey(String, Boolean, RegistryOptions)

Crée une sous-clé ou en ouvre une existante avec l’accès spécifié. Disponible à partir de .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

Paramètres

subkey

String

Nom ou chemin d'accès de la sous-clé à créer ou ouvrir. Cette chaîne n'est pas sensible à la casse.

writable

Boolean

true pour indiquer que la nouvelle sous-clé est accessible en écriture ; sinon, false.

options

RegistryOptions

Option de Registre à utiliser.

Retours

RegistryKey

Sous-clé nouvellement créée ou null si l’opération a échoué. Si une chaîne de longueur nulle est spécifiée pour subkey, l’objet RegistryKey actuel est retourné.

Exceptions

ArgumentNullException

subkey a la valeur null.

ArgumentException

options ne spécifie pas d’option valide.

SecurityException

L’utilisateur n’a pas les autorisations requises pour créer ni ouvrir la clé de Registre.

UnauthorizedAccessException

Impossible d’écrire dans la RegistryKey actuelle ; par exemple, elle n’a pas été ouverte en tant que clé accessible en écriture ou l’utilisateur ne dispose pas des droits d’accès nécessaires.

IOException

Le niveau d’imbrication dépasse 510.

- ou -

Une erreur système s’est produite, telle que la suppression de la clé ou une tentative de création d’une clé dans la racine LocalMachine.

Remarques

Pour effectuer cette action, l’utilisateur doit disposer de l’autorisation à ce niveau et au-dessous dans la hiérarchie du Registre.

Attention

N’exposez pas d’objets RegistryKey de telle sorte qu’un programme malveillant puisse créer des milliers de sous-clés ou de paires clé/valeur sans signification. Par exemple, n’autorisez pas les appelants à entrer des clés ou des valeurs arbitraires.

Pour utiliser la CreateSubKey méthode, vous devez disposer d’une instance de la RegistryKey classe . Pour obtenir une instance de RegistryKey, utilisez l’un des membres statiques de la Registry classe .

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions)

Crée une sous-clé ou en ouvre une pour l'accès en écriture, à l'aide des options de vérification des autorisations et de registre spécifiées.

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

Paramètres

subkey

String

Nom ou chemin d'accès de la sous-clé à créer ou ouvrir.

permissionCheck

RegistryKeyPermissionCheck

L'une des valeurs d'énumération qui spécifie si la clé est ouverte pour un accès en lecture ou en lecture/écriture.

registryOptions

RegistryOptions

Option de Registre à utiliser ; par exemple, option qui crée une clé volatile.

Retours

RegistryKey

Sous-clé nouvellement créée ou null si l’opération a échoué.

Exceptions

ArgumentNullException

subkey a la valeur null.

ObjectDisposedException

L'objet RegistryKey actuel est fermé (les clés fermées ne sont pas accessibles).

UnauthorizedAccessException

L'objet RegistryKey actuel n'est pas accessible en écriture ; par exemple, il n'a pas été ouvert en tant que clé accessible en écriture ou l'utilisateur ne dispose pas des droits d'accès requis.

IOException

Le niveau d’imbrication dépasse 510.

- ou -

Une erreur système s'est produite, telle que la suppression de la clé ou une tentative de création d'une clé à la racine de LocalMachine.

SecurityException

L’utilisateur n’a pas les autorisations requises pour créer ni ouvrir la clé de Registre.

Remarques

Pour obtenir l’objet actuel RegistryKey , spécifiez une chaîne vide («  ») pour subkey.

CreateSubKey(String, RegistryKeyPermissionCheck, RegistryOptions, RegistrySecurity)

Crée une sous-clé ou en ouvre une pour l'accès en écriture, à l'aide de l'option de vérification des autorisations, de l'option de Registre et de la sécurité du Registre spécifiées.

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

Paramètres

subkey

String

Nom ou chemin d'accès de la sous-clé à créer ou ouvrir.

permissionCheck

RegistryKeyPermissionCheck

L'une des valeurs d'énumération qui spécifie si la clé est ouverte pour un accès en lecture ou en lecture/écriture.

registryOptions

RegistryOptions

Option de Registre à utiliser.

registrySecurity

RegistrySecurity

Sécurité du contrôle d'accès pour la nouvelle sous-clé.

Retours

RegistryKey

Sous-clé nouvellement créée ou null si l’opération a échoué.

Exceptions

ArgumentNullException

subkey a la valeur null.

ObjectDisposedException

L'objet RegistryKey actuel est fermé. Les clés fermées ne sont pas accessibles.

UnauthorizedAccessException

L'objet RegistryKey actuel n'est pas accessible en écriture ; par exemple, il n'a pas été ouvert en tant que clé accessible en écriture ou l'utilisateur ne dispose pas des droits d'accès requis.

IOException

Le niveau d’imbrication dépasse 510.

- ou -

Une erreur système s'est produite, telle que la suppression de la clé ou une tentative de création d'une clé à la racine de LocalMachine.

SecurityException

L’utilisateur n’a pas les autorisations requises pour créer ni ouvrir la clé de Registre.

Remarques

Pour obtenir l’objet actuel RegistryKey , spécifiez une chaîne vide («  ») pour subkey.