Interaction.GetSetting 方法

從 Windows 登錄的應用程式項目中傳回機碼設定值。My 功能可以提供比 GetAllSettings 更強大的登錄作業產能和效能。如需詳細資訊，請參閱 My.Computer.Registry 物件。

命名空間： Microsoft.VisualBasic
組件： Microsoft.VisualBasic (在 microsoft.visualbasic.dll 中)

語法

'宣告
Public Shared Function GetSetting ( _
    AppName As String, _
    Section As String, _
    Key As String, _
    <OptionalAttribute> Optional Default As String = "" _
) As String
'用途
Dim AppName As String
Dim Section As String
Dim Key As String
Dim Default As String
Dim returnValue As String

returnValue = Interaction.GetSetting(AppName, Section, Key, Default)

public static string GetSetting (
    string AppName,
    string Section,
    string Key,
    [OptionalAttribute] string Default
)

public:
static String^ GetSetting (
    String^ AppName, 
    String^ Section, 
    String^ Key, 
    [OptionalAttribute] String^ Default
)

public static String GetSetting (
    String AppName, 
    String Section, 
    String Key, 
    /** @attribute OptionalAttribute() */ String Default
)

public static function GetSetting (
    AppName : String, 
    Section : String, 
    Key : String, 
    Default : String
) : String

參數

• AppName
  必要項。String 運算式，包含要求機碼設定的應用程式或專案的名稱。

• Section
  必要項。String 運算式，包含找到機碼設定所在的區段名稱。

• Key
  必要項。String 運算式，包含要傳回的機碼設定之名稱。

• Default
  選擇項。如果未在 Key 設定中設定任何值，則為包含傳回值的運算式。如果省略，則會假設 Default 是長度為零的字串 ("")。

傳回值

從 Windows 登錄的應用程式項目中傳回機碼設定值。 My 功能可以提供比 GetAllSettings 更強大的登錄作業產能和效能。如需詳細資訊，請參閱 My.Computer.Registry 物件。

備註

如需詳細資訊，請參閱 Visual Basic 的主題 GetSetting 函式。

如果 GetSetting 引數中有任何具名的項目不存在，則 GetSetting 會傳回 Default 的值。

GetSetting 要求使用者必須要登入，因為它會在 HKEY_LOCAL_USER 登錄機碼之下作業，而此登錄機碼要等到使用者以互動方式登入之後才會變成使用中。

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

GetSetting 需要有 Read登錄使用權限。

範例

此範例會先使用 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")

平台

Windows 98、 Windows 2000 SP4、 Windows CE、 Windows Millennium Edition、 Windows Mobile for Pocket PC、 Windows Mobile for Smartphone、 Windows Server 2003、 Windows XP Media Center Edition、 Windows XP Professional x64 Edition、 Windows XP SP2、 Windows XP Starter Edition

.NET Framework 並不支援各種平台的所有版本。如需支援平台版本的相關資訊，請參閱系統需求一節的內容。

版本資訊

.NET Framework

支援版本：2.0、1.1、1.0

請參閱

參考

Interaction 類別
Interaction 成員
Microsoft.VisualBasic 命名空間
ArgumentException Class
RegistryPermission Class

其他資源

GetSetting 函式
DeleteSetting 函式
GetAllSettings 函式
SaveSetting 函式
一般登錄工作