Interaction.GetAllSettings(String, String) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Zwraca listę ustawień klucza i ich odpowiednich wartości (pierwotnie utworzonych przy SaveSetting
użyciu ) z wpisu aplikacji w rejestrze systemu Windows. My
Korzystanie z funkcji zapewnia większą produktywność i wydajność operacji rejestru niż GetAllSettings
. Aby uzyskać więcej informacji, zobacz 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
Wymagane. String
wyrażenie zawierające nazwę aplikacji lub projektu, którego ustawienia klucza są żądane.
- Section
- String
Wymagane. String
wyrażenie zawierające nazwę sekcji, której ustawienia klucza są żądane. GetAllSettings
Zwraca obiekt zawierający dwuwymiarową tablicę ciągów. Ciągi zawierają wszystkie ustawienia klucza w określonej sekcji oraz odpowiadające im wartości.
Zwraca
Lista ustawień klucza i ich odpowiednich wartości (pierwotnie utworzonych przy SaveSetting
użyciu ) z wpisu aplikacji w rejestrze systemu Windows.
My
Korzystanie z funkcji zapewnia większą produktywność i wydajność operacji rejestru niż GetAllSettings
. Aby uzyskać więcej informacji, zobacz Registry.
- Atrybuty
Wyjątki
Użytkownik nie jest zalogowany.
Przykłady
W tym przykładzie najpierw użyto SaveSetting
funkcji do wpisów w rejestrze systemu Windows dla aplikacji określonej jako AppName
, a następnie używa GetAllSettings
funkcji do wyświetlania ustawień. Należy pamiętać, że nie można pobrać nazw i Section
nazw aplikacji za pomocą polecenia GetAllSettings
. DeleteSetting
Na koniec funkcja usuwa wpisy aplikacji.
' 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")
Uwagi
GetAllSettings
zwraca niezainicjowaneObject
, jeśli albo Section
AppName
nie istnieje.
Ponieważ działa on w ramach HKEY_LOCAL_USER
klucza rejestru, który nie jest aktywny, dopóki użytkownik nie zaloguje się interaktywnie, GetAllSettings
wymaga zalogowania użytkownika.
Ustawienia rejestru, które mają być dostępne z nieinterakcyjnego procesu (na przykład Mtx.exe), powinny być przechowywane w ramach HKEY_LOCAL_MACHINE\Software\
kluczy rejestru lub HKEY_USER\DEFAULT\Software
.