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
自變數,因此保證會傳回某些值。 請注意,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。