Udostępnij za pośrednictwem

RegistryKey.GetSubKeyNames Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
Microsoft.Win32
Zestaw:
Microsoft.Win32.Registry.dll
Zestaw:
mscorlib.dll
Źródło:
RegistryKey.cs

Pobiera tablicę ciągów zawierających wszystkie nazwy podklucza.

public:
 cli::array <System::String ^> ^ GetSubKeyNames();
public string[] GetSubKeyNames ();
member this.GetSubKeyNames : unit -> string[]
Public Function GetSubKeyNames () As String()

Zwraca

String[]

Tablica ciągów, która zawiera nazwy podklucza dla bieżącego klucza.

Wyjątki

SecurityException

Użytkownik nie ma uprawnień wymaganych do odczytu z klucza.

ObjectDisposedException

Manipulowanie RegistryKey jest zamykane (nie można uzyskać dostępu do zamkniętych kluczy).

UnauthorizedAccessException

Użytkownik nie posiada niezbędnych praw wobec rejestru.

IOException

Wystąpił błąd systemowy, na przykład bieżący klucz został usunięty.

Przykłady

Ten przykład kodu jest częścią większego przykładu podanego RegistryKey dla klasy.

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

Uwagi

Ta metoda nie rekursywnie wyszukuje nazw. Zwraca nazwy na poziomie podstawowym, z którego została wywołana.

Dotyczy

Zobacz też