Tipo di dati UShort (Visual Basic)UShort data type (Visual Basic)

Include interi senza segno a 16 bit (a 2 byte) compresi tra 0 e 65.535.Holds unsigned 16-bit (2-byte) integers ranging in value from 0 through 65,535.

CommentiRemarks

Utilizzare il UShort tipo di dati per contenere dati binari troppo grandi per Byte .Use the UShort data type to contain binary data too large for Byte.

Il valore predefinito di UShort è 0.The default value of UShort is 0.

Assegnazioni di valori letteraliLiteral assignments

È possibile dichiarare e inizializzare una variabile assegnandogli un valore letterale UShort decimale, un valore letterale esadecimale, un valore letterale ottale o (a partire da Visual Basic 2017) un valore letterale binario.You can declare and initialize a UShort variable by assigning it a decimal literal, a hexadecimal literal, an octal literal, or (starting with Visual Basic 2017) a binary literal. 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.If the integer literal is outside the range of UShort (that is, if it is less than UInt16.MinValue or greater than UInt16.MaxValue, a compilation error occurs.

Nell'esempio seguente, i numeri interi uguali a 65.034 rappresentati come valori letterali decimali, esadecimali e binari vengono assegnati ai UShort valori.In the following example, integers equal to 65,034 that are represented as decimal, hexadecimal, and binary literals are assigned to UShort values.

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

Usare 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.You use the prefix &h or &H to denote a hexadecimal literal, the prefix &b or &B to denote a binary literal, and the prefix &o or &O to denote an octal literal. I valori letterali decimali non hanno prefissi.Decimal literals have no prefix.

A partire da Visual Basic 2017, è anche possibile usare il carattere di sottolineatura, _ , come separatore di cifre per migliorare la leggibilità, come illustrato nell'esempio seguente.Starting with Visual Basic 2017, you can also use the underscore character, _, as a digit separator to enhance readability, as the following example shows.

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, è anche possibile usare il carattere di sottolineatura ( _ ) come separatore iniziale tra il prefisso e le cifre esadecimali, binarie o ottali.Starting with Visual Basic 15.5, you can also use the underscore character (_) as a leading separator between the prefix and the hexadecimal, binary, or octal digits. Ad esempio:For example:

Dim number As UShort = &H_FF8C

Per usare il carattere di sottolineatura come separatore iniziale, è necessario aggiungere l'elemento seguente al file di progetto (*.vbproj) di Visual Basic:To use the underscore character as a leading separator, you must add the following element to your Visual Basic project (*.vbproj) file:

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

Per ulteriori informazioni, vedere Impostazione della versione del linguaggio Visual Basic.For more information see setting the Visual Basic language version.

I valori letterali numerici possono includere anche il US us carattere di tipo o per indicare il UShort tipo di dati, come illustrato nell'esempio riportato di seguito.Numeric literals can also include the US or us type character to denote the UShort data type, as the following example shows.

Dim number = &H_5826us

Suggerimenti per la programmazioneProgramming tips

  • Numeri negativi.Negative Numbers. Poiché UShort è un tipo senza segno, non può rappresentare un numero negativo.Because UShort is an unsigned type, it cannot represent a negative number. Se si usa l'operatore unario meno ( - ) su un'espressione che restituisce il tipo UShort , Visual Basic converte prima l'espressione in Integer .If you use the unary minus (-) operator on an expression that evaluates to type UShort, Visual Basic converts the expression to Integer first.

  • Conformità a CLS.CLS Compliance. Il UShort tipo di dati non fa parte del Common Language Specification (CLS), pertanto il codice conforme a CLS non può utilizzare un componente che lo utilizza.The UShort data type is not part of the Common Language Specification (CLS), so CLS-compliant code cannot consume a component that uses it.

  • Conversioni.Widening. Il UShort tipo di dati viene ampliato in Integer , UInteger , Long , ULong , Decimal , Single e Double .The UShort data type widens to Integer, UInteger, Long, ULong, Decimal, Single, and Double. Ciò significa che è possibile UShort eseguire la conversione in uno di questi tipi senza riscontrare un System.OverflowException errore.This means you can convert UShort to any of these types without encountering a System.OverflowException error.

  • Digitare i caratteri.Type Characters. L'aggiunta di caratteri di tipo letterale US a un valore letterale impone il UShort tipo di dati.Appending the literal type characters US to a literal forces it to the UShort data type. UShortnon ha un carattere di tipo identificatore.UShort has no identifier type character.

  • Tipo di framework.Framework Type. Il tipo corrispondente in .NET Framework è la struttura System.UInt16.The corresponding type in the .NET Framework is the System.UInt16 structure.

Vedere ancheSee also