Zeichenfolgenformatierer
Ändern Sie die Formatierung von einem oder mehreren Werten gemäß einer anpassbaren Regel.
Sie können den Zeichenfolgenformatierer verwenden, um Folgendes zu tun:
- Hinzufügen von Zeichen vor oder nach einem Wert, wenn der Wert der Quellvariablen numerisch ist.
- Formatieren und Parametrisieren von SQL-Abfragen für die Verwendung in Datenbankobjekten.
- Verlinken mehrerer Zeichenfolgen in einer Reihe.
- Anwenden numerischer Formatierungen, wie z. B. Dezimalstellen oder Rundung von Fließkommazahlen.
Eigenschaften
Eigenschaft | Beschreibung |
---|---|
Format | Die Formatierungsregel für Variablenreferenzen:
|
Modus | Die Richtung des dynamischen Links:
|
Quelle
Eine oder mehrere Variablen, identifiziert durch:
- {-Platzhalterindex_number}
- Progressive Ganzzahl gleich oder größer als Null. Zum Beispiel{1}
- {#-Platzhalterplaceholder_identifier}
- String mit vorangestelltem#. Zum Beispiel{#speed}
TIPP:
Verwenden Sie eine beliebige Kombination von Platzhaltern in beliebiger Reihenfolge. Verwenden Sie eine beliebige Anzahl von Platzhaltern in dem Ausdruck.
Sie können auch Platzhalter
{index,alignment:format}
verschachteln, um die Formatierung der angezeigten Daten dynamisch zu ändern. Zum Beispiel:- {0:f{1}}
- Der mit{1}verknüpfte Variablenwert legt die Anzahl der Dezimalstellen fest.
- {0:{1}{2}}
- Der mit{1}verknüpfte Variablenwert legt den numerischen Datentyp fest.
- Der mit{2}verknüpfte Variablenwert legt die Anzahl der Dezimalstellen fest.
- {0,{1}:{2}{3}}
- Der mit{1}verknüpfte Variablenwert legt die Ausrichtung fest.
- Der mit{2}verknüpfte Variablenwert legt den numerischen Datentyp fest.
- Der mit{3}verknüpfte Variablenwert legt die Anzahl der Dezimalstellen fest.
Datentypen
Format | Beschreibung | Beispiel |
---|---|---|
g | Kurzes Datum und Uhrzeit, lokal |
|
F | Erweitertes Datum und Uhrzeit, lokal |
|
X | Kurzes Datum und Uhrzeit, UTC |
|
x | Erweitertes Datum und Uhrzeit, UTC |
|
U | Vollständiges Weltdatum und Uhrzeit, UTC |
|
p | Kurzes Datum, lokal |
|
P | Erweitertes Datum, lokal |
|
d | Kurzes Datum, UTC |
|
D | Erweitertes Datum, UTC |
|
t | Kurzzeit, Ortszeit |
|
T | Erweiterte Zeit, Ortszeit |
|
h | Kurze Zeit, UTC |
|
H | Erweiterte Zeit, UTC |
|
Format | Beschreibung | Beispiel |
---|---|---|
d | Numerisch, ohne Tausendertrennzeichen. Nach dem Formatplatzhalter wird die Anzahl der Dezimalstellen mit einer Ganzzahl (ohne Auffüllung) konfiguriert. |
|
n | Numerisch, mit Tausendertrennzeichen. Nach dem Formatplatzhalter wird die Anzahl der Dezimalstellen mit einer Ganzzahl (ohne Auffüllung) konfiguriert. |
|
e | Exponentialschreibweise. Nach dem Formatplatzhalter wird die Anzahl der signifikanten Zahlen mit einer Ganzzahl konfiguriert. |
|
f | Festkomma-Schreibweise. Nach dem Formatplatzhalter wird die genaue Anzahl der Dezimalstellen mit einer Ganzzahl konfiguriert. |
|
p | Prozentsatz. Nach dem Formatplatzhalter wird eine Ganzzahl verwendet, um die Anzahl der Dezimalstellen zu konfigurieren. |
|
x | Hexadezimale Schreibweise. | 255 ► ff |
b | Binäre Schreibweise. | 107 ► 1101011 |
o | Oktalschreibweise. | 56 ► 70 |
Format | Beschreibung | Beispiel |
---|---|---|
c | Konstantes Format. |
|
g | Allgemeines Kurzformat. |
|
G | Erweitertes allgemeines Format. |
|
Format | Beschreibung | Beispiel |
---|---|---|
l | Alles Kleinbuchstaben. | grüßEN ► grüßen |
u | Alles Großbuchstaben. | grüßEN ► GRÜSSEN |
t | Alle Anfangsbuchstaben in Großbuchstaben. | grüßEN ► GRÜSSEN |
f | Unabhängig von der Großschreibung. | grüßEN ► grüssen |
Format | Beschreibung | Beispiel |
---|---|---|
sql_identifier | Formatiert eine bestimmte String oder LocalizedText als ID für eine Tabelle oder Spalte. | - |
sql_literal | Formatiert den Wert einer Variablen als SQL-Literalwert ( Zahl , Zeichenfolge , Datum , Zeit usw.). | - |
Beispiele für SQL-Abfragen
Parametrisieren Sie den Namen der internen Spalte mit der Bedingung:
SELECT * FROM Table1 WHERE {0:sql_identifier} > 5
Vergleich mit einer Datenvariablen:
SELECT * FROM AlarmsDatalogger WHERE Time > {0:sql_literal}
Parametrisieren Sie den
LIKE
-Operator:SELECT * FROM AlarmsDatalogger WHERE Name LIKE '{0}'
Parametrisieren Sie einen Teil einer Abfrage mit einem Platzhalter:
SELECT * FROM Table1 {0}
Der Platzhalter mit dem Index
0
ist mit einer Projekt-Zeichenfolgenvariablen verknüpft und parametrisiert eine Spalte; der Platzhalter mit dem Index 1
ist mit einer numerischen Variablen verknüpft, die den Wert für den Vergleichsoperator >
darstellt:SELECT * FROM {0:sql_identifier} WHERE Column1 > {1:sql_literal}
Parametrisieren Sie den Tabellennamen, die Spalte und auch den Operator
LIKE
:SELECT {0:sql_identifier} FROM {1:sql_identifier} WHERE {0:sql_identifier} LIKE '{2}'
Pfadformatierung
Betrachten Sie diese Möglichkeiten der Pfadformatierung:
- Um eine Zeichenfolge als Dateipfad zu formatieren, können Sie diese Syntax verwenden:{index,alignment:.filepath}
- Input
- ns=5;%PROJECTDIR%/Logo.svg
- Output
- C:\Users\UserName\AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\ProjectName\ProjectFiles\Logo.svg
- Um eine Zeichenfolge als URI zu formatieren, können Sie diese Syntax verwenden:{index,alignment:.uri}
- Input
- ns=5;%PROJECTDIR%/Logo.svg
- Output
- file:///C:/Users/UserName/AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/ProjectName/ProjectFiles/Logo.svg
- Um einen Teil eines Pfades zu formatieren, können Sie diese Syntax verwenden:file:///C:/Reports/Report.{0}.pdf
Rückwärtsformatierung
Mit der Funktion zur Rückwärtsformatierung können Sie einen formatierten Wert zur Laufzeit ändern, um den Wert durch einen neuen Wert zu ersetzen, den die Anwendung zur Laufzeit mit derselben Formatierung anzeigt.
Die Rückwärtsformatierung benötigt für eine korrekte Funktion die folgenden Einstellungen:
- Der dynamische LinkModusdes Konverters mussLesen/Schreibensein.
- Das FeldFormatdarf nur einen Platzhalter oder eine Quelle haben. Der Platzhalter kann ein Suffix und/oder Präfix haben und mit einer Formatzeichenfolge wie{0:n}gesetzt werden.
Output
Die in die Eigenschaft
Format
eingegebene Zeichenfolge, basierend auf den Formatierungsregeln mit Werten anstelle des Platzhalters oder der Platzhalter.Beispiel
Rückmeldung geben