MaskedTextProvider.InsertAt Méthode

Définition

Espace de noms:

System.ComponentModel

Assembly:

System.ComponentModel.TypeConverter.dll

Insère un caractère ou une chaîne à une position spécifique dans la chaîne mise en forme.

Surcharges

InsertAt(Char, Int32)	Insère le caractère spécifié à la position spécifiée dans la chaîne mise en forme.
InsertAt(String, Int32)	Insère la chaîne spécifiée à une position spécifiée dans la chaîne mise en forme.
InsertAt(Char, Int32, Int32, MaskedTextResultHint)	Insère le caractère spécifié à la position spécifiée dans la chaîne mise en forme et retourne la dernière position d'insertion et l'état de l'opération.
InsertAt(String, Int32, Int32, MaskedTextResultHint)	Insère la chaîne spécifiée à une position spécifiée dans la chaîne mise en forme et retourne la dernière position d'insertion et l'état de l'opération.

InsertAt(Char, Int32)

Source:

MaskedTextProvider.cs

Insère le caractère spécifié à la position spécifiée dans la chaîne mise en forme.

public:
 bool InsertAt(char input, int position);

public bool InsertAt (char input, int position);

member this.InsertAt : char * int -> bool

Public Function InsertAt (input As Char, position As Integer) As Boolean

Paramètres

input

Char

Objet Char à insérer.

position

Int32

Position de base zéro dans la chaîne mise en forme pour insérer le caractère.

Retours

Boolean

true si l'insertion aboutit ; sinon, false.

Remarques

La InsertAt méthode insère un caractère dans la première position de modification à ou au-delà de celle spécifiée par le pos paramètre . Cette méthode déplace tous les caractères existants après le point d’insertion d’une position pour faire de la place pour le caractère inséré input . Si l’une des erreurs suivantes se produit, l’insertion n’est pas effectuée et la méthode retourne false.

• Le pos paramètre est inférieur à zéro ou supérieur à la Length valeur de la chaîne mise en forme.

• Un caractère modifiable n’a pas été trouvé dans la chaîne mise en forme à ou au-delà de la position spécifiée, pos.

• Le caractère d’insertion, input, n’est pas un caractère d’entrée valide, car il n’est pas imprimable ou ne correspond pas à son élément mask correspondant.

• Il n’y a pas de position disponible à droite du point d’insertion, de sorte que les caractères existants ne peuvent pas être déplacés.

• Le changement des caractères existants entraînerait une violation du masque.

Une chaîne vide input n’entraîne aucune modification de la chaîne mise en forme, mais retourne true.

Voir aussi

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32)

Source:

MaskedTextProvider.cs

Insère la chaîne spécifiée à une position spécifiée dans la chaîne mise en forme.

public:
 bool InsertAt(System::String ^ input, int position);

public bool InsertAt (string input, int position);

member this.InsertAt : string * int -> bool

Public Function InsertAt (input As String, position As Integer) As Boolean

Paramètres

input

String

Objet String à insérer.

position

Int32

Position de base zéro dans la chaîne mise en forme pour insérer la chaîne d'entrée.

Retours

Boolean

true si l'insertion aboutit ; sinon, false.

Exceptions

ArgumentNullException

Le paramètre input a la valeur null.

Remarques

La InsertAt méthode insère chaque caractère de la input chaîne dans les positions de modification situées à la position pos et au-delà. Cette méthode déplace tous les caractères existants après le point d’insertion d’une position pour chaque caractère inséré. Si l’une des erreurs suivantes se produit, aucune insertion n’est effectuée et la méthode retourne false.

• Le pos paramètre est inférieur à zéro ou supérieur à la Length valeur de la chaîne mise en forme.

• Il n’existe pas suffisamment de caractères modifiables dans la chaîne mise en forme à la position spécifiée, pos, pour insérer tous les caractères de la input chaîne.

• Un ou plusieurs caractères d’insertion ne sont pas un caractère d’entrée valide, car ils ne sont pas imprimables ou ne correspondent pas à leur élément de masque correspondant.

• Il n’y a pas suffisamment de positions disponibles à droite du point d’insertion, de sorte que les caractères existants ne peuvent pas être déplacés.

• Le changement des caractères existants entraînerait une violation du masque. Notez que ce décalage se produit lors de l’insertion de chaque caractère individuel.

Une chaîne vide input n’entraîne aucune modification de la chaîne mise en forme, mais retourne true.

Voir aussi

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(Char, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Insère le caractère spécifié à la position spécifiée dans la chaîne mise en forme et retourne la dernière position d'insertion et l'état de l'opération.

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

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

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

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

Paramètres

input

Char

Objet Char à insérer.

position

Int32

Position de base zéro dans la chaîne mise en forme pour insérer le caractère.

testPosition

Int32

Si la méthode aboutit, la dernière position où un caractère a été inséré ; sinon, la première position où l'insertion a échoué. Paramètre de sortie.

resultHint

MaskedTextResultHint

MaskedTextResultHint qui décrit succinctement le résultat de l'opération d'insertion. Paramètre de sortie.

Retours

Boolean

true si l'insertion aboutit ; sinon, false.

Remarques

La InsertAt méthode insère un caractère dans la première position de modification à ou au-delà de celle spécifiée par le pos paramètre . Cette méthode déplace tous les caractères existants après le point d’insertion d’une position pour faire de la place pour le caractère inséré input . Si l’une des erreurs suivantes se produit, l’insertion n’est pas effectuée et la méthode retourne false.

• Le pos paramètre est inférieur à zéro ou supérieur à la Length valeur de la chaîne mise en forme.

• Un caractère modifiable n’a pas été trouvé dans la chaîne mise en forme à ou au-delà de la position spécifiée, pos.

• Le caractère d’insertion, input, n’est pas un caractère d’entrée valide, car il n’est pas imprimable ou ne correspond pas à son élément mask correspondant.

• Il n’y a pas de position disponible à droite du point d’insertion, de sorte que les caractères existants ne peuvent pas être déplacés.

• Le changement des caractères existants entraînerait une violation du masque.

Une chaîne vide input n’entraîne aucune modification de la chaîne mise en forme, mais retourne true.

Voir aussi

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString

InsertAt(String, Int32, Int32, MaskedTextResultHint)

Source:

MaskedTextProvider.cs

Insère la chaîne spécifiée à une position spécifiée dans la chaîne mise en forme et retourne la dernière position d'insertion et l'état de l'opération.

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

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

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

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

Paramètres

input

String

Objet String à insérer.

position

Int32

Position de base zéro dans la chaîne mise en forme pour insérer la chaîne d'entrée.

testPosition

Int32

Si la méthode aboutit, la dernière position où un caractère a été inséré ; sinon, la première position où l'insertion a échoué. Paramètre de sortie.

resultHint

MaskedTextResultHint

MaskedTextResultHint qui décrit succinctement le résultat de l'opération d'insertion. Paramètre de sortie.

Retours

Boolean

true si l'insertion aboutit ; sinon, false.

Exceptions

ArgumentNullException

Le paramètre input a la valeur null.

Remarques

La InsertAt méthode insère chaque caractère de la input chaîne dans les positions de modification situées à la position pos et au-delà. Cette méthode déplace tous les caractères existants après le point d’insertion d’une position pour chaque caractère inséré. Si l’une des erreurs suivantes se produit, aucune insertion n’est effectuée et la méthode retourne false.

• Le pos paramètre est inférieur à zéro ou supérieur à la Length valeur de la chaîne mise en forme.

• Il n’existe pas suffisamment de caractères modifiables dans la chaîne mise en forme à la position spécifiée, pos, pour insérer tous les caractères de la input chaîne.

• Un ou plusieurs caractères d’insertion ne sont pas un caractère d’entrée valide, car ils ne sont pas imprimables ou ne correspondent pas à leur élément de masque correspondant.

• Il n’y a pas suffisamment de positions disponibles à droite du point d’insertion, de sorte que les caractères existants ne peuvent pas être déplacés.

• Le changement des caractères existants entraînerait une violation du masque. Notez que ce décalage se produit lors de l’insertion de chaque caractère individuel.

Une chaîne vide input n’entraîne aucune modification de la chaîne mise en forme, mais retourne true.

Voir aussi

• Add
• AvailableEditPositionCount
• Mask
• Remove
• Replace
• Set
• ToDisplayString()
• VerifyString