BitConverter.ToInt16 Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Überlädt

Name	Beschreibung
ToInt16(ReadOnlySpan<Byte>)	Konvertiert einen schreibgeschützten Bytebereich in eine 16-Bit-Ganzzahl mit Vorzeichen.
ToInt16(Byte[], Int32)	Gibt eine 16-Bit-Ganzzahl zurück, die aus zwei Bytes an einer angegebenen Position in einem Bytearray konvertiert wird.

ToInt16(ReadOnlySpan<Byte>)

Quelle:

BitConverter.cs

Konvertiert einen schreibgeschützten Bytebereich in eine 16-Bit-Ganzzahl mit Vorzeichen.

public:
 static short ToInt16(ReadOnlySpan<System::Byte> value);

public static short ToInt16(ReadOnlySpan<byte> value);

static member ToInt16 : ReadOnlySpan<byte> -> int16

Public Shared Function ToInt16 (value As ReadOnlySpan(Of Byte)) As Short

Parameter

value

ReadOnlySpan<Byte>

Eine schreibgeschützte Spanne, die die zu konvertierenden Bytes enthält.

Gibt zurück

Int16

Eine 16-Bit-ganzzahlige Vorzeichen, die die konvertierten Bytes darstellt.

Ausnahmen

ArgumentOutOfRangeException

Die Länge beträgt value kleiner als 2.

ToInt16(Byte[], Int32)

Quelle:

BitConverter.cs

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

public:
 static short ToInt16(cli::array <System::Byte> ^ value, int startIndex);

public static short ToInt16(byte[] value, int startIndex);

static member ToInt16 : byte[] * int -> int16

Public Shared Function ToInt16 (value As Byte(), startIndex As Integer) As Short

Parameter

value

Byte[]

Ein Bytearray, das die zu konvertierenden beiden Bytes enthält.

startIndex

Int32

Die Startposition innerhalb valuevon .

Gibt zurück

Int16

Eine 16-Bit-ganzzahlige Vorzeichen, die von zwei Bytes gebildet wird, beginnend bei startIndex.

Ausnahmen

ArgumentException

startIndex entspricht der Länge von value minus 1.

ArgumentNullException

value ist null.

ArgumentOutOfRangeException

startIndex ist kleiner als 0 oder größer als die Länge von value minus 1.

Beispiele

Im folgenden Codebeispiel werden Elemente von Byte Arrays mit der ToInt16 Methode in Int16 Werte konvertiert.

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

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

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

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

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

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

        // Convert byte array elements to short values.
        BAToInt16( byteArray, 1 );
        BAToInt16( byteArray, 0 );
        BAToInt16( byteArray, 8 );
        BAToInt16( byteArray, 4 );
        BAToInt16( byteArray, 6 );
        BAToInt16( byteArray, 9 );
        BAToInt16( byteArray, 2 );
    }
}

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

initial byte array
------------------
0F-00-00-80-10-27-F0-D8-F1-FF-7F

index   array elements     short
-----   --------------     -----
    1            00-00         0
    0            0F-00        15
    8            F1-FF       -15
    4            10-27     10000
    6            F0-D8    -10000
    9            FF-7F     32767
    2            00-80    -32768
*/

open System

let print obj1 obj2 obj3 = printfn $"{obj1,5}{obj2,17}{obj3,10}"

// Convert two byte array elements to a short and display it.
let BAToInt16 bytes index =
    let value = BitConverter.ToInt16(bytes, index)

    print index (BitConverter.ToString(bytes, index, 2)) value

let byteArray =
    [| 15uy; 0uy; 0uy; 128uy; 16uy; 39uy; 240uy; 216uy; 241uy; 255uy; 127uy |]

printfn "This example of the BitConverter.ToInt16(byte [], int) \nmethod generates the following output. It converts elements \nof a byte array to short values.\n"
printfn "initial byte array"
printfn "------------------"
printfn $"{BitConverter.ToString byteArray}\n"
print "index" "array elements" "short"
print "-----" "--------------" "-----"

// Convert byte array elements to short values.
BAToInt16 byteArray 1
BAToInt16 byteArray 0
BAToInt16 byteArray 8
BAToInt16 byteArray 4
BAToInt16 byteArray 6
BAToInt16 byteArray 9
BAToInt16 byteArray 2


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

// initial byte array
// ------------------
// 0F-00-00-80-10-27-F0-D8-F1-FF-7F

// index   array elements     short
// -----   --------------     -----
//     1            00-00         0
//     0            0F-00        15
//     8            F1-FF       -15
//     4            10-27     10000
//     6            F0-D8    -10000
//     9            FF-7F     32767
//     2            00-80    -32768

' Example of the BitConverter.ToInt16 method.
Module BytesToInt16Demo

    Const formatter As String = "{0,5}{1,17}{2,10}"
 
    ' Convert two Byte array elements to a Short and display it.
    Sub BAToInt16( bytes( ) As Byte, index As Integer )

        Dim value As Short = BitConverter.ToInt16( bytes, index )

        Console.WriteLine( formatter, index, _
            BitConverter.ToString( bytes, index, 2 ), value )
    End Sub 
       
    Sub Main( )

        Dim byteArray as Byte( ) = { _
             15, 0, 0, 128, 16, 39, 240, 216, 241, 255, 127 }

        Console.WriteLine( _
            "This example of the BitConverter.ToInt16( Byte( ), " & _
            "Integer ) " & vbCrLf & "method generates the " & _
            "following output. It converts elements " & vbCrLf & _
            "of a Byte array to Short values." & vbCrLf )
        Console.WriteLine( "initial Byte array" )
        Console.WriteLine( "------------------" )
        Console.WriteLine( BitConverter.ToString( byteArray ) )
        Console.WriteLine( )
        Console.WriteLine( formatter, "index", "array elements", "Short" )
        Console.WriteLine( formatter, "-----", "--------------", "-----" )
          
        ' Convert Byte array elements to Short values.
        BAToInt16( byteArray, 1 )
        BAToInt16( byteArray, 0 )
        BAToInt16( byteArray, 8 )
        BAToInt16( byteArray, 4 )
        BAToInt16( byteArray, 6 )
        BAToInt16( byteArray, 9 )
        BAToInt16( byteArray, 2 )
    End Sub 
End Module

' This example of the BitConverter.ToInt16( Byte( ), Integer )
' method generates the following output. It converts elements
' of a Byte array to Short values.
' 
' initial Byte array
' ------------------
' 0F-00-00-80-10-27-F0-D8-F1-FF-7F
' 
' index   array elements     Short
' -----   --------------     -----
'     1            00-00         0
'     0            0F-00        15
'     8            F1-FF       -15
'     4            10-27     10000
'     6            F0-D8    -10000
'     9            FF-7F     32767
'     2            00-80    -32768

Hinweise

Die ToInt16 Methode konvertiert die Bytes von Index startIndex in startIndex +1 in einen Int16 Wert. Die Reihenfolge der Bytes im Array muss die Endianität der Architektur des Computersystems widerspiegeln. Weitere Informationen finden Sie im Abschnitt "Hinweise" des BitConverter Klassenthemas.

Weitere Informationen

• GetBytes(Int16)