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

定義

名前空間:
Microsoft.VisualBasic
アセンブリ:
Microsoft.VisualBasic.dll

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

public:
 static void SaveSetting(System::String ^ AppName, System::String ^ Section, System::String ^ Key, System::String ^ Setting);
public static void SaveSetting(string AppName, string Section, string Key, string Setting);
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が設定されている値を含む式。

例外

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が必要です。

適用対象

こちらもご覧ください