Edit

Share via


RegistryProxy.LocalMachine Property

Definition

Returns a RegistryKey type, which provides access to HKEY_LOCAL_MACHINE.

public:
 property Microsoft::Win32::RegistryKey ^ LocalMachine { Microsoft::Win32::RegistryKey ^ get(); };
public Microsoft.Win32.RegistryKey LocalMachine { get; }
member this.LocalMachine : Microsoft.Win32.RegistryKey
Public ReadOnly Property LocalMachine As RegistryKey

Property Value

RegistryKey

Examples

This example opens the subkey Software\MyCompany\Preferences and sets the value FontColor to "red".

My.Computer.Registry.LocalMachine.OpenSubKey(
  "Software\MyCompany\Preferences", True)
My.Computer.Registry.LocalMachine.SetValue("FontColor", "red")

Remarks

HKEY_LOCAL_MACHINE is usually used to store settings that do not vary from user to user in Windows. All users of the computer share this key. Its five subkeys (Hardware, SAM, Security, Software, and System) hold configuration data for the local machine.

The RegistryPermission class, which is in the System.Security.Permissions namespace, controls access to registry variables. Registry variables should not be stored in memory locations where code without RegistryPermission can access them. Similarly, when granting permissions, grant the fewest privileges necessary to get the job done.

Registry permission access values are defined by the RegistryPermissionAccess enumeration. The following table details its members.

Value Description
AllAccess Create, read, and write access to registry variables.
Create Create access to registry variables.
NoAccess No access to registry variables.
Read Read access to registry variables.
Write Write access to registry variables.

The following table lists examples of tasks involving the My.Computer.Registry object.

To See
Create a registry key and set its value How to: Create a Registry Key and Set Its Value
Delete a registry key How to: Delete a Registry Key
Read a value from a registry key How to: Read a Value from a Registry Key

Applies to

See also