BitConverter.ToUInt16 メソッド

定義

名前空間:: System

アセンブリ:: netstandard.dll, System.Runtime.dll

アセンブリ:: System.Runtime.Extensions.dll

アセンブリ:: netstandard.dll

アセンブリ:: mscorlib.dll, System.Runtime.Extensions.dll

アセンブリ:: mscorlib.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

オーバーロード

名前	説明
ToUInt16(ReadOnlySpan<Byte>)	読み取り専用バイトスパンを 16 ビット符号なし整数に変換します。
ToUInt16(Byte[], Int32)	バイト配列内の指定した位置にある 2 バイトから変換された 16 ビット符号なし整数を返します。

ToUInt16(ReadOnlySpan<Byte>)

ソース:: BitConverter.cs

ソース:: BitConverter.cs

ソース:: BitConverter.cs

ソース:: BitConverter.cs

ソース:: BitConverter.cs

重要

この API は CLS 準拠ではありません。

読み取り専用バイトスパンを 16 ビット符号なし整数に変換します。

public:
 static System::UInt16 ToUInt16(ReadOnlySpan<System::Byte> value);

[System.CLSCompliant(false)]
public static ushort ToUInt16(ReadOnlySpan<byte> value);

[<System.CLSCompliant(false)>]
static member ToUInt16 : ReadOnlySpan<byte> -> uint16

Public Shared Function ToUInt16 (value As ReadOnlySpan(Of Byte)) As UShort

パラメーター

value: ReadOnlySpan<Byte>

変換するバイトを含む読み取り専用スパン。

返品

UInt16

変換されたバイトを表す 16 ビット符号なし整数。

属性: CLSCompliantAttribute

例外

ArgumentOutOfRangeException

valueの長さが 2 未満です。

適用対象

ToUInt16(Byte[], Int32)

ソース:: BitConverter.cs

ソース:: BitConverter.cs

ソース:: BitConverter.cs

ソース:: BitConverter.cs

ソース:: BitConverter.cs

重要

この API は CLS 準拠ではありません。

バイト配列内の指定した位置にある 2 バイトから変換された 16 ビット符号なし整数を返します。

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

[System.CLSCompliant(false)]
public static ushort ToUInt16(byte[] value, int startIndex);

[<System.CLSCompliant(false)>]
static member ToUInt16 : byte[] * int -> uint16

Public Shared Function ToUInt16 (value As Byte(), startIndex As Integer) As UShort

パラメーター

value: Byte[]

変換する 2 バイトを含むバイトの配列。

startIndex: Int32

value内の開始位置。

返品

UInt16

startIndexから始まる 2 バイトで形成された 16 ビット符号なし整数。

属性: CLSCompliantAttribute

例外

ArgumentException

startIndex は、 value から 1 を引いた長さに等しくなります。

ArgumentNullException

value は nullです。

ArgumentOutOfRangeException

startIndex が 0 より小さいか、 value から 1 を引いた長さより大きい値です。

例

次のコード例では、Byte配列の要素を、UInt16 メソッドを使用して値をToUInt16に変換します。

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

open System

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

// Convert two byte array elements to a ushort and display it.
let BAToUInt16 bytes index =
    let value = BitConverter.ToUInt16(bytes, index)

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

let byteArray =
    [| 15uy; 0uy; 0uy; 255uy; 3uy; 16uy; 39uy; 255uy; 255uy; 127uy |]

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

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

' Example of the BitConverter.ToUInt16 method.
Module BytesToUInt16Demo

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

        Dim value As UInt16 = BitConverter.ToUInt16( bytes, index )

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

        Dim byteArray as Byte( ) = { _
             15, 0, 0, 255, 3, 16, 39, 255, 255, 127 }

        Console.WriteLine( _
            "This example of the BitConverter.ToUInt16( Byte( ), " & _
            "Integer ) " & vbCrLf & "method generates the " & _
            "following output. It converts elements " & vbCrLf & _
            "of a Byte array to UInt16 values." & vbCrLf )
        Console.WriteLine( "initial Byte array" )
        Console.WriteLine( "------------------" )
        Console.WriteLine( BitConverter.ToString( byteArray ) )
        Console.WriteLine( )
        Console.WriteLine( formatter, "index", "array elements", _
            "UInt16" )
        Console.WriteLine( formatter, "-----", "--------------", _
            "------" )
          
        ' Convert Byte array elements to UInt16 values.
        BAToUInt16( byteArray, 1 )
        BAToUInt16( byteArray, 0 )
        BAToUInt16( byteArray, 3 )
        BAToUInt16( byteArray, 5 )
        BAToUInt16( byteArray, 8 )
        BAToUInt16( byteArray, 7 )
    End Sub 
End Module

' This example of the BitConverter.ToUInt16( Byte( ), Integer )
' method generates the following output. It converts elements
' of a Byte array to UInt16 values.
' 
' initial Byte array
' ------------------
' 0F-00-00-FF-03-10-27-FF-FF-7F
' 
' index   array elements    UInt16
' -----   --------------    ------
'     1            00-00         0
'     0            0F-00        15
'     3            FF-03      1023
'     5            10-27     10000
'     8            FF-7F     32767
'     7            FF-FF     65535

注釈

ToUInt16メソッドは、バイトをインデックス startIndex から startIndex + 1 にUInt16値に変換します。配列内のバイトの順序は、コンピューターシステムのアーキテクチャのエンディアンを反映している必要があります。詳細については、「 BitConverter クラス」トピックの「解説」セクションを参照してください。

こちらもご覧ください

GetBytes(UInt16)

適用対象

フィードバック

このページはお役に立ちましたか?