Interaction.GetAllSettings(String, String) Metoda

Reference

Definice

Obor názvů:: Microsoft.VisualBasic

Sestavení:: Microsoft.VisualBasic.Core.dll

Sestavení:: Microsoft.VisualBasic.dll

Zdroj:: Interaction.vb

Zdroj:: Interaction.vb

Zdroj:: Interaction.vb

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Vrátí seznam nastavení klíčů a jejich odpovídajících hodnot (původně vytvořených pomocí SaveSetting) z položky aplikace v registru systému Windows. Použití této My funkce poskytuje vyšší produktivitu a výkon při operacích registru než GetAllSettings. Další informace naleznete v tématu Registry.

public:
 static cli::array <System::String ^, 2> ^ GetAllSettings(System::String ^ AppName, System::String ^ Section);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static string[,]? GetAllSettings (string AppName, string Section);

public static string[,] GetAllSettings (string AppName, string Section);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member GetAllSettings : string * string -> string[,]

static member GetAllSettings : string * string -> string[,]

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

Parametry

AppName: String

Povinná hodnota. String výraz obsahující název aplikace nebo projektu, jehož nastavení klíče je požadováno.

Section: String

Povinná hodnota. String výraz obsahující název oddílu, jehož nastavení klíče je požadováno. GetAllSettings vrátí objekt, který obsahuje dvojrozměrné pole řetězců. Řetězce obsahují všechna nastavení klíče v zadaném oddílu a jejich odpovídající hodnoty.

Návraty

String[,]

Seznam nastavení klíče a jejich příslušných hodnot (původně vytvořených pomocí SaveSetting) z položky aplikace v registru Systému Windows.

Použití této My funkce poskytuje vyšší produktivitu a výkon při operacích registru než GetAllSettings. Další informace naleznete v tématu Registry.

Atributy: SupportedOSPlatformAttribute

Výjimky

ArgumentException

Uživatel není přihlášen.

Příklady

Tento příklad nejprve použije SaveSetting funkci k vytvoření položek v registru systému Windows pro aplikaci zadanou jako AppNamea pak použije GetAllSettings funkci k zobrazení nastavení. Všimněte si, že názvy a Section názvy aplikací nelze načíst pomocí GetAllSettingspříkazu . Nakonec DeleteSetting funkce odebere položky aplikace.

' 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")

Poznámky

GetAllSettingsvrátí neinicializovanýObject, pokud neexistuje nebo SectionAppName neexistuje.

Vzhledem k tomu, že funguje pod HKEY_LOCAL_USER klíčem registru, který není aktivní, dokud se uživatel nepřihlásí interaktivně, GetAllSettings vyžaduje, aby byl uživatel přihlášen.

Nastavení registru, ke kterým se má přistupovat z neinteraktivního procesu (například Mtx.exe), by měla být uložena v HKEY_LOCAL_MACHINE\Software\ klíčích registru nebo v klíčích HKEY_USER\DEFAULT\Software registru.

Platí pro