Funzione Left (Visual Basic)

Aggiornamento: novembre 2007

Restituisce una stringa contenente un numero di caratteri specificato a partire dalla sinistra della stringa.

Public Shared Function Left( _
   ByVal str As String, _
   ByVal Length As Integer _
) As String

Parametri

• str
  Obbligatorio. Espressione String della quale vengono restituiti i primi caratteri a sinistra.

• Length
  Obbligatorio. Espressione Integer. Espressione numerica che indica il numero di caratteri da restituire. Se è uguale a 0, verrà restituita una stringa di lunghezza zero (""). Se è maggiore o uguale al numero di caratteri dell'argomento str, verrà restituita l'intera stringa.

Eccezioni

Se si esegue l'aggiornamento delle applicazioni Visual Basic 6.0 che utilizzano la gestione degli errori non strutturata, vedere la colonna "Numero di errore". È possibile confrontare il numero di errore con la Proprietà Number (oggetto Err). Se possibile, tuttavia, si consiglia di sostituire il controllo dell'errore con la procedura illustrata nella sezione Cenni preliminari sulla gestione strutturata delle eccezioni per Visual Basic.

Note

Per determinare il numero di caratteri in str, utilizzare la funzione Len. Se utilizzata in un'applicazione Windows Form o in qualsiasi altra classe che includa una proprietà Left, la funzione dovrà essere qualificata in modo completo con Microsoft.VisualBasic.Left.

Nota:
La funzione LeftB disponibile nelle versioni precedenti di Visual Basic restituisce una stringa in byte, anziché in caratteri Viene utilizzata soprattutto per la conversione di stringhe in applicazioni del set di caratteri a byte doppio (DBCS). Tutte le stringhe correnti di Visual Basic sono in Unicode e la funzione LeftB non è più supportata.

Esempio

Nell'esempio riportato di seguito viene illustrato l'utilizzo della funzione Left per restituire una sottostringa di una determinata String. In una classe con una proprietà Left può essere necessario qualificare in modo completo la funzione Left.

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

Requisiti

Spazio dei nomi:Microsoft.VisualBasic

**Modulo:**Strings

Assembly: Visual Basic Runtime Library (in Microsoft.VisualBasic.dll)

Vedere anche

Concetti

Riepilogo delle modifiche al supporto degli elementi di programmazione

Riferimenti

Riepilogo della gestione delle stringhe

Funzione Right (Visual Basic)

Funzione Len (Visual Basic)

Funzione Mid (Visual Basic)

ArgumentException