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
Tipo di eccezione |
Numero di errore |
Condizione |
|---|---|---|
Length < 0. |
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.
.gif "Nota") 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