Tipo di dati UShort (Visual Basic)

Contiene interi senza segno a 16 bit (2 byte) con valori compresi tra 0 e 65.535.

Osservazioni:

Usare il tipo di dati UShort per contenere dati binari troppo grandi per Byte.

Il valore predefinito di UShort è 0.

Assegnazioni di valori letterali

È possibile dichiarare e inizializzare una variabile UShort assegnandole un valore letterale decimale, un valore letterale esadecimale, un valore letterale ottale o (a partire da Visual Basic 2017) un valore letterale binario. Se il valore letterale integer è esterno all'intervallo di UShort, vale a dire se è minore di UInt16.MinValue o maggiore di UInt16.MaxValue, si verifica un errore di compilazione.

Nell'esempio seguente, gli interi uguali a 65.034 rappresentati come valori letterali decimali, esadecimali e binari vengono assegnati ai valori UShort.

Dim ushortValue1 As UShort = 65034
Console.WriteLine(ushortValue1)

Dim ushortValue2 As UShort = &HFE0A
Console.WriteLine(ushortValue2)

Dim ushortValue3 As UShort = &B1111_1110_0000_1010
Console.WriteLine(ushortValue3)
' The example displays the following output:
'          65034
'          65034
'          65034

Nota

Si utilizza il prefisso &h o &H per indicare un valore letterale esadecimale, il prefisso &b o &B per indicare un valore letterale binario e il prefisso &o o &O per indicare un valore letterale ottale. I valori letterali decimali non hanno prefissi.

A partire da Visual Basic 2017, è possibile anche usare il carattere underscore, _, come separatore di cifre per migliorare la leggibilità, come illustrato nell'esempio seguente.

Dim ushortValue1 As UShort = 65_034
Console.WriteLine(ushortValue1)

Dim ushortValue3 As UShort = &B11111110_00001010
Console.WriteLine(ushortValue3)
' The example displays the following output:
'          65034
'          65034

A partire da Visual Basic 15.5, è possibile anche usare il carattere underscore (_) come separatore iniziale tra il prefisso e le cifre esadecimali, binarie oppure ottali. Ad esempio:

Dim number As UShort = &H_FF8C

Per usare il carattere underscore come separatore iniziale, è necessario aggiungere l'elemento seguente al file di progetto Visual Basic (*.vbproj):

<PropertyGroup>
  <LangVersion>15.5</LangVersion>
</PropertyGroup>

Per altre informazioni, vedere Selezionare la versione del linguaggio visual Basic.

I valori letterali numerici possono includere anche il carattere di tipo US o us per indicare il tipo di dati UShort, come illustrato nell'esempio seguente.

Dim number = &H_5826us

Suggerimenti per la programmazione

  • Numeri negativi. Poiché UShort è un tipo senza segno, non può rappresentare un numero negativo. Se si utilizza l'operatore meno unario (-) in un'espressione che restituisce il tipo UShort, Visual Basic converte prima l'espressione in Integer.

  • Conformità a CLS. Il tipo di dati UShort non fa parte del Common Language Specification (CLS), pertanto il codice conforme a CLS non può utilizzare un componente che usa tale tipo di dati.

  • Widening. Il tipo di dati UShort si allarga a Integer, UInteger, Long, ULong, Decimal, Single e Double. Ciò significa che è possibile convertire UShort in uno di questi tipi senza generare un errore System.OverflowException.

  • Caratteri di tipo. Se si accodano i caratteri di tipo letterale US a un valore letterale, si forza la conversione di tale valore nel tipo di dati UShort. UShort non ha alcun carattere di tipo identificatore.

  • Tipo di Framework. Il tipo corrispondente in .NET Framework è la struttura System.UInt16.

Vedi anche