Formatador de strings

Modifique a formatação de um ou mais valores de acordo com uma regra personalizável.
É possível usar o formatador de strings para:
  • Adicionar caracteres antes ou depois de um valor, se o valor da variável de origem for numérico.
  • Formatar e parametrizar consultas SQL para usar em objetos de banco de dados.
  • Vincular várias strings em uma série.
  • Aplicar formatação numérica, como casas decimais ou arredondamento flutuante.

Propriedades

Propriedade
Descrição
Formato
A regra de formatação para referência de variável:
  • Índice
    . Um número de índice que identifica uma variável de entrada. Para cada espaço reservado
    {index}
    na regra de formatação, um novo campo que indica a origem é exibido.
  • Alinhamento
    . Um inteiro que representa o número de caracteres do valor de origem formatado de acordo com a regra.
  • Formato
    . A formatação a ser aplicada às variáveis de entrada.
    O espaço reservado de formato aceita um subconjunto dos valores exigidos pela notação do .NET Framework para o método
    String.Format
    . Os espaços reservados devem usar a sintaxe
    {index,alignment:format}
    .
Modo
A direção do vínculo dinâmico:
  • Leia do nó de origem para o pai.
  • Grave do nó pai para o nó de origem.
  • Leia do nó de origem para o pai e grave do pai para o nó de origem.

Origem

Uma ou mais variáveis identificadas por:
Espaço reservado
{
index_number
}
Inteiro progressivo igual ou maior que zero. Por exemplo
{1}
Espaço reservado
{#
placeholder_identifier
}
String prefixada com
#
. Por exemplo
{#speed}
DICA: Use qualquer combinação de espaços reservados em qualquer ordem. Use qualquer número de espaços reservados na expressão.
Você também pode aninhar espaços reservados
{index,alignment:format}
para alterar dinamicamente a formatação dos dados exibidos. Por exemplo:
{0:f{1}}
  • O valor da variável vinculado a
    {1}
    define o número de casas decimais.
{0:{1}{2}}
  • O valor da variável vinculado a
    {1}
    define o tipo de dados numéricos.
  • O valor da variável vinculado a
    {2}
    define o número de casas decimais.
{0,{1}:{2}{3}}
  • O valor da variável vinculado a
    {1}
    define o alinhamento.
  • O valor da variável vinculado a
    {2}
    define o tipo de dados numéricos.
  • O valor da variável vinculado a
    {3}
    define o número de casas decimais.

Tipos de dados

Dados de exemplo: 23/04/2021 17:25:31, sessão com deslocamento de fuso horário de 60 minutos.
DateTime
Formato
Descrição
Exemplo
g
Data e hora abreviadas, locais
  • (en-US): 4/23/21, 06:25 PM
  • (it-IT): 23/04/21, 18:25
F
Data e hora estendidas, locais
  • (en-US): Apr 23, 2021, 6:25:31 PM
  • (it-IT): 23 apr 2021, 18:25:31
X
Data e hora abreviadas, UTC
  • (en-US): 4/23/21, 4:25 PM (UTC)
  • (it-IT): 23/04/21, 16:25 (UTC)
x
Data e hora estendidas, UTC
  • (en-US): Apr 23, 2021, 4:25:31 PM (UTC)
  • (it-IT): 23 apr 2021, 16:25:31 (UTC)
U
Data e hora universais completas, UTC
  • (en-US): April 23, 2021 4:25:31 PM GMT (UTC)
  • (it-IT): 23 aprile 2021 16:25:31 GMT (UTC)
p
Data abreviada, local
  • (en-US): 4/23/21
  • (it-IT): 23/04/21
P
Data estendida, local
  • (en-US): April 23, 2021
  • (it-IT): 23 apr 2021
d
Data abreviada, UTC
  • (en-US): 4/23/21 (UTC)
  • (it-IT): 23/04/21 (UTC)
D
Data estendida, UTC
  • (en-US): Apr 23, 2021 (UTC)
  • (it-IT): 23 apr 2021 (UTC)
t
Hora abreviada, local
  • (en-US): 6:25 PM
  • (it-IT): 18:25
T
Hora estendida, local
  • (en-US): 6:25:31 PM
  • (it-IT): 18:25:31
h
Hora abreviada, UTC
  • (en-US): 4:25 PM (UTC)
  • (it-IT): 16:25 (UTC)
H
Hora estendida, UTC
  • (en-US): 4:25:31 PM (UTC)
  • (it-IT): 16:25:31 (UTC)
Numérico (Double Float Int16 Int32 Int64 Integer UInt16 UInt32 UInt64 UInteger)
Formato
Descrição
Exemplo
d
Numérico, sem separador de milhares.
Após o espaço reservado de formato, o número de casas decimais é configurado com um inteiro (sem preenchimento).
  • d
    : -1234 ► -1234
  • d
    : 5.618 ► 5618
  • d2
    : 1.234,239 ► 1234,24
n
Numérico, com separador de milhares.
Após o espaço reservado de formato, o número de casas decimais é configurado com um inteiro (sem preenchimento).
  • n1
    : -1234,23 ► -1.234,2
  • n2
    : 5804,236 ► 5.804,24
  • n3
    : -1234,23 ► -1.234,230
e
Notação exponencial.
Após o espaço reservado de formato, o número de casas decimais é configurado com um inteiro.
  • e10
    : 12345.6789 ► 1.2345678900E4
  • e2
    : 2665.778 ► 2.67E3
f
Notação de ponto fixo.
Após o espaço reservado de formato, o número exato de casas decimais é configurado com um inteiro.
  • f3
    : 123 ► 123,000
  • f3
    : 123,23 ► 123,230
  • f4
    : -1898300,678 ► -1.898.300,6780
  • f3
    : 123,4 ► 123,400
p
Porcentagem.
Após o espaço reservado de formato, um inteiro é usado para configurar o número de casas decimais.
  • p
    : 1 ► 100%
  • p3
    : -0,397481 ► -39,748%
x
Notação hexadecimal.
255 ► ff
b
Notação binária.
107 ► 1101011
o
Notação octal.
56 ► 70
Duração e período
Formato
Descrição
Exemplo
c
Formato constante.
  • 3.17:25:30.5000000
  • 4:30:00 AM
g
Formato abreviado geral.
  • (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
Formato geral estendido.
  • (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
String
Formato
Descrição
Exemplo
l
Todas minúsculas.
grüßEN ► grüßen
u
Todas maiúsculas.
grüßEN ► GRÜSSEN
t
Todas as primeiras letras maiúsculas.
grüßEN ► GRÜSSEN
f
Independente de maiúsculas ou minúsculas.
grüßEN ► grüssen
SQL ANSI
Formato
Descrição
Exemplo
sql_identifier
Formata uma determinada
String
ou
LocalizedText
como um identificador de tabela ou coluna.
-
sql_literal
Formata o valor de uma variável como um valor literal SQL (
Número
,
String
,
data
,
hora
e assim por diante).
-

Exemplos de consultas SQL

Parametrize o nome da coluna interna com a condição:
SELECT * FROM Table1 WHERE {0:sql_identifier} > 5
Comparação com uma variável de dados:
SELECT * FROM AlarmsDatalogger WHERE Time > {0:sql_literal}
Parametrize o operador
LIKE
:
SELECT * FROM AlarmsDatalogger WHERE Name LIKE '{0}'
Parametrize uma parte de uma consulta com um espaço reservado:
SELECT * FROM Table1 {0}
O espaço reservado com índice
0
é vinculado a uma variável de string do projeto e parametriza uma coluna; O espaço reservado com índice
1
é vinculado a uma variável numérica que representa o valor do operador de comparação
>
:
SELECT * FROM {0:sql_identifier} WHERE Column1 > {1:sql_literal}
Parametrize o nome da tabela, a coluna e o operador
LIKE
:
SELECT {0:sql_identifier} FROM {1:sql_identifier} WHERE {0:sql_identifier} LIKE '{2}'

Formatação de caminho

Considere estes recursos de formatação de caminho:
  • Para formatar uma string como um caminho de arquivo, você pode usar esta sintaxe:
    {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
  • Para formatar uma string como um URI, você pode usar esta sintaxe:
    {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
  • Para formatar uma parte de um caminho, você pode usar esta sintaxe:
    file:///C:/Reports/Report
    {0}
    .pdf
    .

Formatação inversa

O recurso de formatação inversa permite modificar um valor formatado em tempo de execução para substituir o valor por um novo valor que o aplicativo exibe com a mesma formatação em tempo de execução.
O recurso de formatação inversa requer as seguintes configurações para operar corretamente:
  • O
    Modo
    de vínculo dinâmico do conversor deve ser
    Ler/Gravar
    .
  • O campo
    Formato
    deve ter apenas um espaço reservado ou origem. O espaço reservado pode ter um sufixo e/ou prefixo e ser definido com uma string de formato, como
    {0:n}
    .

Output

A string inserida na propriedade
Formato
, com base nas regras de formatação com valores no lugar do espaço reservado ou espaços reservados.

Exemplo

Dê sua opinião
Tem dúvidas ou comentários sobre esta documentação? Por favor, envie seu comentário aqui.