RegistryKey::GetValueNames Method ()
Retrieves an array of strings that contains all the value names associated with this key.
Assembly: mscorlib (in mscorlib.dll)
Return Value
Type: array<System::String^>^An array of strings that contains the value names for the current key.
| Exception | Condition |
|---|---|
| SecurityException | The user does not have the permissions required to read from the registry key. |
| ObjectDisposedException | The RegistryKey being manipulated is closed (closed keys cannot be accessed). |
| UnauthorizedAccessException | The user does not have the necessary registry rights. |
| IOException | A system error occurred; for example, the current key has been deleted. |
If no value names for the key are found, an empty array is returned.
A registry key can have a default value — that is, a name/value pair in which the name is the empty string (""). If a default value has been set for a registry key, the array returned by the GetValueNames method includes the empty string.
This code example is part of a larger example provided for the RegistryKey class.
// 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() ); } }
for the ability to read from the registry. Associated enumeration: RegistryPermissionAccess::Read
Available since 1.1