BitConverter.ToUInt16 Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
| ToUInt16(ReadOnlySpan<Byte>) |
Converte um intervalo de bytes somente leitura em um inteiro sem sinal de 16 bits. |
| ToUInt16(Byte[], Int32) |
Retorna um inteiro sem sinal de 16 bits convertido de dois bytes em uma posição especificada em uma matriz de bytes. |
ToUInt16(ReadOnlySpan<Byte>)
- Origem:
- BitConverter.cs
- Origem:
- BitConverter.cs
- Origem:
- BitConverter.cs
Importante
Esta API não está em conformidade com CLS.
Converte um intervalo de bytes somente leitura em um 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> -> uint16Public Shared Function ToUInt16 (value As ReadOnlySpan(Of Byte)) As UShortParâmetros
- value
- ReadOnlySpan<Byte>
Um intervalo somente leitura que contém os bytes a serem convertidos.
Retornos
Um inteiro sem sinal de 16 bits que representa os bytes convertidos.
- Atributos
Exceções
O tamanho de value é menor que 2.
Aplica-se a
ToUInt16(Byte[], Int32)
- Origem:
- BitConverter.cs
- Origem:
- BitConverter.cs
- Origem:
- BitConverter.cs
Importante
Esta API não está em conformidade com CLS.
Retorna um inteiro sem sinal de 16 bits convertido de dois bytes em uma posição especificada em uma matriz 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 -> uint16Public Shared Function ToUInt16 (value As Byte(), startIndex As Integer) As UShortParâmetros
- value
- Byte[]
A matriz de bytes que inclui os dois bytes a serem convertidos.
- startIndex
- Int32
A posição inicial dentro de value.
Retornos
Um inteiro sem sinal de 16 bits formado por dois bytes, começando em startIndex.
- Atributos
Exceções
startIndex é igual ao comprimento de value menos 1.
value é null.
startIndex é menor que zero ou maior que o tamanho de value menos 1.
Exemplos
O exemplo de código a seguir converte elementos de Byte matrizes em UInt16 valores com o ToUInt16 método .
// Example of the BitConverter::ToUInt16 method.
using namespace System;
// Convert two byte array elements to an unsigned short and display it.
void BAToUInt16( array<unsigned char>^bytes, int index )
{
unsigned short value = BitConverter::ToUInt16( bytes, index );
Console::WriteLine( "{0,5}{1,17}{2,16}", index, BitConverter::ToString( bytes, index, 2 ), value );
}
int main()
{
array<unsigned char>^byteArray = {15,0,0,255,3,16,39,255,255,127};
Console::WriteLine( "This example of the BitConverter::ToUInt16( unsigned "
"char[ ], int ) \nmethod generates the following output. It "
"converts elements of a \nbyte array to unsigned short "
"values.\n" );
Console::WriteLine( "initial byte array" );
Console::WriteLine( "------------------" );
Console::WriteLine( BitConverter::ToString( byteArray ) );
Console::WriteLine();
Console::WriteLine( "{0,5}{1,17}{2,16}", "index", "array elements", "unsigned short" );
Console::WriteLine( "{0,5}{1,17}{2,16}", "-----", "--------------", "--------------" );
// Convert byte array elements to unsigned short 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( unsigned char[ ], int )
method generates the following output. It converts elements of a
byte array to unsigned short values.
initial byte array
------------------
0F-00-00-FF-03-10-27-FF-FF-7F
index array elements unsigned short
----- -------------- --------------
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.
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
Comentários
O ToUInt16 método converte os bytes do índice startIndex em startIndex + 1 em um UInt16 valor. A ordem dos bytes na matriz deve refletir a endianidade da arquitetura do sistema de computador. Para obter mais informações, consulte a seção Comentários do tópico de BitConverter classe.
Confira também
Aplica-se a
Colaborar conosco no GitHub
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de