Interaction.GetSetting(String, String, String, String) 方法

定义

命名空间:

Microsoft.VisualBasic

程序集:

Microsoft.VisualBasic.Core.dll

Source:

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 为零长度字符串（“）。

返回

String

Windows 注册表中应用程序条目中的键设置值。

My 功能使注册表操作的工作效率和性能高于 GetAllSettings。

属性

SupportedOSPlatformAttribute

例外

ArgumentException

一个或多个参数不是 String 表达式，或者用户未登录。

示例

此示例首先使用 SaveSetting 函数为指定为 AppName的应用程序创建 Windows 注册表中的条目，然后使用 GetSetting 函数显示其中一个设置。 由于指定了 Default 参数，因此保证返回某些值。 请注意，无法使用 GetSetting检索 Section 名称。 最后，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）