Tipo de datos UShort (Visual Basic)

  • Artículo

Contiene enteros de 16 bits (2 bytes) sin signo cuyo valor oscila entre 0 y 65 535.

Comentarios

Use el tipo de datos UShort para contener datos binarios demasiado grandes para Byte.

El valor predeterminado de UShort es 0.

Asignaciones de literales

Puede declarar e inicializar una variable UShort si la asigna a un literal decimal, un literal hexadecimal, un literal octal o (a partir de Visual Basic 2017) un literal binario. Si el literal entero está fuera del intervalo de UShort (es decir, si es inferior a UInt16.MinValue o mayor que UInt16.MaxValue, se produce un error de compilación.

En el ejemplo siguiente, los enteros que equivalen a 65 034 que se representan como literales binarios, hexadecimales y decimales se asignan a valores 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

Use el prefijo &h o &H para denotar un literal hexadecimal, el prefijo &b o &B para denotar un literal binario y el prefijo &o o &O para denotar un literal octal. Los literales decimales no tienen prefijo.

A partir de Visual Basic 2017, también puede usar el carácter de subrayado, _, como un separador de dígitos para mejorar la legibilidad, tal como se muestra en el ejemplo siguiente.

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 partir de Visual Basic 15.5 también puede usar el carácter de subrayado (_) como separador inicial entre el prefijo y los dígitos hexadecimales, binarios u octales. Por ejemplo:

Dim number As UShort = &H_FF8C

Para usar el carácter de subrayado como separador inicial, debe agregar el elemento siguiente al archivo del proyecto de Visual Basic (*.vbproj):

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

Para más información, consulte Selección de la versión del lenguaje de Visual Basic.

Los literales numéricos también pueden incluir el carácter de tipoUS o us para denotar el tipo de datos UShort, como se muestra en el ejemplo siguiente.

Dim number = &H_5826us

sugerencias de programación

  • Números negativos. Dado que UShort es un tipo sin signo, no puede representar un número negativo. Si usa el operador unario menos (-) en una expresión que se evalúa como tipo UShort, Visual Basic convierte primero la expresión en Integer.

  • Conformidad con CLS. El tipo de datos UShort no forma parte de Common Language Specification (CLS), por lo que el código conforme a CLS no puede consumir un componente que lo utilice.

  • Ampliación. El tipo de datos UShort se amplía a Integer, UInteger, Long, ULong, Decimal, Single y Double. Esto significa que puede convertir UShort en cualquiera de estos tipos sin que se produzca un error System.OverflowException.

  • Caracteres de tipo. Al agregar el carácter de tipo literal US a un literal, se convierte forzosamente al tipo de datos UShort. UShort no tiene ningún carácter de tipo identificador.

  • Tipo de Framework. El tipo correspondiente en .NET Framework es la estructura System.UInt16.

Consulte también