Interaction.SaveSetting(String, String, String, String) メソッド

定義

名前空間:

Microsoft.VisualBasic

アセンブリ:

Microsoft.VisualBasic.Core.dll

ソース:

Interaction.vb

Windows レジストリにアプリケーション エントリを保存または作成します。 My 機能を使用すると、SaveSettingよりもレジストリ操作の生産性とパフォーマンスが向上します。 詳細については、Registryを参照してください。

public:
 static void SaveSetting(System::String ^ AppName, System::String ^ Section, System::String ^ Key, System::String ^ Setting);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void SaveSetting (string AppName, string Section, string Key, string Setting);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member SaveSetting : string * string * string * string -> unit

Public Sub SaveSetting (AppName As String, Section As String, Key As String, Setting As String)

パラメーター

AppName

String

必須。 String 設定が適用されるアプリケーションまたはプロジェクトの名前を含む式です。

Section

String

必須。 String キー設定を保存するセクションの名前を含む式です。

Key

String

必須。 String 保存するキー設定の名前を含む式です。

Setting

String

必須。 Key が設定されている値を含む式。

属性

SupportedOSPlatformAttribute

例外

ArgumentException

キー レジストリを作成できなかったか、ユーザーがログインしていません。

例

次の例では、最初に SaveSetting 関数を使用して、MyApp アプリケーションの Windows レジストリにエントリを作成してから、DeleteSetting 関数を使用してそれらを削除します。

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Remove Startup section and all its settings from registry.
DeleteSetting("MyApp", "Startup")
' Remove MyApp from the registry.
DeleteSetting("MyApp")

注釈

SaveSetting 関数は、キーを HKEY_CURRENT_USER\Software\VB and VBA Program Settingsに追加します。

何らかの理由でキー設定を保存できない場合は、エラーが発生します。

SaveSetting は、ユーザーが対話形式でログオンするまでアクティブではない HKEY_LOCAL_USER レジストリ キーで動作するため、ログオンする必要があります。

非対話型プロセス (Mtx.exeなど) からアクセスするレジストリ設定は、HKEY_LOCAL_MACHINE\Software\ または HKEY_USER\DEFAULT\Software レジストリ キーのいずれかに格納する必要があります。

SaveSetting には Write と CreateRegistryPermissionが必要です。

こちらもご覧ください

• DeleteSetting(String, String, String)
• GetAllSettings(String, String)
• GetSetting(String, String, String, String)
• RegistryPermission
• レジストリの読み取りと書き込みの (Visual Basic)