GetSetting 函數

套用到
Microsoft 365 Access Access 2021 Access 2019 Access 2016

注意

如果 Microsoft Jet 運算式服務以沙箱模式執行,則會停用本主題中所述的函數、方法、物件或屬性,這會防止評估可能不安全的運算式。 如需沙箱模式的詳細資訊,請在說明中搜尋「沙箱模式」。

從 Windows 登錄中的應用程式項目或 Macintosh 上的 (返回金鑰設定值,) 應用程式初始化檔案中的資訊。

語法

GetSetting (appname, section, key [, default ] )

GetSetting 函數語法具有下列引數:

引數 描述
應用程式名稱 必要。 包含要求金鑰設定之應用程式或專案名稱的字串運算式。 在 Macintosh 上,這是 [系統] 資料夾中 [喜好設定] 資料夾中初始化檔案的檔案名稱。
章節 必要。 包含找到按鍵設定之區段名稱的字串運算式。
機碼 必要。 包含要返回的金鑰設定名稱的字串運算式。
預設 可省略。 包含索引鍵設定中未設定任何值時要傳回之值的運算式。 如果省略, 預設值 會假設為零長度字串 (“”) 。

    

註解

如果 GetSetting 引數中所命名的任何項目不存在, GetSetting 會傳回 預設值。

範例

注意

下列範例示範如何在 Visual Basic for Applications (VBA) 模組中使用此函數。 如需使用 VBA 的詳細資訊,請在 [搜尋] 旁的下拉式清單中選取 [開發人員參考],並在 [搜尋] 方塊中輸入一個或多個字詞。

此範例會先使用 SaveSetting 陳述式,在 Windows 登錄 (或 16 位元 Windows 平台上的 .ini 檔案中,為指定為 appname 的應用程式) 項目,然後使用 GetSetting 函式顯示其中一個設定。 因為指定 了預設 引數,所以保證會傳回某些值。 請注意,您無法使用 GetSetting 來擷取區段名稱。 最後, DeleteSetting 陳述式會移除所有應用程式的項目。

' Variant to hold 2-dimensional array returned 
' by GetSetting.
Dim MySettings As Variant
' Place some settings in the registry.
SaveSetting "MyApp","Startup", "Top", 75
SaveSetting "MyApp","Startup", "Left", 50
Debug.Print GetSetting(appname := "MyApp", _
            section := "Startup", _
            key := "Left", default := "25")
DeleteSetting "MyApp", "Startup"