Lire une variable
- Mise à jour2025-07-30
- Temps de lecture : 4 minute(s)
Lit une variable partagée publiée sur réseau, une variable d'E/S ou un conteneur de variables d'E/S.
Pour les variables d'E/S et les conteneurs de variables d'E/S, cette fonction effectue une opération de lecture par balayage.

Entrées/Sorties
refnum de variable partagée en entrée
—
type de données
—
data type spécifie le type de données de la variable partagée ou du conteneur de variables d'E/S. Pour les conteneurs de variables d'E/S, vous devez spécifier un type de données tableau. Cette entrée n'est disponible que si le type de données n'a pas déjà été spécifié. Vous pouvez spécifier un type de données en cochant l'option Spécifier le type de données sur la page Configuration de la boîte de dialogue Propriétés du refnum de variable. Si vous spécifiez le type de données à l'ouverture de la connexion, ce terminal ne sera pas disponible sur les fonctions de lecture et d'écriture suivantes.
entrée d'erreur (pas d'erreur)
—
entrée d'erreur décrit les conditions d'erreur qui ont lieu avant l'exécution de ce nœud. Cette entrée fournit la fonctionnalité entrée d'erreur standard.
refnum de variable partagée en sortie
—
données en sortie
—
données en sortie sont les données lues de la variable partagée ou du conteneur de variables d'E/S.
sortie d'erreur
—
sortie d'erreur contient des informations sur l'erreur. Cette sortie fournit la fonctionnalité sortie d'erreur standard.
horodatage
—
horodatage est l'horodatage qui indique quand les données actuelles ont été écrites à la variable partagée. Cette sortie n'est disponible que si vous cochez l'option Lire l'horodatage sur la page Configuration de la boîte de dialogue Propriétés du refnum de variable. Les conteneurs de variables d'E/S ne supportent pas les horodatages. |
Utilisez cette fonction lorsque vous avez besoin de lire la valeur actuelle quels que soient les changements de valeur. Si vous ne voulez lire que les nouvelles valeurs, utilisez la fonction Lire une variable avec timeout.
refnum de variable partagée en entrée
—
type de données
—
entrée d'erreur (pas d'erreur)
—
refnum de variable partagée en sortie
—
données en sortie
—
sortie d'erreur
—
horodatage
—