BitConverter.ToInt16 Metoda

Definicja

Namespace:

System

Zestawów:

netstandard.dll, System.Runtime.dll

Przeciążenia

Nazwa	Opis
ToInt16(ReadOnlySpan<Byte>)	Konwertuje zakres bajtów tylko do odczytu na 16-bitową liczbę całkowitą ze znakiem.
ToInt16(Byte[], Int32)	Zwraca 16-bitową liczbę całkowitą ze znakiem przekonwertowaną z dwóch bajtów na określonej pozycji w tablicy bajtów.

ToInt16(ReadOnlySpan<Byte>)

Źródło:

BitConverter.cs

Konwertuje zakres bajtów tylko do odczytu na 16-bitową liczbę całkowitą ze znakiem.

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

Parametry

value

ReadOnlySpan<Byte>

Zakres tylko do odczytu zawierający bajty do konwersji.

Zwraca

Int16

16-bitowa liczba całkowita ze znakiem reprezentującym przekonwertowane bajty.

Wyjątki

ArgumentOutOfRangeException

Długość value jest mniejsza niż 2.

ToInt16(Byte[], Int32)

Źródło:

BitConverter.cs

Zwraca 16-bitową liczbę całkowitą ze znakiem przekonwertowaną z dwóch bajtów na określonej pozycji w tablicy bajtów.

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

Parametry

value

Byte[]

Tablica bajtów zawierająca dwa bajty do przekonwertowania.

startIndex

Int32

Pozycja początkowa w obiekcie value.

Zwraca

Int16

16-bitowa liczba całkowita ze znakiem utworzona przez dwa bajty rozpoczynające się od startIndex.

Wyjątki

ArgumentException

startIndex równa się długości value minus 1.

ArgumentNullException

Parametr value ma wartość null.

ArgumentOutOfRangeException

startIndex jest mniejsza niż zero lub większa niż długość value minus 1.

Przykłady

Poniższy przykład kodu konwertuje elementy Byte tablic na Int16 wartości za pomocą ToInt16 metody .

// 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

Uwagi

Metoda ToInt16 konwertuje bajty z indeksu startIndex na startIndex + 1 na Int16 wartość. Kolejność bajtów w tablicy musi odzwierciedlać endianness architektury systemu komputerowego. Aby uzyskać więcej informacji, zobacz sekcję Uwagi tematu BitConverter klasy.

Zobacz także

• GetBytes(Int16)