Partager via

Strings.Left, méthode

  • Article

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

Espace de noms : Microsoft.VisualBasic
Assembly : Microsoft.VisualBasic (dans microsoft.visualbasic.dll)

Syntaxe

'Déclaration
Public Shared Function Left ( _
    str As String, _
    Length As Integer _
) As String
'Utilisation
Dim str As String
Dim Length As Integer
Dim returnValue As String

returnValue = Strings.Left(str, Length)

public static string Left (
    string str,
    int Length
)

public:
static String^ Left (
    String^ str, 
    int Length
)

public static String Left (
    String str, 
    int Length
)

public static function Left (
    str : String, 
    Length : int
) : String

Paramètres

  • str
    Obligatoire. String dont les caractères situés le plus à gauche sont retournés.
  • Length
    Obligatoire. Expression Integer. Expression numérique indiquant le nombre de caractères à retourner. Si ce paramètre a la valeur 0, une chaîne de longueur nulle ("") est retournée. Si sa valeur est supérieure ou égale au nombre de caractères de str, la chaîne est retournée dans son intégralité.

Valeur de retour

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

Notes

Pour plus d'informations, consultez la rubrique Visual Basic Left, fonction (Visual Basic).

Pour déterminer le nombre de caractères contenus dans str, utilisez la fonction Len. En cas d'utilisation dans une application Windows Forms ou toute autre classe disposant d'une propriété Left, vous devez qualifier complètement la fonction avec Microsoft.VisualBasic.Left.

Notes

Dans les précédentes versions de Visual Basic, la fonction LeftB retourne une chaîne en octets plutôt qu'en caractères. Son rôle principal consiste à convertir des chaînes en applications utilisant le jeu de caractères codés sur deux octets (DBCS). Toutes les chaînes Visual Basic en cours sont en Unicode, et la fonction LeftB n'est plus prise en charge.

Exemple

Cet exemple montre l'utilisation de la fonction Left pour retourner une sous-chaîne d'un String donné. Dans une classe qui dispose d'une propriété Left, il peut être nécessaire de qualifier complètement la fonction Left.

Dim TestString As String = "Hello World!"
' Returns "Hello".
Dim subString As String = Microsoft.VisualBasic.Left(TestString, 5)

Plates-formes

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

Informations de version

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0

Voir aussi

Référence

Strings, classe
Membres Strings
Microsoft.VisualBasic, espace de noms
ArgumentException

Autres ressources

Left, fonction (Visual Basic)
Liste des manipulations de chaînes
Right, fonction (Visual Basic)
Len, fonction (Visual Basic)
Mid, fonction (Visual Basic)
Récapitulatif des modifications relatives à la prise en charge des éléments de programmation