Liest eine bestimmte Anzahl von Bytes von einer TCP-Verbindung und gibt diese in Daten (Ausgang) aus.


icon

Ein-/Ausgänge

  • cenum.png Modus (Standard) —

    Modus gibt die Funktionsweise der Leseoperation an.

    0Standard (Standardwert) - Wartet, bis alle Bytes, die Sie in zu lesende Bytes angeben, ankommen oder bis timeout ms abgelaufen ist. Gibt die Anzahl der bisher gelesenen Bytes aus. Wenn weniger Bytes empfangen wurden als angegeben, werden die empfangenen Bytes ausgegeben und es wird ein Timeout-Fehler gemeldet.
    1Buffered—Wartet, bis alle in Zu lesende Bytes angegebenen Bytes angekommen sind oder Timeout (ms) erreicht wird. Wenn weniger Bytes empfangen wurden als angegeben, werden keine Bytes ausgegeben und es wird ein Timeout-Fehler gemeldet.
    2CRLF—Wartet, bis die unter Zu lesende Bytes angegebenen Byte-Anzahl eingetroffen ist oder bis innerhalb von Zu lesende Bytes ein Wagenrücklauf (CR) gefolgt von einem Zeilenvorschub (LF) auftritt oder bis der Timeout (ms) erreicht ist. Die Funktion gibt die Bytes bis einschließlich CR und LF aus, sofern CR und LF im String gefunden werden.
    3Immediate—Wartet, bis die Funktion die unter Zu lesende Bytes festgelegte Anzahl von Bytes empfängt. Das volle Timeout-Intervall wird nur abgewartet, wenn keine Bytes empfangen werden. Gibt die Anzahl der empfangenen Bytes aus. Meldet einen Timeout-Fehler, wenn keine Bytes empfangen wurden.
  • cncrn.png Verbindungs-ID —

    Verbindungs-ID ist eine Referenz zur eindeutigen Kennzeichnung der TCP-Verbindung.

  • ci32.png Zu lesende Bytes —

    Zu lesende Bytes ist die Anzahl der zu lesenden Bytes. Zum Abfragen der Daten einer Netzwerkverbindung muss ein Wert größer als 0 mit diesem Eingang verbunden werden. Der Standardwert lautet 0.

    Für größenveränderliche Nachrichten empfiehlt sich eine der folgenden Vorgehensweisen:

    • Am Beginn der Nachrichten sollte ein Header fester Größe stehen, in dem die Nachricht beschrieben wird. Dieser Header kann zum Beispiel eine Zahl enthalten, die angibt, was für eine Nachricht folgt, und eine Zahl, die die Größe der Nachricht angibt. Sowohl Server als auch Client empfangen Nachrichten durch Ausstellen einer Lesefunktion von 8 Byte (vorausgesetzt, jede der Zahlen ist ein 4-Byte-Integer), die in zwei Zahlen umgewandelt werden. Anhand der zweiten Zahl wird angezeigt, wie viele Bytes für die restliche Nachricht eine zweite Lesefunktion passieren werden. Sobald der zweite Lesevorgang abgeschlossen ist, springt jede Seite zurück zur Lesefunktion für den 8 Byte großen Header. Diese Vorgehensweise ist am flexibelsten, erfordert jedoch zum Empfang jeder Nachricht zwei Lesevorgänge. In der Praxis wird der zweite Lesevorgang in der Regel unmittelbar nach dem Erstellen der Nachricht mit einer Schreibfunktion beendet.
    • Halten Sie bei jeder Nachricht eine feste Größe ein. Wenn die Nachricht kleiner als angegeben ist, füllen Sie die Nachricht auf die angegebene Größe auf. Das Empfangen von Nachrichten ist damit etwas weniger aufwändig, da nur ein Lesevorgang benötigt wird, jedoch werden dadurch auch zuweilen unnötige Daten übertragen.
    • Senden Sie Nur-Text-Nachrichten, das heißt, jede Nachricht wird durch einen Wagenrücklauf und zwei Zeichen für einen Zeilenvorschub beendet. Die Lesefunktion hat einen Eingang, mit dem das VI beim Befehl CRLF so lange Text liest, bis ein Wagenrücklauf gefolgt von einem Zeilenvorschub angetroffen wird. Diese Form der Übertragung kann zwar bei mehreren aufeinander folgenden Zeilenumschaltungen und -umbrüchen in der Mitte des Textes zu Problemen führen, ist jedoch bei Internetprotokollen wie POP3, FTP oder HTTP üblich.
  • ci32.png Timeout in ms (25000) —

    Timeout (ms) gibt an, wie viele Millisekunden Modus bis zur Ausgabe eines Timeout-Fehlers warten soll.

    Der Standardwert lautet 25.000 ms. Bei –1 wird kein Timeout vorgegeben.

  • cerrcodeclst.png Fehler (Eingang, kein Fehler) —

    Fehler (Eingang) beschreibt Fehlerbedingungen, die vor der Ausführung des Knotens auftreten. An Fehler (Eingang) werden Standardfehlerdaten übergeben.

  • incrn.png Verbindungs-ID (Ausgang) —

    Verbindungs-ID (Ausgang) ist mit Verbindungs-ID identisch.

  • istr.png Daten (Ausgang) —

    Daten (Ausgang) enthält die aus der TCP-Verbindung gelesenen Daten.

  • ierrcodeclst.png Fehler (Ausgang) —

    Fehler (Ausgang) enthält Angaben zum Fehler. Dieser Ausgang ist ein Standardausgang zur Fehlerausgabe.

    • Beispiele

    Die folgenden Beispieldateien sind in LabVIEW enthalten.

    • labview\examples\Data Communication\Protocols\TCP\TCP Named Service\TCP Named Service.lvproj