Interaction.GetSetting(String, String, String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
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
を使用した場合より生産性とパフォーマンスが向上します。
- 属性
例外
文字列型 (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
には が必要 Read
RegistryPermissionです。
適用対象
こちらもご覧ください
.NET
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示