RegistryKey.GetValueNames Método

Definição

Espaço de Nomes:
Microsoft.Win32
Assemblagem:
mscorlib.dll

Recupera um array de cadeias que contém todos os nomes de valores associados a esta chave.

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

Devoluções

String[]

Um array de cadeias que contém os nomes dos valores da chave atual.

Exceções

SecurityException

O utilizador não tem as permissões necessárias para ler da chave do registo.

ObjectDisposedException

O RegistryKey ser manipulado é fechado (as chaves fechadas não podem ser acedidas).

UnauthorizedAccessException

O utilizador não tem os direitos necessários no registo.

IOException

Ocorreu um erro do sistema; por exemplo, a chave atual foi eliminada.

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

Observações

Se não forem encontrados nomes de valor para a chave, um array vazio é devolvido.

Uma chave de registo pode ter um valor predefinido – ou seja, um par nome/valor em que o nome é a cadeia vazia (""). Se foi definido um valor por defeito para uma chave de registo, o array devolvido pelo GetValueNames método inclui a cadeia vazia.

Aplica-se a

Ver também