Mid, instruction

Article
09/12/2008

Mise à jour : novembre 2007

Remplace un nombre spécifié de caractères d'une variable String par les caractères d'une autre chaîne.

Mid( _
   ByRef Target As String, _
   ByVal Start As Integer, _
   Optional ByVal Length As Integer _
) = StringExpression

Éléments

Target
Requis. Nom de la variable String à modifier.
Start
Requis. Expression Integer. Position du caractère dans Target à l'endroit où le remplacement du texte commence. Start utilise un index de base 1.
Length
Facultatif. Expression Integer. Nombre de caractères à remplacer. Si cette valeur est omise, String est utilisé dans son intégralité.
StringExpression
Requis. Expression String qui remplace une partie de Target.

Exceptions

Type d'exception	Numéro de l'erreur	Condition
ArgumentException	5	Start <= 0 ou Length < 0.

Consultez la colonne « Numéro d'erreur » si vous mettez à niveau des applications Visual Basic 6.0 qui utilisent la gestion des erreurs non structurée. (Vous pouvez comparer le numéro d'erreur par rapport à Number, propriété (objet Err).) Toutefois, lorsque cela est possible, vous devez envisager de remplacer un tel contrôle d'erreur par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

Le nombre de caractères remplacé est toujours inférieur ou égal au nombre de caractères dans Target.

Visual Basic possède les instructions Mid, fonction (Visual Basic) et Mid. Ces éléments fonctionnent à la fois sur un nombre spécifié de caractères dans une chaîne, mais la fonction Mid retourne les caractères pendant que l'instruction Mid remplace les caractères. Pour plus d'informations, consultez Mid, fonction (Visual Basic).

Remarque :
Dans les précédentes versions de Visual Basic, l'instruction MidB remplace une sous-chaîne en octets, plutôt que des caractères. Son rôle est d'abord de convertir des chaînes en applications à jeu de caractères codés sur deux octets (DBCS, Double-Byte Character Set). Toutes les chaînes Visual Basic sont en Unicode, et la fonction MidB n'est plus prise en charge.

Exemple

L'exemple suivant utilise l'instruction Mid pour remplacer un nombre spécifié de caractères dans une variable chaîne par les caractères d'une autre chaîne.

Dim TestString As String
' Initializes string.
TestString = "The dog jumps"
' Returns "The fox jumps".
Mid(TestString, 5, 3) = "fox"
' Returns "The cow jumps".
Mid(TestString, 5) = "cow"
' Returns "The cow jumpe".
Mid(TestString, 5) = "cow jumped over"
' Returns "The duc jumpe".
Mid(TestString, 5, 3) = "duck"