MaskedTextProvider.Add Methode

Definition

Namespace:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Fügt der formatierten Zeichenfolge ein Eingabezeichen oder eine Eingabezeichenfolge hinzu.

Überlädt

Add(String, Int32, MaskedTextResultHint)	Fügt die Zeichen aus der angegebenen Eingabezeichenfolge am Ende der formatierten Zeichenfolge hinzu und gibt dann Positions- und beschreibende Informationen aus.
Add(Char, Int32, MaskedTextResultHint)	Fügt das angegebene Eingabezeichen am Ende der formatierten Zeichenfolge hinzu und gibt dann Positions- und beschreibende Informationen aus.
Add(Char)	Fügt das angegebene Eingabezeichen am Ende der formatierten Zeichenfolge hinzu.
Add(String)	Fügt die Zeichen aus der angegebenen Eingabezeichenfolge am Ende der formatierten Zeichenfolge hinzu.

Add(String, Int32, MaskedTextResultHint)

Quelle:

MaskedTextProvider.cs

Fügt die Zeichen aus der angegebenen Eingabezeichenfolge am Ende der formatierten Zeichenfolge hinzu und gibt dann Positions- und beschreibende Informationen aus.

public:
 bool Add(System::String ^ input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool Add (string input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Add : string * int * MaskedTextResultHint -> bool

Public Function Add (input As String, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parameter

input

String

Ein String mit Zeichenwerten, die an die formatierte Zeichenfolge angefügt werden sollen.

testPosition

Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der versucht wurde, das Zeichen hinzuzufügen. Ein Ausgabeparameter.

resultHint

MaskedTextResultHint

Ein MaskedTextResultHint, mit dem das Ergebnis des Vorgangs kurz beschrieben wird. Ein Ausgabeparameter.

Gibt zurück

Boolean

true, wenn alle Zeichen aus der Eingabezeichenfolge erfolgreich hinzugefügt wurden, andernfalls false, um anzugeben, dass keine Zeichen hinzugefügt wurden.

Hinweise

Die Add(String, Int32, MaskedTextResultHint) -Methode fügt die Zeichen aus der input Zeichenfolge der formatierten Zeichenfolge hinzu, beginnend mit der ersten verfügbaren Position nach LastAssignedPosition. Diese Methode schlägt aus einem der folgenden Gründe fehl:

• Alle Zeichen im Eingabewert inputsind nicht druckbar, oder der Eingabewert stimmt nicht mit dem entsprechenden Maskenelement überein.

• Nach der letzten zugewiesenen Position sind nicht genügend Bearbeitungspositionen in der formatierten Zeichenfolge verfügbar.

Wenn diese Methode fehlschlägt, werden keine Ergänzungen vorgenommen, und die -Methode gibt zurück false.

Diese Methode funktioniert genauso wie die überschriebene Version, wobei ein einzelner String Parameter ( ) verwendet wird, Add(String)mit der Ausnahme, dass zusätzliche Informationen ausgegeben werden.

Weitere Informationen

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString

Add(Char, Int32, MaskedTextResultHint)

Quelle:

MaskedTextProvider.cs

Fügt das angegebene Eingabezeichen am Ende der formatierten Zeichenfolge hinzu und gibt dann Positions- und beschreibende Informationen aus.

public:
 bool Add(char input, [Runtime::InteropServices::Out] int % testPosition, [Runtime::InteropServices::Out] System::ComponentModel::MaskedTextResultHint % resultHint);

public bool Add (char input, out int testPosition, out System.ComponentModel.MaskedTextResultHint resultHint);

member this.Add : char * int * MaskedTextResultHint -> bool

Public Function Add (input As Char, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As Boolean

Parameter

input

Char

Ein Char-Wert, der an die formatierte Zeichenfolge angefügt werden soll.

testPosition

Int32

Die nullbasierte Position in der formatierten Zeichenfolge, an der versucht wurde, das Zeichen hinzuzufügen. Ein Ausgabeparameter.

resultHint

MaskedTextResultHint

Ein MaskedTextResultHint, mit dem das Ergebnis des Vorgangs kurz beschrieben wird. Ein Ausgabeparameter.

Gibt zurück

Boolean

true, wenn das Eingabezeichen erfolgreich hinzugefügt wurde, andernfalls false.

Hinweise

Die Add(Char, Int32, MaskedTextResultHint) -Methode versucht, den input Zeichenwert der ersten verfügbaren Position in der formatierten Zeichenfolge nach der zuletzt zugewiesenen Position hinzuzufügen, die durch die LastAssignedPosition -Eigenschaft dargestellt wird. Diese Methode schlägt fehl, wenn alle verfügbaren Positionen vor der letzten zugewiesenen Position liegen. Diese Methode schlägt aus einem der folgenden Gründe fehl:

• Der Eingabewert input, kann nicht gedruckt werden, oder er stimmt nicht mit dem entsprechenden Maskenelement überein.

• Die formatierte Zeichenfolge enthält keine verfügbaren Bearbeitungspositionen, oder nach der letzten zugewiesenen Position sind keine Bearbeitungspositionen verfügbar.

Diese Methode funktioniert genauso wie die überschriebene Version, wobei ein einzelner Char Parameter ( ) verwendet wird, Add(Char)mit der Ausnahme, dass zusätzliche Informationen ausgegeben werden.

Weitere Informationen

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(Char)

Quelle:

MaskedTextProvider.cs

Fügt das angegebene Eingabezeichen am Ende der formatierten Zeichenfolge hinzu.

public:
 bool Add(char input);

public bool Add (char input);

member this.Add : char -> bool

Public Function Add (input As Char) As Boolean

Parameter

input

Char

Ein Char-Wert, der an die formatierte Zeichenfolge angefügt werden soll.

Gibt zurück

Boolean

true, wenn das Eingabezeichen erfolgreich hinzugefügt wurde, andernfalls false.

Hinweise

Die Add(Char) -Methode fügt den input Zeichenwert der ersten verfügbaren Position in der formatierten Zeichenfolge nach der zuletzt zugewiesenen Position hinzu, die durch die LastAssignedPosition -Eigenschaft dargestellt wird. Diese Methode schlägt aus einem der folgenden Gründe fehl:

• Der Eingabewert input, kann nicht gedruckt werden, oder er stimmt nicht mit dem entsprechenden Maskenelement überein.

• Die formatierte Zeichenfolge enthält keine verfügbaren Bearbeitungspositionen, oder nach der letzten zugewiesenen Position sind keine Bearbeitungspositionen verfügbar.

Weitere Informationen

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyChar(Char, Int32, MaskedTextResultHint)

Add(String)

Quelle:

MaskedTextProvider.cs

Fügt die Zeichen aus der angegebenen Eingabezeichenfolge am Ende der formatierten Zeichenfolge hinzu.

public:
 bool Add(System::String ^ input);

public bool Add (string input);

member this.Add : string -> bool

Public Function Add (input As String) As Boolean

Parameter

input

String

Ein String mit Zeichenwerten, die an die formatierte Zeichenfolge angefügt werden sollen.

Gibt zurück

Boolean

true, wenn alle Zeichen aus der Eingabezeichenfolge erfolgreich hinzugefügt wurden, andernfalls false, um anzugeben, dass keine Zeichen hinzugefügt wurden.

Ausnahmen

ArgumentNullException

Der input-Parameter ist null.

Hinweise

Die Add(String) -Methode fügt die Zeichen aus der input Zeichenfolge der formatierten Zeichenfolge hinzu, beginnend mit der ersten verfügbaren Position nach LastAssignedPosition. Diese Methode schlägt aus einem der folgenden Gründe fehl:

• Alle Zeichen im Eingabewert inputsind nicht druckbar, oder der Eingabewert stimmt nicht mit dem entsprechenden Maskenelement überein.

• Nach der letzten zugewiesenen Position sind nicht genügend Bearbeitungspositionen in der formatierten Zeichenfolge verfügbar.

Wenn diese Methode fehlschlägt, werden keine Ergänzungen vorgenommen, und die -Methode gibt zurück false.

Weitere Informationen

• Replace
• Remove
• InsertAt
• Clear
• Set
• AvailableEditPositionCount
• LastAssignedPosition
• IsValidInputChar(Char)
• VerifyString