RegistryKey.GetValueNames Methode

Definitie

Naamruimte:
Microsoft.Win32
Assembly:
mscorlib.dll

Hiermee haalt u een matrix van tekenreeksen op die alle waardenamen bevat die aan deze sleutel zijn gekoppeld.

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

Retouren

String[]

Een matrix met tekenreeksen die de waardenamen voor de huidige sleutel bevat.

Uitzonderingen

SecurityException

De gebruiker beschikt niet over de vereiste machtigingen voor het lezen van de registersleutel.

ObjectDisposedException

Het RegistryKey bewerken is gesloten (gesloten sleutels kunnen niet worden geopend).

UnauthorizedAccessException

De gebruiker beschikt niet over de benodigde registerrechten.

IOException

Er is een systeemfout opgetreden; De huidige sleutel is bijvoorbeeld verwijderd.

Voorbeelden

Dit codevoorbeeld maakt deel uit van een groter voorbeeld voor de RegistryKey klasse.

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

Opmerkingen

Als er geen waardenamen voor de sleutel worden gevonden, wordt een lege matrix geretourneerd.

Een registersleutel kan een standaardwaarde hebben: een naam/waardepaar waarin de naam de lege tekenreeks ("") is. Als er een standaardwaarde is ingesteld voor een registersleutel, bevat de matrix die door de GetValueNames methode wordt geretourneerd de lege tekenreeks.

Van toepassing op

Zie ook