Compartilhar via

Tipo de dados UShort (Visual Basic)

  • Artigo

Contém inteiros sem sinal de 16 bits (2 bytes) variando no valor de zero a 65.535.

Comentários

Use o tipo de dados UShort para conter dados binários muito grandes para Byte.

O valor padrão de UShort é 0.

Atribuições literais

Você pode declarar e inicializar uma variável UShort atribuindo a ela um literal decimal, hexadecimal, octal ou (a partir do Visual Basic 2017) binário. Se o literal inteiro estiver fora do intervalo de UShort (ou seja, se for menor que UInt16.MinValue ou maior que UInt16.MaxValue, ocorrerá um erro de compilação.

No exemplo a seguir, inteiros iguais a 65.034 representados como literais decimais, hexadecimais e binários são atribuídos 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

Observação

Use o prefixo &h ou &H para indicar um literal hexadecimal, &b ou &B para indicar um literal binário e &o ou &O para indicar um literal octal. Literais decimais não têm nenhum prefixo.

A partir do Visual Basic 2017, você também pode usar o caractere de sublinhado, _, como separador de dígitos para melhorar a legibilidade, como no exemplo a seguir.

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 do Visual Basic 15.5, você também pode usar o caractere de sublinhado (_) como separador à esquerda entre o prefixo e os dígitos hexadecimais, binários ou octais. Por exemplo:

Dim number As UShort = &H_FF8C

Para usar o caractere de sublinhado como separador à esquerda, você deve adicionar o seguinte elemento ao arquivo de projeto do Visual Basic (*.vbproj):

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

Para obter mais informações, consulte Selecionar a versão da linguagem Visual Basic.

Literais numéricos também podem incluir o caractere de tipo US ou us para denotar o tipo de dados UShort, como mostra o exemplo a seguir.

Dim number = &H_5826us

Dicas de programação

  • Números Negativos. Como UShort é um tipo sem sinal, não pode representar um número negativo. Se você usar o operador unário menos (-) em uma expressão avaliada como tipo UShort, o Visual Basic primeiro converterá a expressão em Integer.

  • Compatível com CLS. O tipo de dados UShort não faz parte da CLS (Common Language Specification), portanto, o código compatível com CLS não pode consumir um componente que o utilize.

  • Ampliação. O tipo de dados UShort é ampliado para Integer, UInteger, Long, ULong, Decimal, Single e Double. Isso significa que você pode converter UShort em qualquer um desses tipos sem a ocorrência de um erro System.OverflowException.

  • Caracteres de tipo. Acrescentar os caracteres do tipo literal US a um literal o força ao tipo de dados UShort. UShort não tem caractere de identificação de tipo.

  • Tipo do Framework. O tipo correspondente no .NET Framework é a estrutura System.UInt16.

Confira também