RegistryProxy.SetValue Yöntem

Tanım

Ad Alanı:

Microsoft.VisualBasic.MyServices

Bütünleştirilmiş Kod:

Microsoft.VisualBasic.Forms.dll

Kayıt defteri anahtarına bir değer yazar.

Aşırı Yüklemeler

SetValue(String, String, Object)	Kayıt defteri anahtarına bir değer yazar.
SetValue(String, String, Object, RegistryValueKind)	Kayıt defteri anahtarına bir değer yazar.

SetValue(String, String, Object)

Kayıt defteri anahtarına bir değer yazar.

public:
 void SetValue(System::String ^ keyName, System::String ^ valueName, System::Object ^ value);

public void SetValue (string keyName, string valueName, object value);

member this.SetValue : string * string * obj -> unit

Public Sub SetValue (keyName As String, valueName As String, value As Object)

Parametreler

keyName

String

String. Yazılacak anahtarın adı. Gereklidir.

valueName

String

String. Yazılacak değerin adı. Gereklidir.

value

Object

Object. Yazılacak değer. Gereklidir.

Özel durumlar

ArgumentNullException

value, Nothing değeridir.

ArgumentException

keyName geçerli bir kayıt defteri köküyle başlamaz.

-veya-

valueName izin verilen uzunluk üst sınırından (255 karakter) daha uzundur.

UnauthorizedAccessException

RegistryKey salt okunurdur ve bu nedenle yazılamaz; örneğin, kök düzeyinde bir düğümdür veya yazma erişimiyle açılmamıştır.

SecurityException

Kullanıcının kayıt defteri anahtarlarını oluşturmak veya değiştirmek için gereken izinleri yok.

Örnekler

Bu örnek, anahtarındaki HKEY_LOCAL_MACHINE\Software\MyCompany\Preferencesdeğerini FontColor "kırmızı" olarak ayarlar.

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

Açıklamalar

Belirtilen anahtar veya değer yoksa oluşturulur.

Aşağıda yöntemini içeren bir görev örneği verilmiştir My.Computer.Registry.SetValue .

Amaç	Bkz.
Kayıt defteri anahtarında değer ayarlama	Nasıl yapılır: Kayıt Defteri Anahtarı Oluşturma ve Değerini Ayarlama

Ayrıca bkz.

• RegistryValueKind
• SetValue
• Nesneler (Visual Basic)
• Kayıt Defterini Okuma ve Yazma (Visual Basic)
• Güvenlik ve Kayıt Defteri (Visual Basic)

SetValue(String, String, Object, RegistryValueKind)

Kayıt defteri anahtarına bir değer yazar.

public:
 void SetValue(System::String ^ keyName, System::String ^ valueName, System::Object ^ value, Microsoft::Win32::RegistryValueKind valueKind);

public void SetValue (string keyName, string valueName, object value, Microsoft.Win32.RegistryValueKind valueKind);

member this.SetValue : string * string * obj * Microsoft.Win32.RegistryValueKind -> unit

Public Sub SetValue (keyName As String, valueName As String, value As Object, valueKind As RegistryValueKind)

Parametreler

keyName

String

String. Yazılacak anahtarın adı. Gereklidir.

valueName

String

String. Yazılacak değerin adı. Gereklidir.

value

Object

Object. Yazılacak değer. Gereklidir.

valueKind

RegistryValueKind

RegistryValueKind. Gereklidir.

Özel durumlar

ArgumentNullException

value, Nothing değeridir.

ArgumentException

keyName geçerli bir kayıt defteri köküyle başlamaz.

-veya-

keyName izin verilen uzunluk üst sınırından (255 karakter) daha uzundur.

-veya-

türü value tarafından belirtilen kayıt defteri veri türüyle valueKindeşleşmiyor, bu nedenle veriler düzgün dönüştürülemiyor.

UnauthorizedAccessException

RegistryKey salt okunurdur ve bu nedenle yazılamaz; örneğin, kök düzeyinde bir düğümdür veya yazma erişimiyle açılmamıştır.

SecurityException

Kullanıcının kayıt defteri anahtarlarını oluşturmak veya değiştirmek için gereken izinleri yok.

Örnekler

Bu örnek, anahtarındaki HKEY_LOCAL_MACHINE\Software\MyCompany\Preferencesdeğerini FontColor "kırmızı" olarak ayarlar.

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

Açıklamalar

Belirtilen anahtar veya değer yoksa oluşturulur.

Aşağıda yöntemini içeren bir görev örneği verilmiştir My.Computer.Registry.SetValue .

Amaç	Bkz.
Kayıt defteri anahtarında değer ayarlama	Nasıl yapılır: Kayıt Defteri Anahtarı Oluşturma ve Değerini Ayarlama

Ayrıca bkz.

• RegistryValueKind
• SetValue
• Nesneler (Visual Basic)
• Kayıt Defterini Okuma ve Yazma (Visual Basic)
• Güvenlik ve Kayıt Defteri (Visual Basic)