UShort-Datentyp (Visual Basic)

  • Artikel

Speichert 16-Bit-Ganzzahlen (2-Byte) ohne Vorzeichen, deren Werte sich im Bereich von 0 bis 65.535 bewegen.

Hinweise

Verwenden Sie den Datentyp UShort, um binäre Daten zu speichern, die zu groß für Byte sind.

Der Standardwert von UShort lautet 0.

Literalzuweisungen

Sie können eine UShort-Variable deklarieren und initialisieren, indem Sie ihr ein Dezimalliteral, ein hexadezimales Literal, ein oktales Literal oder (ab Visual Basic 2017) ein binäres Literal zuweisen. Wenn Sich das Ganzzahlliteral außerhalb des Bereichs von UShort befindet – sprich, wenn es kleiner als UInt16.MinValue oder größer als UInt16.MaxValue ist – tritt ein Kompilierfehler auf.

Im folgenden Beispiel werden Ganzzahlen wie 65.034, die als dezimale, hexadezimale und binäre Literale dargestellt werden, den UShort-Werten zugewiesen.

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

Hinweis

Verwenden Sie das Präfix &h oder &H zum Kennzeichnen eines hexadezimalen Literals, das Präfix &b oder &B zum Kennzeichnen eines binären Literals und das Präfix &o oder &O zum Kennzeichnen eines oktalen Literals. Dezimale Literale haben kein Präfix.

Ab Visual Basic 2017 können Sie zur besseren Lesbarkeit auch den Unterstrich (_) als Zifferntrennzeichen verwenden, wie im folgenden Beispiel veranschaulicht.

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

Ab Visual Basic 15.5 können Sie auch den Unterstrich (_) als vorangestelltes Trennzeichen zwischen dem Präfix und en hexadezimalen, binären oder oktalen Ziffern verwenden. Beispiel:

Dim number As UShort = &H_FF8C

Um den Unterstrich als vorangestelltes Trennzeichen verwenden zu können, müssen Sie Ihrer Visual Basic-Projektdatei (VBPROJ-Datei) das folgende Element hinzufügen:

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

Weitere Informationen finden Sie unter Auswählen der Visual Basic-Sprachversion.

Numerische Literale können auch die TypzeichenUS oder us enthalten, um den Datentyp UShort anzugeben, wie das folgende Beispiel zeigt.

Dim number = &H_5826us

Programmiertipps

  • Negative Zahlen. Da UShort ein Typ ohne Vorzeichen ist, kann er keine negative Zahl darstellen. Wenn Sie den unären Minusoperator (-) für einen Ausdruck verwenden, der zum Typ UShort ausgewertet wird, konvertiert Visual Basic den Ausdruck zuerst in Integer.

  • CLS-Kompatibilität. Der UShort-Datentyp ist nicht Teil der Common Language Specification (CLS), sodass CLS-kompatibler Code keine Komponente nutzen kann, die ihn verwendet.

  • Erweiterung. Der UShort-Datentyp wird zu Integer, UInteger, Long, ULong, Decimal, Single und Double erweitert. Dies bedeutet, dass Sie UShort in einen dieser Typen konvertieren können, ohne dass ein System.OverflowException-Fehler auftritt.

  • Typzeichen. Durch Anhängen des Literaltypzeichens US an ein Literal wird der UShort-Datentyp erzwungen. UShort hat keine Bezeichner-Typzeichen.

  • Framework-Typ. Der entsprechende Typ in .NET Framework ist die System.UInt16-Struktur.

Siehe auch