Formatador de strings

Modifique a formatação de um ou mais valores de acordo com uma regra personalizável.

DICA:

É possível usar o formatador de strings para:

Vincular várias strings em uma série.

Adicionar caracteres antes ou depois de um valor, se o valor da variável de origem for numérico.

Aplicar formatação numérica, como casas decimais ou arredondamento flutuante. Consulte Tipos de dados do Formatador de strings.

Formatar e parametrizar consultas SQL para usar em objetos de banco de dados. Consulte Exemplos de consultas SQL do formatador de strings.

Entrada

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 de vínculo dinâmico	Ler Leia do nó de origem para o pai. Padrão para vínculos dinâmicos definidos no NetLogics. Gravar Grave do nó pai para o nó de origem. Ler/gravar Leia do nó de origem para o pai e grave do pai para o nó de origem. Padrão para vínculos dinâmicos criados na UI do FactoryTalk Optix Studio .
Vínculo dinâmico	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. Essa propriedade está disponível somente para instâncias de conversor e não para tipos de conversor.

Formatação

Aninhe os 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.

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
}

Entrada: ns=9;%PROJECTDIR%/Logo.svg
Saída: 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
}

Entrada: ns=9;%PROJECTDIR%/Logo.svg
Saída: 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

Use a formatação inversa para 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:

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}

Saída

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

Representação visual de uma configuração de formatador de strings, mostrando uma entrada de mensagem, um campo de formato com o texto "Apply value: {0}?", e um vínculo dinâmico fazendo referência a um valor de caixa de texto da interface do usuário. — Instância de um formatador de strings

Conversores

Tipos de dados do Formatador de strings

Exemplos de consultas SQL do formatador de strings

Dê sua opinião

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