RegistryKey::ToString Method ()


Retrieves a string representation of this key.

Namespace:   Microsoft.Win32
Assembly:  mscorlib (in mscorlib.dll)

virtual String^ ToString() override

Return Value

Type: System::String^

A string representing the key. If the specified key is invalid (cannot be found) then null is returned.

Exception Condition

The RegistryKey being accessed is closed (closed keys cannot be accessed).

The return value includes the registry path of the specified key and the hexadecimal value for the key. The registry path includes the absolute root of the specified key, always starts at one of the base keys for the registry, for example, HKEY_LOCAL_MACHINE.

This code example is part of a larger example provided for the RegistryKey class.

// Delete or close the new subkey.
Console::Write( "\nDelete newly created registry key? (Y/N) " );
if ( Char::ToUpper( Convert::ToChar( Console::Read() ) ) == 'Y' )
   Registry::CurrentUser->DeleteSubKeyTree( "Test9999" );
   Console::WriteLine( "\nRegistry key {0} deleted.", test9999->Name );
   Console::WriteLine( "\nRegistry key {0} closed.", test9999->ToString() );

.NET Framework
Available since 1.1
Return to top