RegistryKey::SubKeyCount Property
.NET Framework (current version)
Retrieves the count of subkeys of the current key.
Assembly: mscorlib (in mscorlib.dll)
| Exception | Condition |
|---|---|
| SecurityException | The user does not have read permission for the 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. |
This property does not recursively count names. It only returns the count of names on the base level from which it was called.
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() ); } }
RegistryPermission
for the ability to read the specified registry key. Associated enumeration: RegistryPermissionAccess::Read
.NET Framework
Available since 1.1
Available since 1.1
Show: