Interaction.GetAllSettings(String, String) 方法

定义

命名空间:

Microsoft.VisualBasic

程序集:

Microsoft.VisualBasic.Core.dll

Source:

Interaction.vb

从 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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetAllSettings : string * string -> string[,]

Public Function GetAllSettings (AppName As String, Section As String) As String(,)

参数

AppName

String

必需。 String 表达式，包含请求其项设置的应用程序或项目的名称。

Section

String

必需。 一个 String 表达式，其中包含请求其关键设置的节的名称。 GetAllSettings 返回一个包含二维字符串数组的对象。 这些字符串包含指定节中的所有项设置及其相应的值。

返回

String[,]

Windows 注册表中某个应用程序的项中的项设置及其各自的值（最初通过 SaveSetting 创建）的列表。

与 My 相比，GetAllSettings 功能在注册表操作方面可为您提供更高的效率和更好的性能。 有关详细信息，请参阅 Registry。

属性

SupportedOSPlatformAttribute

例外

ArgumentException

用户没有登录。

示例

此示例首先使用 SaveSetting 函数在 Windows 注册表中为指定为 AppName的应用程序创建条目，然后使用 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如果 AppName 或 Section 不存在，则返回未初始化Object的 。

由于它在注册表项下 HKEY_LOCAL_USER 运行（在用户以交互方式登录之前不处于活动状态）， GetAllSettings 因此要求用户登录。

要从非交互式进程 (（如 Mtx.exe) ）访问的注册表设置应存储在 或 注册表项下HKEY_LOCAL_MACHINE\Software\HKEY_USER\DEFAULT\Software。

另请参阅

• DeleteSetting(String, String, String)
• GetSetting(String, String, String, String)
• SaveSetting(String, String, String, String)
• ArgumentException
• 读取和写入注册表 (Visual Basic)