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 AppNameangegebene Anwendung vorzunehmen. Anschließend wird die GetAllSettings -Funktion verwendet, um die Einstellungen anzuzeigen. Beachten Sie, dass Anwendungsnamen und Section -namen nicht mit GetAllSettingsabgerufen 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
GetAllSettingsgibt eine nicht initialisierte Object zurück, wenn oder SectionAppName 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.