Funcións de substitución e substitución

Aplícase a: Columnas de fórmula de aplicacións Dataverse de lona Desktop flúe aplicacións impulsadas Power Platform por Modelo CLI

Substitúe unha porción dunha cadea de texto por outra cadea.

Descripción

A función Replace identifica o texto que se vai substituír por posición inicial e lonxitude.

A función Substitute identifica o texto que se vai substituír coincidindo cunha cadea. Se se atopa máis dunha coincidencia, pode substituír todas ou especificar unha que se substitúa.

Se pasa unha cadea única, o valor de retorno é a cadea modificada. Se pasas unha táboa dunha soa columna que contén cadeas, o valor de retorno é unha táboa dunha soa columna cunha columna de valor de cadeas modificadas. Se ten unha táboa con varias columnas, pode plasmala nunha táboa dunha única columna, como traballar con táboas describe.

Sintaxe

Replace( String, StartingPosition, NumberOfCharacters, NewString )

• String - Obrigatorio. A cadea na que operar.
• StartingPosition - Obrigatorio. Posición do carácter para iniciar a substitución. O primeiro carácter da Cadea está na posición 1.
• NumberOfCharacters - Obrigatorio. O número de caracteres que substituír na Cadea.
• NewString - Obrigatorio. A cadea de substitución. O número de caracteres neste argumento pode diferir do argumento NumberOfCharacters.

Substitute( String, OldString, NewString [, InstanceNumber ] )

• String - Obrigatorio. A cadea na que operar.
• OldString - Obrigatorio. A cadea que hai que substituír.
• NewString - Obrigatorio. A cadea de substitución. OldString e NewString poden ter diferentes lonxitudes.
• InstanceNumber: Opcional. Use este argumento para especificar que instancia de OldString substituír se a Cadea contén máis dunha instancia. Se non especifica este argumento, substituiranse todas as instancias.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

• SingleColumnTable - Obrigatorio. Unha táboa de cadeas dunha columna na que operar.
• StartingPosition - Obrigatorio. Posición do carácter para iniciar a substitución. O primeiro carácter de cada cadea na táboa está na posición 1.
• NumberOfCharacters - Obrigatorio. O número de caracteres que substituír en cada cadea.
• NewString - Obrigatorio. A cadea de substitución. O número de caracteres neste argumento pode diferir do argumento NumberOfCharacters.

Substitute( SingleColumnTable, OldString, NewString [, InstanceNumber ] )

• SingleColumnTable - Obrigatorio. Unha táboa de cadeas dunha columna na que operar.
• OldString - Obrigatorio. A cadea que hai que substituír.
• NewString - Obrigatorio. A cadea de substitución. OldString e NewString poden ter diferentes lonxitudes.
• InstanceNumber: Opcional. Use este argumento para especificar que instancia de OldString substituír se a Cadea contén máis dunha instancia. Se non especifica este argumento, substituiranse todas as instancias.

Exemplos

Fórmula	Descripción	Resultado
Replace( "abcdefghijk", 6, 5, "*" )	Substitúe cinco caracteres en "abcdefghijk" por un único carácter "*", comezando polo sexto carácter ("f").	"abcde*k"
Replace( "2019", 3, 2, "20" )	Substitúe os dous últimos caracteres de "2019" por "20".	"2020"
Replace( "123456", 1, 3, "_" )	Substitúe os tres primeiros caracteres de "123456" por un único carácter "_".	"_456"
Substitute( "Sales Data", "Sales", "Cost" )	Substitúe a cadea "Cost" por "Sales".	"Cost Data"
Substitute( "Quarter 1, 2018", "1", "2", 1 )	Substitúe só a primeira instancia de "1" por "2" porque o cuarto argumento (InstanceNumber) ofrécese cun 1.	"Quarter 2, 2018"
Substitute( "Quarter 1, 2011", "1", "2", 3 )	Substitúe só a terceira instancia de "1" por "2" porque o cuarto argumento (InstanceNumber) ofrécese cun 3.	"Quarter 1, 2012"
Substitute( "Quarter 1, 2011", "1", "2" )	Substitúe todas as instancias de "1" por "2" porque o cuarto argumento (InstanceNumber) non se ofrece.	"Quarter 2, 2022"
Replace( [ "Quarter 1, 2018", "Quarter 2, 2011", "Quarter 4, 2019" ], 9, 1, "3" )	Substitúe o noveno carácter de cada rexistro da táboa dunha única columna por "3".	Táboa dunha soa columna cunha Value columna que contén os seguintes valores: [ "Trimestre 3, 2018", "Quarter3,2011", "Quarter 3, 2019" ]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3", 1 )	Como o cuarto argumento (InstanceNumber) ofrécese cun valor de 1, substitúese só a primeira instancia de "1" en cada rexistro da táboa dunha única columna por "3".	Táboa dunha soa columna cunha Value columna que contén os seguintes valores: [ "Qtr 3, 2018", "Quarter3,2011", "Q3,2019"]
Substitute( [ "Qtr 1, 2018", "Quarter 1, 2011", "Q1, 2019" ], "1", "3" )	Como o cuarto argumento (InstanceNumber) non se ofrece, substitúense todas as instancias de "1" en cada rexistro da táboa dunha única columna por "3".	Táboa dunha soa columna cunha Value columna que contén os seguintes valores: [ "Qtr 3, 2038", "Quarter 3, 2033", "Q3,2039"]