MaskedTextProvider.InsertAt Methode

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

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

Überlädt

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 innerhalb der formatierten Zeichenfolge ein und gibt die letzte Einfügeposition sowie den Status des Vorgangs zurück.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Fügt die angegebene Zeichenfolge an einer angegebenen Position innerhalb der formatierten Zeichenfolge ein und gibt die letzte Einfügeposition sowie den Status des Vorgangs zurück.

InsertAt(Char, Int32)

Quelle:

MaskedTextProvider.cs

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

Das einzufügende Char-Objekt.

position

Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der das Zeichen eingefügt werden soll.

Gibt zurück

Boolean

true, wenn die Einfügung erfolgreich war, andernfalls false.

Hinweise

Die InsertAt -Methode fügt ein Zeichen an der ersten Bearbeitungsposition an oder über die durch den pos Parameter angegebene Position ein. 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 einer der folgenden Fehler auftritt, wird die Einfügung nicht ausgeführt, und die -Methode gibt zurück false.

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

• Rechts neben der Einfügemarke sind keine Positionen verfügbar, sodass vorhandene Zeichen nicht verschoben werden können.

• Das Verschieben der vorhandenen Zeichen würde zu einer Verletzung der Maske führen.

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

Weitere Informationen

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32)

Quelle:

MaskedTextProvider.cs

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

Das einzufügende String-Objekt.

position

Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der die Eingabezeichenfolge eingefügt werden soll.

Gibt zurück

Boolean

true, wenn die Einfügung erfolgreich war, andernfalls false.

Ausnahmen

ArgumentNullException

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 kein Einfügevorgang ausgeführt, und die -Methode gibt zurück false.

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

• In der formatierten Zeichenfolge sind nicht genügend bearbeitbare Zeichen an oder über die angegebene Position hinaus vorhanden, posum alle Zeichen aus der input Zeichenfolge einzufügen.

• Mindestens eins der Einfügezeichen sind kein gültiges Eingabezeichen, da sie nicht druckbar sind oder nicht mit dem entsprechenden Maskenelement übereinstimmen.

• Es sind nicht genügend Positionen rechts neben der Einfügemarke verfügbar, sodass vorhandene Zeichen nicht verschoben werden können.

• Das Verschieben der vorhandenen Zeichen würde zu einer Verletzung der Maske führen. Beachten Sie, dass diese Verschiebung während des Einfügens jedes einzelnen Zeichens auftritt.

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

Weitere Informationen

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Quelle:

MaskedTextProvider.cs

Fügt das angegebene Zeichen an der angegebenen Position innerhalb der formatierten Zeichenfolge ein und gibt die letzte Einfügeposition sowie den Status des Vorgangs zurück.

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

Das einzufügende Char-Objekt.

position

Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der das Zeichen eingefügt werden soll.

testPosition

Int32

Bei Erfolg der Methode die Position, an der zuletzt ein Zeichen eingefügt wurde, andernfalls die erste Position, an der die Einfügung fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint

MaskedTextResultHint

Ein MaskedTextResultHint, mit dem das Ergebnis des Einfügevorgangs kurz beschrieben wird. Ein Ausgabeparameter.

Gibt zurück

Boolean

true, wenn die Einfügung erfolgreich war, andernfalls false.

Hinweise

Die InsertAt -Methode fügt ein Zeichen an der ersten Bearbeitungsposition an oder über die durch den pos Parameter angegebene Position ein. 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 einer der folgenden Fehler auftritt, wird die Einfügung nicht ausgeführt, und die -Methode gibt zurück false.

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

• Rechts neben der Einfügemarke sind keine Positionen verfügbar, sodass vorhandene Zeichen nicht verschoben werden können.

• Das Verschieben der vorhandenen Zeichen würde zu einer Verletzung der Maske führen.

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

Weitere Informationen

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Quelle:

MaskedTextProvider.cs

Fügt die angegebene Zeichenfolge an einer angegebenen Position innerhalb der formatierten Zeichenfolge ein und gibt die letzte Einfügeposition sowie den Status des Vorgangs zurück.

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

Das einzufügende String-Objekt.

position

Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der die Eingabezeichenfolge eingefügt werden soll.

testPosition

Int32

Bei Erfolg der Methode die Position, an der zuletzt ein Zeichen eingefügt wurde, andernfalls die erste Position, an der die Einfügung fehlgeschlagen ist. Ein Ausgabeparameter.

resultHint

MaskedTextResultHint

Ein MaskedTextResultHint, mit dem das Ergebnis des Einfügevorgangs kurz beschrieben wird. Ein Ausgabeparameter.

Gibt zurück

Boolean

true, wenn die Einfügung erfolgreich war, andernfalls false.

Ausnahmen

ArgumentNullException

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 kein Einfügevorgang ausgeführt, und die -Methode gibt zurück false.

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

• In der formatierten Zeichenfolge sind nicht genügend bearbeitbare Zeichen an oder über die angegebene Position hinaus vorhanden, posum alle Zeichen aus der input Zeichenfolge einzufügen.

• Mindestens eins der Einfügezeichen sind kein gültiges Eingabezeichen, da sie nicht druckbar sind oder nicht mit dem entsprechenden Maskenelement übereinstimmen.

• Es sind nicht genügend Positionen rechts neben der Einfügemarke verfügbar, sodass vorhandene Zeichen nicht verschoben werden können.

• Das Verschieben der vorhandenen Zeichen würde zu einer Verletzung der Maske führen. Beachten Sie, dass diese Verschiebung während des Einfügens jedes einzelnen Zeichens auftritt.

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

Weitere Informationen

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString