RegistryKey.GetValueNames Methode

Definition

Namespace:
Microsoft.Win32
Assembly:
mscorlib.dll

Ruft ein Array von Zeichenfolgen ab, das alle Wertnamen enthält, die diesem Schlüssel zugeordnet sind.

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

Gibt zurück

String[]

Ein Array von Zeichenfolgen, das die Wertnamen für den aktuellen Schlüssel enthält.

Ausnahmen

SecurityException

Der Benutzer verfügt nicht über die erforderlichen Berechtigungen zum Lesen aus dem Registrierungsschlüssel.

ObjectDisposedException

Die RegistryKey Bearbeitung wird geschlossen (auf geschlossene Schlüssel kann nicht zugegriffen werden).

UnauthorizedAccessException

Der Benutzer verfügt nicht über die erforderlichen Registrierungsrechte.

IOException

Ein Systemfehler ist aufgetreten; Beispielsweise wurde der aktuelle Schlüssel gelöscht.

Beispiele

Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die RegistryKey Klasse bereitgestellt wird.

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

Hinweise

Wenn keine Wertnamen für den Schlüssel gefunden werden, wird ein leeres Array zurückgegeben.

Ein Registrierungsschlüssel kann einen Standardwert haben , d. d. a. ein Name/Wert-Paar, in dem der Name die leere Zeichenfolge ("") ist. Wenn für einen Registrierungsschlüssel ein Standardwert festgelegt wurde, enthält das von der GetValueNames Methode zurückgegebene Array die leere Zeichenfolge.

Gilt für:

Weitere Informationen