RegistryKey.GetValueNames Método

Definição

Namespace:

Microsoft.Win32

Assembly:

Microsoft.Win32.Registry.dll

Recupera uma matriz de cadeias de caracteres que contém todos os nomes de valor associados a essa chave.

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

public string[] GetValueNames ();

member this.GetValueNames : unit -> string[]

Public Function GetValueNames () As String()

Retornos

String[]

Uma matriz de cadeias de caracteres que contém os nomes de valores da chave atual.

Exceções

SecurityException

O usuário não tem as permissões necessárias a serem lidas na chave do Registro.

ObjectDisposedException

O RegistryKey que está sendo manipulado é fechado (chaves fechadas não podem ser acessadas).

UnauthorizedAccessException

O usuário não tem os direitos do Registro necessários.

IOException

Ocorreu um erro de sistema. Por exemplo, a chave atual foi excluída.

Exemplos

Este exemplo de código faz parte de um exemplo maior fornecido para a 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

Comentários

Se nenhum nome de valor para a chave for encontrado, uma matriz vazia será retornada.

Uma chave do Registro pode ter um valor padrão – ou seja, um par nome/valor no qual o nome é a cadeia de caracteres vazia (""). Se um valor padrão tiver sido definido para uma chave do Registro, a matriz retornada pelo GetValueNames método incluirá a cadeia de caracteres vazia.

Confira também

• GetValue(String)
• GetSubKeyNames()