MaskedTextProvider.Add Méthode

Définition

Espace de noms:

System.ComponentModel

Assembly:

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

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

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 -> bool

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

Paramètres

input

String

String qui contient des valeurs de caractère à ajouter à la chaîne mise en forme.

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

Boolean

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

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 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 -> bool

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

Paramètres

input

Char

Une valeur Char à ajouter à la chaîne mise en forme.

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

Boolean

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)

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

Une valeur Char à ajouter à la chaîne mise en forme.

Retours

Boolean

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)

Add(String)

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 -> bool

Public Function Add (input As String) As Boolean

Paramètres

input

String

String qui contient des valeurs de caractère à ajouter à la chaîne mise en forme.

Retours

Boolean

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

ArgumentNullException

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