Formateur de chaîne

Modifiez la mise en forme d'une ou plusieurs valeurs en fonction d'une règle personnalisable.
CONSEIL:
Vous pouvez utiliser le formateur de chaîne pour :
  • lier plusieurs chaînes dans une série ;
  • ajouter des caractères avant ou après une valeur, si la valeur de la variable source est numérique ;
  • appliquer une mise en forme numérique, telle que des décimales ou des arrondis à virgule flottante. Consultez la rubrique Types de données du formateur de chaîne.
  • formater et configurer les requêtes SQL à utiliser dans les objets de base de données ; Consultez la rubrique Exemples de requêtes SQL du formateur de chaîne.

Entrée

Propriétés
Propriété
Description
Format
Règle de mise en forme pour la référence de variable :
  • Index
    . Numéro d'index qui identifie une variable d'entrée. Pour chaque espace réservé
    {index}
     de la règle de mise en forme, un nouveau champ indiquant la source s'affiche.
  • Alignement
    . Entier représentant le nombre de caractères de la valeur source mise en forme en fonction de la règle.
  • Format
    . Mise en forme à appliquer aux variables d'entrée.
    L’espace réservé au format accepte un sous-ensemble de valeurs requises par la notation .NET Framework pour la méthode
    String.Format
    . Les espaces réservés doivent utiliser la syntaxe
    {index,alignment:format}
    .
Mode de lien dynamique
Lire
Icône Sens de lecture du lien dynamique
Lecture du nœud source au parent.
La valeur par défaut des liens dynamiques est définie dans les NetLogics.
Écrire
Icône Sens d’écriture du lien dynamique
Écriture du parent au nœud source.
Lire/écrire
Icône Sens de lecture et d’écriture du lien dynamique
Lecture du nœud source au parent et écriture du parent au nœud source.
Valeur par défaut pour les liens dynamiques créés dans l’interface utilisateur de
FactoryTalk Optix Studio
.
Lien dynamique
Une ou plusieurs variables identifiées par :
Espace réservé
{
index_number
}
Entier progressif égal ou supérieur à zéro. Par exemple,
{1}
Espace réservé
{#
placeholder_identifier
}
Chaîne avec le préfixe
#
. Par exemple,
{#speed}
CONSEIL: Utilisez des combinaisons d’espaces réservés dans n’importe quel ordre. Utilisez autant d’espaces réservés que vous voulez dans l’expression.
Cette propriété est disponible uniquement pour les instances de convertisseur et non pour les types de convertisseur.

Mise en forme

Imbriquez des espaces réservés
{index,alignment:format}
 pour modifier dynamiquement la mise en forme des données affichées. Par exemple :
{0:f{1}}
  • La valeur de la variable liée à
    {1}
     définit le nombre de décimales.
{0:{1}{2}}
  • La valeur de la variable liée à
    {1}
     définit le type de données numérique.
  • La valeur de la variable liée à
    {2}
     définit le nombre de décimales.
{0,{1}:{2}{3}}
  • La valeur de la variable liée à
    {1}
     définit l’alignement.
  • La valeur de la variable liée à
    {2}
     définit le type de données numérique.
  • La valeur de la variable liée à
    {3}
     définit le nombre de décimales.

Formatage du chemin

Considérez les fonctionnalités suivantes de formatage du chemin :
  • Pour formater une chaîne en tant que chemin d'accès au fichier, vous pouvez utiliser la syntaxe suivante :
    {index,alignment:
    filepath
    }
    .
    Entrée
    ns=9;%PROJECTDIR%/Logo.svg
    Sortie
    C:\Users\
    UserName
    \AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\
    ProjectName
    \ProjectFiles\Logo.svg
  • Pour formater une chaîne en tant qu’URI, vous pouvez utiliser la syntaxe suivante :
    {index,alignment:
    uri
    }
    .
    Entrée
    ns=9;%PROJECTDIR%/Logo.svg
    Sortie
    file:///C:/Users/
    UserName
    /AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/
    ProjectName
    /ProjectFiles/Logo.svg
  • Pour formater une partie d’un chemin d'accès, vous pouvez utiliser la syntaxe suivante :
    file:///C:/Reports/Report
    {0}
    .pdf
    .
Utilisez le formatage inversé pour modifier une valeur mise en forme lors de l’exécution afin de remplacer la valeur par une nouvelle valeur que l’application affiche avec le même formatage lors de l’exécution. La fonctionnalité de mise en forme inversée nécessite le bon fonctionnement des paramètres suivants :
  • Le
    Mode
     de lien dynamique du convertisseur doit être
    Lecture/Écriture
    .
  • Le champ
    Format
     ne doit contenir qu'un seul espace réservé ou une seule source. L'espace réservé peut avoir un suffixe et/ou un préfixe, et être défini avec une chaîne de format telle que
    {0:n}
    .

Sortie

Chaîne entrée dans la propriété
Format
 en fonction des règles de mise en forme avec des valeurs à la place des espaces réservés.

Exemple

Instance d’un formateur de chaîne
Représentation visuelle de la configuration d’un formateur de chaîne, montrant une entrée de message, un champ de format avec le texte "Apply value: {0}?", et un lien dynamique pointant vers une valeur de zone de texte de l’interface utilisateur.
Fournir une réponse
Vous avez des questions ou des commentaires sur cette documentation ? Veuillez envoyer vos commentaires ici.
Normal