Decoder.GetChars 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 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)

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

Int32

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

Hinweise

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

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

Wenn aufgerufen wird, bei dem auf festgelegt ist, speichert der Decoder nachfingende Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten GetChars flush false Decodierungsvorgang. Die Anwendung sollte sofort für einen Datenblock aufrufen, bevor sie für denselben Block aufruft, damit alle nach dem vorherigen Block in die GetCharCount GetChars Berechnung einbezogen werden.

Wenn Ihre Anwendung viele Segmente eines Eingabestreams konvertieren soll, erwägen Sie die Verwendung der Convert -Methode. GetChars löst eine Ausnahme aus, wenn die Ausgabespanne nicht groß genug ist, füllt jedoch so viel Speicherplatz wie möglich aus und gibt die gelesenen Bytes und geschriebenen Zeichen zurück, vorausgesetzt, das Ausgabearray lässt mindestens zwei Zeichen Convert zu. Weitere Kommentare Encoding.GetChars finden Sie auch im Thema .

Gilt für

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

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

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

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

Int32

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

Attribute: CLSCompliantAttribute ComVisibleAttribute SecurityCriticalAttribute

Ausnahmen

ArgumentNullException

bytes ist null(Nothing).

- oder -

chars ist null(Nothing).

ArgumentOutOfRangeException

byteCount oder charCount ist kleiner als 0.

ArgumentException

charCount ist niedriger als die sich ergebende Anzahl von Zeichen.

DecoderFallbackException

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

- und -

Für Fallback ist DecoderExceptionFallback festgelegt.

Hinweise

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

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

Siehe auch

Gilt für

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.

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

Int32

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

Ausnahmen

ArgumentNullException

bytes ist null(Nothing).

- oder -

chars ist null(Nothing).

ArgumentOutOfRangeException

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.

ArgumentException

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

DecoderFallbackException

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 ein Bereich von Elementen aus einem Bytearray decodiert und in einem Unicode-Zeichenarray gespeichert wird. Die -Methode wird verwendet, um die Anzahl der Zeichen zu berechnen, die zum Speichern der GetCharCount decodierten Elemente im Array erforderlich bytes 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

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

Siehe auch

Gilt für

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.

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

Int32

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

Ausnahmen

ArgumentNullException

bytes ist null(Nothing).

- oder -

chars ist null(Nothing).

ArgumentOutOfRangeException

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.

ArgumentException

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

DecoderFallbackException

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

- und -

Für Fallback ist DecoderExceptionFallback festgelegt.

Hinweise

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

Siehe auch

Gilt für

Decoder.GetChars Methode

Definition

Überlädt

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

Parameter

Gibt zurück

Hinweise

Gilt für

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

Parameter

Gibt zurück

Ausnahmen

Hinweise

Siehe auch

Gilt für

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

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Siehe auch

Gilt für

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

Parameter

Gibt zurück

Ausnahmen

Hinweise

Siehe auch

Gilt für

Zusätzliche Ressourcen

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