Interaction.GetSetting(String, String, String, String) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
从 Windows 注册表中的应用程序条目中返回一个键设置值。
My 功能使注册表操作的工作效率和性能高于 GetAllSettings。 有关详细信息,请参阅 Registry。
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string? GetSetting(string AppName, string Section, string Key, string? Default = "");
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
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 为零长度字符串(“)。
返回
Windows 注册表中应用程序条目中的键设置值。
My 功能使注册表操作的工作效率和性能高于 GetAllSettings。
- 属性
例外
一个或多个参数不是 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。