BitConverter.ToChar-Methode
Gibt ein Unicode-Zeichen zurück, das aus zwei Bytes an der angegebenen Position in einem Bytearray konvertiert wurde.
Namespace: System
Assembly: mscorlib (in mscorlib.dll)
Syntax
'Declaration
Public Shared Function ToChar ( _
value As Byte(), _
startIndex As Integer _
) As Char
'Usage
Dim value As Byte()
Dim startIndex As Integer
Dim returnValue As Char
returnValue = BitConverter.ToChar(value, startIndex)
public static char ToChar (
byte[] value,
int startIndex
)
public:
static wchar_t ToChar (
array<unsigned char>^ value,
int startIndex
)
public static char ToChar (
byte[] value,
int startIndex
)
public static function ToChar (
value : byte[],
startIndex : int
) : char
Parameter
- value
Ein Array.
- startIndex
Die Anfangsposition in value.
Rückgabewert
Ein Zeichen, das beginnend bei startIndex aus zwei Bytes gebildet wird.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
value ist NULL (Nothing in Visual Basic). |
|
startIndex ist kleiner als 0 (null) oder größer als die Länge von value minus 2. |
Beispiel
Im folgenden Codebeispiel werden Elemente von Byte-Arrays mithilfe der ToChar-Methode in Char-Werte (Unicode-Zeichen) konvertiert.
' Example of the BitConverter.ToChar method.
Imports System
Imports Microsoft.VisualBasic
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 ?
// 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 ?
*/
// Example of the BitConverter::ToChar method.
using namespace System;
// Convert two byte array elements to a __wchar_t and display it.
void BAToChar( array<unsigned char>^bytes, int index )
{
__wchar_t value = BitConverter::ToChar( bytes, index );
Console::WriteLine( "{0,5}{1,17}{2,11}", index, BitConverter::ToString( bytes, index, 2 ), value );
}
int main()
{
array<unsigned char>^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( unsigned "
"char[ ], int ) \nmethod generates the following output. It "
"converts elements of a \nbyte array to __wchar_t values.\n" );
Console::WriteLine( "initial unsigned char array" );
Console::WriteLine( "---------------------------" );
Console::WriteLine( BitConverter::ToString( byteArray ) );
Console::WriteLine();
Console::WriteLine( "{0,5}{1,17}{2,11}", "index", "array elements", "__wchar_t" );
Console::WriteLine( "{0,5}{1,17}{2,11}", "-----", "--------------", "---------" );
// Convert byte array elements to __wchar_t 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( unsigned char[ ], int )
method generates the following output. It converts elements of a
byte array to __wchar_t values.
initial unsigned char array
---------------------------
20-00-00-2A-00-41-00-7D-00-C5-00-A8-03-29-04-AC-20
index array elements __wchar_t
----- -------------- ---------
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.
import System.*;
class BytesToCharDemo
{
private static String formatter = "{0,5}{1,17}{2,8}";
// Convert two byte array elements to a char and display it.
public static void BAToChar(ubyte bytes[], int index)
{
char value = BitConverter.ToChar(bytes, index);
Console.WriteLine(formatter, (Int32)index,
BitConverter.ToString(bytes, index, 2), (Char)value);
} //BAToChar
public static void main(String[] args)
{
ubyte 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 ) \n"
+ "method 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);
} //main
} //BytesToCharDemo
/*
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 ?
*/
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
.NET Compact Framework
Unterstützt in: 2.0, 1.0
Siehe auch
Referenz
BitConverter-Klasse
BitConverter-Member
System-Namespace
Char