適用於：
畫布應用程式 Copilot Studio 桌面流程 Dataverse 公式欄 模型導向應用程式 Power Platform CLI Dataverse 函數 Power Pages
Replace 文字字串的一部分與另一個字串。
Description
此函數會 Replace 依起始位置和長度來識別要取代的文字。
此 Substitute 函式會透過比對字串來識別要取代的文字。 如果找到多個相符的字串，您可以將它們全部取代或指定一個來取代。
如果您傳遞單一字串，則傳回值是修改後的字串。 如果您傳遞包含字串的單欄資料表，則傳回值是包含已修改字串的值欄的單欄資料表。 如果您有多欄資料表，您可依照 使用資料表 所述，將該資料表改為單欄資料表。
語法
Replace（ 字串、 起始位置、 字元數、 新字串 ）
- string - 必需。 要處理的字串。
- StartingPosition - 必需。 要開始取代的字元位置。 String 的第一個字元在位置 1。
- NumberOfCharacters - 必需。 String 中要取代的字元數。
- NewString - 必需。 取代字串。 此引數中的字元數可能與 NumberOfCharacters 引數不同。
Substitute（ 字串， 舊字串， 新字串 [， 實例編號 ] ）
- string - 必需。 要處理的字串。
- OldString - 必需。 要取代的字串。
- NewString - 必需。 取代字串。 OldString 和 NewString 可以具有不同的長度。
- InstanceNumber - 可選。 當 String 包含多個實例時，請使用此引數來指定要取代的 OldString 實例。 如果不指定此參數，則會取代所有實例。
Replace（ SingleColumnTable、 起始位置、 字元數、 新字串 ）
- SingleColumnTable - 必需。 要處理的字串單欄資料表。
- StartingPosition - 必需。 要開始取代的字元位置。 資料表中每個字串的第一個字元在位置 1。
- NumberOfCharacters - 必需。 每個字串中要取代的字元數。
- NewString - 必需。 取代字串。 此引數中的字元數可能與 NumberOfCharacters 引數不同。
Substitute（ SingleColumnTable， OldString， NewString [， 實例編號 ] ）
- SingleColumnTable - 必需。 要處理的字串單欄資料表。
- OldString - 必需。 要取代的字串。
- NewString - 必需。 取代字串。 OldString 和 NewString 可以具有不同的長度。
- InstanceNumber - 可選。 當 String 包含多個實例時，請使用此引數來指定要取代的 OldString 實例。 如果不指定此參數，則會取代所有實例。
範例
| 公式 | Description | 結果 |
|---|---|---|
| Replace（ “abcdefghijk”， 6， 5， “*” ） | 將「abcdefghijk」中，從第六個字元 (「f」) 開始的五個字元取代為單一「*」字元。 | "abcde*k" |
| Replace( "2019", 3, 2, "20" ) | 將「2019」的後兩個字元取代為「20」。 | 「2020」 |
| Replace( "123456", 1, 3, "_" ) | 會以單一「_ 」字元取代「123456」的前三個字元。 | 「_456」 |
| Substitute（ “銷售數據”、“銷售額”、“成本” ） | 將字串「成本」取代為「銷售」。 | 「成本資料」 |
| Substitute（ “2018年第一季度”， “1”， “2”， 1 ） | 因為第四個參數 (InstanceNumber) 提供 1，所以只取代第一個「1」與「2」的實例。 | 「2018 年第 2 季」 |
| Substitute（ “2011年第一季度”、“1”、“2”、“3 ） | 因為第四個參數 (InstanceNumber) 提供一個 3，所以只將「1」的第三個實例替代為「 2」。 | 「2012 年第 1 季」 |
| Substitute（ “2011年第一季度”、“1”、“2” ） | 因為沒提供第四個參數 (InstanceNumber)，所以將「1」的所有實例替代為「 2」。 | 「2022 年第 2 季」 |
|
Replace( [ “2018 年第 1 季度”， “2011 年第二季度”， “2019 年第 4 季度”]， 9, 1, "3" ) |
會以「3」取代單一欄資料表每個記錄中的第九個字元。 | 單欄資料表，其中的 Value 欄包含下列值：[ "Quarter 3, 2018",“2011 年第三季度”， “2019 年第 3 季度” ] |
|
Substitute( [ “2018 年第 1 季度”， “2011 年第一季度”， “2019 年第一季度”]， "1", "3", 1 ) |
因為第四個參數 (InstanceNumber) 提供的值為 1，所以只會在單一欄表中的每個記錄中只取代第一個「1」的實例。 | 單欄資料表，其中的 Value 欄包含下列值：[ "Qtr 3, 2018",“2011 年第三季度”， “2019 年第三季度” ] |
|
Substitute( [ “2018 年第 1 季度”， “2011 年第一季度”， “2019 年第一季度”]， "1", "3" ) |
因為無法提供第四個參數 (InstanceNumber) ，所以只會在單一欄表中的每個記錄中以「3」來取代所有「1」的實例。 | 單欄資料表，其中的 Value 欄包含下列值：[ "Qtr 3, 2038",“2033 年第三季度”， 「2019年， 第3季」 ] |