Funzioni Asc e AscW

Articolo
09/12/2008

Aggiornamento: novembre 2007

Restituiscono un valore Integer che rappresenta il codice carattere corrispondente a un carattere.

Public Overloads Function Asc(ByVal String As Char) As Integer
Public Overloads Function AscW(ByVal String As Char) As Integer
' -or-
Public Overloads Function Asc(ByVal String As String) As Integer
Public Overloads Function AscW(ByVal String As String) As Integer

Parametri

String
Obbligatorio. Qualsiasi espressione Char o String valida. Se String corrisponde a un'espressione String, per l'input viene utilizzato solo il primo carattere della stringa. Se String corrisponde a Nothing o non contiene alcun carattere, si verifica un errore ArgumentException.

Eccezioni

Tipo di eccezione	Numero di errore	Condizione
ArgumentException	5	String è vuoto o ha lunghezza zero.

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

Asc restituisce il punto di codice, o codice carattere, per il carattere di input, che può essere compreso tra 0 e 255 per i valori di set di caratteri a byte singolo (SBCS, Single-Byte Character Set) e tra -32768 e 32767 per i valori di set di caratteri a byte doppio (DBCS, Double-Byte Character Set).

Il valore restituito dipende dalla tabella codici per il thread corrente, contenuta nella proprietà ANSICodePage della classe TextInfo nello spazio dei nomi System.Globalization. È possibile ottenere ANSICodePage specificando System.Globalization.CultureInfo.CurrentCulture.TextInfo.ANSICodePage.

AscW restituisce il punto di codice Unicode per il carattere di input, che può essere compreso tra 0 e 65535. Il valore restituito è indipendente dalle impostazioni della tabella codici e dalle impostazioni cultura per il thread corrente.

Nota:
La funzione AscB delle versioni precedenti di Visual Basic restituisce un codice per un byte, anziché un carattere. Viene utilizzata soprattutto per la conversione di stringhe in applicazioni del set di caratteri a byte doppio (DBCS). A partire da Visual Basic 2005, le stringhe sono in Unicode e la funzione AscB non è più supportata.

Esempio

Nell'esempio riportato di seguito la funzione Asc viene utilizzata per restituire i codici carattere del Tipo di dati Integer (Visual Basic) corrispondenti alla prima lettera di ciascuna stringa.

Dim codeInt As Integer
' The following line of code sets codeInt to 65.
codeInt = Asc("A")
' The following line of code sets codeInt to 97.
codeInt = Asc("a")
' The following line of code sets codeInt to 65.
codeInt = Asc("Apple")