Teilen über


Decoder.GetChars Methode

Definition

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge in Zeichen decodiert.

Überlädt

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

Decodiert beim Überschreiben in einer abgeleiteten Klasse eine Folge von Spannenbytes und alle Bytes im internen Puffer in eine Gruppe von Zeichen, die ab dem angegebenen Zeichenzeiger gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung zu löschen ist.

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

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge beginnend am angegebenen Bytezeiger einschließlich aller Bytes im internen Puffer in Zeichen decodiert, die ab Beginn des angegebenen Zeichenzeigers gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung zu löschen ist.

GetChars(Byte[], Int32, Int32, Char[], Int32)

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge aus dem angegebenen Bytearray einschließlich aller Bytes im internen Puffer in das angegebene Zeichenarray decodiert.

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

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge aus dem angegebenen Bytearray einschließlich aller Bytes im internen Puffer in das angegebene Zeichenarray decodiert. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung zu löschen ist.

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

Quelle:
Decoder.cs
Quelle:
Decoder.cs
Quelle:
Decoder.cs

Decodiert beim Überschreiben in einer abgeleiteten Klasse eine Folge von Spannenbytes und alle Bytes im internen Puffer in eine Gruppe von Zeichen, die ab dem angegebenen Zeichenzeiger gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung zu löschen ist.

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

Parameter

bytes
ReadOnlySpan<Byte>

Eine zu decodierende Bytespanne.

chars
Span<Char>

Eine Spanne, in die die resultierende Gruppe von Zeichen geschrieben werden soll.

flush
Boolean

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

Gibt zurück

Die tatsächliche Anzahl der Zeichen, die an der durch den chars-Parameter angegebenen Spanne geschrieben wurden.

Hinweise

Denken Sie daran, dass das -Objekt den Decoder Zustand zwischen Aufrufen von GetCharsspeichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den flush Parameter auf true festlegen, um sicherzustellen, dass die Zustandsinformationen geleert werden. Mit dieser Einstellung ignoriert der Decoder ungültige Bytes am Ende des Datenblocks und löscht den internen Puffer.

Um die genaue Spannweite zu berechnen, die GetChars zum Speichern der resultierenden Zeichen erforderlich ist, sollte die Anwendung verwenden GetCharCount.

Wenn GetChars mit flush festgelegt auf falseaufgerufen wird, speichert der Decoder nachfolgende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte einen Datenblock unmittelbar vor dem Aufrufen GetChars desselben Blocks aufrufenGetCharCount, damit alle nachfolgenden Bytes aus dem vorherigen Block in die Berechnung einbezogen werden.

Wenn Ihre Anwendung viele Segmente eines Eingabedatenstroms konvertieren soll, sollten Sie die Convert -Methode verwenden. GetChars löst eine Ausnahme aus, wenn die Ausgabespanne nicht groß genug ist, aber Convert so viel Speicherplatz wie möglich füllt und die gelesenen Bytes und geschriebenen Zeichen zurückgibt, sofern das Ausgabearray mindestens zwei Zeichen zulässt. Weitere Kommentare finden Sie auch im Encoding.GetChars Thema.

Gilt für:

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

Quelle:
Decoder.cs
Quelle:
Decoder.cs
Quelle:
Decoder.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge beginnend am angegebenen Bytezeiger einschließlich aller Bytes im internen Puffer in Zeichen decodiert, die ab Beginn des angegebenen Zeichenzeigers gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung zu löschen ist.

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

Parameter

bytes
Byte*

Ein Zeiger auf das erste zu decodierende Byte.

byteCount
Int32

Die Anzahl der zu decodierenden Bytes.

chars
Char*

Ein Zeiger auf die Position, an der mit dem Schreiben der sich ergebenden Zeichen begonnen werden soll.

charCount
Int32

Die maximale Anzahl der zu schreibenden Zeichen.

flush
Boolean

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

Gibt zurück

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

Attribute

Ausnahmen

bytes ist null(Nothing).

- oder -

chars ist null(Nothing).

byteCount oder charCount ist kleiner als 0.

charCount ist niedriger als die sich ergebende Anzahl von Zeichen.

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

- und -

Für Fallback ist DecoderExceptionFallback festgelegt.

Hinweise

Denken Sie daran, dass das -Objekt den Decoder Zustand zwischen Aufrufen von GetCharsspeichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den flush Parameter auf true festlegen, um sicherzustellen, dass die Zustandsinformationen geleert werden. Mit dieser Einstellung ignoriert der Decoder ungültige Bytes am Ende des Datenblocks und löscht den internen Puffer.

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

Wenn GetChars mit flush festgelegt auf falseaufgerufen wird, speichert der Decoder nachfolgende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte einen Datenblock unmittelbar vor dem Aufrufen GetChars desselben Blocks aufrufenGetCharCount, damit alle nachfolgenden Bytes aus dem vorherigen Block in die Berechnung einbezogen werden.

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

Weitere Informationen

Gilt für:

GetChars(Byte[], Int32, Int32, Char[], Int32)

Quelle:
Decoder.cs
Quelle:
Decoder.cs
Quelle:
Decoder.cs

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge aus dem angegebenen Bytearray einschließlich aller Bytes im internen Puffer in das angegebene Zeichenarray decodiert.

public:
 abstract int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);
public abstract int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);
abstract member GetChars : byte[] * int * int * char[] * int -> int
Public MustOverride Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer) As Integer

Parameter

bytes
Byte[]

Das Bytearray, das die zu decodierende Bytefolge enthält.

byteIndex
Int32

Der Index des ersten zu decodierenden Bytes.

byteCount
Int32

Die Anzahl der zu decodierenden Bytes.

chars
Char[]

Das Zeichenarray, das die sich ergebenden Zeichen enthalten soll.

charIndex
Int32

Der Index, an dem mit dem Schreiben der sich ergebenden Zeichen begonnen werden soll.

Gibt zurück

Die tatsächliche Anzahl der Zeichen, die in chars geschrieben werden.

Ausnahmen

bytes ist null(Nothing).

- oder -

chars ist null(Nothing).

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

- oder -

byteindex und byteCount geben keinen gültigen Bereich in bytesan.

- oder -

charIndex ist kein gültiger Index in chars.

chars hat von charIndex bis zum Ende des Arrays nicht genügend Kapazität, um die sich ergebenden Zeichen aufzunehmen.

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

- und -

Für Fallback ist DecoderExceptionFallback festgelegt.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie sie einen Bereich von Elementen aus einem Bytearray decodieren und in einem Unicode-Zeichenarray speichern. Die GetCharCount -Methode wird verwendet, um die Anzahl der Zeichen zu berechnen, die zum Speichern der decodierten Elemente im Array byteserforderlich sind. Die GetChars -Methode decodiert die angegebenen Elemente im Bytearray und speichert sie im neuen Zeichenarray.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
int main()
{
   array<Char>^chars;
   array<Byte>^bytes = {85,0,110,0,105,0,99,0,111,0,100,0,101,0};
   Decoder^ uniDecoder = Encoding::Unicode->GetDecoder();
   int charCount = uniDecoder->GetCharCount( bytes, 0, bytes->Length );
   chars = gcnew array<Char>(charCount);
   int charsDecodedCount = uniDecoder->GetChars( bytes, 0, bytes->Length, chars, 0 );
   Console::WriteLine( "{0} characters used to decode bytes.", charsDecodedCount );
   Console::Write( "Decoded chars: " );
   IEnumerator^ myEnum = chars->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Char c = safe_cast<Char>(myEnum->Current);
      Console::Write( "[{0}]", c.ToString() );
   }

   Console::WriteLine();
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/
using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0
        };

        Decoder uniDecoder = Encoding.Unicode.GetDecoder();

        int charCount = uniDecoder.GetCharCount(bytes, 0, bytes.Length);
        chars = new Char[charCount];
        int charsDecodedCount = uniDecoder.GetChars(bytes, 0, bytes.Length, chars, 0);

        Console.WriteLine(
            "{0} characters used to decode bytes.", charsDecodedCount
        );

        Console.Write("Decoded chars: ");
        foreach (Char c in chars) {
            Console.Write("[{0}]", c);
        }
        Console.WriteLine();
    }
}

/* This code example produces the following output.

7 characters used to decode bytes.
Decoded chars: [U][n][i][c][o][d][e]

*/
Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85, 0, 110, 0, 105, 0, 99, 0, 111, 0, 100, 0, 101, 0 _
        }
        
        Dim uniDecoder As Decoder = Encoding.Unicode.GetDecoder()
        
        Dim charCount As Integer = uniDecoder.GetCharCount(bytes, 0, bytes.Length)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = _
            uniDecoder.GetChars(bytes, 0, bytes.Length, chars, 0)
        
        Console.WriteLine( _
            "{0} characters used to decode bytes.", _
            charsDecodedCount _
        )
        
        Console.Write("Decoded chars: ")
        Dim c As Char
        For Each c In  chars
            Console.Write("[{0}]", c)
        Next c
        Console.WriteLine()
    End Sub
End Class

'This code example produces the following output.
'
'7 characters used to decode bytes.
'Decoded chars: [U][n][i][c][o][d][e]
'

Hinweise

Denken Sie daran, dass das -Objekt den Decoder Zustand zwischen Aufrufen von GetCharsspeichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den flush Parameter auf true festlegen, um sicherzustellen, dass die Zustandsinformationen geleert werden. Mit dieser Einstellung ignoriert der Decoder ungültige Bytes am Ende des Datenblocks und löscht den internen Puffer.

Um die genaue Arraygröße zu berechnen, die GetChars zum Speichern der resultierenden Zeichen erforderlich ist, sollte die Anwendung verwenden GetCharCount.

Wenn GetChars mit flush festgelegt auf falseaufgerufen wird, speichert der Decoder nachfolgende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte einen Datenblock unmittelbar vor dem Aufrufen GetChars desselben Blocks aufrufenGetCharCount, damit alle nachfolgenden Bytes aus dem vorherigen Block in die Berechnung einbezogen werden.

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

Weitere Informationen

Gilt für:

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

Quelle:
Decoder.cs
Quelle:
Decoder.cs
Quelle:
Decoder.cs

Beim Überschreiben in einer abgeleiteten Klasse wird eine Bytefolge aus dem angegebenen Bytearray einschließlich aller Bytes im internen Puffer in das angegebene Zeichenarray decodiert. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung zu löschen ist.

public:
 virtual int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex, bool flush);
public virtual int GetChars (byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex, bool flush);
abstract member GetChars : byte[] * int * int * char[] * int * bool -> int
override this.GetChars : byte[] * int * int * char[] * int * bool -> int
Public Overridable Function GetChars (bytes As Byte(), byteIndex As Integer, byteCount As Integer, chars As Char(), charIndex As Integer, flush As Boolean) As Integer

Parameter

bytes
Byte[]

Das Bytearray, das die zu decodierende Bytefolge enthält.

byteIndex
Int32

Der Index des ersten zu decodierenden Bytes.

byteCount
Int32

Die Anzahl der zu decodierenden Bytes.

chars
Char[]

Das Zeichenarray, das die sich ergebenden Zeichen enthalten soll.

charIndex
Int32

Der Index, an dem mit dem Schreiben der sich ergebenden Zeichen begonnen werden soll.

flush
Boolean

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

Gibt zurück

Die tatsächliche Anzahl der Zeichen, die in den chars-Parameter geschrieben wird.

Ausnahmen

bytes ist null(Nothing).

- oder -

chars ist null(Nothing).

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

- oder -

byteindex und byteCount geben keinen gültigen Bereich in bytesan.

- oder -

charIndex ist kein gültiger Index in chars.

chars hat von charIndex bis zum Ende des Arrays nicht genügend Kapazität, um die sich ergebenden Zeichen aufzunehmen.

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

- und -

Für Fallback ist DecoderExceptionFallback festgelegt.

Hinweise

Denken Sie daran, dass das -Objekt den Decoder Zustand zwischen Aufrufen von GetCharsspeichert. Wenn die Anwendung mit einem Datenstrom fertig ist, sollte sie den flush Parameter auf true festlegen, um sicherzustellen, dass die Statusinformationen geleert werden. Mit dieser Einstellung ignoriert der Decoder ungültige Bytes am Ende des Datenblocks und löscht den internen Puffer.

Um die genaue Arraygröße zu berechnen, die GetChars zum Speichern der resultierenden Zeichen erforderlich ist, sollte die Anwendung verwenden GetCharCount.

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

Wenn Ihre Anwendung viele Segmente eines Eingabedatenstroms konvertieren soll, sollten Sie die Convert -Methode verwenden. GetChars 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 Bytes und geschriebenen Zeichen zurückgibt, sofern das Ausgabearray mindestens zwei Zeichen zulässt. Weitere Kommentare finden Sie auch im Encoding.GetChars Thema.

Weitere Informationen

Gilt für: