Share via

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 資料類型不屬於 Common Language Specification (CLS)，因此符合 CLS 規範的程式碼無法取用使用該資料類型的元件。

  • 擴展。 UShort 資料類型可擴展為 Integer、UInteger、Long、ULong、Decimal、Single 和 Double。 這表示，您可以將 UShort 轉換成這些類型的任何一種，而不會發生 System.OverflowException 錯誤。

  • 類型字元。 將常值類型字元 US 附加到常值，會強制其成為 UShort 資料類型。 UShort 沒有識別項型別字元。

  • Framework 類型。 在 .NET Framework 中對應的類型為 System.UInt16 結構。

另請參閱