ASCIIEncoding.GetBytes Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Codiert Zeichen in eine Bytefolge.
Überlädt
GetBytes(ReadOnlySpan<Char>, Span<Byte>) |
Codiert den angegebenen Zeichenbereich in den angegebenen Bytebereich. |
GetBytes(Char*, Int32, Byte*, Int32) |
Codiert Zeichen beginnend am angegebenen Zeichenzeiger in eine Bytefolge, die beginnend am angegebenen Bytezeiger gespeichert wird. |
GetBytes(Char[], Int32, Int32, Byte[], Int32) |
Codiert Zeichen aus dem angegebenen Zeichenarray in das angegebene Bytearray. |
GetBytes(String, Int32, Int32, Byte[], Int32) |
Codiert Zeichen aus der angegebenen String-Klasse in das angegebene Bytearray. |
GetBytes(ReadOnlySpan<Char>, Span<Byte>)
Codiert den angegebenen Zeichenbereich in den angegebenen Bytebereich.
public:
override int GetBytes(ReadOnlySpan<char> chars, Span<System::Byte> bytes);
public override int GetBytes (ReadOnlySpan<char> chars, Span<byte> bytes);
override this.GetBytes : ReadOnlySpan<char> * Span<byte> -> int
Public Overrides Function GetBytes (chars As ReadOnlySpan(Of Char), bytes As Span(Of Byte)) As Integer
Parameter
- chars
- ReadOnlySpan<Char>
Der zu codierende Zeichenbereich.
Gibt zurück
Die tatsächliche Anzahl der Bytes, die in bytes
geschrieben werden.
Hinweise
Um die genaue Größe zu berechnen, die zum GetBytes Speichern der resultierenden Bytes erforderlich ist, verwenden Sie GetByteCount. Um die maximale Größe zu berechnen, verwenden Sie GetMaxByteCount. Die- GetByteCount Methode ermöglicht im Allgemeinen die Zuordnung von weniger Arbeitsspeicher, während die- GetMaxByteCount Methode im Allgemeinen schneller ausgeführt wird.
Daten, die konvertiert werden sollen, z. B. Daten, die aus einem Datenstrom gelesen werden, können nur in sequenziellen Blöcken verfügbar sein. In diesem Fall, oder wenn die Menge der Daten so umfangreich ist, dass er in kleinere Blöcke aufgeteilt werden muss, verwenden die Decoder oder die Encoder gebotenen der GetDecoder Methode oder die GetEncoder -Methode, bzw.
ASCIIEncoding gibt keine Fehlererkennung an. Ein Unicode-Zeichen größer als U+007F
als das ASCII-Fragezeichen ("?").
Achtung
Aus Sicherheitsgründen sollten Sie die Fehlererkennung verwenden UTF8Encoding, UnicodeEncodingoder UTF32Encoding aktivieren.
Gilt für
GetBytes(Char*, Int32, Byte*, Int32)
Wichtig
Diese API ist nicht CLS-kompatibel.
- CLS-kompatible Alternative
- System.Text.ASCIIEncoding.GetBytes(Char[], Int32, Int32, Byte[], Int32)
Codiert Zeichen beginnend am angegebenen Zeichenzeiger in eine Bytefolge, die beginnend am angegebenen Bytezeiger gespeichert wird.
public:
override int GetBytes(char* chars, int charCount, System::Byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetBytes (char* chars, int charCount, byte* bytes, int byteCount);
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int -> int
Parameter
- chars
- Char*
Ein Zeiger auf das erste zu codierende Zeichen.
- charCount
- Int32
Die Anzahl der zu codierenden Zeichen.
- bytes
- Byte*
Ein Zeiger auf die Position, an der mit dem Schreiben der sich ergebenden Bytefolge begonnen werden soll.
- byteCount
- Int32
Die maximale Anzahl der zu schreibenden Bytes.
Gibt zurück
Die durch bytes
angegebene tatsächliche Anzahl von Bytes, die am Speicherort geschrieben wurden.
- Attribute
Ausnahmen
charCount
oder byteCount
ist kleiner als 0.
byteCount
ist niedriger als die sich ergebende Anzahl von Bytes.
Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET). - und - Für EncoderFallback ist EncoderExceptionFallback festgelegt.
Hinweise
Um die genaue Arraygröße zu berechnen, die erforderlich ist, um GetBytes die resultierende Bytes zu speichern, wird die Anwendung verwendet GetByteCount. Um die maximale Arraygröße zu berechnen, sollte die Anwendung verwenden GetMaxByteCount. Die- GetByteCount Methode ermöglicht im Allgemeinen die Zuordnung von weniger Arbeitsspeicher, während die- GetMaxByteCount Methode im Allgemeinen schneller ausgeführt wird.
Daten, die konvertiert werden sollen, z. B. Datenlesedaten aus einem Datenstrom, können nur in sequenziellen Blöcken verfügbar sein. In diesem Fall oder wenn die Menge der Daten so umfangreich ist, dass er in kleinere Blöcke aufgeteilt werden muss, sollte die Anwendung verwenden die Decoder oder die Encoder gebotenen der GetDecoder Methode oder die GetEncoder Methode bzw.
ASCIIEncoding gibt keine Fehlererkennung an. Jedes Unicode-Zeichen größer als U+007F wird in ein ASCII-Fragezeichen ("?") übersetzt.
Achtung
Aus Sicherheitsgründen wird Ihre Anwendung empfohlen, die Fehlererkennung zu verwenden UTF8Encoding, UnicodeEncodingoder UTF32Encoding zu aktivieren.
Siehe auch
Gilt für
GetBytes(Char[], Int32, Int32, Byte[], Int32)
Codiert Zeichen aus dem angegebenen Zeichenarray in das angegebene Bytearray.
public:
override int GetBytes(cli::array <char> ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes (char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : char[] * int * int * byte[] * int -> int
Public Overrides Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer
Parameter
- chars
- Char[]
Das Zeichenarray, das die zu codierenden Zeichen enthält.
- charIndex
- Int32
Der Index des ersten zu codierenden Zeichens.
- charCount
- Int32
Die Anzahl der zu codierenden Zeichen.
- bytes
- Byte[]
Das Bytearray, das die sich ergebende Bytefolge enthalten soll.
- byteIndex
- Int32
Der Index, an dem mit dem Schreiben der sich ergebenden Bytefolge begonnen werden soll.
Gibt zurück
Die tatsächliche Anzahl der Bytes, die in bytes
geschrieben werden.
Ausnahmen
charIndex
, charCount
oder byteIndex
ist kleiner als 0 (null).
- oder -
charIndex
und charCount
geben keinen gültigen Bereich in chars
an.
- oder -
byteIndex
ist kein gültiger Index in bytes
.
bytes
hat von byteIndex
bis zum Ende des Arrays nicht genügend Kapazität, um die sich ergebenden Bytes aufzunehmen.
Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET). - und - Für EncoderFallback ist EncoderExceptionFallback festgelegt.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie mithilfe der GetBytes Methode ein Zeichenbereich aus einer Zeichenfolge codiert und die codierten Zeichen in einem Bereich von Elementen in einem Bytearray gespeichert werden.
using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
array<Byte>^bytes;
String^ chars = "ASCII Encoding Example";
ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
int byteCount = ascii->GetByteCount( chars->ToCharArray(), 6, 8 );
bytes = gcnew array<Byte>(byteCount);
int bytesEncodedCount = ascii->GetBytes( chars, 6, 8, bytes, 0 );
Console::WriteLine( " {0} bytes used to encode string.", bytesEncodedCount );
Console::Write( "Encoded bytes: " );
IEnumerator^ myEnum = bytes->GetEnumerator();
while ( myEnum->MoveNext() )
{
Byte b = safe_cast<Byte>(myEnum->Current);
Console::Write( "[{0}]", b );
}
Console::WriteLine();
}
using System;
using System.Text;
class ASCIIEncodingExample {
public static void Main() {
Byte[] bytes;
String chars = "ASCII Encoding Example";
ASCIIEncoding ascii = new ASCIIEncoding();
int byteCount = ascii.GetByteCount(chars.ToCharArray(), 6, 8);
bytes = new Byte[byteCount];
int bytesEncodedCount = ascii.GetBytes(chars, 6, 8, bytes, 0);
Console.WriteLine(
"{0} bytes used to encode string.", bytesEncodedCount
);
Console.Write("Encoded bytes: ");
foreach (Byte b in bytes) {
Console.Write("[{0}]", b);
}
Console.WriteLine();
}
}
Imports System.Text
Class ASCIIEncodingExample
Public Shared Sub Main()
Dim bytes() As Byte
Dim chars As String = "ASCII Encoding Example"
Dim ascii As New ASCIIEncoding()
Dim byteCount As Integer = ascii.GetByteCount(chars.ToCharArray(), 6, 8)
bytes = New Byte(byteCount - 1) {}
Dim bytesEncodedCount As Integer = ascii.GetBytes(chars, 6, 8, bytes, 0)
Console.WriteLine("{0} bytes used to encode string.", bytesEncodedCount)
Console.Write("Encoded bytes: ")
Dim b As Byte
For Each b In bytes
Console.Write("[{0}]", b)
Next b
Console.WriteLine()
End Sub
End Class
Hinweise
Um die genaue Arraygröße zu berechnen, die erforderlich ist, um GetBytes die resultierende Bytes zu speichern, wird die Anwendung verwendet GetByteCount. Um die maximale Arraygröße zu berechnen, sollte die Anwendung verwenden GetMaxByteCount. Die- GetByteCount Methode ermöglicht im Allgemeinen die Zuordnung von weniger Arbeitsspeicher, während die- GetMaxByteCount Methode im Allgemeinen schneller ausgeführt wird.
Daten, die konvertiert werden sollen, z. B. Datenlesedaten aus einem Datenstrom, können nur in sequenziellen Blöcken verfügbar sein. In diesem Fall oder wenn die Menge der Daten so umfangreich ist, dass er in kleinere Blöcke aufgeteilt werden muss, sollte die Anwendung verwenden die Decoder oder die Encoder gebotenen der GetDecoder Methode oder die GetEncoder Methode bzw.
ASCIIEncoding gibt keine Fehlererkennung an. Jedes Unicode-Zeichen größer als U+007F wird als ASCII-Fragezeichen ("?") codiert.
Achtung
Aus Sicherheitsgründen wird Ihre Anwendung empfohlen, die Fehlererkennung zu verwenden UTF8Encoding, UnicodeEncodingoder UTF32Encoding zu aktivieren.
Siehe auch
Gilt für
GetBytes(String, Int32, Int32, Byte[], Int32)
Codiert Zeichen aus der angegebenen String-Klasse in das angegebene Bytearray.
public:
override int GetBytes(System::String ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex);
public override int GetBytes (string chars, int charIndex, int charCount, byte[] bytes, int byteIndex);
override this.GetBytes : string * int * int * byte[] * int -> int
Public Overrides Function GetBytes (chars As String, charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer) As Integer
Parameter
- charIndex
- Int32
Der Index des ersten zu codierenden Zeichens.
- charCount
- Int32
Die Anzahl der zu codierenden Zeichen.
- bytes
- Byte[]
Das Bytearray, das die sich ergebende Bytefolge enthalten soll.
- byteIndex
- Int32
Der Index, an dem mit dem Schreiben der sich ergebenden Bytefolge begonnen werden soll.
Gibt zurück
Die tatsächliche Anzahl der Bytes, die in bytes
geschrieben werden.
Ausnahmen
charIndex
, charCount
oder byteIndex
ist kleiner als 0 (null).
- oder -
charIndex
und charCount
geben keinen gültigen Bereich in chars
an.
- oder -
byteIndex
ist kein gültiger Index in bytes
.
bytes
hat von byteIndex
bis zum Ende des Arrays nicht genügend Kapazität, um die sich ergebenden Bytes aufzunehmen.
Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET). - und - Für EncoderFallback ist EncoderExceptionFallback festgelegt.
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie Sie mithilfe der GetBytes Methode einen Bereich von Elementen aus einem Unicode-Zeichenarray codieren und die codierten Bytes in einem Bereich von Elementen in einem Bytearray speichern.
using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
array<Byte>^bytes;
// Unicode characters.
// Pi
// Sigma
array<Char>^chars = {L'\u03a0',L'\u03a3',L'\u03a6',L'\u03a9'};
ASCIIEncoding^ ascii = gcnew ASCIIEncoding;
int byteCount = ascii->GetByteCount( chars, 1, 2 );
bytes = gcnew array<Byte>(byteCount);
int bytesEncodedCount = ascii->GetBytes( chars, 1, 2, bytes, 0 );
Console::WriteLine( " {0} bytes used to encode characters.", bytesEncodedCount );
Console::Write( "Encoded bytes: " );
IEnumerator^ myEnum = bytes->GetEnumerator();
while ( myEnum->MoveNext() )
{
Byte b = safe_cast<Byte>(myEnum->Current);
Console::Write( "[{0}]", b );
}
Console::WriteLine();
}
using System;
using System.Text;
class ASCIIEncodingExample {
public static void Main() {
Byte[] bytes;
// Unicode characters.
Char[] chars = new Char[] {
'\u0023', // #
'\u0025', // %
'\u03a0', // Pi
'\u03a3' // Sigma
};
ASCIIEncoding ascii = new ASCIIEncoding();
int byteCount = ascii.GetByteCount(chars, 1, 2);
bytes = new Byte[byteCount];
int bytesEncodedCount = ascii.GetBytes(chars, 1, 2, bytes, 0);
Console.WriteLine(
"{0} bytes used to encode characters.", bytesEncodedCount
);
Console.Write("Encoded bytes: ");
foreach (Byte b in bytes) {
Console.Write("[{0}]", b);
}
Console.WriteLine();
}
}
Imports System.Text
Imports Microsoft.VisualBasic.Strings
Class ASCIIEncodingExample
Public Shared Sub Main()
Dim bytes() As Byte
' Unicode characters.
' ChrW(35) = #
' ChrW(37) = %
' ChrW(928) = Pi
' ChrW(931) = Sigma
Dim chars() As Char = {ChrW(35), ChrW(37), ChrW(928), ChrW(931)}
Dim ascii As New ASCIIEncoding()
Dim byteCount As Integer = ascii.GetByteCount(chars, 1, 2)
bytes = New Byte(byteCount - 1){}
Dim bytesEncodedCount As Integer = ascii.GetBytes(chars, 1, 2, bytes, 0)
Console.WriteLine("{0} bytes used to encode characters.", bytesEncodedCount)
Console.Write("Encoded bytes: ")
Dim b As Byte
For Each b In bytes
Console.Write("[{0}]", b)
Next b
Console.WriteLine()
End Sub
End Class
Hinweise
Um die genaue Arraygröße zu berechnen, die erforderlich ist, um GetBytes die resultierende Bytes zu speichern, wird die Anwendung verwendet GetByteCount. Um die maximale Arraygröße zu berechnen, sollte die Anwendung verwenden GetMaxByteCount. Die- GetByteCount Methode ermöglicht im Allgemeinen die Zuordnung von weniger Arbeitsspeicher, während die- GetMaxByteCount Methode im Allgemeinen schneller ausgeführt wird.
Daten, die konvertiert werden sollen, z. B. Datenlesedaten aus einem Datenstrom, können nur in sequenziellen Blöcken verfügbar sein. In diesem Fall oder wenn die Menge der Daten so umfangreich ist, dass er in kleinere Blöcke aufgeteilt werden muss, sollte die Anwendung verwenden die Decoder oder die Encoder gebotenen der GetDecoder Methode oder die GetEncoder Methode bzw.
ASCIIEncoding gibt keine Fehlererkennung an. Jedes Unicode-Zeichen größer als U+007F wird als ASCII-Fragezeichen ("?") codiert.
Achtung
Aus Sicherheitsgründen wird Ihre Anwendung empfohlen, die Fehlererkennung zu verwenden UTF8Encoding, UnicodeEncodingoder UTF32Encoding zu aktivieren.