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

Содержит 16-разрядные (2-байтные) целые числа без знака в диапазоне от 0 до 65 535.Holds unsigned 16-bit (2-byte) integers ranging in value from 0 through 65,535.

КомментарииRemarks

Используйте UShort тип данных для хранения двоичных данных, размер которых слишком велик Byte .Use the UShort data type to contain binary data too large for Byte.

Значение по умолчанию для типа UShort — 0.The default value of UShort is 0.

Присваивания литераловLiteral assignments

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

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

Примечание

Используйте префикс &h или &H , чтобы обозначить шестнадцатеричный литерал, префикс &b или &B обозначить двоичный литерал, а также префикс &o или &O обозначить Восьмеричный литерал.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. У десятичных литералов префиксов нет.Decimal literals have no prefix.

Начиная с Visual Basic 2017, можно также использовать символ подчеркивания () в _ качестве разделителя цифр, чтобы улучшить удобочитаемость, как показано в следующем примере.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

Начиная с Visual Basic 15,5, можно также использовать символ подчеркивания () в _ качестве начального разделителя между префиксом и шестнадцатеричными, двоичными или восьмеричными цифрами.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. Пример:For example:

Dim number As UShort = &H_FF8C

Чтобы использовать символ подчеркивания в качестве начального разделителя, нужно добавить в файл проекта Visual Basic (*.vbproj) следующий элемент: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>

Для получения дополнительной информации см.For more information see setting the Visual Basic language version.

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

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

  • Отрицательные числа.Negative Numbers. Так как UShort является неподписанным типом, он не может представлять отрицательное число.Because UShort is an unsigned type, it cannot represent a negative number. При использовании оператора унарного минуса ( - ) в выражении, результатом которого является тип UShort , Visual Basic преобразует выражение в Integer First.If you use the unary minus (-) operator on an expression that evaluates to type UShort, Visual Basic converts the expression to Integer first.

  • Соответствие CLS.CLS Compliance. UShortТип данных не является частью спецификации CLS, поэтому CLS-совместимый код не может использовать компонент, который его использует.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. UShortТип данных расширяется до Integer ,,,,, UInteger Long ULong Decimal Single и Double .The UShort data type widens to Integer, UInteger, Long, ULong, Decimal, Single, and Double. Это означает, что можно преобразовать UShort в любой из этих типов без возникновения System.OverflowException ошибки.This means you can convert UShort to any of these types without encountering a System.OverflowException error.

  • Символы типа.Type Characters. При добавлении символов типа литерала US к литералу он применяет его к UShort типу данных.Appending the literal type characters US to a literal forces it to the UShort data type. UShortне имеет символа типа идентификатора.UShort has no identifier type character.

  • Тип Framework.Framework Type. В .NET Framework данный тип соответствует структуре System.UInt16.The corresponding type in the .NET Framework is the System.UInt16 structure.

См. также разделSee also