MaskedTextProvider.InsertAt Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
- 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
posParameter 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.
posDas 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
- 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
posParameter 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 derinputZeichenfolge 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
- 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
posParameter 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.
posDas 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
- 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
posParameter 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 derinputZeichenfolge 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.