Encoder.GetBytes Methode

Referenz

Definition

Namespace:: System.Text

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Assembly:: mscorlib.dll

Assembly:: System.Text.Encoding.dll

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.

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, Encoder dass das -Objekt den Zustand zwischen Aufrufen von GetBytes speichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den Parameter im letzten Aufruf von auf festlegen, um sicherzustellen, dass die Zustandsinformationen geleert und die codierten Bytes ordnungsgemäß flush true beendet GetBytes werden. Mit dieser Einstellung ignoriert der Encoder ungültige Bytes am Ende des Datenblocks, z. B. nicht übereinstimmende Ersatzzeichen oder unvollständige kombinierende Sequenzen, und lädt den internen Puffer.

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

Wenn aufgerufen wird, bei dem auf festgelegt ist, speichert der Encoder nachfingende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im GetBytes flush nächsten false Codierungsvorgang. Die Anwendung sollte für einen Datenblock unmittelbar vor dem Aufruf für denselben Block aufrufen, damit alle nachdenkenden Zeichen aus dem vorherigen Block GetByteCount in die Berechnung einbezogen GetBytes werden.

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

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.

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)

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);

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

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)

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 sie einen Bereich von Elementen aus einem Zeichenarray codieren und die codierten Bytes in einem Bereich von Elementen in einem Bytearray speichern. Die GetByteCount -Methode wird verwendet, um die Größe des Arrays zu bestimmen, das für erforderlich GetBytes ist.

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

Encoder.GetBytes Methode

Definition

Überlädt

Hinweise

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

Parameter

Gibt zurück

Gilt für

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

Parameter

Gibt zurück

Ausnahmen

Gilt für

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

Parameter

Gibt zurück

Ausnahmen

Beispiele

Gilt für

Zusätzliche Ressourcen

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