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

Contiene interi senza segno a 16 bit (a 2 byte) nell'intervallo compreso tra 0 e 65.535.Holds unsigned 16-bit (2-byte) integers ranging in value from 0 through 65,535.

NoteRemarks

Usare la 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 un UShort variabile da assegnarle un valore letterale 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 valori interi uguali a 65,034 rappresentati come decimali, esadecimali o valori letterali binari vengono assegnati a 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

Il prefisso viene usato &h oppure &H per indicare un valore letterale esadecimale, il prefisso &b oppure &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 viene illustrato.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 ottale.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 altre informazioni, vedere impostando la versione del linguaggio Visual Basic.For more information see setting the Visual Basic language version.

Valori letterali numerici possono includere anche il US o us Digita carattere per indicare il UShort tipo di dati, come illustrato nell'esempio seguente.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 sulla programmazioneProgramming tips

  • Numeri negativi.Negative Numbers. Poiché UShort è un tipo unsigned, non può rappresentare un numero negativo.Because UShort is an unsigned type, it cannot represent a negative number. Se si usa l'operatore meno unario (-) gli operatori di un'espressione che restituisce il tipo UShort, Visual Basic consente di convertire l'espressione da Integer prima.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 è in parte il Common Language Specification (CLS), in modo che il codice conforme a CLS non è possibile utilizzare un componente che lo usa.The UShort data type is not part of the Common Language Specification (CLS), so CLS-compliant code cannot consume a component that uses it.

  • Widening.Widening. Il UShort può ampliarsi nel tipo di dati 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 convertire UShort a uno di questi tipi senza generare un System.OverflowException errore.This means you can convert UShort to any of these types without encountering a System.OverflowException error.

  • Caratteri tipo.Type Characters. Aggiungendo i caratteri di tipo di valore letterale US a un valore letterale, se ne determina la UShort tipo di dati.Appending the literal type characters US to a literal forces it to the UShort data type. UShort possiede alcun 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