RegistryKey.GetSubKeyNames Méthode

Référence

Définition

Espace de noms:: Microsoft.Win32

Assembly:: Microsoft.Win32.Registry.dll

Assembly:: mscorlib.dll

Source:: RegistryKey.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Récupère un tableau de chaînes qui contient tous les noms de sous-clés.

public:
 cli::array <System::String ^> ^ GetSubKeyNames();

public string[] GetSubKeyNames ();

member this.GetSubKeyNames : unit -> string[]

Public Function GetSubKeyNames () As String()

Retours

String[]

Tableau de chaînes qui contient les noms des sous-clés pour la clé active.

Exceptions

SecurityException

L'utilisateur n'a pas les autorisations requises pour lire dans la clé.

ObjectDisposedException

Le RegistryKey en cours de manipulation est fermé (les clés fermées ne sont pas accessibles).

UnauthorizedAccessException

L'utilisateur ne dispose pas des droits d'accès à la base de registres appropriés.

IOException

Une erreur système s'est produite, telle que la suppression de la clé actuelle.

Exemples

Cet exemple de code fait partie d’un exemple plus grand fourni pour la RegistryKey classe .

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

   }
}

// 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());
        }
    }
}

' 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

Remarques

Cette méthode ne trouve pas de noms de manière récursive. Il retourne les noms du niveau de base à partir duquel il a été appelé.

S’applique à

Produit	Versions
.NET	Core 1.0, Core 1.1, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop	3.0, 3.1, 5

Partager via