Teilen über


MaskedTextProvider.Replace Methode

Definition

Ersetzt ein oder mehrere bearbeitbare Zeichen in der formatierten Zeichenfolge durch die angegebenen Zeichen.

Überlädt

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

Ersetzt einen Bereich bearbeitbarer Zeichen zwischen der angegebenen Anfangs- und Endposition durch die angegebene Zeichenfolge und gibt dann die Löschposition sowie beschreibende Informationen aus.

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

Ersetzt ein einzelnes Zeichen zwischen der angegebenen Anfangs- und Endposition durch den angegebenen Zeichenwert und gibt dann die Löschposition sowie beschreibende Informationen aus.

Replace(String, Int32, Int32, MaskedTextResultHint)

Ersetzt einen Bereich bearbeitbarer Zeichen beginnend an der angegebenen Position und mit der angegebenen Zeichenfolge und gibt dann die Löschposition sowie beschreibende Informationen aus.

Replace(Char, Int32, Int32, MaskedTextResultHint)

Ersetzt ein einzelnes Zeichen an oder hinter der angegebenen Position durch den angegebenen Zeichenwert und gibt dann die Löschposition sowie beschreibende Informationen aus.

Replace(String, Int32)

Ersetzt einen Bereich bearbeitbarer Zeichen und beginnt dabei an der angegebenen Position sowie mit der angegebenen Zeichenfolge.

Replace(Char, Int32)

Ersetzt ein einzelnes Zeichen an oder hinter der angegebenen Position durch den angegebenen Zeichenwert.

Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs

Ersetzt einen Bereich bearbeitbarer Zeichen zwischen der angegebenen Anfangs- und Endposition durch die angegebene Zeichenfolge und gibt dann die Löschposition sowie beschreibende Informationen aus.

public:
 bool Replace(System::String ^ input, int startPosition, int endPosition, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace (string input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : string * int * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As String, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parameter

input
String

Der String-Wert, durch den die vorhandenen bearbeitbaren Zeichen ersetzt werden.

startPosition
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der die Ersetzung beginnt.

endPosition
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der die Ersetzung endet.

testPosition
Int32

Bei Erfolg die nullbasierte Position in der formatierten Zeichenfolge, an der das letzte Zeichen ersetzt wurde, andernfalls die erste Position, an der der Vorgang fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

Ein MaskedTextResultHint, mit dem das Ergebnis der Ersetzung kurz beschrieben wird. Ein Ausgabeparameter.

Gibt zurück

true, wenn alle Zeichen erfolgreich ersetzt wurden, andernfalls false.

Hinweise

Die Replace -Methode sucht nach der ersten bearbeitbaren Position in der formatierten Zeichenfolge zwischen den angegebenen Anfangs- und Endpositionen. Unter der Annahme, dass nach diesem Punkt genügend bearbeitbare Positionen vorhanden sind, werden die vorhandenen Zeichenwerte nacheinander durch den Inhalt des Ersetzungszeichenfolgenparameters inputersetzt.

Die folgenden Bedingungen gelten als Fehler. Wenn ein Fehler auftritt, erfolgt kein Ersatz und Replace gibt zurück false.

  • Die startPos Parameter oder endPos zeigen vor dem Anfang der formatierten Zeichenfolge oder über ihr Ende hinaus.

  • Es gibt nicht genügend bearbeitbare Positionen in der formatierten Zeichenfolge, um den Inhalt der Ersetzungszeichenfolge zu speichern.

  • Einer der Ersatzzeichenwerte ist ungültig, da er nicht druckbar ist oder nicht mit dem entsprechenden Maskenelement übereinstimmt.

Zusätzlich zum Rückgabewert verfügt diese Methode über zwei Ausgabeparameter, um zusätzliche Informationen zum Ersetzungsvorgang zu liefern.

Weitere Informationen

Gilt für:

Replace(Char, Int32, Int32, Int32, MaskedTextResultHint)

Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs

Ersetzt ein einzelnes Zeichen zwischen der angegebenen Anfangs- und Endposition durch den angegebenen Zeichenwert und gibt dann die Löschposition sowie beschreibende Informationen aus.

public:
 bool Replace(char input, int startPosition, int endPosition, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace (char input, int startPosition, int endPosition, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : char * int * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As Char, startPosition As Integer, endPosition As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parameter

input
Char

Der Char-Wert, der den vorhandenen Wert ersetzt.

startPosition
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der die Ersetzung beginnt.

endPosition
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der die Ersetzung endet.

testPosition
Int32

Bei Erfolg die nullbasierte Position in der formatierten Zeichenfolge, an der das letzte Zeichen ersetzt wurde, andernfalls die erste Position, an der der Vorgang fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

Ein MaskedTextResultHint, mit dem das Ergebnis der Ersetzung kurz beschrieben wird. Ein Ausgabeparameter.

Gibt zurück

true, wenn das Zeichen erfolgreich ersetzt wurde, andernfalls false.

Hinweise

Die Replace(Char, Int32, Int32, Int32, MaskedTextResultHint) -Methode sucht nach der ersten bearbeitbaren Position in der formatierten Zeichenfolge zwischen den angegebenen Anfangs- und Endpositionen. Wenn eine gefunden wird, wird der Wert der bearbeitbaren Position in das angegebene Zeichen geändert. input Jede der folgenden Bedingungen führt zu einer Fehlerbedingung, die dazu führt, dass kein Ersatz ausgeführt wird und der Wert zurückgegeben false wird:

  • Die startPos Parameter oder endPos zeigen vor dem Anfang der formatierten Zeichenfolge oder über ihr Ende hinaus.

  • Im angegebenen Intervall wurde kein bearbeitbares Zeichen gefunden.

  • Das Ersetzungszeichen inputist kein gültiges Eingabezeichen, da es nicht druckbar ist oder nicht mit dem entsprechenden Maskenelement übereinstimmt.

Zusätzlich zum Rückgabewert verfügt diese Methode über zwei Ausgabeparameter, um zusätzliche Informationen zum Ersetzungsvorgang zu liefern.

Weitere Informationen

Gilt für:

Replace(String, Int32, Int32, MaskedTextResultHint)

Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs

Ersetzt einen Bereich bearbeitbarer Zeichen beginnend an der angegebenen Position und mit der angegebenen Zeichenfolge und gibt dann die Löschposition sowie beschreibende Informationen aus.

public:
 bool Replace(System::String ^ input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace (string input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : string * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As String, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parameter

input
String

Der String-Wert, durch den die vorhandenen bearbeitbaren Zeichen ersetzt werden.

position
Int32

Die nullbasierte Position, an der nach dem ersten zu ersetzenden bearbeitbaren Zeichen gesucht werden soll.

testPosition
Int32

Bei Erfolg die nullbasierte Position in der formatierten Zeichenfolge, an der das letzte Zeichen ersetzt wurde, andernfalls die erste Position, an der der Vorgang fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

Ein MaskedTextResultHint, mit dem das Ergebnis der Ersetzung kurz beschrieben wird. Ein Ausgabeparameter.

Gibt zurück

true, wenn alle Zeichen erfolgreich ersetzt wurden, andernfalls false.

Hinweise

Die Replace(String, Int32, Int32, MaskedTextResultHint) -Methode sucht nach der ersten bearbeitbaren Position an oder über der angegebenen Position, pos. Unter der Annahme, dass nach diesem Punkt genügend bearbeitbare Positionen vorhanden sind, werden die vorhandenen Zeichenwerte nacheinander durch den Inhalt des Ersetzungszeichenfolgenparameters inputersetzt.

Die folgenden Bedingungen gelten als Fehler. Wenn ein Fehler auftritt, erfolgt kein Ersatz und Replace(String, Int32, Int32, MaskedTextResultHint) gibt zurück false.

  • Der pos Parameter ist kleiner als 0 (null) oder größer als der Length der formatierten Zeichenfolge.

  • Es gibt nicht genügend bearbeitbare Positionen in der formatierten Zeichenfolge, um den Inhalt der Ersetzungszeichenfolge zu speichern.

  • Einer der Ersatzzeichenwerte ist ungültig, da er nicht druckbar ist oder nicht mit dem entsprechenden Maskenelement übereinstimmt.

Zusätzlich zum Rückgabewert verfügt diese Methode über zwei Ausgabeparameter, um zusätzliche Informationen zum Ersetzungsvorgang zu liefern.

Weitere Informationen

Gilt für:

Replace(Char, Int32, Int32, MaskedTextResultHint)

Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs

Ersetzt ein einzelnes Zeichen an oder hinter der angegebenen Position durch den angegebenen Zeichenwert und gibt dann die Löschposition sowie beschreibende Informationen aus.

public:
 bool Replace(char input, int position, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);
public bool Replace (char input, int position, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);
member this.Replace : char * int * int * MaskedTextResultHint -> bool
Public Function Replace (input As Char, position As Integer, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parameter

input
Char

Der Char-Wert, der den vorhandenen Wert ersetzt.

position
Int32

Die nullbasierte Position, an der nach dem ersten zu ersetzenden bearbeitbaren Zeichen gesucht werden soll.

testPosition
Int32

Bei Erfolg die nullbasierte Position in der formatierten Zeichenfolge, an der das letzte Zeichen ersetzt wurde, andernfalls die erste Position, an der der Vorgang fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

Ein MaskedTextResultHint, mit dem das Ergebnis der Ersetzung kurz beschrieben wird. Ein Ausgabeparameter.

Gibt zurück

true, wenn das Zeichen erfolgreich ersetzt wurde, andernfalls false.

Hinweise

Die Replace(Char, Int32, Int32, MaskedTextResultHint) -Methode sucht nach der ersten bearbeitbaren Position in der formatierten Zeichenfolge an oder über die angegebene Position poshinaus. Wenn eine gefunden wird, wird der Wert der bearbeitbaren Position in das angegebene Zeichen geändert. input Jede der folgenden Bedingungen führt zu einer Fehlerbedingung, die dazu führt, dass kein Ersatz ausgeführt wird und der Wert zurückgegeben false wird:

  • Der pos Parameter ist kleiner als 0 (null) oder größer als der Length der formatierten Zeichenfolge.

  • Ein bearbeitbares Zeichen wurde in der formatierten Zeichenfolge an oder über die angegebene Position posnicht gefunden.

  • Das Ersetzungszeichen inputist kein gültiges Eingabezeichen, da es nicht druckbar ist oder nicht mit dem entsprechenden Maskenelement übereinstimmt.

Zusätzlich zum Rückgabewert verfügt diese Methode über zwei Ausgabeparameter, um zusätzliche Informationen zum Ersetzungsvorgang zu liefern.

Weitere Informationen

Gilt für:

Replace(String, Int32)

Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs

Ersetzt einen Bereich bearbeitbarer Zeichen und beginnt dabei an der angegebenen Position sowie mit der angegebenen Zeichenfolge.

public:
 bool Replace(System::String ^ input, int position);
public bool Replace (string input, int position);
member this.Replace : string * int -> bool
Public Function Replace (input As String, position As Integer) As Boolean

Parameter

input
String

Der String-Wert, durch den die vorhandenen bearbeitbaren Zeichen ersetzt werden.

position
Int32

Die nullbasierte Position, an der nach dem ersten zu ersetzenden bearbeitbaren Zeichen gesucht werden soll.

Gibt zurück

true, wenn alle Zeichen erfolgreich ersetzt wurden, andernfalls false.

Ausnahmen

Der input-Parameter ist null.

Hinweise

Die Replace(String, Int32) -Methode sucht nach der ersten bearbeitbaren Position an oder über der angegebenen Position, pos. Unter der Annahme, dass nach diesem Punkt genügend bearbeitbare Positionen vorhanden sind, werden die vorhandenen Zeichenwerte nacheinander durch den Inhalt des Ersetzungszeichenfolgenparameters inputersetzt.

Die folgenden Bedingungen gelten als Fehler. Wenn ein Fehler auftritt, erfolgt kein Ersatz und Replace(String, Int32) gibt zurück false.

  • Der pos Parameter ist kleiner als 0 (null) oder größer als der Length der formatierten Zeichenfolge.

  • Es gibt nicht genügend bearbeitbare Positionen in der formatierten Zeichenfolge, um den Inhalt der Ersetzungszeichenfolge zu speichern.

  • Einer der Ersatzzeichenwerte ist ungültig, da er nicht druckbar ist oder nicht mit dem entsprechenden Maskenelement übereinstimmt.

Weitere Informationen

Gilt für:

Replace(Char, Int32)

Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs
Quelle:
MaskedTextProvider.cs

Ersetzt ein einzelnes Zeichen an oder hinter der angegebenen Position durch den angegebenen Zeichenwert.

public:
 bool Replace(char input, int position);
public bool Replace (char input, int position);
member this.Replace : char * int -> bool
Public Function Replace (input As Char, position As Integer) As Boolean

Parameter

input
Char

Der Char-Wert, der den vorhandenen Wert ersetzt.

position
Int32

Die nullbasierte Position, an der nach dem ersten zu ersetzenden bearbeitbaren Zeichen gesucht werden soll.

Gibt zurück

true, wenn das Zeichen erfolgreich ersetzt wurde, andernfalls false.

Hinweise

Die Replace(Char, Int32) -Methode sucht nach der ersten bearbeitbaren Position in der formatierten Zeichenfolge an oder über die angegebene Position poshinaus. Wenn eine gefunden wird, wird der Wert der bearbeitbaren Position in das angegebene Zeichen geändert. input Jede der folgenden Bedingungen führt zu einem Fehler, der dazu führt, dass kein Ersatz ausgeführt wird und der Wert zurückgegeben false wird:

  • Der pos Parameter ist kleiner als 0 (null) oder größer als der Length der formatierten Zeichenfolge.

  • Ein bearbeitbares Zeichen wurde in der formatierten Zeichenfolge an oder über die angegebene Position posnicht gefunden.

  • Das Ersetzungszeichen inputist kein gültiges Eingabezeichen, da es nicht druckbar ist oder nicht mit dem entsprechenden Maskenelement übereinstimmt.

Weitere Informationen

Gilt für: