My.Computer.Registry.SetValue メソッド

更新 : 2007 年 11 月

レジストリ キーに値を書き込みます。

' Usage
My.Computer.Registry.SetValue(keyName ,valueName ,value)
My.Computer.Registry.SetValue(keyName ,valueName ,value ,valueKind)
' Declaration
Public Sub SetValue( _
   ByVal keyName As String, _
   ByVal valueName As String, _
   ByVal value As Object _
)
' -or-
Public Sub SetValue( _
   ByVal keyName As String, _
   ByVal valueName As String, _
   ByVal value As Object, _
   ByVal valueKind As Microsoft.Win32.RegistryValueKind _
)

パラメータ

• keyName
  String です。書き込むキーの名前です。必ず指定します。

• valueName
  String です。書き込む値の名前です。必ず指定します。

• value
  Object です。書き込む値です。必ず指定します。

• valueKind
  RegistryValueKind です。必ず指定します。

解説

指定されたキーまたは値が存在しないときは、新たに作成されます。

例外

次の条件を満たす場合は、例外が発生する可能性があります。

• キーの名前が Nothing (ArgumentNullException) である場合。

• キー名が 255 文字の制限を超えている場合 (ArgumentException)

• このハイブは無効 (ArgumentException) です。

• キーが閉じている場合 (IOException)

• パスが無効 (IOException) です。

• レジストリ キーが読み取り専用の場合 (UnauthorizedAccessException)

処理手順

My.Computer.Registry.SetValue メソッドに関連するタスクの例を次の表に示します。

タスク	参照項目
レジストリ キーの値を設定する	方法 : Visual Basic でレジストリ キーを作成し、値を設定する

使用例

この例では、HKEY_LOCAL_MACHINE\Software\MyCompany\Preferences キーの FontColor に "赤" を設定します。

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

必要条件

名前空間 : Microsoft.VisualBasic.MyServices

クラスRegistryProxy (Registry へのアクセスを提供します)

アセンブリ : Visual Basic ランタイム ライブラリ (Microsoft.VisualBasic.dll)

アクセス許可

次のアクセス許可が必要になる場合があります。

アクセス許可	説明
RegistryPermission	レジストリへのアクセスを制御します。関連する列挙体は、RegistryPermissionAccess.Write、RegistryPermissionAccess.Create です。

詳細については、「コード アクセス セキュリティ」および「アクセス許可の要求」を参照してください。

参照

処理手順

トラブルシューティング : レジストリの操作

概念

一般的なレジストリ タスク

セキュリティとレジストリ

My を使用したレジストリからの読み取りとレジストリへの書き込み

レジストリ アクセス (Visual Basic 6.0 ユーザー向け)

参照

My.Computer.Registry オブジェクト

Microsoft.Win32.RegistryValueKind

Registry.SetValue