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

定義

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? GetSetting (string AppName, string Section, string Key, string? Default = "");
public static string GetSetting (string AppName, string Section, string Key, string Default = "");
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetSetting : string * string * string * string -> string
static member GetSetting : string * string * string * string -> string
Public Function GetSetting (AppName As String, Section As String, Key As String, Optional Default As String = "") As String

パラメーター

AppName
String

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

Section
String

必須。 String キー設定が見つかったセクションの名前を含む式です。

Key
String

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

Default
String

随意。 Key 設定で値が設定されていない場合に返す値を含む式。 省略した場合、Default は長さ 0 の文字列 ("") と見なされます。

戻り値

Windows レジストリ内のアプリケーションのエントリからのキー設定値。

My 機能を使用すると、GetAllSettingsよりもレジストリ操作の生産性とパフォーマンスが向上します。

属性

例外

1 つ以上の引数が式 String されていないか、ユーザーがログインしていません。

この例では、最初に SaveSetting 関数を使用して、AppNameとして指定されたアプリケーションの Windows レジストリにエントリを作成し、次に GetSetting 関数を使用していずれかの設定を表示します。 Default 引数が指定されているため、一部の値が確実に返されます。 Section 名は GetSettingで取得できないことに注意してください。 最後に、DeleteSetting 関数は、アプリケーションのすべてのエントリを削除します。

' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
Console.WriteLine(GetSetting("MyApp", "Startup", "Left", "25"))
DeleteSetting("MyApp")

注釈

GetSetting 引数で指定された項目のいずれかが存在しない場合、GetSettingDefaultの値を返します。

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

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

GetSetting には ReadRegistryPermissionが必要です。

適用対象

こちらもご覧ください