BitConverter.ToInt16 方法

参考

定义

命名空间:: System

程序集:: System.Runtime.Extensions.dll

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

ToInt16(Byte[], Int32)	返回由字节数组中指定位置的两个字节转换来的 16 位有符号整数。
ToInt16(ReadOnlySpan<Byte>)	将只读字节范围转换为 16 位带符号整数。

ToInt16(Byte[], Int32)

Source:: BitConverter.cs

Source:: BitConverter.cs

Source:: BitConverter.cs

返回由字节数组中指定位置的两个字节转换来的 16 位有符号整数。

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

参数

value: Byte[]

包含要转换的两个字节的字节数组。

startIndex: Int32

value 内的起始位置。

Int16

由两个字节构成、从 startIndex 开始的 16 位有符号整数。

例外

ArgumentException

startIndex 等于 value 减 1 的长度。

ArgumentNullException

value 为 null。

ArgumentOutOfRangeException

startIndex 小于零或大于 value 减 1 的长度。

示例

下面的代码示例使用 ToInt16 方法将数组的Byte元素转换为Int16值。

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

// Convert two byte array elements to a short and display it.
void BAToInt16( array<unsigned char>^bytes, int index )
{
   short value = BitConverter::ToInt16( bytes, index );
   Console::WriteLine( "{0,5}{1,17}{2,10}", index, BitConverter::ToString( bytes, index, 2 ), value );
}

int main()
{
   array<unsigned char>^byteArray = {15,0,0,128,16,39,240,216,241,255,127};
   Console::WriteLine( "This example of the BitConverter::ToInt16( unsigned "
   "char[ ], int ) \nmethod generates the following output. It "
   "converts elements of a \nbyte array to short values.\n" );
   Console::WriteLine( "initial byte array" );
   Console::WriteLine( "------------------" );
   Console::WriteLine( BitConverter::ToString( byteArray ) );
   Console::WriteLine();
   Console::WriteLine( "{0,5}{1,17}{2,10}", "index", "array elements", "short" );
   Console::WriteLine( "{0,5}{1,17}{2,10}", "-----", "--------------", "-----" );
   
   // 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( unsigned char[ ], 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.
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

注解

方法 ToInt16 将字节从索引 startIndex 转换为 startIndex + 1 的值 Int16 。数组中的字节顺序必须反映计算机系统体系结构的字节数。有关详细信息，请参阅类主题的 BitConverter “备注”部分。

另请参阅

GetBytes(Int16)

适用于

ToInt16(ReadOnlySpan<Byte>)

Source:: BitConverter.cs

Source:: BitConverter.cs

Source:: BitConverter.cs

将只读字节范围转换为 16 位带符号整数。

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

参数

value: ReadOnlySpan<Byte>

包含要转换的字节的只读范围。

Int16

表示已转换字节的 16 位带符号整数。

例外

ArgumentOutOfRangeException

value 的长度小于 2。

适用于

BitConverter.ToInt16 方法

定义

重载

ToInt16(Byte[], Int32)

参数

返回

例外

示例

注解

另请参阅

适用于

ToInt16(ReadOnlySpan<Byte>)

参数

返回

例外

适用于

反馈

其他资源