Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a:
Aplicativos do Canvas Fluxos do Copilot Studio Desktop Colunas de fórmulas Dataverse Aplicações orientadas por modelos CLI da Power Platform Funções Dataverse Páginas de energia
Replace uma parte de uma cadeia de caracteres de texto com outra cadeia de caracteres.
Descrição
A Replace função identifica o texto a ser substituído pela posição inicial e comprimento.
A Substitute função identifica o texto a ser substituído pela correspondência de uma cadeia de caracteres. Se for encontrado mais de uma correspondência, pode substituir todas as ou especificar uma para substituir.
Se transmitir uma cadeia única, o valor de retorno será a cadeia modificada. Se transmitir uma tabela de coluna única com cadeias, o valor devolvido será uma tabela de coluna única com uma coluna Valor das cadeias modificadas. Se tiver uma tabela com várias colunas, pode formatá-las para uma tabela com uma única coluna, conforme descrito em trabalhar com tabelas.
Sintaxe
Replace( String, StartingPosition, NumberOfCharacters, NewString )
- string - obrigatório. A cadeia a ser utilizada.
- StartingPosition - Obrigatório. Posição do caráter a iniciar a substituição. O primeiro caráter da Cadeia é na posição 1.
- NumberOfCharacters - Obrigatório. O número de carateres a substituir na Cadeia.
- NewString - Obrigatório. A cadeia de substituição. O número de carateres neste argumento pode diferir do argumento NumberOfCharacters.
Substitute( String, OldString, NewString [, InstanceNumber ] )
- string - obrigatório. A cadeia a ser utilizada.
- OldString - Obrigatório. A cadeia a substituir.
- NewString - Obrigatório. A cadeia de substituição. OldString e NewString podem ter comprimentos diferentes.
- InstanceNumber - Opcional. Utilize este argumento para especificar a instância de OldString a substituir se String contiver mais de uma instância. Se não especificar este argumento, todas as instâncias serão substituídas.
Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )
- SingleColumnTable - Obrigatório. Uma tabela de coluna única de cadeias onde atuar.
- StartingPosition - Obrigatório. Posição do caráter a iniciar a substituição. O primeiro caráter de cada cadeia na tabela está na posição 1.
- NumberOfCharacters - Obrigatório. O número de carateres a substituir em cada cadeia.
- NewString - Obrigatório. A cadeia de substituição. O número de carateres neste argumento pode diferir do argumento NumberOfCharacters.
Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )
- SingleColumnTable - Obrigatório. Uma tabela de coluna única de cadeias onde atuar.
- OldString - Obrigatório. A cadeia a substituir.
- NewString - Obrigatório. A cadeia de substituição. OldString e NewString podem ter comprimentos diferentes.
- InstanceNumber - Opcional. Utilize este argumento para especificar a instância de OldString a substituir se String contiver mais de uma instância. Se não especificar este argumento, todas as instâncias serão substituídas.
Exemplos
| Fórmula | Descrição | Resultado |
|---|---|---|
| Replace( "abcdefghijk", 6, 5, "*" ) | Substitui cinco caracteres em "abcdefghijk" com um único carácter "*", a partir do sexto carácter ("f"). | "abcde*k" |
| Replace( "2019", 3, 2, "20" ) | Substitui os dois últimos caracteres de "2019" por "20". | "2020" |
| Replace( "123456", 1, 3, "_" ) | Substitui os primeiros três caracteres de "123456" por um único carácter "_". | "_456" |
| Substitute( "Dados de vendas", "Vendas", "Custo" ) | Substitui a cadeia de "Cost" por "Sales". | "Dados de custo" |
| Substitute( "Trimestre 1, 2018", "1", "2", 1 ) | Substitui apenas a primeira instância de "1" por "2" porque o quarto argumento (InstanceNumber) é fornecido com um 1. | "2º trimestre de 2018" |
| Substitute( "Trimestre 1, 2011", "1", "2", 3 ) | Substitui apenas a terceira instância de "1" por "2" porque o quarto argumento (InstanceNumber) é fornecido com um 3. | "1º trimestre de 2012" |
| Substitute( "Trimestre 1, 2011", "1", "2" ) | Substitui todas as instâncias de "1" por "2" porque o quarto argumento (InstanceNumber) não é fornecido. | "2º trimestre de 2022" |
|
Replace( [ "Trimestre 1, 2018", "Trimestre 2, 2011", "Trimestre 4, 2019" ], 9, 1, "3" ) |
Substitui o nono carácter em cada registo da tabela de coluna única com "3". | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Quarter 3, 2018","Trimestre 3, 2011", "Trimestre 3, 2019" ] |
|
Substitute( ["Tr 1, 2018", "Trimestre 1, 2011", "T1, 2019" ], "1", "3", 1 ) |
Como o quarto argumento (InstanceNumber) é fornecido com um valor de 1, substitui apenas a primeira instância de "1" em cada registo da tabela de coluna única com "3". | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Qtr 3, 2018","Trimestre 3, 2011", "Q3,2019"] |
|
Substitute( ["Tr 1, 2018", "Trimestre 1, 2011", "T1, 2019" ], "1", "3" ) |
Como o quarto argumento (InstanceNumber) não é fornecido, substitui todas as instância de "1" em cada registo da tabela de coluna única com "3". | Uma tabela de coluna única com uma coluna Value contendo os seguintes valores: [ "Qtr 3, 2038","Trimestre 3, 2033", "Q3,2039"] |