Interaction.GetSetting(String, String, String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows レジストリ内のアプリケーションのエントリからキー設定値を返します。
My機能を使用すると、GetAllSettingsよりもレジストリ操作の生産性とパフォーマンスが向上します。 詳細については、Registryを参照してください。
public static string GetSetting(string AppName, string Section, string Key, string Default = "");
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引数で指定された項目のいずれかが存在しない場合、GetSettingは Default の値を返します。
ユーザーが対話形式でログオンするまでアクティブではない HKEY_LOCAL_USER レジストリ キーで動作するため、 GetSetting ユーザーがログオンする必要があります。
非対話型プロセス (Mtx.exeなど) からアクセスするレジストリ設定は、 HKEY_LOCAL_MACHINE\Software\ または HKEY_USER\DEFAULT\Software レジストリ キーのいずれかに格納する必要があります。
GetSetting には ReadRegistryPermissionが必要です。