GetAllSettings 函式

發行項
08/21/2008

更新：2007 年 11 月

從 Windows 登錄中的應用程式項目傳回機碼設定的清單以及其個別的值 (原由 SaveSetting 所建立)。

使用 My 功能可以提供比 GetAllSettings 更強大的登錄作業產能和效能。如需詳細資訊，請參閱 My.Computer.Registry 物件。

Public Function GetAllSettings( _
   ByVal AppName As String, _ 
   ByVal Section As String _
) As String(,)

參數

AppName
必要項。String 運算式，包含應用程式名稱或是要求機碼設定的專案名稱。
Section
必要項。String 運算式包含要求的機碼設定所屬的區段名稱。GetAllSettings 可傳回內含二維字串陣列的物件。字串包含指定區段中的所有機碼設定及其對應值。

例外狀況

例外狀況類型	錯誤代碼	條件
ArgumentException	5	使用者未登入。

如果將使用非結構化錯誤處理的 Visual Basic 6.0 應用程式升級，請參閱「錯誤代碼」資料行 (您可以將錯誤代碼與 Number 屬性 (Err 物件) 比對)。但是，請盡可能考慮以 Visual Basic 的結構化例外處理概觀取代這類錯誤控制項。

備註

若不存在 AppName 或 Section，GetAllSettings 會傳回未初始化的 Object。

因為 GetAllSettings 是在 HKEY_LOCAL_USER 登錄機碼 (Registry Key) 下作業，所以它會要求使用者登入，而這個機碼要等到使用者以互動方式登入時才會作用。

要從非互動式處理序 (例如 Mtx.exe) 存取的登錄設定應該存放在 HKEY_LOCAL_MACHINE\Software\ 或 HKEY_USER\DEFAULT\Software 登錄機碼 (Registry Key) 之下。

範例

這個範例會先使用 SaveSetting 函式在 Windows 登錄中被指定為 AppName 的應用程式建立項目，然後使用 GetAllSettings 函式來顯示設定。請注意，不能以 GetAllSettings 擷取應用程式名稱和 Section 名稱。最後，DeleteSetting 函式會移除應用程式的項目。

' Object to hold 2-dimensional array returned by GetAllSettings.
' Integer to hold counter.
Dim MySettings(,) As String
Dim intSettings As Integer
' Place some settings in the registry.
SaveSetting("MyApp", "Startup", "Top", "75")
SaveSetting("MyApp", "Startup", "Left", "50")
' Retrieve the settings.
MySettings = GetAllSettings("MyApp", "Startup")
For intSettings = LBound(MySettings, 1) To UBound(MySettings, 1)
   WriteLine(1, MySettings(intSettings, 0))
   WriteLine(1, MySettings(intSettings, 1))
Next intSettings
DeleteSetting("MyApp")