Formattatore stringa
Modificare la formattazione di uno o più valori in base a una regola personalizzabile.
È possibile utilizzare il formattatore stringa per:
- Aggiungere caratteri prima o dopo un valore, se il valore della variabile sorgente è numerico.
- Formattare e parametrizzare query SQL da utilizzare sugli oggetti del database.
- Collegare più stringhe insieme in una serie.
- Applicare formattazione numerica, come cifre dopo la virgola o arrotondamento dei valori float.
Proprietà
Proprietà | Descrizione |
|---|---|
Formato | La regola di formattazione per il riferimento delle variabili:
|
Modalità | La direzione del collegamento dinamico:
|
Sorgente
La sorgente è una o più variabili, identificate da un segnaposto con un
{index number}
. Il numero dell'indice è progressivo e deve essere un numero intero maggiore di zero {0}
.I segnaposto possono essere visualizzati in qualsiasi ordine nella regola di formattazione. Ad esempio, the minimum value of {3}, {0} and {2} is {1}
è una sintassi valida.È possibile nidificare i segnaposto nella stringa di formattazione
{index,alignment:format}
per modificare in modo dinamico la formattazione dei dati visualizzati.Esempi di segnaposto nidificati:
- {0:f{1}}
- Il valore della variabile collegato a{1}definisce il numero di posizioni decimali.
- {0:{1}{2}}
- Il valore della variabile collegato a{1}definisce il tipo di dati numerici.
- Il valore della variabile collegato a{2}definisce il numero di posizioni decimali.
- {0,{1}:{2}{3}}
- Il valore della variabile collegato a{1}a definisce l'allineamento.
- Il valore della variabile collegato a{2}definisce il tipo di dati numerici.
- Il valore della variabile collegato a{3}definisce il numero di posizioni decimali.
Tipi di dati
Formato | Descrizione | Esempio |
|---|---|---|
g | Data e ora brevi, locale |
|
F | Data e ora estese, locale |
|
X | Data e ora brevi, UTC |
|
x | Data e ora estese, UTC |
|
U | Data e ora completa universale, UTC |
|
p | Data breve, locale |
|
P | Data estesa, locale |
|
d | Data breve, UTC |
|
D | Data estesa, UTC |
|
t | Ora breve, locale |
|
T | Ora estesa, locale |
|
h | Ora breve, UTC |
|
H | Ora estesa, UTC |
|
Formato | Descrizione | Esempio |
|---|---|---|
d | Numerico, senza separatore delle migliaia. Dopo il segnaposto del formato, con un numero intero si configura il numero di posizioni decimali (senza padding). |
|
n | Numerico, con separatore delle migliaia. Dopo il segnaposto del formato, con un numero intero si configura il numero di posizioni decimali (senza padding). |
|
e | Notazione esponenziale. Dopo il segnaposto del formato, con un numero intero si configura il numero di cifre significative. |
|
f | Notazione a punto fisso. Dopo il segnaposto del formato, con un numero intero si configura il numero esatto di posizioni decimali. |
|
p | Percentuale. Dopo il segnaposto del formato, con un numero intero si configura il numero di posizioni decimali. |
|
x | Notazione esadecimale. | 255 ► ff |
b | Notazione binaria. | 107 ► 1101011 |
o | Notazione ottale. | 56 ► 70 |
Formato | Descrizione | Esempio |
|---|---|---|
c | Formato costante. |
|
g | Formato breve generale. |
|
G | Formato generale esteso. |
|
Formato | Descrizione | Esempio |
|---|---|---|
l | Tutte minuscole. | grüßEN ► grüßen |
u | Tutte maiuscole. | grüßEN ► GRÜSSEN |
t | Tutte le prime lettere maiuscole. | grüßEN ► GRÜSSEN |
f | Indipendente da minuscolo e maiuscolo. | grüßEN ► grüssen |
Formato | Descrizione | Esempio |
|---|---|---|
sql_identifier | Formatta un dato String o LocalizedText in identificatore di tabella o di colonna. | - |
sql_literal | Formatta il valore di una variabile come un valore SQL letterale ( Numero , Stringa , data , ora , ecc.). | - |
Esempi di query SQL
Parametrizzare il nome della colonna interna alla condizione:
SELECT * FROM Table1 WHERE {0:sql_identifier} > 5
Confronto con una variabile di tipo data:
SELECT * FROM AlarmsDatalogger WHERE Time > {0:sql_literal}
Parametrizzare l'operatore
LIKE
:SELECT * FROM AlarmsDatalogger WHERE Name LIKE '{0}'
Parametrizzare una parte di una query con un segnaposto:
SELECT * FROM Table1 {0}
Il segnaposto con indice
0
è collegato a una variabile stringa di progetto e parametrizza una colonna; il segnaposto con indice 1
è collegato a una variabile numerica che rappresenta il valore per l'operatore di confronto >
:SELECT * FROM {0:sql_identifier} WHERE Column1 > {1:sql_literal}
Parametrizzare il nome della tabella, la colonna e anche l'operatore
LIKE
:SELECT {0:sql_identifier} FROM {1:sql_identifier} WHERE {0:sql_identifier} LIKE '{2}'
Formattazione percorso
Prendere in considerazione queste funzionalità di formattazione del percorso:
- Per formattare una stringa come percorso di file, utilizzare questa sintassi:{index,alignment:.filepath}
- Input
- ns=5;%PROJECTDIR%/Logo.svg
- Output
- C:\Utenti\UserName\AppData\Local\Rockwell Automation\FactoryTalk Optix\Emulator\Projects\ProjectName\ProjectFiles\Logo.svg
- Per formattare una stringa come URI, utilizzare questa sintassi:{index,alignment:.uri}
- Input
- ns=5;%PROJECTDIR%/Logo.svg
- Output
- file:///C:/Utenti/UserName/AppData/Local/Rockwell Automation/FactoryTalk Optix/Emulator/Projects/ProjectName/ProjectFiles/Logo.svg
- Per formattare una parte di un percorso, utilizzare questa sintassi:file:///C:/Reports/Report.{0}.pdf
Formattazione inversa
La funzione di formattazione inversa consente di modificare un valore formattato a runtime per sostituirlo con un nuovo valore visualizzato dall'applicazione con la stessa formattazione a runtime.
La funzione di formattazione inversa richiede che le seguenti impostazioni funzionino correttamente:
- LaModalitàdi collegamento dinamico del convertitore deve essere diLettura/Scrittura.
- Il campoFormatodeve avere un solo segnaposto o origine. Il segnaposto può avere un suffisso e/o prefisso e può essere impostato con una stringa di formato come{0:n}.
Output
La stringa immessa nella proprietà
Formato
, in base alle regole di formattazione con valori al posto dei segnaposto.Esempio

Fornire un feedback
Lettura dal nodo sorgente all'elemento padre.
Scrittura dall'elemento padre al nodo sorgente.
Lettura dal nodo sorgente all'elemento padre e scrittura dall'elemento padre al nodo sorgente.