Interaction.GetAllSettings(String, String) Methode

Referenz

Definition

Namespace:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Quelle:: Interaction.vb

Quelle:: Interaction.vb

Quelle:: Interaction.vb

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

String[,]

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: SupportedOSPlatformAttribute

Ausnahmen

ArgumentException

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.

Gilt für: