✕
✕

ReadAllText

TwinCAT TIA
Lokal Datei- und Ordner-Zugriff Datei

ns=2;s=DEPRAG Smart/Local/FileAndDirectoryAccess/FileAccess/ReadAllText

Der Befehl liest den Inhalt einer Datei in eine Zeichenfolge ein.

Parameter:

    FullPath
    Pfad der Datei. Die Datei kann entweder eine lokale Datei sein oder eine Datei, die auf einem Netzwerklaufwerk abgelegt ist.

Rückgabewert:

    ReadAllText
    Eine Variable vom Typ OpcMethodReturnValueString. In der Eigenschaft Result sind die befehlsspezifischen Rückgabewerte enthalten.
      Result
      Der Inhalt der Datei als Zeichenkette.

Beispiele:

Neben den bereits erläuterten Parametern sind für die Implementierung in TwinCAT 3 nachfolgende Variablen anzulegen / zu übergeben:

Beckhoff Parameter:

    bFileAccessReadAllText
    Eine boolesche Variable, über welche die Ausführung des ReadAllText-Befehls getriggert werden kann.
    OutputDataFileAccessReadAllText
    Eine Instanz der "ST_ReadAllTextOutputData", in welche der Rückgabewert der ReadAllText-Methode geschrieben wird.
    hrFileAccessReadAllText
    Hiermit kann die Ausführung des Befehls überwacht werden. Fehler-Codes haben den Typ "HRESULT".
    fbFileAccess
    Eine Instanz des, mit der DEPRAG Smart-Bibliothek gelieferten, "FB_FileAccess" Funktionsbausteins.
    sfullPathSourceFile
    Eine STRING-Variable, die den vollständigen Pfad der Datei enthält.
    Encoding
    Eine Enumeration vom Typ Encoding, welche die Codierung des Inhalts der Datei enthält.
    ConnectionHandle
    Beim Verbindungsaufbau zwischen DEPRAG Smart Server und Ihrem OPC UA Client erhaltenes "ConnectionHandle". 


VAR
     bFileAccessReadAllText        : BOOL;
     OutputDataFileAccessReadAllText      : ST_ReadAllTextOutputData;
     hrFileAccessReadAllText        : HRESULT;

     fbFileAccess  : FB_FileAccess;
END_VAR

hrFileAccessReadAllText := fbFileAccess.ReadAllText(
           bExecute     := bFileAccessReadAllText,   
           ConnectionHandle  := depragSmartConnection.ConnectionHandle, 
           sfullPathSourceFile  := 'C:\Test\text.txt',
           Encoding    := Encoding.Utf8,
           OutputData    => OutputDataFileAccessReadAllText);
IF hrFileAccessReadAllText <> S_FALSE THEN 
     bFileAccessReadAllText := FALSE;
END_IF

Für Beispiele und Erklärungen bezüglich der Aufrufe von Knoten via Siemens TIA Portal sei an dieser Stelle auf den Unterpunkt "Siemens TIA Portal" in Abschnitt "Erste Schritte" verwiesen.