Share via


System.PrivateProfileString[String, String, String] Eigenschaft

Definition

Gibt eine Zeichenfolge in einer Einstellungsdatei oder der Windows-Registrierung zurück oder legt sie fest.

public:
 property System::String ^ PrivateProfileString[System::String ^, System::String ^, System::String ^] { System::String ^ get(System::String ^ FileName, System::String ^ Section, System::String ^ Key); void set(System::String ^ FileName, System::String ^ Section, System::String ^ Key, System::String ^ value); };
public string PrivateProfileString[string FileName, string Section, string Key] { get; set; }
member this.PrivateProfileString(string * string * string) : string with get, set
Public Property PrivateProfileString(FileName As String, Section As String, Key As String) As String

Parameter

FileName
String

String erforderlich. Der Name für die Initialisierungsdatei. Wenn kein Pfad angegeben ist, wird der Windows-Ordner angenommen.

Section
String

String erforderlich. Der Name des Abschnitts in der Einstellungsdatei, der enthält Key. In einer Windows-Einstellungsdatei wird der Abschnittsname zwischen Klammern vor den zugeordneten Schlüsseln angezeigt (schließen Sie die Klammern nicht mit Sectionein). Wenn Sie den Wert eines Eintrags aus der Windows-Registrierung zurückgeben, Section sollte der vollständige Pfad zum Unterschlüssel sein, einschließlich der Unterstruktur (z. B. "HKEY_CURRENT_USER\Software\Microsoft\Office\version \Word\Options").

Key
String

String erforderlich. Die Schlüsseleinstellung oder der Wert des Eintrags der Registrierungsdatenbank, den Sie abrufen möchten. In einer Windows-Initialisierungsdatei folgen auf den Schlüsselnamen ein Gleichheitszeichen (=) und die Einstellung. Wenn Sie den Wert eines Eintrags aus der Windows-Registrierung zurückgeben, Key sollte der Name eines Eintrags im von Section angegebenen Unterschlüssel sein (z. B. "STARTUP-PATH").

Eigenschaftswert

Hinweise

Sie können Code schreiben, der eine Einstellungsdatei zum Speichern und Abrufen von Einstellungen verwendet. Beispielsweise können Sie den Namen des aktiven Dokuments speichern, wenn Sie Word beenden, damit es beim nächsten Starten von Microsoft Word automatisch erneut geöffnet werden kann. Eine Einstellungsdatei ist eine Textdatei mit Informationen, die wie die Informationen in der Windows 3.x-Datei WIN.INI angeordnet sind.

Gilt für: