Encoder.GetBytes Methode

  • Referenz

Definition

Namespace:
System.Text
Assembly:
System.Runtime.dll
Assembly:
netstandard.dll
Assembly:
mscorlib.dll
Assembly:
System.Text.Encoding.dll

Beim Überschreiben in einer abgeleiteten Klasse werden die Zeichen in eine Bytefolge codiert.

Überlädt

GetBytes(ReadOnlySpan<Char>, Span<Byte>, Boolean)

Codiert beim Überschreiben in einer abgeleiteten Klasse eine Gruppe von Zeichen in der Eingabezeichenspanne und alle Zeichen im internen Puffer in eine Folge von Bytes, die in der Eingabebytespanne gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Encoders nach der Konvertierung zu löschen ist.
GetBytes(Char*, Int32, Byte*, Int32, Boolean)

Beim Überschreiben in einer abgeleiteten Klasse werden Zeichen beginnend am angegebenen Zeichenzeiger und Zeichen im internen Puffer in eine Bytefolge codiert, die beginnend am angegebenen Bytezeiger gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Encoders nach der Konvertierung zu löschen ist.
GetBytes(Char[], Int32, Int32, Byte[], Int32, Boolean)

Beim Überschreiben in einer abgeleiteten Klasse werden Zeichen aus dem angegebenen Zeichenarray und Zeichen im internen Puffer in den angegebenen Bytearray codiert. Ein Parameter gibt an, ob der interne Zustand des Encoders nach der Konvertierung zu löschen ist.

Hinweise

Denken Sie daran, dass das -Objekt den Encoder Zustand zwischen Aufrufen von GetBytesspeichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den flush Parameter im letzten Aufruf auf true festlegen, um GetBytes sicherzustellen, dass die Zustandsinformationen geleert und die codierten Bytes ordnungsgemäß beendet werden. Mit dieser Einstellung ignoriert der Encoder ungültige Bytes am Ende des Datenblocks, z. B. nicht übereinstimmende Ersatzzeichen oder unvollständige Kombinationssequenzen, und löscht den internen Puffer.

Um die genaue Puffergröße zu berechnen, die GetBytes zum Speichern der resultierenden Zeichen erforderlich ist, sollte die Anwendung verwenden GetByteCount.

Wenn GetBytes aufgerufen wird und flush auf falsefestgelegt ist, speichert der Encoder nachfolgende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Codierungsvorgang. Die Anwendung sollte einen Datenblock unmittelbar vor dem Aufrufen GetBytes desselben Blocks aufrufenGetByteCount, damit alle nachfolgenden Zeichen aus dem vorherigen Block in die Berechnung einbezogen werden.

Wenn Ihre Anwendung viele Segmente eines Eingabedatenstroms konvertieren soll, sollten Sie die Convert -Methode verwenden. GetBytes löst eine Ausnahme aus, wenn der Ausgabepuffer nicht groß genug ist, aber Convert so viel Speicherplatz wie möglich auffüllt und die gelesenen Zeichen und geschriebenen Bytes zurückgibt. Weitere Kommentare finden Sie auch im Encoding.GetBytes Thema.

GetBytes(ReadOnlySpan<Char>, Span<Byte>, Boolean)

Quelle:
Encoder.cs
Quelle:
Encoder.cs
Quelle:
Encoder.cs

Codiert beim Überschreiben in einer abgeleiteten Klasse eine Gruppe von Zeichen in der Eingabezeichenspanne und alle Zeichen im internen Puffer in eine Folge von Bytes, die in der Eingabebytespanne gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Encoders nach der Konvertierung zu löschen ist.

public:
 virtual int GetBytes(ReadOnlySpan<char> chars, Span<System::Byte> bytes, bool flush);
public virtual int GetBytes (ReadOnlySpan<char> chars, Span<byte> bytes, bool flush);
abstract member GetBytes : ReadOnlySpan<char> * Span<byte> * bool -> int
override this.GetBytes : ReadOnlySpan<char> * Span<byte> * bool -> int
Public Overridable Function GetBytes (chars As ReadOnlySpan(Of Char), bytes As Span(Of Byte), flush As Boolean) As Integer

Parameter

chars
ReadOnlySpan<Char>

Eine zu codierende Zeichenspanne.

bytes
Span<Byte>

Eine Bytespanne, in die die resultierende Bytefolge geschrieben werden soll.

flush
Boolean

true löscht nach der Konvertierung den internen Zustand des Encoders, andernfalls false.

Gibt zurück

Int32

Die tatsächliche Anzahl an Bytes, die an der durch den bytes-Parameter angegebenen Position geschrieben wurden.

Gilt für:

GetBytes(Char*, Int32, Byte*, Int32, Boolean)

Quelle:
Encoder.cs
Quelle:
Encoder.cs
Quelle:
Encoder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Beim Überschreiben in einer abgeleiteten Klasse werden Zeichen beginnend am angegebenen Zeichenzeiger und Zeichen im internen Puffer in eine Bytefolge codiert, die beginnend am angegebenen Bytezeiger gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Encoders nach der Konvertierung zu löschen ist.

public:
 virtual int GetBytes(char* chars, int charCount, System::Byte* bytes, int byteCount, bool flush);
[System.CLSCompliant(false)]
public virtual int GetBytes (char* chars, int charCount, byte* bytes, int byteCount, bool flush);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public virtual int GetBytes (char* chars, int charCount, byte* bytes, int byteCount, bool flush);
[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public virtual int GetBytes (char* chars, int charCount, byte* bytes, int byteCount, bool flush);
[<System.CLSCompliant(false)>]
abstract member GetBytes : nativeptr<char> * int * nativeptr<byte> * int * bool -> int
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int * bool -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
abstract member GetBytes : nativeptr<char> * int * nativeptr<byte> * int * bool -> int
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int * bool -> int
[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
abstract member GetBytes : nativeptr<char> * int * nativeptr<byte> * int * bool -> int
override this.GetBytes : nativeptr<char> * int * nativeptr<byte> * int * bool -> 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.

flush
Boolean

true löscht nach der Konvertierung den internen Zustand des Encoders, andernfalls false.

Gibt zurück

Int32

Die tatsächliche Anzahl an Bytes, die an der durch den bytes-Parameter angegebenen Position geschrieben wurden.

Attribute
CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

chars ist null(Nothing).

- oder -

bytes ist null(Nothing).

ArgumentOutOfRangeException

charCount oder byteCount ist kleiner als 0.

ArgumentException

byteCount ist niedriger als die sich ergebende Anzahl von Bytes.

EncoderFallbackException

Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET).

- und -

Für Fallback ist EncoderExceptionFallback festgelegt.

Gilt für:

GetBytes(Char[], Int32, Int32, Byte[], Int32, Boolean)

Quelle:
Encoder.cs
Quelle:
Encoder.cs
Quelle:
Encoder.cs

Beim Überschreiben in einer abgeleiteten Klasse werden Zeichen aus dem angegebenen Zeichenarray und Zeichen im internen Puffer in den angegebenen Bytearray codiert. Ein Parameter gibt an, ob der interne Zustand des Encoders nach der Konvertierung zu löschen ist.

public:
 abstract int GetBytes(cli::array <char> ^ chars, int charIndex, int charCount, cli::array <System::Byte> ^ bytes, int byteIndex, bool flush);
public abstract int GetBytes (char[] chars, int charIndex, int charCount, byte[] bytes, int byteIndex, bool flush);
abstract member GetBytes : char[] * int * int * byte[] * int * bool -> int
Public MustOverride Function GetBytes (chars As Char(), charIndex As Integer, charCount As Integer, bytes As Byte(), byteIndex As Integer, flush As Boolean) 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.

flush
Boolean

true löscht nach der Konvertierung den internen Zustand des Encoders, andernfalls false.

Gibt zurück

Int32

Die tatsächliche Anzahl der Bytes, die in bytes geschrieben werden.

Ausnahmen

ArgumentNullException

chars ist null(Nothing).

- oder -

bytes ist null(Nothing).

ArgumentOutOfRangeException

charIndex, charCount oder byteIndex ist kleiner als 0 (null).

- oder -

charIndex und charCount geben keinen gültigen Bereich in charsan.

- oder -

byteIndex ist kein gültiger Index in bytes.

ArgumentException

bytes hat von byteIndex bis zum Ende des Arrays nicht genügend Kapazität, um die sich ergebenden Bytes aufzunehmen.

EncoderFallbackException

Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET).

- und -

Für Fallback ist EncoderExceptionFallback festgelegt.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie ein Bereich von Elementen aus einem Zeichenarray codiert und die codierten Bytes in einem Bereich von Elementen in einem Bytearray gespeichert werden. Die GetByteCount -Methode wird verwendet, um die Größe des Arrays zu bestimmen, das für erforderlich ist GetBytes.

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'};
   Encoder^ uniEncoder = Encoding::Unicode->GetEncoder();
   int byteCount = uniEncoder->GetByteCount( chars, 0, chars->Length, true );
   bytes = gcnew array<Byte>(byteCount);
   int bytesEncodedCount = uniEncoder->GetBytes( chars, 0, chars->Length, bytes, 0, true );
   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();
}

/* This code example produces the following output.

8 bytes used to encode characters.
Encoded bytes: [160][3][163][3][166][3][169][3]

*/

using System;
using System.Text;

class EncoderExample {
    public static void Main() {
        Byte[] bytes;
        // Unicode characters.
        Char[] chars = new Char[] {
            '\u0023', // #
            '\u0025', // %
            '\u03a0', // Pi
            '\u03a3'  // Sigma
        };
        
        Encoder uniEncoder = Encoding.Unicode.GetEncoder();
        
        int byteCount = uniEncoder.GetByteCount(chars, 0, chars.Length, true);
        bytes = new Byte[byteCount];
        int bytesEncodedCount = uniEncoder.GetBytes(chars, 0, chars.Length, bytes, 0, true);
        
        Console.WriteLine(
            "{0} bytes used to encode characters.", bytesEncodedCount
        );

        Console.Write("Encoded bytes: ");
        foreach (Byte b in bytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
    }
}

/* This code example produces the following output.

8 bytes used to encode characters.
Encoded bytes: [35][0][37][0][160][3][163][3]

*/

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class EncoderExample
    
    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 uniEncoder As Encoder = Encoding.Unicode.GetEncoder()
        
        Dim byteCount As Integer = _
            uniEncoder.GetByteCount(chars, 0, chars.Length, True)
        bytes = New Byte(byteCount - 1) {}
        Dim bytesEncodedCount As Integer = _
            uniEncoder.GetBytes(chars, 0, chars.Length, bytes, 0, True)
        
        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

'This code example produces the following output.
'8 bytes used to encode characters.
'Encoded bytes: [35][0][37][0][160][3][163][3]
'

Gilt für: