RegistryKey.GetSubKeyNames Метод

Определение

Пространство имен:

Microsoft.Win32

Сборка:

Microsoft.Win32.Registry.dll

Возвращает массив строк, который содержит все имена подразделов.

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

public string[] GetSubKeyNames ();

member this.GetSubKeyNames : unit -> string[]

Public Function GetSubKeyNames () As String()

Возвращаемое значение

String[]

Массив строк, который содержит имена подразделов для текущего раздела.

Исключения

SecurityException

У пользователя отсутствуют разрешения, необходимые для чтения из раздела.

ObjectDisposedException

Объект RegistryKey, с которым выполняются действия, закрыт (доступ к закрытым разделам отсутствует).

UnauthorizedAccessException

У пользователя отсутствуют необходимые права доступа к реестру.

IOException

Произошла системная ошибка, например, был удален текущий раздел.

Примеры

Этот пример входит в состав более крупного примера использования класса RegistryKey.

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

Комментарии

Этот метод не выполняет рекурсивный поиск имен. Он возвращает имена на базовом уровне, с которого он был вызван.

См. также раздел

• SubKeyCount
• GetValueNames()