Schreibt einen Wert in eine standardkonforme .ini-Datei.

IniWrite ( "filename", "section", "key", "value" )

Parameter

Rückgabewert

Bemerkungen

Eine standardkonforme .ini-Datei sieht folgendermaßen aus:
[SektionsName]
Schlüssel=Wert

Wenn die Datei nicht bereits existiert, wird sie erstellt, sofern das Verzeichnis existiert. Schlüssel und/oder Sektionen werden am Ende angehängt und in keiner Weise sortiert.

Wenn Anführungszeichen einen .ini-Wert umschließen sollen, so müssen sie gedoppelt werden, da der äußere Satz Anführungszeichen entfernt wird. Z.B.: ""Dies ist ein Test"" ergibt "Dies ist ein Test", bei der Verwendung von IniRead().

Voranstehende und nachfolgende Leerzeichen werden entfernt. Um die Leerzeichen beizubehalten, muss der String in Anführungszeichen gesetzt werden. Beispiel: " Dies ist ein Test" wird die Leerzeichen erhalten. Jedoch werden die Anführungszeichen, wie oben beschrieben, entfernt.

Mehrzeilige Werte sind nicht möglich.

Wenn eine .ini-Datei mit Unicode-Kodierung verwendet werden soll, muss zuerst eine .ini-Datei mit der FileOpen() Funktion erstellt und der mode-Parameter auf Unicode gesetzt werden.

Verwandte Funktionen

IniDelete, IniRead, IniReadSection, IniReadSectionNames, IniRenameSection, IniWriteSection

Beispiel

#include <MsgBoxConstants.au3>
#include <WinAPIFiles.au3>

Example()

Func Example()
    ; Erstellt eine Konstante im lokalen Bereich des Dateipfades, welcher zum lesen bzw. schreiben verwendet wird.
    Local Const $sFilePath = _WinAPI_GetTempFileName(@TempDir)

    ; Schreibt den Wert von 'AutoIt' in den Schlüssel 'Titel' und in die Sektion 'General'.
    IniWrite($sFilePath, "General", "Titel", "AutoIt")

    ; Liest in der ini-Datei den Wert von 'Titel' in der Sektion 'General'.
    Local $sRead = IniRead($sFilePath, "General", "Titel", "Default Value")

    ; Zeigt den Wert der von IniRead zurückgegeben wurde.
    MsgBox($MB_SYSTEMMODAL, "", "Der Wert von 'Titel' in der Sektion 'General' lautet: " & $sRead)

    ; Löscht den Schlüssel 'Titel'
    IniDelete($sFilePath, "General", "Titel")

    ; Liest in der ini-Datei den Wert von 'Titel' in der Sektion 'General'.
    $sRead = IniRead($sFilePath, "General", "Titel", "Default Value")

    ; Zeigt den Wert der von IniRead zurückgegeben wurde. Falls es dort keinen Schlüssel gibt, wird der Standardwert übergeben von IniRead angezeigt.
    MsgBox($MB_SYSTEMMODAL, "", "Der Wert von 'Titel' in der Sektion 'General' lautet: " & $sRead)

    ; Löscht die ini-Datei.
    FileDelete($sFilePath)
EndFunc   ;==>Example