MaskedTextProvider.Add Methode

Definition

Namespace:

System.ComponentModel

Assemblys:

netstandard.dll, System.ComponentModel.TypeConverter.dll

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

Überlädt

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

Add(String, Int32, MaskedTextResultHint)

Quelle:

MaskedTextProvider.cs

Fügt die Zeichen in der angegebenen Eingabezeichenfolge am Ende der formatierten Zeichenfolge hinzu und gibt dann Position 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

Eine String enthaltende Zeichenwerte, 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

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

Gibt zurück

Boolean

true wenn alle Zeichen aus der Eingabezeichenfolge erfolgreich hinzugefügt wurden; andernfalls false wird angegeben, 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 folgenden Gründen fehl:

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

• Es stehen nicht genügend Bearbeitungspositionen in der formatierten Zeichenfolge nach der letzten zugewiesenen Position zur Verfügung.

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

Diese Methode funktioniert mit der überschriebenen Version, die einen einzelnen String Parameter verwendet, 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 Position 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

A MaskedTextResultHint that succinctly describes the result of the operation. 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 folgenden Gründen fehl:

• Der Eingabewert , inputist nicht druckbar oder stimmt nicht mit dem entsprechenden Maskenelement überein.

• In der formatierten Zeichenfolge sind null Bearbeitungspositionen verfügbar, oder nach der letzten zugewiesenen Position sind keine Bearbeitungspositionen verfügbar.

Diese Methode funktioniert mit der überschriebenen Version, die einen einzelnen Char Parameter verwendet, 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 folgenden Gründen fehl:

• Der Eingabewert , inputist nicht druckbar oder stimmt nicht mit dem entsprechenden Maskenelement überein.

• In der formatierten Zeichenfolge sind null Bearbeitungspositionen verfügbar, 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 in 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

Eine String enthaltende Zeichenwerte, 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 wird angegeben, 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 folgenden Gründen fehl:

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

• Es stehen nicht genügend Bearbeitungspositionen in der formatierten Zeichenfolge nach der letzten zugewiesenen Position zur Verfügung.

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