Strings.Left(String, Int32) Méthode

Référence

Définition

Espace de noms:: Microsoft.VisualBasic

Assembly:: Microsoft.VisualBasic.Core.dll

Assembly:: Microsoft.VisualBasic.dll

Source:: Strings.vb

Source:: Strings.vb

Source:: Strings.vb

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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

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

public static string Left (string? str, int Length);

public static string Left (string str, int Length);

static member Left : string * int -> string

Public Function Left (str As String, Length As Integer) As String

Paramètres

str: String

Obligatoire. Expression String dont les caractères situés le plus à gauche sont retournés.

Length: Int32

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é.

Retours

String

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

Exceptions

ArgumentException

Length< 0.

Exemples

Cet exemple illustre l’utilisation de la Left fonction pour retourner une sous-chaîne d’un donné String. Dans une classe qui a une Left propriété, il peut être nécessaire de qualifier entièrement la Left fonction.

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

Remarques

Pour déterminer le nombre de caractères dans str, utilisez la Len fonction . Si elle est utilisée dans une application Windows Forms, ou toute autre classe qui a une Left propriété, vous devez qualifier entièrement la fonction avec Microsoft.VisualBasic.Left.

Notes

La LeftB fonction dans les versions précédentes de Visual Basic retourne une chaîne en octets plutôt qu’en caractères. Elle est principalement utilisée pour convertir des chaînes dans les applications de jeu de caractères sur deux octets (DBCS). Toutes les chaînes Visual Basic actuelles sont en Unicode et LeftB ne sont plus prises en charge.

S’applique à