Interaction.GetAllSettings(String, String) Metoda
Definice
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íče a jejich odpovídajících hodnot (původně vytvořených pomocí SaveSetting) ze položky aplikace v registru Windows. Použití této My funkce poskytuje vyšší produktivitu a výkon v operacích registru než GetAllSettings. Další informace najdete na webu Registry.
public:
static cli::array <System::String ^, 2> ^ GetAllSettings(System::String ^ AppName, System::String ^ Section);
public static string[,] GetAllSettings(string AppName, string Section);
static member GetAllSettings : string * string -> string[,]
Public Function GetAllSettings (AppName As String, Section As String) As String(,)
Parametry
- AppName
- String
Required.
String výraz obsahující název aplikace nebo projektu, jehož nastavení klíče je požadováno.
- Section
- String
Required.
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é části a jejich odpovídající hodnoty.
Návraty
Seznam nastavení klíče a jejich odpovídajících hodnot (původně vytvořených pomocí SaveSetting) ze položky aplikace v registru Windows.
Použití této My funkce poskytuje vyšší produktivitu a výkon v operacích registru než GetAllSettings. Další informace najdete na webu Registry.
Výjimky
Uživatel není přihlášen.
Příklady
Tento příklad nejprve používá funkci SaveSetting k vytvoření položek v registru Windows pro aplikaci zadanou jako AppName a pak pomocí funkce GetAllSettings zobrazí nastavení. Všimněte si, že názvy a Section názvy aplikací nelze načíst pomocí GetAllSettings.
DeleteSetting Nakonec 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
GetAllSettings vrátí neinicializovaný Object , pokud neexistuje AppName nebo Section neexistuje.
Protože funguje pod HKEY_LOCAL_USER klíčem registru, který není aktivní, dokud se uživatel neaktivuje interaktivně, GetAllSettings vyžaduje přihlášení uživatele.
Nastavení registru, ke kterým se má přistupovat z neinteraktivního procesu (například Mtx.exe), by se měla ukládat v klíčích HKEY_LOCAL_MACHINE\Software\ registru nebo v klíčích HKEY_USER\DEFAULT\Software registru.