BitConverter.ToChar Метод

Определение

Пространство имен:: System

Сборки:: netstandard.dll, System.Runtime.dll

Сборка:: System.Runtime.Extensions.dll

Сборка:: netstandard.dll

Сборки:: mscorlib.dll, System.Runtime.Extensions.dll

Сборка:: mscorlib.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Перегрузки

Имя	Описание
ToChar(ReadOnlySpan<Byte>)	Преобразует диапазон байтов только для чтения в символ.
ToChar(Byte[], Int32)	Возвращает символ Юникода, преобразованный из двух байтов в указанной позиции в массиве байтов.

ToChar(ReadOnlySpan<Byte>)

Исходный код:: BitConverter.cs

Исходный код:: BitConverter.cs

Исходный код:: BitConverter.cs

Исходный код:: BitConverter.cs

Исходный код:: BitConverter.cs

Преобразует диапазон байтов только для чтения в символ.

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

Параметры

value: ReadOnlySpan<Byte>

Диапазон только для чтения, содержащий байты для преобразования.

Возвращаемое значение

Char

Символ, представляющий преобразованные байты.

Исключения

ArgumentOutOfRangeException

Длина value меньше длины Char.

Применяется к

ToChar(Byte[], Int32)

Исходный код:: BitConverter.cs

Исходный код:: BitConverter.cs

Исходный код:: BitConverter.cs

Исходный код:: BitConverter.cs

Исходный код:: BitConverter.cs

Возвращает символ Юникода, преобразованный из двух байтов в указанной позиции в массиве байтов.

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

Параметры

value: Byte[]

Массив, включающий два байта для преобразования.

startIndex: Int32

Начальная позиция внутри value.

Возвращаемое значение

Char

Символ, сформированный двумя байтами, начиная с startIndex.

Исключения

ArgumentException

startIndex равен длине value минус 1.

ArgumentNullException

value равно null.

ArgumentOutOfRangeException

startIndex меньше нуля или больше длины value минус 1.

Примеры

В следующем примере кода элементы Byte массивов преобразуются в Char значения (символы Юникода) с ToChar помощью метода.

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

Метод ToChar преобразует байты из индекса startIndex в startIndex +1 в Char значение. Порядок байтов в массиве должен отражать конечную часть архитектуры компьютерной системы. Дополнительные сведения см. в разделе "Примечания" раздела BitConverter класса.

См. также раздел

GetBytes(Char)

Применяется к

Кері байланыс

Бет пайдалы болды ма?

Бөлісу құралы:

BitConverter.ToChar Метод

Определение

Перегрузки

ToChar(ReadOnlySpan<Byte>)

Параметры

Возвращаемое значение

Исключения

Применяется к

ToChar(Byte[], Int32)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к