MaskedTextProvider.InsertAt Methode

Definition

Fügt ein Zeichen oder eine Zeichenfolge an einer bestimmten Position innerhalb der formatierten Zeichenfolge ein.

Überlädt

Name Beschreibung
InsertAt(Char, Int32)

Fügt das angegebene Zeichen an der angegebenen Position innerhalb der formatierten Zeichenfolge ein.

InsertAt(String, Int32)

Fügt die angegebene Zeichenfolge an einer angegebenen Position innerhalb der formatierten Zeichenfolge ein.

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Fügt das angegebene Zeichen an der angegebenen Position in der formatierten Zeichenfolge ein, wobei die letzte Einfügeposition und der Status des Vorgangs zurückgegeben werden.

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Fügt die angegebene Zeichenfolge an einer angegebenen Position innerhalb der formatierten Zeichenfolge ein, wobei die letzte Einfügeposition und der Status des Vorgangs zurückgegeben werden.

InsertAt(Char, Int32)

Fügt das angegebene Zeichen an der angegebenen Position innerhalb der formatierten Zeichenfolge ein.

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

Parameter

input
Char

Der Char einzufügende Text.

position
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, um das Zeichen einzufügen.

Gibt zurück

truewenn die Einfügung erfolgreich war; andernfalls . false

Hinweise

Die InsertAt Methode fügt ein Zeichen an der ersten Bearbeitungsposition an oder darüber hinaus ein, die durch den pos Parameter angegeben wurde. Diese Methode verschiebt alle vorhandenen Zeichen nach der Einfügemarke um eine Position, um Platz für das eingefügte input Zeichen zu schaffen. Wenn eines der folgenden Fehler auftritt, wird die Einfügung nicht ausgeführt, und die Methode gibt zurück false.

  • 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 Einfügezeichen ist kein gültiges Eingabezeichen, inputda es nicht druckbar ist oder nicht mit dem entsprechenden Maskenelement übereinstimmt.

  • Es gibt keine verfügbaren Positionen rechts neben der Einfügemarke, sodass vorhandene Zeichen nicht verschoben werden können.

  • Eine Verschiebung der vorhandenen Zeichen würde zu einer Verletzung der Maske führen.

Eine leere input Zeichenfolge bewirkt keine Änderung in der formatierten Zeichenfolge, gibt jedoch zurück true.

Weitere Informationen

Gilt für:

InsertAt(String, Int32)

Fügt die angegebene Zeichenfolge an einer angegebenen Position innerhalb der formatierten Zeichenfolge ein.

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

Parameter

input
String

Der String einzufügende Text.

position
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, um die Eingabezeichenfolge einzufügen.

Gibt zurück

truewenn die Einfügung erfolgreich war; andernfalls . false

Ausnahmen

Der input Parameter ist null.

Hinweise

Die InsertAt Methode fügt jedes Zeichen aus der input Zeichenfolge in die Bearbeitungspositionen ein, die sich an position pos und darüber hinaus befinden. Diese Methode verschiebt alle vorhandenen Zeichen nach der Einfügemarke um eine Position für jedes eingefügte Zeichen. Wenn einer der folgenden Fehler auftritt, wird keine Einfügung ausgeführt, und die Methode gibt zurück false.

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

  • Nicht genügend bearbeitbare Zeichen sind in der formatierten Zeichenfolge an oder außerhalb der angegebenen Position vorhanden, posum alle Zeichen aus der input Zeichenfolge einzufügen.

  • Mindestens eines der Einfügezeichen ist kein gültiges Eingabezeichen, da sie nicht gedruckt werden können oder nicht mit dem entsprechenden Maskenelement übereinstimmen.

  • Es stehen nicht genügend Positionen rechts neben der Einfügemarke zur Verfügung, sodass vorhandene Zeichen nicht verschoben werden können.

  • Eine Verschiebung der vorhandenen Zeichen würde zu einer Verletzung der Maske führen. Beachten Sie, dass diese Verschiebung während der Einfügung jedes einzelnen Zeichens erfolgt.

Eine leere input Zeichenfolge bewirkt keine Änderung in der formatierten Zeichenfolge, gibt jedoch zurück true.

Weitere Informationen

Gilt für:

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Fügt das angegebene Zeichen an der angegebenen Position in der formatierten Zeichenfolge ein, wobei die letzte Einfügeposition und der Status des Vorgangs zurückgegeben werden.

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

Parameter

input
Char

Der Char einzufügende Text.

position
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, um das Zeichen einzufügen.

testPosition
Int32

Wenn die Methode erfolgreich ist, ist die letzte Position, an der ein Zeichen eingefügt wurde; andernfalls ist die erste Position, an der die Einfügemarke fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

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

Gibt zurück

truewenn die Einfügung erfolgreich war; andernfalls . false

Hinweise

Die InsertAt Methode fügt ein Zeichen an der ersten Bearbeitungsposition an oder darüber hinaus ein, die durch den pos Parameter angegeben wurde. Diese Methode verschiebt alle vorhandenen Zeichen nach der Einfügemarke um eine Position, um Platz für das eingefügte input Zeichen zu schaffen. Wenn eines der folgenden Fehler auftritt, wird die Einfügung nicht ausgeführt, und die Methode gibt zurück false.

  • 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 Einfügezeichen ist kein gültiges Eingabezeichen, inputda es nicht druckbar ist oder nicht mit dem entsprechenden Maskenelement übereinstimmt.

  • Es gibt keine verfügbaren Positionen rechts neben der Einfügemarke, sodass vorhandene Zeichen nicht verschoben werden können.

  • Eine Verschiebung der vorhandenen Zeichen würde zu einer Verletzung der Maske führen.

Eine leere input Zeichenfolge bewirkt keine Änderung in der formatierten Zeichenfolge, gibt jedoch zurück true.

Weitere Informationen

Gilt für:

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Fügt die angegebene Zeichenfolge an einer angegebenen Position innerhalb der formatierten Zeichenfolge ein, wobei die letzte Einfügeposition und der Status des Vorgangs zurückgegeben werden.

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

Parameter

input
String

Der String einzufügende Text.

position
Int32

Die nullbasierte Position in der formatierten Zeichenfolge, um die Eingabezeichenfolge einzufügen.

testPosition
Int32

Wenn die Methode erfolgreich ist, ist die letzte Position, an der ein Zeichen eingefügt wurde; andernfalls ist die erste Position, an der die Einfügemarke fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint
MaskedTextResultHint

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

Gibt zurück

truewenn die Einfügung erfolgreich war; andernfalls . false

Ausnahmen

Der input Parameter ist null.

Hinweise

Die InsertAt Methode fügt jedes Zeichen aus der input Zeichenfolge in die Bearbeitungspositionen ein, die sich an position pos und darüber hinaus befinden. Diese Methode verschiebt alle vorhandenen Zeichen nach der Einfügemarke um eine Position für jedes eingefügte Zeichen. Wenn einer der folgenden Fehler auftritt, wird keine Einfügung ausgeführt, und die Methode gibt zurück false.

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

  • Nicht genügend bearbeitbare Zeichen sind in der formatierten Zeichenfolge an oder außerhalb der angegebenen Position vorhanden, posum alle Zeichen aus der input Zeichenfolge einzufügen.

  • Mindestens eines der Einfügezeichen ist kein gültiges Eingabezeichen, da sie nicht gedruckt werden können oder nicht mit dem entsprechenden Maskenelement übereinstimmen.

  • Es stehen nicht genügend Positionen rechts neben der Einfügemarke zur Verfügung, sodass vorhandene Zeichen nicht verschoben werden können.

  • Eine Verschiebung der vorhandenen Zeichen würde zu einer Verletzung der Maske führen. Beachten Sie, dass diese Verschiebung während der Einfügung jedes einzelnen Zeichens erfolgt.

Eine leere input Zeichenfolge bewirkt keine Änderung in der formatierten Zeichenfolge, gibt jedoch zurück true.

Weitere Informationen

Gilt für: