Metodo RegistryProxy.SetValue (String, String, Object, RegistryValueKind)

 

Data di pubblicazione: novembre 2016

Scrive un valore a una chiave del Registro di sistema.

Spazio dei nomi:   Microsoft.VisualBasic.MyServices
Assembly:  Microsoft.VisualBasic (in Microsoft.VisualBasic.dll)

public void SetValue(
	string keyName,
	string valueName,
	object value,
	RegistryValueKind valueKind
)

Parametri

keyName
Type: System.String

String. Nome della chiave da scrivere. Obbligatorio.

valueName
Type: System.String

String. Nome del valore da scrivere. Obbligatorio.

value
Type: System.Object

Object. Valore da scrivere. Obbligatorio.

valueKind
Type: Microsoft.Win32.RegistryValueKind

RegistryValueKind. Obbligatorio.

Exception Condition
ArgumentNullException

value è Nothing.

ArgumentException

keyName non inizia con una radice del Registro di sistema valido.

-oppure-

keyName è maggiore della lunghezza massima consentita (255 caratteri).

-oppure-

Il tipo di value non corrisponde al tipo di dati del Registro di sistema specificato da valueKind, pertanto i dati non possono essere convertiti correttamente.

UnauthorizedAccessException

Il RegistryKey è di sola lettura e pertanto non è possibile scrivere; ad esempio, è un nodo di primo livello, o non è stato aperto con accesso in scrittura.

SecurityException

L'utente non dispone delle autorizzazioni necessarie per creare o modificare le chiavi del Registro di sistema.

Se la chiave specificata o un valore non esiste, viene creato.

Di seguito è riportato un esempio di un'attività che coinvolgono il My.Computer.Registry.SetValue metodo.

Per

Vedere

Impostare un valore in una chiave del Registro di sistema

How to: Create a Registry Key and Set Its Value in Visual Basic

In questo esempio imposta il valore FontColor su "red" nella chiave HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences.

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

RegistryPermission

to modify the specified registry key if it exists, or to create the registry key if it does not already exist. Associated enumerations: F:System.Security.Permissions.RegistryPermissionAccess.Write, F:System.Security.Permissions.RegistryPermissionAccess.Create

.NET Framework
Disponibile da 2.0
Torna all'inizio
Mostra: