BitConverter.ToInt32 Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Перегрузки
| ToInt32(ReadOnlySpan<Byte>) |
Преобразует доступный только для чтения диапазон байтов в 32-разрядное целое число со знаком. |
| ToInt32(Byte[], Int32) |
Возвращает 32-битовое целое число со знаком, преобразованное из четырех байтов с указанной позицией в массив байтов. |
ToInt32(ReadOnlySpan<Byte>)
Преобразует доступный только для чтения диапазон байтов в 32-разрядное целое число со знаком.
public:
static int ToInt32(ReadOnlySpan<System::Byte> value);public static int ToInt32 (ReadOnlySpan<byte> value);static member ToInt32 : ReadOnlySpan<byte> -> intPublic Shared Function ToInt32 (value As ReadOnlySpan(Of Byte)) As IntegerПараметры
- value
- ReadOnlySpan<Byte>
Доступный только для чтения диапазон, содержащий байты для преобразования.
Возвращаемое значение
32-разрядное целое число со знаком, которое представляет преобразованные байты.
Исключения
Длина value меньше 4.
Применяется к
ToInt32(Byte[], Int32)
Возвращает 32-битовое целое число со знаком, преобразованное из четырех байтов с указанной позицией в массив байтов.
public:
static int ToInt32(cli::array <System::Byte> ^ value, int startIndex);public static int ToInt32 (byte[] value, int startIndex);static member ToInt32 : byte[] * int -> intPublic Shared Function ToInt32 (value As Byte(), startIndex As Integer) As IntegerПараметры
- value
- Byte[]
Массив байтов, включающий четыре байта для преобразования.
- startIndex
- Int32
Начальная позиция в value.
Возвращаемое значение
32-битовое знаковое целое число, образованное четырьмя байтами, начинающимися с startIndex.
Исключения
Значение параметра startIndex больше или равно длине параметра value минус 3 и меньше или равно длине параметра value минус 1.
value имеет значение null.
startIndex меньше нуля или больше, чем длина value минус 1.
Примеры
В следующем примере метод используется ToInt32 для создания Int32 значений из четырехбайтового массива и из четырех верхних четырех байтов восьмибайтового массива. Он также использует GetBytes(Int32) методы и ToInt32 методы для кругового Int32 пути значения.
using System;
public class Example
{
public static void Main()
{
// Create an Integer from a 4-byte array.
Byte[] bytes1 = { 0xEC, 0x00, 0x00, 0x00 };
Console.WriteLine("{0}--> 0x{1:X4} ({1:N0})", FormatBytes(bytes1),
BitConverter.ToInt32(bytes1, 0));
// Create an Integer from the upper four bytes of a byte array.
Byte[] bytes2 = BitConverter.GetBytes(Int64.MaxValue / 2);
Console.WriteLine("{0}--> 0x{1:X4} ({1:N0})", FormatBytes(bytes2),
BitConverter.ToInt32(bytes2, 4));
// Round-trip an integer value.
int original = (int) Math.Pow(16, 3);
Byte[] bytes3 = BitConverter.GetBytes(original);
int restored = BitConverter.ToInt32(bytes3, 0);
Console.WriteLine("0x{0:X4} ({0:N0}) --> {1} --> 0x{2:X4} ({2:N0})", original,
FormatBytes(bytes3), restored);
}
private static string FormatBytes(Byte[] bytes)
{
string value = "";
foreach (var byt in bytes)
value += string.Format("{0:X2} ", byt);
return value;
}
}
// The example displays the following output:
// EC 00 00 00 --> 0x00EC (236)
// FF FF FF FF FF FF FF 3F --> 0x3FFFFFFF (1,073,741,823)
// 0x1000 (4,096) --> 00 10 00 00 --> 0x1000 (4,096)
open System
let formatBytes (bytes: byte []) =
bytes
|> Array.map (fun x -> $"{x:X2}")
|> String.concat ""
// Create an Integer from a 4-byte array.
let bytes1 = [| 0xECuy; 0x00uy; 0x00uy; 0x00uy |]
let int1 = BitConverter.ToInt32(bytes1, 0)
printfn $"{formatBytes bytes1}--> 0x{int1:X4} ({int1:N0})"
// Create an Integer from the upper four bytes of a byte array.
let bytes2 = BitConverter.GetBytes(Int64.MaxValue / 2L)
let int2 = BitConverter.ToInt32(bytes2, 4)
printfn $"{formatBytes bytes2}--> 0x{int2:X4} ({int2:N0})"
// Round-trip an integer value.
let original = pown 16 3
let bytes3 = BitConverter.GetBytes original
let restored = BitConverter.ToInt32(bytes3, 0)
printfn $"0x{original:X4} ({original:N0}) --> {formatBytes bytes3} --> 0x{restored:X4} ({restored:N0})"
// The example displays the following output:
// EC 00 00 00 --> 0x00EC (236)
// FF FF FF FF FF FF FF 3F --> 0x3FFFFFFF (1,073,741,823)
// 0x1000 (4,096) --> 00 10 00 00 --> 0x1000 (4,096)
Module Example
Public Sub Main()
' Create an Integer from a 4-byte array.
Dim bytes1() As Byte = { &hEC, &h00, &h00, &h00 }
Console.WriteLine("{0}--> 0x{1:X4} ({1:N0})", FormatBytes(bytes1),
BitConverter.ToInt32(bytes1, 0))
' Create an Integer from the upper four bytes of a byte array.
Dim bytes2() As Byte = BitConverter.GetBytes(Int64.MaxValue \ 2)
Console.WriteLine("{0}--> 0x{1:X4} ({1:N0})", FormatBytes(bytes2),
BitConverter.ToInt32(bytes2, 4))
' Round-trip an integer value.
Dim original As Integer = CInt(16^3)
Dim bytes3() As Byte = BitConverter.GetBytes(original)
Dim restored As Integer = BitConverter.ToInt32(bytes3, 0)
Console.WriteLine("0x{0:X4} ({0:N0}) --> {1} --> 0x{2:X4} ({2:N0})", original,
FormatBytes(bytes3), restored)
End Sub
Private Function FormatBytes(bytes() As Byte) As String
Dim value As String = ""
For Each byt In bytes
value += String.Format("{0:X2} ", byt)
Next
Return value
End Function
End Module
' The example displays the following output:
' EC 00 00 00 --> 0x00EC (236)
' FF FF FF FF FF FF FF 3F --> 0x3FFFFFFF (1,073,741,823)
' 0x1000 (4,096) --> 00 10 00 00 --> 0x1000 (4,096)
Комментарии
Метод ToInt32 преобразует байты из индекса startIndex в startIndex +3 в Int32 значение. Порядок байтов в массиве должен отражать конечную конечную часть архитектуры компьютерной системы. Дополнительные сведения см. в разделе "Примечания".BitConverter