MaskedTextProvider.Add Méthode

Définition

Espace de noms:

System.ComponentModel

Assemblys:

netstandard.dll, System.ComponentModel.TypeConverter.dll

Ajoute un caractère d’entrée ou une chaîne d’entrée à la chaîne mise en forme.

Surcharges

Nom	Description
Add(String, Int32, MaskedTextResultHint)	Ajoute les caractères de la chaîne d’entrée spécifiée à la fin de la chaîne mise en forme, puis génère des informations descriptives et de position.
Add(Char, Int32, MaskedTextResultHint)	Ajoute le caractère d’entrée spécifié à la fin de la chaîne mise en forme, puis génère des informations descriptives et de position.
Add(Char)	Ajoute le caractère d’entrée spécifié à la fin de la chaîne mise en forme.
Add(String)	Ajoute les caractères de la chaîne d’entrée spécifiée à la fin de la chaîne mise en forme.

Add(String, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Ajoute les caractères de la chaîne d’entrée spécifiée à la fin de la chaîne mise en forme, puis génère des informations descriptives et de position.

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

Paramètres

input

String

Valeur String de caractère contenant à ajouter à la chaîne mise en forme.

testPosition

Int32

Position de base zéro dans la chaîne mise en forme où la tentative d’ajout du caractère a été effectuée. Paramètre de sortie.

resultHint

MaskedTextResultHint

Qui MaskedTextResultHint décrit brièvement le résultat de l’opération. Paramètre de sortie.

Retours

Boolean

true si tous les caractères de la chaîne d’entrée ont été ajoutés avec succès ; sinon false , pour indiquer qu’aucun caractère n’a été ajouté.

Remarques

La Add(String, Int32, MaskedTextResultHint) méthode ajoute les caractères de la input chaîne à la chaîne mise en forme, en commençant par la première position disponible après LastAssignedPosition. Cette méthode échoue pour l’une des raisons suivantes :

• Les caractères de la valeur d’entrée, inputne sont pas imprimables, ou la valeur d’entrée ne correspond pas à son élément de masque correspondant.

• Il n’y a pas suffisamment de positions de modification disponibles dans la chaîne mise en forme après la dernière position affectée.

Si cette méthode échoue, aucune addition n’est effectuée et la méthode retourne false.

Cette méthode fonctionne de la même façon que la version substituée prenant un paramètre unique String , Add(String)sauf qu’elle génère des informations supplémentaires.

Voir aussi

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

Add(Char, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Ajoute le caractère d’entrée spécifié à la fin de la chaîne mise en forme, puis génère des informations descriptives et de position.

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

Paramètres

input

Char

Valeur Char à ajouter à la chaîne mise en forme.

testPosition

Int32

Position de base zéro dans la chaîne mise en forme où la tentative d’ajout du caractère a été effectuée. Paramètre de sortie.

resultHint

MaskedTextResultHint

Qui MaskedTextResultHint décrit brièvement le résultat de l’opération. Paramètre de sortie.

Retours

Boolean

true si le caractère d’entrée a été ajouté avec succès ; sinon false.

Remarques

La Add(Char, Int32, MaskedTextResultHint) méthode tente d’ajouter la valeur de input caractère à la première position disponible dans la chaîne mise en forme après la dernière affectation de la position représentée par la LastAssignedPosition propriété. Cette méthode échoue si toutes les positions disponibles sont avant la dernière position affectée. Cette méthode échoue pour l’une des raisons suivantes :

• La valeur d’entrée, n’est inputpas imprimable ou ne correspond pas à son élément mask correspondant.

• Aucune position de modification n’est disponible dans la chaîne mise en forme, ou aucune position de modification n’est disponible après la dernière position affectée.

Cette méthode fonctionne de la même façon que la version substituée prenant un paramètre unique Char , Add(Char)sauf qu’elle génère des informations supplémentaires.

Voir aussi

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

Add(Char)

Source:

MaskedTextProvider.cs

Ajoute le caractère d’entrée spécifié à la fin de la chaîne mise en forme.

public:
 bool Add(char input);

public bool Add(char input);

member this.Add : char -> bool

Public Function Add (input As Char) As Boolean

Paramètres

input

Char

Valeur Char à ajouter à la chaîne mise en forme.

Retours

Boolean

true si le caractère d’entrée a été ajouté avec succès ; sinon false.

Remarques

La Add(Char) méthode ajoute la input valeur de caractère à la première position disponible dans la chaîne mise en forme après la dernière affectation de la position qui est représentée par la LastAssignedPosition propriété. Cette méthode échoue pour l’une des raisons suivantes :

• La valeur d’entrée, n’est inputpas imprimable ou ne correspond pas à son élément mask correspondant.

• Aucune position de modification n’est disponible dans la chaîne mise en forme, ou aucune position de modification n’est disponible après la dernière position affectée.

Voir aussi

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

Add(String)

Source:

MaskedTextProvider.cs

Ajoute les caractères de la chaîne d’entrée spécifiée à la fin de la chaîne mise en forme.

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

public bool Add(string input);

member this.Add : string -> bool

Public Function Add (input As String) As Boolean

Paramètres

input

String

Valeur String de caractère contenant à ajouter à la chaîne mise en forme.

Retours

Boolean

true si tous les caractères de la chaîne d’entrée ont été ajoutés avec succès ; sinon false , pour indiquer qu’aucun caractère n’a été ajouté.

Exceptions

ArgumentNullException

Le input paramètre est null.

Remarques

La Add(String) méthode ajoute les caractères de la input chaîne à la chaîne mise en forme, en commençant par la première position disponible après LastAssignedPosition. Cette méthode échoue pour l’une des raisons suivantes :

• Les caractères de la valeur d’entrée, inputne sont pas imprimables, ou la valeur d’entrée ne correspond pas à son élément de masque correspondant.

• Il n’y a pas suffisamment de positions de modification disponibles dans la chaîne mise en forme après la dernière position affectée.

Si cette méthode échoue, aucune addition n’est effectuée et la méthode retourne false.

Voir aussi

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