RegistryKey.GetSubKeyNames Método

Definición

Espacio de nombres:
Microsoft.Win32
Ensamblado:
Microsoft.Win32.Registry.dll
Ensamblado:
mscorlib.dll
Paquete:
Microsoft.Win32.Registry v5.0.0
Source:
RegistryKey.cs

Recupera una matriz de cadenas que contiene todos los nombres de subclave.

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

Devoluciones

String[]

Matriz de cadenas que contiene los nombres de las subclaves de la clave actual.

Excepciones

SecurityException

El usuario no tiene los permisos necesarios para leer desde la clave.

ObjectDisposedException

El RegistryKey objeto que se está manipulando está cerrado (no se puede acceder a las claves cerradas).

UnauthorizedAccessException

El usuario no tiene los derechos del Registro necesarios.

IOException

Se ha producido un error del sistema, por ejemplo, se ha eliminado la clave actual.

Ejemplos

Este ejemplo de código forma parte de un ejemplo más grande proporcionado para la RegistryKey clase .

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

Comentarios

Este método no busca nombres de forma recursiva. Devuelve los nombres en el nivel base desde el que se llamó.

Se aplica a

Consulte también