Replace și Substitute funcții

Se aplică la: Aplicațiile Pânză Copilot Studio Desktop fluxurilor de dateVerse coloane de formule Model aplicații bazate pe platforma Power Platform CLI Dataverse funcții Power Pages

Replace o porțiune a unui șir de text cu un alt șir.

Descriere

Funcția Replace identifică textul de înlocuit cu poziția de început și lungimea.

Funcția Substitute identifică textul de înlocuit prin potrivirea unui șir. Dacă se găsesc mai multe potriviri, le puteți înlocui pe toate sau puteți specifica una pe care să o înlocuiți.

Dacă transmiteți un singur șir, valoarea returnată este șirul modificat. Dacă treceți un tabel cu o singură coloană care conține șiruri, valoarea returnată este un tabel cu o singură coloană cu o Valoare coloana de șiruri modificate. Dacă aveți un tabel cu mai multe coloane, îl puteți modela într-un tabel cu o singură coloană, conform descrierii din lucrul cu tabele.

Sintaxă

Replace( String, StartingPosition, NumberOfCharacters, NewString )

• String - Obligatoriu. Șirul asupra căruia se operează.
• StartingPosition - Obligatoriu. Poziția caracterului pentru a începe înlocuirea. Primul caracter al Șirului este în poziția 1.
• NumberOfCharacters - Obligatoriu. Numărul de caractere de înlocuit în Şir.
• NewString - Obligatoriu. Șir de înlocuire. Numărul de caractere din acest argument poate diferi de argumente NumberOfCharacters.

Substitute( Șir, OldString, NewString [, InstanceNumber ] )

• String - Obligatoriu. Șirul asupra căruia se operează.
• OldString - Obligatoriu. Șirul de înlocuit.
• NewString - Obligatoriu. Șir de înlocuire. OldString și NewString pot avea lungimi diferite.
• InstanceNumber - Opțional. Utilizați acest argument pentru a specifica care instanță OldString trebuie înlocuită dacă Șirul conține mai multe instanțe. Dacă nu specificați acest argument, toate instanțele vor fi înlocuite.

Replace( SingleColumnTable, StartingPosition, NumberOfCharacters, NewString )

• SingleColumnTable - Obligatoriu. Un tabel de numere cu o singură coloană de șiruri de utilizat.
• StartingPosition - Obligatoriu. Poziția caracterului pentru a începe înlocuirea. Primul caracter al fiecărui șir din tabel este în poziția 1.
• NumberOfCharacters - Obligatoriu. Numărul de caractere de înlocuit în fiecare șir.
• NewString - Obligatoriu. Șir de înlocuire. Numărul de caractere din acest argument poate diferi de argumente NumberOfCharacters.

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

• SingleColumnTable - Obligatoriu. Un tabel de numere cu o singură coloană de șiruri de utilizat.
• OldString - Obligatoriu. Șirul de înlocuit.
• NewString - Obligatoriu. Șir de înlocuire. OldString și NewString pot avea lungimi diferite.
• InstanceNumber - Opțional. Utilizați acest argument pentru a specifica care instanță OldString trebuie înlocuită dacă Șirul conține mai multe instanțe. Dacă nu specificați acest argument, toate instanțele vor fi înlocuite.

Exemple

Formulă	Descriere	Rezultat
Replace( "abcdefghijk", 6, 5, "*" )	Înlocuiește cinci caractere din "abcdefghijk" cu un singur caracter "*", începând cu al șaselea caracter ("f").	"abcde*k"
Replace( "2019", 3, 2, "20" )	Înlocuiește ultimele două personaje din "2019" cu "20".	"2020"
Replace( "123456", 1, 3, "_" )	Înlocuiește primele trei caractere ale "123456" cu un singur caracter "_".	"_456"
Substitute( "Date vânzări", "Vânzări", "Cost" )	Înlocuiește șirul "Cost" pentru "Vânzări".	"Date despre costuri"
Substitute( "Trimestrul 1, 2018", "1", "2", 1 )	Înlocuiește doar prima instanță "1" cu "2", deoarece al patrulea argument (InstanceNumber) este prevăzut cu un 1.	"Trimestrul 2, 2018"
Substitute( "Trimestrul 1, 2011", "1", "2", 3 )	Înlocuiește doar a treia instanță "1" cu "2", deoarece al patrulea argument (InstanceNumber) este prevăzut cu un 3.	"Trimestrul 1, 2012"
Substitute( "Trimestrul 1, 2011", "1", "2" )	Înlocuiește toate instanțele "1" cu "2", deoarece al patrulea argument (InstanceNumber) nu este prevăzut.	"Trimestrul 2, 2022"
Replace( [ Trimestrul 1, 2018", "Trimestrul 2, 2011", "Trimestrul 4, 2019" ], 9, 1, "3" )	Înlocuiește cel de-al nouălea caracter din fiecare înregistrare a tabelului cu o singură coloană cu "3".	Un tabel cu o singură coloană cu o Value coloană care conține următoarele valori: [ „Trimestru 3, 2018”, "Trimestrul3,2011", "Trimestrul 3, 2019" ]
Substitute( [ "Trim 1, 2018", "Trimestrul 1, 2011", "T1, 2019" ], "1", "3", 1 )	Deoarece al patrulea argument (InstanceNumber) este prevăzut cu o valoare de 1, înlocuiește doar prima instanță "1" în fiecare înregistrare a tabelului cu o singură coloană cu "3".	Un tabel cu o singură coloană cu o coloană Value conținând următoarele valori: [ „Tr. 3, 2018”, "Trimestrul3,2011", "T3,2019"]
Substitute( [ "Trim 1, 2018", "Trimestrul 1, 2011", "T1, 2019" ], "1", "3" )	Deoarece al patrulea argument (InstanceNumber) nu este prevăzut cu o valoare de 1, înlocuiește toate instanțele "1" în fiecare înregistrare a tabelului cu o singură coloană cu "3".	Un tabel cu o singură coloană cu o coloană Value conținând următoarele valori: [ „Qtr 3, 2038”, "Trimestrul 3, 2033", "T3,2039"]