Die Funktionen „Replace“ und „Substitute“

Gilt für: Canvas-Apps Dataverse Formelspalten Desktop-Flows Modellgesteuerte Apps Power Pages Power Platform CLI

Ersetzen Sie einen Teil einer Textzeichenfolge durch eine andere Zeichenfolge.

Beschreibung

Die Replace-Funktion identifiziert den zu ersetzenden Text anhand der Anfangsposition und Länge.

Die Substitute-Funktion identifiziert den zu ersetzenden Text anhand einer Übereinstimmung mit einer Zeichenfolge. Wenn mehr als eine Übereinstimmung gefunden wird, können Sie alle ersetzen oder eine zu ersetzende angeben.

Wenn Sie eine einzelne Zeichenfolge übergeben, ist der Rückgabewert die geänderte Zeichenfolge. Wenn Sie eine einspaltige Tabelle übergeben, die Zeichenfolgen enthält, ist der Rückgabewert eine einspaltige Tabelle mit einer Wert-Spalte geänderter Zeichenfolge. Mehrspaltige Tabellen können in einspaltige Tabellen umgeformt werden, wie unter Arbeiten mit Tabellen beschrieben wird.

Syntax

Ersetzen Sie( String, StartingPosition, NumberOfCharacters, NewString )

• String – Erforderlich. Die zu verarbeitende Zeichenfolge
• Startposition – Erforderlich. Zeichenposition, ab der ersetzt werden soll. Das erste Zeichen von String befindet sich an Position 1.
• NumberOfCharacters – Erforderlich. Die Anzahl der zu ersetzenden Zeichen in String
• NewString – Erforderlich. Die Ersatzzeichenfolge. Die Anzahl der Zeichen in diesem Argument kann sich von dem NumberOfCharacters-Argument unterscheiden.

Ersetzen( Zeichenfolge, Alte Zeichenfolge, Neue Zeichenfolge [, Instanznummer ] )

• String – Erforderlich. Die zu verarbeitende Zeichenfolge
• OldString – Erforderlich. Die zu ersetzende Zeichenfolge
• NewString – Erforderlich. Die Ersatzzeichenfolge. OldString und NewString können unterschiedliche Längen haben.
• Instanznummer – Optional. Verwenden Sie dieses Argument, um anzugeben, welche Instanz von OldString ersetzt werden soll, wenn String mehr als eine Instanz enthält. Wenn Sie dieses Argument nicht angeben, werden alle Instanzen ersetzt.

Ersetzen( Einzelspaltentabelle, Startposition, AnzahlZeichen, NeueZeichenfolge )

• SingleColumnTable – Erforderlich. Eine einspaltige Tabelle mit Zeichenfolgen, die verarbeitet werden sollen.
• Startposition – Erforderlich. Zeichenposition, ab der ersetzt werden soll. Das erste Zeichen einer jeden Zeichenfolge in der Tabelle ist an Position 1.
• NumberOfCharacters – Erforderlich. Die Zahl der zu ersetzenden Zeichen in jeder Zeichenfolge
• NewString – Erforderlich. Die Ersatzzeichenfolge. Die Anzahl der Zeichen in diesem Argument kann sich von dem NumberOfCharacters-Argument unterscheiden.

Ersetzen( Einzelspaltentabelle, AlteZeichenfolge, NeueZeichenfolge [, Instanznummer ] )

• SingleColumnTable – Erforderlich. Eine einspaltige Tabelle mit Zeichenfolgen, die verarbeitet werden sollen.
• OldString – Erforderlich. Die zu ersetzende Zeichenfolge
• NewString – Erforderlich. Die Ersatzzeichenfolge. OldString und NewString können unterschiedliche Längen haben.
• Instanznummer – Optional. Verwenden Sie dieses Argument, um anzugeben, welche Instanz von OldString ersetzt werden soll, wenn String mehr als eine Instanz enthält. Wenn Sie dieses Argument nicht angeben, werden alle Instanzen ersetzt.

Beispiele

Formel	Beschreibung	Ergebnis
Ersetzen( "abcdefghijk", 6, 5, "*" )	Ersetzt fünf Zeichen in "abcdefghijk" durch ein einzelnes "*"-Zeichen, beginnend mit dem sechsten Zeichen ("f").	"abcde*k"
Ersetzen( "2019", 3, 2, "20" )	Ersetzt die letzten beiden Zeichen von "2019" durch "20".	"2020"
Ersetzen( "123456", 1, 3, "_" )	Ersetzt die ersten drei Zeichen von "123456" durch ein einzelnes "_".	"_456"
Ersetzen Sie ("Verkaufsdaten", "Verkäufe", "Kosten")	Ersetzt die Zeichenfolge "Cost" durch "Sales".	"Cost Data"
Ersetzen( "1. Quartal 2018", "1", "2", 1 )	Ersetzt nur die erste Instanz von "1" durch "2", weil das vierte Argument (InstanceNumber) mit einer 1 versehen ist.	"Quarter 2, 2018"
Ersatz( "1. Quartal 2011", "1", "2", 3 )	Ersetzt nur die dritte Instanz von "1" durch "2", weil das vierte Argument (InstanceNumber) mit einer 3 versehen ist.	"Quarter 1, 2012"
Ersatz( "1. Quartal 2011", "1", "2" )	Ersetzt alle Instanzen von "1" durch "2", weil das vierte Argument (InstanceNumber) nicht vorhanden ist.	"Quarter 2, 2022"
Ersetzen( [ „Quartal, 1, 2018“, „Quartal, 2, 2011“, „Quartal, 4, 2019“ ], 9, 1, „3“ )	Ersetzt das neunte Zeichen in jedem Datensatz der einspaltigen Tabelle durch "3".	Eine einspaltige Tabelle mit einer Value-Spalte mit folgenden Werten: [ „3. Quartal 2018“, „Quartal, 3, 2011“, „Quartal, 3, 2019“ ]
Ersatz( [ „Qtr 1, 2018“, „Quartal, 1, 2011“, „Q1, 2019“], „1“, „3“, 1 )	Weil das vierte Argument (InstanceNumber) mit dem Wert 1 versehen wird und nur die erste Instanz von "1" in jedem Datensatz der einspaltigen Tabelle durch "3" ersetzt.	Eine einspaltige Tabelle mit einer Value-Spalte mit folgenden Werten: [ „3. Qu. 2018“, „Quartal, 3, 2011“, "Q3,2019"]
Ersatz( [ „Qtr 1, 2018“, „Quartal, 1, 2011“, „Q1, 2019“], „1“, „3“)	Weil das vierte Argument (InstanceNumber) nicht bereitgestellt wird, werden alle Instanzen von "1" in jedem Datensatz der einspaltigen Tabelle durch "3" ersetzt.	Eine einspaltige Tabelle mit einer Value-Spalte mit folgenden Werten: [ „3. Qu. 2038“, Quartal, 3, 2033, "Q3,2039"]