BitConverter.ToUInt16 Método

Definição

Espaço de Nomes:: System

Assemblagens:: netstandard.dll, System.Runtime.dll

Assemblagem:: System.Runtime.Extensions.dll

Assemblagem:: netstandard.dll

Assemblagens:: mscorlib.dll, System.Runtime.Extensions.dll

Assemblagem:: mscorlib.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Descrição
ToUInt16(ReadOnlySpan<Byte>)	Converte um byte-span de apenas leitura num inteiro sem sinal de 16 bits.
ToUInt16(Byte[], Int32)	Devolve um inteiro sem sinal de 16 bits convertido a partir de dois bytes numa posição especificada num array de bytes.

ToUInt16(ReadOnlySpan<Byte>)

Origem:: BitConverter.cs

Origem:: BitConverter.cs

Origem:: BitConverter.cs

Origem:: BitConverter.cs

Origem:: BitConverter.cs

Importante

Esta API não está em conformidade com CLS.

Converte um byte-span de apenas leitura num inteiro sem sinal de 16 bits.

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

Parâmetros

value: ReadOnlySpan<Byte>

Um span de só leitura contendo os bytes a converter.

Devoluções

UInt16

Um inteiro sem sinal de 16 bits que representa os bytes convertidos.

Atributos: CLSCompliantAttribute

Exceções

ArgumentOutOfRangeException

O comprimento de value é inferior a 2.

Aplica-se a

ToUInt16(Byte[], Int32)

Origem:: BitConverter.cs

Origem:: BitConverter.cs

Origem:: BitConverter.cs

Origem:: BitConverter.cs

Origem:: BitConverter.cs

Importante

Esta API não está em conformidade com CLS.

Devolve um inteiro sem sinal de 16 bits convertido a partir de dois bytes numa posição especificada num array de bytes.

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

Parâmetros

value: Byte[]

O array de bytes que inclui os dois bytes a converter.

startIndex: Int32

A posição inicial dentro valuede .

Devoluções

UInt16

Um inteiro sem sinal de 16 bits formado por dois bytes começando em startIndex.

Atributos: CLSCompliantAttribute

Exceções

ArgumentException

startIndex é igual ao comprimento de value menos 1.

ArgumentNullException

value é null.

ArgumentOutOfRangeException

startIndex é menor que zero ou maior que o comprimento de value menos 1.

Exemplos

O seguinte exemplo de código converte elementos de Byte arrays em UInt16 valores com o ToUInt16 método.

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

Observações

O ToUInt16 método converte os bytes do índice startIndex para startIndex + 1 num UInt16 valor. A ordem dos bytes no array deve refletir a endianidade da arquitetura do sistema informático. Para mais informações, consulte a secção de Observações do tema da BitConverter aula.

Ver também

GetBytes(UInt16)

Aplica-se a

Comentários

Esta página foi útil?