Partilhar via


Tipo de dados UShort (Visual Basic)

Contém inteiros não assinados de 16 bits (2 bytes) que variam em valor de 0 a 65.535.

Observações

Use o UShort tipo de dados 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 UShort variável atribuindo-lhe um literal decimal, um literal hexadecimal, um literal octal ou (a partir do Visual Basic 2017) um literal binário. Se o literal inteiro estiver fora do intervalo de (isto é, se for menor UInt16.MinValue ou maior que UInt16.MaxValue, ocorrerá um erro de UShort compilação.

No exemplo a seguir, inteiros iguais a 65.034 que são representados como literais decimais, hexadecimais e binários são atribuídos a UShort valores.

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

Você usa o prefixo &h ou &H para denotar um literal hexadecimal, o prefixo &b ou &B para denotar um literal binário e o prefixo &o ou &O para denotar um literal octal. Os literais decimais não têm prefixo.

A partir do Visual Basic 2017, você também pode usar o caractere de sublinhado, _, como um separador de dígitos para melhorar a legibilidade, como mostra o 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 um 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 um separador à esquerda, você deve adicionar o seguinte elemento ao seu arquivo de projeto do Visual Basic (*.vbproj):

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

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

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

Dim number = &H_5826us

Dicas de programação

  • Números negativos. Por UShort ser um tipo não assinado, não pode representar um número negativo. Se você usar o operador unary menos (-) em uma expressão que avalia para digitar UShort, o Visual Basic converte a expressão em Integer primeiro.

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

  • Alargamento. O UShort tipo de dados é ampliado para Integer, UInteger, , Long, ULongDecimal, Singlee Double. Isso significa que você pode converter UShort para qualquer um desses tipos sem encontrar um System.OverflowException erro.

  • Digite caracteres. Anexar os caracteres US de tipo literal a um literal força-o UShort ao tipo de dados. UShort não tem caractere de tipo de identificador.

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

Consulte também