MaskedTextProvider.Add Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute un caractère d'entrée ou une chaîne d'entrée à la chaîne mise en forme.
Surcharges
| Add(String, Int32, MaskedTextResultHint) |
Ajoute les caractères dans la chaîne d'entrée spécifiée à la fin de la chaîne mise en forme, puis génère les 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 les 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 dans 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
- Source:
- MaskedTextProvider.cs
- Source:
- MaskedTextProvider.cs
Ajoute les caractères dans la chaîne d'entrée spécifiée à la fin de la chaîne mise en forme, puis génère les 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 -> boolPublic Function Add (input As String, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As BooleanParamètres
- testPosition
- Int32
Position de base zéro dans la chaîne mise en forme et ayant fait l'objet d'une tentative d'ajout du caractère. Paramètre de sortie.
- resultHint
- MaskedTextResultHint
MaskedTextResultHint qui décrit succinctement le résultat de l'opération. Paramètre de sortie.
Retours
true si tous les caractères de la chaîne d'entrée ont été correctement ajouté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 :
Tous les caractères de la valeur d’entrée,
input, ne sont pas imprimables, ou la valeur d’entrée ne correspond pas à son élément mask 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 attribuée.
Si cette méthode échoue, aucun ajout n’est effectué et la méthode retourne false.
Cette méthode fonctionne de la même façon que la version remplacée prenant un seul String paramètre, Add(String), sauf qu’elle génère des informations supplémentaires.
Voir aussi
- Replace
- Remove
- InsertAt
- Clear
- Set
- AvailableEditPositionCount
- LastAssignedPosition
- IsValidInputChar(Char)
- VerifyString
S’applique à
Add(Char, Int32, MaskedTextResultHint)
- Source:
- MaskedTextProvider.cs
- Source:
- MaskedTextProvider.cs
- 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 les 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 -> boolPublic Function Add (input As Char, ByRef testPosition As Integer, ByRef resultHint As MaskedTextResultHint) As BooleanParamètres
- testPosition
- Int32
Position de base zéro dans la chaîne mise en forme et ayant fait l'objet d'une tentative d'ajout du caractère. Paramètre de sortie.
- resultHint
- MaskedTextResultHint
MaskedTextResultHint qui décrit succinctement le résultat de l'opération. Paramètre de sortie.
Retours
true si le caractère d'entrée a été correctement ajouté ; 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 position affectée, qui est représentée par la LastAssignedPosition propriété . Cette méthode échoue si toutes les positions disponibles se trouvent avant la dernière position attribuée. Cette méthode échoue pour l’une des raisons suivantes :
La valeur d’entrée,
input, n’est pas imprimable ou ne correspond pas à son élément mask correspondant.Il n’y a aucune position de modification disponible dans la chaîne mise en forme, ou il n’y a aucune position de modification disponible après la dernière position attribuée.
Cette méthode fonctionne de la même façon que la version remplacée prenant un seul Char paramètre, 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)
S’applique à
Add(Char)
- Source:
- MaskedTextProvider.cs
- Source:
- MaskedTextProvider.cs
- 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 -> boolPublic Function Add (input As Char) As BooleanParamètres
Retours
true si le caractère d'entrée a été correctement ajouté ; sinon, false.
Remarques
La Add(Char) méthode ajoute la valeur de input caractère à la première position disponible dans la chaîne mise en forme après la dernière position affectée, 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,
input, n’est pas imprimable ou ne correspond pas à son élément mask correspondant.Il n’y a aucune position de modification disponible dans la chaîne mise en forme, ou il n’y a aucune position de modification disponible après la dernière position attribuée.
Voir aussi
- Replace
- Remove
- InsertAt
- Clear
- Set
- AvailableEditPositionCount
- LastAssignedPosition
- IsValidInputChar(Char)
- VerifyChar(Char, Int32, MaskedTextResultHint)
S’applique à
Add(String)
- Source:
- MaskedTextProvider.cs
- Source:
- MaskedTextProvider.cs
- Source:
- MaskedTextProvider.cs
Ajoute les caractères dans 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 -> boolPublic Function Add (input As String) As BooleanParamètres
Retours
true si tous les caractères de la chaîne d'entrée ont été correctement ajoutés ; sinon, false pour indiquer qu'aucun caractère n'a été ajouté.
Exceptions
Le paramètre input a la valeur 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 :
Tous les caractères de la valeur d’entrée,
input, ne sont pas imprimables, ou la valeur d’entrée ne correspond pas à son élément mask 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 attribuée.
Si cette méthode échoue, aucun ajout n’est effectué et la méthode retourne false.
Voir aussi
- Replace
- Remove
- InsertAt
- Clear
- Set
- AvailableEditPositionCount
- LastAssignedPosition
- IsValidInputChar(Char)
- VerifyString
