Interaction.GetAllSettings(String, String) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Gibt eine Liste der Schlüsseleinstellungen eines Anwendungseintrags in der Windows-Registrierung mit ihren jeweiligen Werten (ursprünglich mit SaveSetting
erstellt) zurück. Die Verwendung des My
-Features ermöglicht bei Registrierungsvorgängen höhere Produktivität und Leistung als GetAllSettings
. Weitere Informationen finden Sie unter 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(,)
Parameter
- AppName
- String
Erforderlich. String
-Ausdruck mit dem Namen der Anwendung oder des Projekts, deren bzw. dessen Schlüsseleinstellungen angefordert werden.
- Section
- String
Erforderlich. String
-Ausdruck mit dem Namen des Abschnitts, dessen Schlüsseleinstellungen angefordert werden. GetAllSettings
gibt ein Objekt zurück, das ein zweidimensionales Zeichenfolgenarray enthält. Die Zeichenfolgen enthalten alle Schlüsseleinstellungen im angegebenen Abschnitt zuzüglich ihrer entsprechenden Werte.
Gibt zurück
Eine Liste der Schlüsseleinstellungen eines Anwendungseintrags in der Windows-Registrierung mit ihren jeweiligen Werten (ursprünglich mit SaveSetting
erstellt).
Die Verwendung des My
-Features ermöglicht bei Registrierungsvorgängen höhere Produktivität und Leistung als GetAllSettings
. Weitere Informationen finden Sie unter Registry.
- Attribute
Ausnahmen
Benutzer ist nicht angemeldet.
Beispiele
In diesem Beispiel wird zunächst die SaveSetting
-Funktion verwendet, um Einträge in der Windows-Registrierung für die als AppName
angegebene Anwendung vorzunehmen. Anschließend wird die GetAllSettings
-Funktion verwendet, um die Einstellungen anzuzeigen. Beachten Sie, dass Anwendungsnamen und Section
-namen nicht mit GetAllSettings
abgerufen werden können. Schließlich entfernt die DeleteSetting
Funktion die Einträge der Anwendung.
' 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")
Hinweise
GetAllSettings
gibt eine nicht initialisierte Object
zurück, wenn oder Section
AppName
nicht vorhanden ist.
Da er unter dem Registrierungsschlüssel ausgeführt wird, der HKEY_LOCAL_USER
erst aktiv ist, wenn sich ein Benutzer interaktiv anmeldet, GetAllSettings
muss ein Benutzer angemeldet sein.
Registrierungseinstellungen, auf die über einen nicht interaktiven Prozess (z. B. Mtx.exe) zugegriffen werden soll, sollten entweder unter oder unter den HKEY_LOCAL_MACHINE\Software\
HKEY_USER\DEFAULT\Software
Registrierungsschlüsseln gespeichert werden.