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:
  • Index
    . Eine Indexnummer, die eine Eingabevariable identifiziert. Für jeden
    {index}
    -Platzhalter in der Formatierungsregel erscheint ein neues Feld, das die Quelle angibt.
  • Ausrichtung
    . Eine Ganzzahl, die die Anzahl der Zeichen des Quellwerts angibt, der gemäß der Regel formatiert wurde.
  • Format
    . Die Formatierung, die auf Eingabevariablen angewendet werden soll.
    Der Formatplatzhalter akzeptiert eine Teilmenge der Werte, die von der .NET Framework-Schreibweise für die
    String.Format
    -Methode gefordert werden. Platzhalter müssen die Syntax
    {index,alignment:format}
    verwenden.
Modus
Die Richtung des dynamischen Links:
  • Lesen vom Quellknoten zum übergeordneten Knoten.
  • Schreiben vom übergeordneten Knoten zum Quellknoten.
  • Lesen vom Quellknoten zum übergeordneten Knoten und Schreiben vom übergeordneten Knoten zum Quellknoten.

Quelle

Eine oder mehrere Variablen, identifiziert durch:
{
index_number
}
-Platzhalter
Progressive Ganzzahl gleich oder größer als Null. Zum Beispiel
{1}
{#
placeholder_identifier
}
-Platzhalter
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

Beispieldaten: 23/04/2021 17:25:31, Sitzung mit 60 Minuten TimeZone-Offset.
DateTime
Format
Beschreibung
Beispiel
g
Kurzes Datum und Uhrzeit, lokal
  • (en-US): 4/23/21, 06:25 PM
  • (it-IT): 23/04/21, 18:25
F
Erweitertes Datum und Uhrzeit, lokal
  • (en-US): Apr 23, 2021, 6:25:31 PM
  • (it-IT): 23 apr 2021, 18:25:31
X
Kurzes Datum und Uhrzeit, UTC
  • (en-US): 4/23/21, 4:25 PM (UTC)
  • (it-IT): 23/04/21, 16:25 (UTC)
x
Erweitertes Datum und Uhrzeit, UTC
  • (en-US): Apr 23, 2021, 4:25:31 PM (UTC)
  • (it-IT): 23 apr 2021, 16:25:31 (UTC)
U
Vollständiges Weltdatum und Uhrzeit, UTC
  • (en-US): April 23, 2021 4:25:31 PM GMT (UTC)
  • (it-IT): 23 aprile 2021 16:25:31 GMT (UTC)
p
Kurzes Datum, lokal
  • (en-US): 4/23/21
  • (it-IT): 23/04/21
P
Erweitertes Datum, lokal
  • (en-US): April 23, 2021
  • (it-IT): 23 apr 2021
d
Kurzes Datum, UTC
  • (en-US): 4/23/21 (UTC)
  • (it-IT): 23/04/21 (UTC)
D
Erweitertes Datum, UTC
  • (en-US): Apr 23, 2021 (UTC)
  • (it-IT): 23 apr 2021 (UTC)
t
Kurzzeit, Ortszeit
  • (en-US): 6:25 PM
  • (it-IT): 18:25
T
Erweiterte Zeit, Ortszeit
  • (en-US): 6:25:31 PM
  • (it-IT): 18:25:31
h
Kurze Zeit, UTC
  • (en-US): 4:25 PM (UTC)
  • (it-IT): 16:25 (UTC)
H
Erweiterte Zeit, UTC
  • (en-US): 4:25:31 PM (UTC)
  • (it-IT): 16:25:31 (UTC)
Numerisch (Double Float Int16 Int32 Int64 Integer UInt16 UInt32 UInt64 UInteger)
Format
Beschreibung
Beispiel
d
Numerisch, ohne Tausendertrennzeichen.
Nach dem Formatplatzhalter wird die Anzahl der Dezimalstellen mit einer Ganzzahl (ohne Auffüllung) konfiguriert.
  • d
    : -1234 ► -1234
  • d
    : 5.618 ► 5618
  • d2
    : 1,234.239 ► 1234.24
n
Numerisch, mit Tausendertrennzeichen.
Nach dem Formatplatzhalter wird die Anzahl der Dezimalstellen mit einer Ganzzahl (ohne Auffüllung) konfiguriert.
  • n1
    : -1234.23 ► -1,234.2
  • n2
    : 5804.236 ► 5,804.24
  • n3
    : -1234.23 ► -1,234.230
e
Exponentialschreibweise.
Nach dem Formatplatzhalter wird die Anzahl der signifikanten Zahlen mit einer Ganzzahl konfiguriert.
  • e10
    : 12345.6789 ► 1.2345678900E4
  • e2
    : 2665.778 ► 2.67E3
f
Festkomma-Schreibweise.
Nach dem Formatplatzhalter wird die genaue Anzahl der Dezimalstellen mit einer Ganzzahl konfiguriert.
  • f3
    : 123 ► 123.000
  • f3
    : 123.23 ► 123.230
  • f4
    : -1898300.678 ► -1,898,300.6780
  • f3
    : 123.4 ► 123.400
p
Prozentsatz.
Nach dem Formatplatzhalter wird eine Ganzzahl verwendet, um die Anzahl der Dezimalstellen zu konfigurieren.
  • p
    : 1 ► 100%
  • p3
    : -0.397481 ► -39.748%
x
Hexadezimale Schreibweise.
255 ► ff
b
Binäre Schreibweise.
107 ► 1101011
o
Oktalschreibweise.
56 ► 70
Dauer und Zeitspanne
Format
Beschreibung
Beispiel
c
Konstantes Format.
  • 3.17:25:30.5000000
  • 4:30:00 AM
g
Allgemeines Kurzformat.
  • (en-US): 1:3:16:50.5
  • (en-US): 5:15:09:00
  • (fr-FR): 2:9:02:00,0200000
  • (fr-FR): 15:12:20:00
  • (en-US): 5:12:00
  • (fr-FR): 20:10:00
G
Erweitertes allgemeines Format.
  • (en-US): 12:08:30 AM:00.0000000
  • (fr-FR): 12:08:30 AM:00.0000000
  • (en-US): 12:18:20 AM:00.0000000
  • (fr-FR): 12:17:30 AM:00.0000000
Zeichenfolge
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
ANSI SQL
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 Link
    Modus
    des Konverters muss
    Lesen/Schreiben
    sein.
  • Das Feld
    Format
    darf 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
Haben Sie Fragen oder Feedback zu dieser Dokumentation? Bitte geben Sie hier Ihr Feedback ab.