BitConverter.ToUInt64 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| ToUInt64(Byte[], Int32) |
8바이트에서 변환된 64비트 부호 없는 정수를 바이트 배열의 지정된 위치에 반환합니다. |
| ToUInt64(ReadOnlySpan<Byte>) |
바이트를 부호 없는 long으로 변환합니다. |
ToUInt64(Byte[], Int32)
중요
이 API는 CLS 규격이 아닙니다.
8바이트에서 변환된 64비트 부호 없는 정수를 바이트 배열의 지정된 위치에 반환합니다.
public:
static System::UInt64 ToUInt64(cli::array <System::Byte> ^ value, int startIndex);[System.CLSCompliant(false)]
public static ulong ToUInt64 (byte[] value, int startIndex);[<System.CLSCompliant(false)>]
static member ToUInt64 : byte[] * int -> uint64Public Shared Function ToUInt64 (value As Byte(), startIndex As Integer) As ULong매개 변수
- value
- Byte[]
변환할 8바이트를 포함하는 바이트 배열입니다.
- startIndex
- Int32
value 내의 시작 위치입니다.
반환
startIndex에서 시작하고 8바이트로 형성된 64비트 부호 없는 정수입니다.
- 특성
예외
startIndex가 value의 길이에서 7을 뺀 값보다 크거나 같고 value의 길이에서 1을 뺀 값보다 작거나 같은 경우
value이(가) null인 경우
startIndex가 0보다 작거나 value - 1의 길이보다 큰 경우
예제
다음 코드 예제에서는 메서드를 사용하여 UInt64 배열의 Byte 요소를 값으로 ToUInt64 변환합니다.
// Example of the BitConverter::ToUInt64 method.
using namespace System;
// Convert eight byte array elements to an unsigned __int64 value and
// display it.
void BAToUInt64( array<unsigned char>^bytes, int index )
{
unsigned __int64 value = BitConverter::ToUInt64( bytes, index );
Console::WriteLine( "{0,5}{1,27}{2,24}", index, BitConverter::ToString( bytes, index, 8 ), value );
}
// Display a byte array, using multiple lines if necessary.
void WriteMultiLineByteArray( array<unsigned char>^bytes )
{
const int rowSize = 20;
int iter;
Console::WriteLine( "initial unsigned char array" );
Console::WriteLine( "---------------------------" );
for ( iter = 0; iter < bytes->Length - rowSize; iter += rowSize )
{
Console::Write( BitConverter::ToString( bytes, iter, rowSize ) );
Console::WriteLine( "-" );
}
Console::WriteLine( BitConverter::ToString( bytes, iter ) );
Console::WriteLine();
}
int main()
{
array<unsigned char>^byteArray = {255,255,255,0,0,0,0,0,0,0,0,1,0,0,0,100,167,179,182,224,13,0,202,154,59,0,0,0,0,170,170,170,170,170,170,0,0,232,137,4,35,199,138,255,255,255,255,255,255,255,255,127};
Console::WriteLine( "This example of the BitConverter::ToUInt64( unsigned "
"char[ ], int ) \nmethod generates the following output. It "
"converts elements of a \nbyte array to unsigned __int64 "
"values.\n" );
WriteMultiLineByteArray( byteArray );
Console::WriteLine( "{0,5}{1,27}{2,24}", "index", "array elements", "unsigned __int64" );
Console::WriteLine( "{0,5}{1,27}{2,24}", "-----", "--------------", "----------------" );
// Convert byte array elements to unsigned __int64 values.
BAToUInt64( byteArray, 3 );
BAToUInt64( byteArray, 0 );
BAToUInt64( byteArray, 21 );
BAToUInt64( byteArray, 7 );
BAToUInt64( byteArray, 29 );
BAToUInt64( byteArray, 13 );
BAToUInt64( byteArray, 35 );
BAToUInt64( byteArray, 44 );
BAToUInt64( byteArray, 43 );
}
/*
This example of the BitConverter::ToUInt64( unsigned char[ ], int )
method generates the following output. It converts elements of a
byte array to unsigned __int64 values.
initial unsigned char array
---------------------------
FF-FF-FF-00-00-00-00-00-00-00-00-01-00-00-00-64-A7-B3-B6-E0-
0D-00-CA-9A-3B-00-00-00-00-AA-AA-AA-AA-AA-AA-00-00-E8-89-04-
23-C7-8A-FF-FF-FF-FF-FF-FF-FF-FF-7F
index array elements unsigned __int64
----- -------------- ----------------
3 00-00-00-00-00-00-00-00 0
0 FF-FF-FF-00-00-00-00-00 16777215
21 00-CA-9A-3B-00-00-00-00 1000000000
7 00-00-00-00-01-00-00-00 4294967296
29 AA-AA-AA-AA-AA-AA-00-00 187649984473770
13 00-00-64-A7-B3-B6-E0-0D 1000000000000000000
35 00-00-E8-89-04-23-C7-8A 10000000000000000000
44 FF-FF-FF-FF-FF-FF-FF-7F 9223372036854775807
43 FF-FF-FF-FF-FF-FF-FF-FF 18446744073709551615
*/
// Example of the BitConverter.ToUInt64 method.
using System;
class BytesToUInt64Demo
{
const string formatter = "{0,5}{1,27}{2,24}";
// Convert eight byte array elements to a ulong and display it.
public static void BAToUInt64( byte[ ] bytes, int index )
{
ulong value = BitConverter.ToUInt64( bytes, index );
Console.WriteLine( formatter, index,
BitConverter.ToString( bytes, index, 8 ), value );
}
// Display a byte array, using multiple lines if necessary.
public static void WriteMultiLineByteArray( byte[ ] bytes )
{
const int rowSize = 20;
int iter;
Console.WriteLine( "initial byte array" );
Console.WriteLine( "------------------" );
for( iter = 0; iter < bytes.Length - rowSize; iter += rowSize )
{
Console.Write(
BitConverter.ToString( bytes, iter, rowSize ) );
Console.WriteLine( "-" );
}
Console.WriteLine( BitConverter.ToString( bytes, iter ) );
Console.WriteLine( );
}
public static void Main( )
{
byte[ ] byteArray = {
255, 255, 255, 0, 0, 0, 0, 0, 0, 0,
0, 1, 0, 0, 0, 100, 167, 179, 182, 224,
13, 0, 202, 154, 59, 0, 0, 0, 0, 170,
170, 170, 170, 170, 170, 0, 0, 232, 137, 4,
35, 199, 138, 255, 255, 255, 255, 255, 255, 255,
255, 127 };
Console.WriteLine(
"This example of the BitConverter.ToUInt64( byte[ ], " +
"int ) \nmethod generates the following output. It " +
"converts elements \nof a byte array to ulong values.\n" );
WriteMultiLineByteArray( byteArray );
Console.WriteLine( formatter, "index", "array elements",
"ulong" );
Console.WriteLine( formatter, "-----", "--------------",
"------" );
// Convert byte array elements to ulong values.
BAToUInt64( byteArray, 3 );
BAToUInt64( byteArray, 0 );
BAToUInt64( byteArray, 21 );
BAToUInt64( byteArray, 7 );
BAToUInt64( byteArray, 29 );
BAToUInt64( byteArray, 13 );
BAToUInt64( byteArray, 35 );
BAToUInt64( byteArray, 44 );
BAToUInt64( byteArray, 43 );
}
}
/*
This example of the BitConverter.ToUInt64( byte[ ], int )
method generates the following output. It converts elements
of a byte array to ulong values.
initial byte array
------------------
FF-FF-FF-00-00-00-00-00-00-00-00-01-00-00-00-64-A7-B3-B6-E0-
0D-00-CA-9A-3B-00-00-00-00-AA-AA-AA-AA-AA-AA-00-00-E8-89-04-
23-C7-8A-FF-FF-FF-FF-FF-FF-FF-FF-7F
index array elements ulong
----- -------------- ------
3 00-00-00-00-00-00-00-00 0
0 FF-FF-FF-00-00-00-00-00 16777215
21 00-CA-9A-3B-00-00-00-00 1000000000
7 00-00-00-00-01-00-00-00 4294967296
29 AA-AA-AA-AA-AA-AA-00-00 187649984473770
13 00-00-64-A7-B3-B6-E0-0D 1000000000000000000
35 00-00-E8-89-04-23-C7-8A 10000000000000000000
44 FF-FF-FF-FF-FF-FF-FF-7F 9223372036854775807
43 FF-FF-FF-FF-FF-FF-FF-FF 18446744073709551615
*/
open System
let print obj1 obj2 obj3 = printfn $"{obj1,5}{obj2,27}{obj3,24}"
// Convert eight byte array elements to a ulong and display it.
let BAToUInt64 bytes index =
let value = BitConverter.ToUInt64(bytes, index)
print index (BitConverter.ToString(bytes, index, 8)) value
// Display a byte array, using multiple lines if necessary.
let writeMultiLineByteArray (bytes: byte []) =
let rowSize = 20
printfn "initial byte array"
printfn "------------------"
let mutable iter = 0
for i in 0 .. rowSize .. bytes.Length - rowSize - 1 do
printfn $"{BitConverter.ToString(bytes, i, rowSize)}-"
iter <- i
printfn $"{BitConverter.ToString(bytes, iter + rowSize)}\n"
let byteArray =
[| 255uy; 255uy; 255uy; 0uy; 0uy; 0uy; 0uy; 0uy; 0uy; 0uy
0uy; 1uy; 0uy; 0uy; 0uy; 100uy; 167uy; 179uy; 182uy; 224uy
13uy; 0uy; 202uy; 154uy; 59uy; 0uy; 0uy; 0uy; 0uy; 170uy
170uy; 170uy; 170uy; 170uy; 170uy; 0uy; 0uy; 232uy; 137uy; 4uy
35uy; 199uy; 138uy; 255uy; 255uy; 255uy; 255uy; 255uy; 255uy; 255uy
255uy; 127uy |]
printfn "This example of the BitConverter.ToUInt64(byte [], int) \nmethod generates the following output. It converts elements \nof a byte array to ulong values.\n"
writeMultiLineByteArray byteArray
print "index" "array elements" "ulong"
print "-----" "--------------" "------"
// Convert byte array elements to ulong values.
BAToUInt64 byteArray 3
BAToUInt64 byteArray 0
BAToUInt64 byteArray 21
BAToUInt64 byteArray 7
BAToUInt64 byteArray 29
BAToUInt64 byteArray 13
BAToUInt64 byteArray 35
BAToUInt64 byteArray 44
BAToUInt64 byteArray 43
// This example of the BitConverter.ToUInt64( byte[ ], int )
// method generates the following output. It converts elements
// of a byte array to ulong values.
//
// initial byte array
// ------------------
// FF-FF-FF-00-00-00-00-00-00-00-00-01-00-00-00-64-A7-B3-B6-E0-
// 0D-00-CA-9A-3B-00-00-00-00-AA-AA-AA-AA-AA-AA-00-00-E8-89-04-
// 23-C7-8A-FF-FF-FF-FF-FF-FF-FF-FF-7F
//
// index array elements ulong
// ----- -------------- ------
// 3 00-00-00-00-00-00-00-00 0
// 0 FF-FF-FF-00-00-00-00-00 16777215
// 21 00-CA-9A-3B-00-00-00-00 1000000000
// 7 00-00-00-00-01-00-00-00 4294967296
// 29 AA-AA-AA-AA-AA-AA-00-00 187649984473770
// 13 00-00-64-A7-B3-B6-E0-0D 1000000000000000000
// 35 00-00-E8-89-04-23-C7-8A 10000000000000000000
// 44 FF-FF-FF-FF-FF-FF-FF-7F 9223372036854775807
// 43 FF-FF-FF-FF-FF-FF-FF-FF 18446744073709551615
' Example of the BitConverter.ToUInt64 method.
Module BytesToUInt64Demo
Const formatter As String = "{0,5}{1,27}{2,24}"
' Convert eight Byte array elements to a UInt64 and display it.
Sub BAToUInt64( bytes( ) As Byte, index As Integer )
Dim value As UInt64 = BitConverter.ToUInt64( bytes, index )
Console.WriteLine( formatter, index, _
BitConverter.ToString( bytes, index, 8 ), value )
End Sub
' Display a Byte array, using multiple lines if necessary.
Sub WriteMultiLineByteArray( bytes( ) As Byte )
Const rowSize As Integer = 20
Dim iter As Integer
Console.WriteLine( "initial Byte array" )
Console.WriteLine( "------------------" )
For iter = 0 To bytes.Length - rowSize - 1 Step rowSize
Console.Write( _
BitConverter.ToString( bytes, iter, rowSize ) )
Console.WriteLine( "-" )
Next iter
Console.WriteLine( BitConverter.ToString( bytes, iter ) )
Console.WriteLine( )
End Sub
Sub Main( )
Dim byteArray as Byte( ) = { _
255, 255, 255, 0, 0, 0, 0, 0, 0, 0, _
0, 1, 0, 0, 0, 100, 167, 179, 182, 224, _
13, 0, 202, 154, 59, 0, 0, 0, 0, 170, _
170, 170, 170, 170, 170, 0, 0, 232, 137, 4, _
35, 199, 138, 255, 255, 255, 255, 255, 255, 255, _
255, 127 }
Console.WriteLine( _
"This example of the BitConverter.ToUInt64( Byte( ), " & _
"Integer ) " & vbCrLf & "method generates the " & _
"following output. It converts elements " & vbCrLf & _
"of a Byte array to UInt64 values." & vbCrLf )
WriteMultiLineByteArray( byteArray )
Console.WriteLine( formatter, "index", "array elements", _
"UInt64" )
Console.WriteLine( formatter, "-----", "--------------", _
"------" )
' Convert Byte array elements to UInt64 values.
BAToUInt64( byteArray, 3 )
BAToUInt64( byteArray, 0 )
BAToUInt64( byteArray, 21 )
BAToUInt64( byteArray, 7 )
BAToUInt64( byteArray, 29 )
BAToUInt64( byteArray, 13 )
BAToUInt64( byteArray, 35 )
BAToUInt64( byteArray, 44 )
BAToUInt64( byteArray, 43 )
End Sub
End Module
' This example of the BitConverter.ToUInt64( Byte( ), Integer )
' method generates the following output. It converts elements
' of a Byte array to UInt64 values.
'
' initial Byte array
' ------------------
' FF-FF-FF-00-00-00-00-00-00-00-00-01-00-00-00-64-A7-B3-B6-E0-
' 0D-00-CA-9A-3B-00-00-00-00-AA-AA-AA-AA-AA-AA-00-00-E8-89-04-
' 23-C7-8A-FF-FF-FF-FF-FF-FF-FF-FF-7F
'
' index array elements UInt64
' ----- -------------- ------
' 3 00-00-00-00-00-00-00-00 0
' 0 FF-FF-FF-00-00-00-00-00 16777215
' 21 00-CA-9A-3B-00-00-00-00 1000000000
' 7 00-00-00-00-01-00-00-00 4294967296
' 29 AA-AA-AA-AA-AA-AA-00-00 187649984473770
' 13 00-00-64-A7-B3-B6-E0-0D 1000000000000000000
' 35 00-00-E8-89-04-23-C7-8A 10000000000000000000
' 44 FF-FF-FF-FF-FF-FF-FF-7F 9223372036854775807
' 43 FF-FF-FF-FF-FF-FF-FF-FF 18446744073709551615
설명
이 메서드는 ToUInt64 바이트를 인덱 startIndex 스에서 + 7로 startIndex 값으로 UInt64 변환합니다. 배열의 바이트 순서는 컴퓨터 시스템 아키텍처의 엔디언성을 반영해야 합니다. 자세한 내용은 수업 항목의 설명 섹션을 BitConverter 참조하세요.
추가 정보
적용 대상
ToUInt64(ReadOnlySpan<Byte>)
중요
이 API는 CLS 규격이 아닙니다.
바이트를 부호 없는 long으로 변환합니다.
public:
static System::UInt64 ToUInt64(ReadOnlySpan<System::Byte> value);[System.CLSCompliant(false)]
public static ulong ToUInt64 (ReadOnlySpan<byte> value);[<System.CLSCompliant(false)>]
static member ToUInt64 : ReadOnlySpan<byte> -> uint64Public Shared Function ToUInt64 (value As ReadOnlySpan(Of Byte)) As ULong매개 변수
- value
- ReadOnlySpan<Byte>
변환할 바이트를 포함하는 읽기 전용 범위입니다.
반환
변환된 바이트를 나타내는 64비트 부호 없는 정수입니다.
- 특성
예외
value의 길이가 8보다 작습니다.