Mid, fonction (Visual Basic)

Mise à jour : novembre 2007

Retourne une chaîne contenant un nombre spécifié de caractères d'une chaîne.

Public Shared Function Mid( _
   ByVal str As String, _
   ByVal Start As Integer, _
   Optional ByVal Length As Integer _
) As String

Paramètres

  • str
    Requis. Expression String à partir de laquelle les caractères sont retournés.

  • Start
    Requis. Expression Integer. Position de départ des caractères à retourner. Si l'argument Start est supérieur au nombre de caractères contenus dans l'argument str, la fonction Mid retourne une chaîne de longueur nulle (""). Start est de base un.

  • Length
    Facultatif. Expression Integer. Nombre de caractères à retourner. Si cet argument est omis ou si le nombre de caractères dans le texte (y compris le caractère à la position Start) est inférieur à ceux qui sont compris dans l'argument Length, tous les caractères entre la position de début et la fin de la chaîne sont retournés.

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 non structurée des erreurs. (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'erreurs par Vue d'ensemble de la gestion structurée des exceptions pour Visual Basic.

Notes

Pour déterminer le nombre de caractères contenus dans str, utilisez la fonction Len.

Visual Basic possède la fonction Mid et l'instruction 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, instruction.

Remarque :

Dans les précédentes versions de Visual Basic, la fonction MidB retourne une 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 la fonction Mid pour retourner un nombre spécifié de caractères à partir d'une chaîne.

' Creates text string.
Dim TestString As String = "Mid Function Demo"
' Returns "Mid".
Dim FirstWord As String = Mid(TestString, 1, 3)
' Returns "Demo".
Dim LastWord As String = Mid(TestString, 14, 4)
' Returns "Function Demo".
Dim MidWords As String = Mid(TestString, 5)

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**Strings

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Voir aussi

Concepts

Récapitulatif des modifications relatives à la prise en charge des éléments de programmation

Référence

Liste des manipulations de chaînes

Left, fonction (Visual Basic)

Len, fonction (Visual Basic)

Trim, LTrim et RTrim, fonctions

Mid, instruction

Right, fonction (Visual Basic)

ArgumentException

Autres ressources

Chaînes en Visual Basic

Introduction aux chaînes en Visual Basic