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

定義

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

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

public:
 static cli::array <System::String ^, 2> ^ GetAllSettings(System::String ^ AppName, System::String ^ Section);
public static string[,] GetAllSettings(string AppName, string Section);
static member GetAllSettings : string * string -> string[,]
Public Function GetAllSettings (AppName As String, Section As String) As String(,)

パラメーター

AppName
String

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

Section
String

必須。 String キー設定が要求されるセクションの名前を含む式。 GetAllSettings は、文字列の 2 次元配列を含むオブジェクトを返します。 文字列には、指定したセクションのすべてのキー設定と、それに対応する値が含まれます。

返品

String[,]

Windows レジストリ内のアプリケーションのエントリから取得したキー設定とそれぞれの値 (最初は SaveSetting で作成されたもの) の一覧。

My機能を使用すると、GetAllSettingsよりもレジストリ操作の生産性とパフォーマンスが向上します。 詳細については、Registryを参照してください。

例外

ArgumentException

ユーザーがログインしていません。

例

この例では、最初に SaveSetting 関数を使用して、AppName として指定されたアプリケーションのWindows レジストリにエントリを作成し、次に GetAllSettings 関数を使用して設定を表示します。 アプリケーション名と Section 名は、 GetAllSettingsで取得できないことに注意してください。 最後に、 DeleteSetting 関数は、アプリケーションのエントリを削除します。

' Object to hold 2-dimensional array returned by GetAllSettings.
' Integer to hold counter.
Dim MySettings(,) As String
Dim intSettings As Integer
' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Retrieve the settings.
MySettings = GetAllSettings("MyApp", "Startup")
For intSettings = LBound(MySettings, 1) To UBound(MySettings, 1)
    WriteLine(1, MySettings(intSettings, 0))
    WriteLine(1, MySettings(intSettings, 1))
Next intSettings
DeleteSetting("MyApp")

注釈

GetAllSettingsは、AppNameまたはSectionが存在しない場合、初期化されていないObjectを返します。

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

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

適用対象

こちらもご覧ください