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
函数在 Windows 注册表中为指定为 AppName
的应用程序创建条目,然后使用 GetSetting
函数显示其中一个设置。 Default
由于指定了 参数,因此保证返回某些值。 请注意, Section
不能使用 GetSetting
检索名称。 最后, 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
Read
RegistryPermission需要 。
适用于
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈