DataSocket: Lesen - Funktion
- Aktualisiert2025-07-30
- 5 Minute(n) Lesezeit
Entnimmt den nächsten verfügbaren Wert aus der Warteschlange des Client-Puffers für die unter Verbindung (Eingang) angegebene Verbindung und gibt diesen Wert aus.

Ein-/Ausgänge
Verbindung (Eingang)
—
Verbindung (Eingang) gibt die Datenquelle an. connection in kann eine Zeichenkette sein, die die URLbeschreibt, eine gemeinsam genutzte Variablensteuerung, ein Referenzparameter für die Verbindung , der von einer DataSocket Open-Funktion ausgegeben wird, oder ein Parameter für die Verbindung out , der von einer DataSocket Write-Funktion ausgegeben wird.
Typ (Variant)
—
Typ (Variant) bestimmt den Datentyp für den Lesevorgang und den Typen des Ausgangs Daten. Die Standardeinstellung lautet "Variant", das heißt, es ist jeder Typ verwendbar. Der Datentyp dieses Ausgangs richtet sich nach dem Datentyp des angeschlossenen Elements. Der Eingangswert wird ignoriert.
Timeout in ms (10000)
—
Timeout (ms) gibt an, wie lange im Verbindungspuffer auf einen neuen Wert gewartet werden soll. Wenn Auf neuen Wert warten FALSE ist und der erste Wert schon angekommen ist, wird dieser Eingang ignoriert. Die Standardeinstellung lautet 10000 ms (10 Sekunden).
Fehler (Eingang, kein Fehler)
—
Fehler (Eingang) beschreibt Fehlerbedingungen, die vor der Ausführung des Knotens auftreten. An Fehler (Eingang) werden Standardfehlerdaten übergeben.
Auf neuen Wert warten (T)
—
Auf neuen Wert warten wartet bei TRUE einen neuen Wert ab. Wenn der Verbindungspuffer unverarbeitete Daten enthält, gibt diese Funktion sofort den nächsten Wert aus. Anderenfalls wartet die Funktion so lange, wie in Timeout (ms) angegeben. Wenn innerhalb der vorgesehen Zeit kein neuer Wert folgt, gibt die Funktion den aktuellen Wert aus und Timeout wechselt auf TRUE. Wenn Auf neuen Wert warten auf FALSE steht, gibt die Funktion den nächsten Wert des Verbindungspuffer oder den letzten gelesenen Wert aus.
Status
—
Status meldet Warnungen oder Fehler von einem PSP-Server oder FieldPoint-Controller. Wenn das 31. Bit 1ist, zeigt der Status einen Fehler an. Anderenfalls gibt Status einen Statuscode aus.
Qualität
—
Qualität ist die Qualität der Daten, die Sie von einer Umgebungsvariable oder einem Element des NI-Protokolls zum Senden und Empfangen(NI-PSP) erhalten haben. Diese Einstellung wird bei der Fehlersuche an einem VI benötigt. In der folgenden Tabelle sehen Sie mögliche Einstellungen für Qualität.
Verbindung (Ausgang)
—
Verbindung (Ausgang) gibt die Datenquelle für die Verbindung an.
Daten
—
Daten gibt die gelesenen Daten aus. Wenn in der Funktion ein Timeout erfolgt, gibt Daten den von dieser Funktion zuletzt gelesenen Wert aus. Wenn in der Funktion vor dem Lesen von Daten ein Timeout erfolgt oder ein inkompatibler Datentyp festgestellt wurde, gibt Daten 0, Leer oder einen äquivalenten Wert aus.
Timeout
—
Zeitbegrenzung überschritten gibt TRUE aus, wenn das Timeout überschritten wird oder auf einen Startwert gewartet wird.
Fehler (Ausgang)
—
Fehler (Ausgang) enthält Angaben zum Fehler. Dieser Ausgang ist ein Standardausgang zur Fehlerausgabe.
Zeitstempel
—
Zeitstempel gibt die Zeitangaben für Umgebungsvariablen und NI-PSP-Daten an. |
Beispiele
Die folgenden Beispieldateien sind in LabVIEW enthalten.
- labview\examples\Data Communication\DataSocket\Simple DataSocket\Simple DataSocket.lvproj
Verbindung (Eingang)
—
Typ (Variant)
—
Timeout in ms (10000)
—
Fehler (Eingang, kein Fehler)
—
Auf neuen Wert warten (T)
—
Status
—
Qualität
—
Verbindung (Ausgang)
—
Daten
—
Timeout
—
Fehler (Ausgang)
—
Zeitstempel
—