Interaction.GetAllSettings(String, String) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
Windows レジストリのアプリケーションのエントリから、キー設定のリストと各キー設定の値 (以前に SaveSetting
を使用して作成されたもの) を返します。 My
機能を使用すると、GetAllSettings
を使用した場合より生産性とパフォーマンスが向上します。 詳細については、「Registry」を参照してください。
public:
static cli::array <System::String ^, 2> ^ GetAllSettings(System::String ^ AppName, System::String ^ Section);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string[,]? GetAllSettings (string AppName, string Section);
public static string[,] GetAllSettings (string AppName, string Section);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetAllSettings : string * string -> string[,]
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 次元配列を含むオブジェクトを返します。 文字列には、指定されたセクションにあるすべてのキー設定に加え、その設定に対応する値も含まれます。
戻り値
Windows レジストリのアプリケーションのエントリからの、キー設定のリストと各キー設定の値 (以前に SaveSetting
を使用して作成されたもの)。
My
機能を使用すると、GetAllSettings
を使用した場合より生産性とパフォーマンスが向上します。 詳細については、「Registry」を参照してください。
- 属性
例外
ユーザーがログインしていません。
例
この例では、最初に 関数を SaveSetting
使用して、 として AppName
指定されたアプリケーションの Windows レジストリにエントリを作成し、 関数を GetAllSettings
使用して設定を表示します。 を使用GetAllSettings
してアプリケーション名とSection
名前を取得できないことに注意してください。 最後に、 関数は 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
または Section
が存在しない場合AppName
は、初期化Object
されていない が返されます。
ユーザーが対話形式で HKEY_LOCAL_USER
ログオンするまでアクティブではないレジストリ キーで動作するため、 GetAllSettings
ユーザーがログオンする必要があります。
非対話型プロセス (Mtx.exe など) からアクセスするレジストリ設定は、 または レジストリ キーの HKEY_LOCAL_MACHINE\Software\
下に格納する HKEY_USER\DEFAULT\Software
必要があります。
適用対象
こちらもご覧ください
.NET