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

定義

名前空間:

Microsoft.VisualBasic

アセンブリ:

Microsoft.VisualBasic.Core.dll

ソース:

Interaction.vb

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

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
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

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 の文字列 ("") と想定されます。

戻り値

String

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

My 機能を使用すると、GetAllSettings を使用した場合より生産性とパフォーマンスが向上します。

属性

SupportedOSPlatformAttribute

例外

ArgumentException

文字列型 (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です。

こちらもご覧ください

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