Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

BitConverter.ToUInt16-Methode: (Byte[], Int32)

 

Veröffentlicht: Oktober 2016

Gibt eine 16-Bit-Ganzzahl ohne Vorzeichen konvertiert, die aus zwei Bytes an einer angegebenen Position in einem Bytearray zurück.

Diese API ist nicht CLS-kompatibel.

Namespace:   System
Assembly:  mscorlib (in mscorlib.dll)

[CLSCompliantAttribute(false)]
public static ushort ToUInt16(
	byte[] value,
	int startIndex
)

Parameter

value
Type: System.Byte[]

Das Array von Bytes.

startIndex
Type: System.Int32

Die Anfangsposition in value.

Rückgabewert

Type: System.UInt16

Eine 16-Bit-Ganzzahl ohne Vorzeichen gebildet, indem zwei Bytes, beginnend bei startIndex.

Exception Condition
ArgumentException

startIndexentspricht der Länge von value minus 1.

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndexist kleiner als 0 (null) oder größer als die Länge des value minus 1.

Die ToUInt16 -Methode konvertiert die Bytes aus dem Index startIndex auf startIndex + 1 fest, um eine UInt16 Wert. Die Reihenfolge der Bytes im Array muss das Endianness der der Architektur des Computersystems widerspiegeln; Weitere Informationen finden Sie im Abschnitt "Hinweise" der BitConverter klassenthema.

Im folgenden Codebeispiel wird konvertiert die Elemente der Byte auf arrays UInt16 Werte mit der ToUInt16 Methode.

// Example of the BitConverter.ToUInt16 method.
using System;

class BytesToUInt16Demo
{
    const string formatter = "{0,5}{1,17}{2,10}";

    // Convert two byte array elements to a ushort and display it.
    public static void BAToUInt16( byte[ ] bytes, int index )
    {
        ushort value = BitConverter.ToUInt16( bytes, index );

        Console.WriteLine( formatter, index, 
            BitConverter.ToString( bytes, index, 2 ), value );
    }

    public static void Main( )
    {
        byte[] byteArray = {
            15, 0, 0, 255, 3, 16, 39, 255, 255, 127 };

        Console.WriteLine( 
            "This example of the BitConverter.ToUInt16( byte[ ], " +
            "int ) \nmethod generates the following output. It " +
            "converts elements \nof a byte array to ushort values.\n" );
        Console.WriteLine( "initial byte array" );
        Console.WriteLine( "------------------" );
        Console.WriteLine( BitConverter.ToString( byteArray ) );
        Console.WriteLine( );
        Console.WriteLine( formatter, "index", "array elements", 
            "ushort" );
        Console.WriteLine( formatter, "-----", "--------------", 
            "------" );

        // Convert byte array elements to ushort values.
        BAToUInt16( byteArray, 1 );
        BAToUInt16( byteArray, 0 );
        BAToUInt16( byteArray, 3 );
        BAToUInt16( byteArray, 5 );
        BAToUInt16( byteArray, 8 );
        BAToUInt16( byteArray, 7 );
    }
}

/*
This example of the BitConverter.ToUInt16( byte[ ], int )
method generates the following output. It converts elements
of a byte array to ushort values.

initial byte array
------------------
0F-00-00-FF-03-10-27-FF-FF-7F

index   array elements    ushort
-----   --------------    ------
    1            00-00         0
    0            0F-00        15
    3            FF-03      1023
    5            10-27     10000
    8            FF-7F     32767
    7            FF-FF     65535
*/

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: