BitConverter.ToChar Metoda

Definicja

Namespace:

System

Zestawów:

netstandard.dll, System.Runtime.dll

Przeciążenia

Nazwa	Opis
ToChar(ReadOnlySpan<Byte>)	Konwertuje zakres bajtów tylko do odczytu na znak.
ToChar(Byte[], Int32)	Zwraca znak Unicode przekonwertowany z dwóch bajtów w określonej pozycji w tablicy bajtów.

ToChar(ReadOnlySpan<Byte>)

Źródło:

BitConverter.cs

Konwertuje zakres bajtów tylko do odczytu na znak.

public:
 static char ToChar(ReadOnlySpan<System::Byte> value);

public static char ToChar(ReadOnlySpan<byte> value);

static member ToChar : ReadOnlySpan<byte> -> char

Public Shared Function ToChar (value As ReadOnlySpan(Of Byte)) As Char

Parametry

value

ReadOnlySpan<Byte>

Zakres tylko do odczytu zawierający bajty do konwersji.

Zwraca

Char

Znak reprezentujący przekonwertowane bajty.

Wyjątki

ArgumentOutOfRangeException

Długość value obiektu jest mniejsza niż długość obiektu Char.

ToChar(Byte[], Int32)

Źródło:

BitConverter.cs

Zwraca znak Unicode przekonwertowany z dwóch bajtów w określonej pozycji w tablicy bajtów.

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

public static char ToChar(byte[] value, int startIndex);

static member ToChar : byte[] * int -> char

Public Shared Function ToChar (value As Byte(), startIndex As Integer) As Char

Parametry

value

Byte[]

Tablica zawierająca dwa bajty do przekonwertowania.

startIndex

Int32

Pozycja początkowa w obiekcie value.

Zwraca

Char

Znak utworzony przez dwa bajty rozpoczynające się od startIndex.

Wyjątki

ArgumentException

startIndex równa się długości value minus 1.

ArgumentNullException

Parametr value ma wartość null.

ArgumentOutOfRangeException

startIndex jest mniejsza niż zero lub większa niż długość value minus 1.

Przykłady

Poniższy przykład kodu konwertuje elementy Byte tablic na Char wartości (znaki Unicode) za pomocą ToChar metody .

// Example of the BitConverter.ToChar method.
using System;

class BytesToCharDemo
{
    const string formatter = "{0,5}{1,17}{2,8}";

    // Convert two byte array elements to a char and display it.
    public static void BAToChar( byte[] bytes, int index )
    {
        char value = BitConverter.ToChar( bytes, index );

        Console.WriteLine( formatter, index,
            BitConverter.ToString( bytes, index, 2 ), value );
    }

    public static void Main( )
    {
        byte[] byteArray = {
             32,   0,   0,  42,   0,  65,   0, 125,   0,
            197,   0, 168,   3,  41,   4, 172,  32 };

        Console.WriteLine(
            "This example of the BitConverter.ToChar( byte[ ], " +
            "int ) \nmethod generates the following output. It " +
            "converts \nelements of a byte array to char values.\n" );
        Console.WriteLine( "initial byte array" );
        Console.WriteLine( "------------------" );
        Console.WriteLine( BitConverter.ToString( byteArray ) );
        Console.WriteLine( );
        Console.WriteLine( formatter, "index", "array elements", "char" );
        Console.WriteLine( formatter, "-----", "--------------", "----" );

        // Convert byte array elements to char values.
        BAToChar( byteArray, 0 );
        BAToChar( byteArray, 1 );
        BAToChar( byteArray, 3 );
        BAToChar( byteArray, 5 );
        BAToChar( byteArray, 7 );
        BAToChar( byteArray, 9 );
        BAToChar( byteArray, 11 );
        BAToChar( byteArray, 13 );
        BAToChar( byteArray, 15 );
    }
}

/*
This example of the BitConverter.ToChar(byte[ ], int)
method generates the following output. It converts
elements of a byte array to char values.

initial byte array
------------------
20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20

index   array elements    char
-----   --------------    ----
    0            20-00
    1            00-00
    3            2A-00       *
    5            41-00       A
    7            7D-00       }
    9            C5-00       Å
   11            A8-03       Ψ
   13            29-04       Щ
   15            AC-20       €
*/

open System

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

// Convert two byte array elements to a char and display it.
let BAToChar bytes index =
    let value = BitConverter.ToChar(bytes, index)

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

let byteArray = 
    [| 32uy; 0uy; 0uy; 42uy; 0uy; 65uy; 0uy; 125uy; 0uy
       197uy; 0uy; 168uy; 3uy; 41uy; 4uy; 172uy; 32uy |]

printfn "This example of the BitConverter.ToChar(byte [], int) \nmethod generates the following output. It converts \nelements of a byte array to char values.\n"
printfn "initial byte array"
printfn "------------------"
printfn $"{BitConverter.ToString byteArray}\n"

print "index" "array elements" "char"
print "-----" "--------------" "----"

// Convert byte array elements to char values.
BAToChar byteArray 0
BAToChar byteArray 1
BAToChar byteArray 3
BAToChar byteArray 5
BAToChar byteArray 7
BAToChar byteArray 9
BAToChar byteArray 11
BAToChar byteArray 13
BAToChar byteArray 15


// This example of the BitConverter.ToChar(byte [], int)
// method generates the following output. It converts
// elements of a byte array to char values.
//
// initial byte array
// ------------------
// 20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20
//
// index   array elements    char
// -----   --------------    ----
//     0            20-00
//     1            00-00
//     3            2A-00       *
//     5            41-00       A
//     7            7D-00       }
//     9            C5-00       Å
//    11            A8-03       Ψ
//    13            29-04       Щ
//    15            AC-20       €

' Example of the BitConverter.ToChar method.
Module BytesToCharDemo

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

        Dim value As Char = BitConverter.ToChar( bytes, index )

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

        Dim byteArray as Byte( ) = { _
             32,   0,   0,  42,   0,  65,   0, 125,   0, 197, _
              0, 168,   3,  41,   4, 172,  32 }

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

' This example of the BitConverter.ToChar( Byte( ), Integer )
' method generates the following output. It converts elements 
' of a Byte array to Char values.
' 
' initial Byte array
' ------------------
' 20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20
'
' index   array elements    Char
' -----   --------------    ----
'     0            20-00
'     1            00-00
'     3            2A-00       *
'     5            41-00       A
'     7            7D-00       }
'     9            C5-00       Å
'    11            A8-03       Ψ
'    13            29-04       Щ
'    15            AC-20       €

Uwagi

Metoda ToChar konwertuje bajty z indeksu startIndex na startIndex + 1 na Char wartość. Kolejność bajtów w tablicy musi odzwierciedlać endianness architektury systemu komputerowego. Aby uzyskać więcej informacji, zobacz sekcję Uwagi tematu BitConverter klasy.

Zobacz także

• GetBytes(Char)