Тип данных UShort (Visual Basic)

Содержит целое число без знака от 16-разрядного (2-байта) от 0 до 65 535.

Замечания

Используйте тип данных, чтобы содержать слишком большие двоичные UShort данные.Byte

Значение по умолчанию для типа UShort — 0.

Литеральные назначения

Можно объявить и инициализировать UShort переменную, назначив ему десятичный литерал, шестнадцатеричный литерал, восьмеричный литерал или (начиная с Visual Basic 2017) двоичный литерал. Если целочисленный литерал выходит за пределы диапазона UShort (то есть, если он меньше UInt16.MinValue или больше UInt16.MaxValue), возникает ошибка компиляции.

В следующем примере целые числа равны 65 034, представленные как десятичные, шестнадцатеричные и двоичные литералы, присваиваются 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

Примечание.

Вы используете префикс или обозначает шестнадцатеричный литерал, префикс &h или &H&B для обозначения двоичного литерала, а также префикса &b&o или &O для обозначения восьмеричного литерала. У десятичных литералов префиксов нет.

Начиная с Visual Basic 2017, вы также можете использовать символ подчеркивания, _как разделитель цифр для повышения удобочитаемости, как показано в следующем примере.

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

Начиная с Visual Basic 15.5, можно также использовать символ подчеркивания (_) в качестве ведущего разделителя между префиксом и шестнадцатеричными, двоичными или восьмизначными цифрами. Например:

Dim number As UShort = &H_FF8C

Чтобы использовать символ подчеркивания в качестве ведущего разделителя, необходимо добавить следующий элемент в файл проекта Visual Basic (*.vbproj):

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

Дополнительные сведения см. в разделе "Выбор версии языка Visual Basic".

Числовые литералы также могут включать US символ или usсимвол типа для обозначения UShort типа данных, как показано в следующем примере.

Dim number = &H_5826us

Советы по программированию

  • Отрицательные числа. Так как UShort это неподписанный тип, он не может представлять отрицательное число. Если вы используете унарный оператор минус (-) для выражения, которое вычисляет тип UShort, Visual Basic преобразует выражение Integer в первое.

  • Соответствие CLS. UShort Тип данных не является частью спецификации CLS, поэтому код, совместимый с CLS, не может использовать компонент, использующий его.

  • Расширение. Тип UShort данных расширяется до Integer, UInteger, Long, ULong, Decimalи SingleDouble. Это означает, что вы можете преобразовать UShort в любой из этих типов без возникновения System.OverflowException ошибки.

  • Тип символов. Добавление символов US литерального типа к литералу заставляет его к типу UShort данных. UShort не имеет символа типа идентификатора.

  • Тип платформы. В .NET Framework данный тип соответствует структуре System.UInt16.

См. также