MaskedTextProvider.Replace Methode

Definition

Ersetzt mindestens ein bearbeitbares Zeichen in der formatierten Zeichenfolge durch die angegebenen Zeichen.

Überlädt

Name Beschreibung
Replace(String, Int32, Int32, Int32, MaskedTextResultHint)

Ersetzt einen Bereich bearbeitbarer Zeichen zwischen den angegebenen Anfangs- und Endpositionen durch die angegebene Zeichenfolge und gibt dann die Entfernungsposition und beschreibende Informationen aus.

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

Ersetzt ein einzelnes Zeichen zwischen den angegebenen Anfangs- und Endpositionen durch den angegebenen Zeichenwert und gibt dann die Entfernungsposition und beschreibende Informationen aus.

Replace(String, Int32, Int32, MaskedTextResultHint)

Ersetzt einen Bereich von bearbeitbaren Zeichen beginnend an der angegebenen Position durch die angegebene Zeichenfolge und gibt dann die Entfernungsposition und beschreibende Informationen aus.

Replace(Char, Int32, Int32, MaskedTextResultHint)

Ersetzt ein einzelnes Zeichen an oder über die angegebene Position durch den angegebenen Zeichenwert und gibt dann die Entfernungsposition und beschreibende Informationen aus.

Replace(String, Int32)

Ersetzt einen Bereich von bearbeitbaren Zeichen beginnend an der angegebenen Position durch die angegebene Zeichenfolge.

Replace(Char, Int32)

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

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

Ersetzt einen Bereich bearbeitbarer Zeichen zwischen den angegebenen Anfangs- und Endpositionen durch die angegebene Zeichenfolge und gibt dann die Entfernungsposition und 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, der verwendet wird, um die vorhandenen bearbeitbaren Zeichen zu ersetzen.

startPosition
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der der Ersatz beginnt.

endPosition
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der der Ersatz endet.

testPosition
Int32

Bei erfolgreicher Ausführung die nullbasierte Position in der formatierten Zeichenfolge, in der das letzte Zeichen tatsächlich ersetzt wurde; andernfalls die erste Position, an der der Vorgang fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

A MaskedTextResultHint that succinctly describes the result of the replacement operation. Ein Ausgabeparameter.

Gibt zurück

truewenn 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. Bei Der Annahme, dass nach diesem Punkt genügend bearbeitbare Positionen vorhanden sind, werden die vorhandenen Zeichenwerte einzeln durch den Inhalt des Ersetzungszeichenfolgenparameters ersetzt. input

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

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

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

  • Einer der Ersetzungszeichenwerte 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)

Ersetzt ein einzelnes Zeichen zwischen den angegebenen Anfangs- und Endpositionen durch den angegebenen Zeichenwert und gibt dann die Entfernungsposition und 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 der Ersatz beginnt.

endPosition
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der der Ersatz endet.

testPosition
Int32

Bei erfolgreicher Ausführung die nullbasierte Position in der formatierten Zeichenfolge, in der das letzte Zeichen tatsächlich ersetzt wurde; andernfalls die erste Position, an der der Vorgang fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

A MaskedTextResultHint that succinctly describes the result of the replacement operation. Ein Ausgabeparameter.

Gibt zurück

truewenn 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 Eine der folgenden Bedingungen führt zu einer Fehlerbedingung, die bewirkt, dass kein Ersatz ausgeführt wird und ein Wert false zurückgegeben wird:

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

  • Ein bearbeitbares Zeichen wurde im angegebenen Intervall nicht 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)

Ersetzt einen Bereich von bearbeitbaren Zeichen beginnend an der angegebenen Position durch die angegebene Zeichenfolge und gibt dann die Entfernungsposition und 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, der verwendet wird, um die vorhandenen bearbeitbaren Zeichen zu ersetzen.

position
Int32

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

testPosition
Int32

Bei erfolgreicher Ausführung die nullbasierte Position in der formatierten Zeichenfolge, in der das letzte Zeichen tatsächlich ersetzt wurde; andernfalls die erste Position, an der der Vorgang fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

A MaskedTextResultHint that succinctly describes the result of the replacement operation. Ein Ausgabeparameter.

Gibt zurück

truewenn alle Zeichen erfolgreich ersetzt wurden; andernfalls . false

Hinweise

Die Replace(String, Int32, Int32, MaskedTextResultHint) Methode sucht nach der ersten bearbeitbaren Position an oder über die angegebene Position hinaus. pos Bei Der Annahme, dass nach diesem Punkt genügend bearbeitbare Positionen vorhanden sind, werden die vorhandenen Zeichenwerte einzeln durch den Inhalt des Ersetzungszeichenfolgenparameters ersetzt. input

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

  • Der pos Parameter ist kleiner als Null oder größer als die Length formatierte Zeichenfolge.

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

  • Einer der Ersetzungszeichenwerte 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)

Ersetzt ein einzelnes Zeichen an oder über die angegebene Position durch den angegebenen Zeichenwert und gibt dann die Entfernungsposition und 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, die nach dem ersten zu ersetzenden bearbeitbaren Zeichen gesucht werden soll.

testPosition
Int32

Bei erfolgreicher Ausführung die nullbasierte Position in der formatierten Zeichenfolge, in der das letzte Zeichen tatsächlich ersetzt wurde; andernfalls die erste Position, an der der Vorgang fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

A MaskedTextResultHint that succinctly describes the result of the replacement operation. Ein Ausgabeparameter.

Gibt zurück

truewenn 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 hinaus. pos Wenn eine gefunden wird, wird der Wert der bearbeitbaren Position in das angegebene Zeichen geändert. input Eine der folgenden Bedingungen führt zu einer Fehlerbedingung, die bewirkt, dass kein Ersatz ausgeführt wird und ein Wert false zurückgegeben wird:

  • Der pos Parameter ist kleiner als Null oder größer als die Length formatierte Zeichenfolge.

  • Ein bearbeitbares Zeichen wurde in der formatierten Zeichenfolge an oder über der angegebenen Position nicht gefunden. pos

  • 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)

Ersetzt einen Bereich von bearbeitbaren Zeichen beginnend an der angegebenen Position durch die angegebene 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, der verwendet wird, um die vorhandenen bearbeitbaren Zeichen zu ersetzen.

position
Int32

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

Gibt zurück

truewenn 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 die angegebene Position hinaus. pos Unter der Annahme, dass nach diesem Punkt genügend bearbeitbare Positionen vorhanden sind, werden die vorhandenen Zeichenwerte einzeln durch den Inhalt des Ersetzungszeichenfolgenparameters ersetzt. input

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

  • Der pos Parameter ist kleiner als Null oder größer als die Length formatierte Zeichenfolge.

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

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

Weitere Informationen

Gilt für:

Replace(Char, Int32)

Ersetzt ein einzelnes Zeichen an oder über 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, die nach dem ersten zu ersetzenden bearbeitbaren Zeichen gesucht werden soll.

Gibt zurück

truewenn 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 hinaus. pos Wenn eine gefunden wird, wird der Wert der bearbeitbaren Position in das angegebene Zeichen geändert. input Eine der folgenden Bedingungen führt zu einem Fehler, der bewirkt, dass keine Ersetzung ausgeführt wird und ein Wert false zurückgegeben wird:

  • Der pos Parameter ist kleiner als Null oder größer als die Length formatierte Zeichenfolge.

  • Ein bearbeitbares Zeichen wurde in der formatierten Zeichenfolge an oder über der angegebenen Position nicht gefunden. pos

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

Weitere Informationen

Gilt für: