Decoder.GetChars Methode

Definition

Namespace:

System.Text

Assembly:

mscorlib.dll

Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, decodieren Sie eine Bytesequenz in eine Reihe von Zeichen.

Überlädt

Name	Beschreibung
GetChars(Byte*, Int32, Char*, Int32, Boolean)	Wenn sie in einer abgeleiteten Klasse überschrieben werden, decodieren Sie eine Abfolge von Bytes beginnend mit dem angegebenen Bytezeiger und allen Bytes im internen Puffer in eine Reihe von Zeichen, die ab dem angegebenen Zeichenzeiger gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung gelöscht werden soll.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Wenn eine abgeleitete Klasse überschrieben wird, decodiert eine Bytesequenz aus dem angegebenen Bytearray und alle Bytes im internen Puffer in das angegebene Zeichenarray.
GetChars(Byte[], Int32, Int32, Char[], Int32, Boolean)	Wenn eine abgeleitete Klasse überschrieben wird, decodiert eine Bytesequenz aus dem angegebenen Bytearray und alle Bytes im internen Puffer in das angegebene Zeichenarray. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung gelöscht werden soll.

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

Wichtig

Diese API ist nicht CLS-kompatibel.

Wenn sie in einer abgeleiteten Klasse überschrieben werden, decodieren Sie eine Abfolge von Bytes beginnend mit dem angegebenen Bytezeiger und allen Bytes im internen Puffer in eine Reihe von Zeichen, die ab dem angegebenen Zeichenzeiger gespeichert werden. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung gelöscht werden soll.

public:
 virtual int GetChars(System::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)>]
[<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 Byte, das decodiert werden soll.

byteCount

Int32

Die Anzahl der Bytes, die decodiert werden sollen.

chars

Char*

Ein Zeiger auf die Position, an der mit dem Schreiben der resultierenden Zeichenmenge begonnen werden soll.

charCount

Int32

Die maximale Anzahl von Zeichen, die geschrieben werden sollen.

flush

Boolean

trueum den internen Zustand des Decoders nach der Konvertierung zu löschen; andernfalls . false

Gibt zurück

Int32

Die tatsächliche Anzahl von 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 Null.

ArgumentException

charCount ist kleiner als die resultierende Anzahl von Zeichen.

DecoderFallbackException

Ein Fallback ist aufgetreten (weitere Informationen finden Sie unter "Zeichencodierung in .NET")

-und-

Fallback ist auf DecoderExceptionFallback festgelegt.

Hinweise

Denken Sie daran, dass das Decoder Objekt den Zustand zwischen Aufrufen GetCharsvon . Wenn die Anwendung mit einem Datenstrom fertig ist, sollte der flush Parameter true so festgelegt werden, 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 Puffergröße zu berechnen, GetChars die zum Speichern der resultierenden Zeichen erforderlich ist, sollte die Anwendung verwenden GetCharCount.

Wenn GetChars mit flush "Set" falseaufgerufen wird, speichert der Decoder nachgestellte Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte unmittelbar vor dem Aufrufen GetChars desselben Blocks einen Datenblock aufrufenGetCharCount, sodass 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 Platz wie möglich ausfüllt und die geschriebenen Bytes zurückgibt, sofern das Ausgabearray mindestens zwei Zeichen zulässt. Weitere Kommentare finden Sie auch im Encoding.GetChars Thema.

Weitere Informationen

• GetCharCount(Byte*, Int32, Boolean)
• Reset()

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

Wenn eine abgeleitete Klasse überschrieben wird, decodiert eine Bytesequenz aus dem angegebenen Bytearray und alle Bytes im internen Puffer in das angegebene Zeichenarray.

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 Abfolge von Bytes enthält, die decodiert werden sollen.

byteIndex

Int32

Der Index des ersten zu decodierenden Bytes.

byteCount

Int32

Die Anzahl der Bytes, die decodiert werden sollen.

chars

Char[]

Das Zeichenarray, das den resultierenden Satz von Zeichen enthält.

charIndex

Int32

Der Index, an dem mit dem Schreiben der resultierenden Zeichenmenge begonnen werden soll.

Gibt zurück

Int32

Die tatsächliche Anzahl der Zeichen, in charsdie geschrieben wurde.

Ausnahmen

ArgumentNullException

bytes ist null (Nothing).

-oder-

chars ist null (Nothing).

ArgumentOutOfRangeException

byteIndex oder byteCountcharIndex ist kleiner als Null.

-oder-

byteIndex und byteCount keinen gültigen Bereich in bytes.

-oder-

charIndex ist kein gültiger Index in chars.

ArgumentException

chars verfügt nicht über genügend Kapazität vom charIndex Ende des Arrays, um die resultierenden Zeichen aufzunehmen.

DecoderFallbackException

Ein Fallback ist aufgetreten (weitere Informationen finden Sie unter "Zeichencodierung in .NET")

-und-

Fallback ist auf 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 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 Decoder Objekt den Zustand zwischen Aufrufen GetCharsvon . Wenn die Anwendung mit einem Datenstrom fertig ist, sollte der flush Parameter true so festgelegt werden, 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 mit flush "Set" falseaufgerufen wird, speichert der Decoder nachgestellte Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte unmittelbar vor dem Aufrufen GetChars desselben Blocks einen Datenblock aufrufenGetCharCount, sodass 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 Platz wie möglich ausfüllt und die geschriebenen Bytes zurückgibt, sofern das Ausgabearray mindestens zwei Zeichen zulässt. Weitere Kommentare finden Sie auch im Encoding.GetChars Thema.

Weitere Informationen

• GetCharCount(Byte[], Int32, Int32)
• Reset()

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

Wenn eine abgeleitete Klasse überschrieben wird, decodiert eine Bytesequenz aus dem angegebenen Bytearray und alle Bytes im internen Puffer in das angegebene Zeichenarray. Ein Parameter gibt an, ob der interne Zustand des Decoders nach der Konvertierung gelöscht werden soll.

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 Abfolge von Bytes enthält, die decodiert werden sollen.

byteIndex

Int32

Der Index des ersten zu decodierenden Bytes.

byteCount

Int32

Die Anzahl der Bytes, die decodiert werden sollen.

chars

Char[]

Das Zeichenarray, das den resultierenden Satz von Zeichen enthält.

charIndex

Int32

Der Index, an dem mit dem Schreiben der resultierenden Zeichenmenge begonnen werden soll.

flush

Boolean

trueum den internen Zustand des Decoders nach der Konvertierung zu löschen; andernfalls . false

Gibt zurück

Int32

Die tatsächliche Anzahl von Zeichen, die in den chars Parameter geschrieben wurden.

Ausnahmen

ArgumentNullException

bytes ist null (Nothing).

-oder-

chars ist null (Nothing).

ArgumentOutOfRangeException

byteIndex oder byteCountcharIndex ist kleiner als Null.

-oder-

byteIndex und byteCount keinen gültigen Bereich in bytes.

-oder-

charIndex ist kein gültiger Index in chars.

ArgumentException

chars verfügt nicht über genügend Kapazität vom charIndex Ende des Arrays, um die resultierenden Zeichen aufzunehmen.

DecoderFallbackException

Ein Fallback ist aufgetreten (weitere Informationen finden Sie unter "Zeichencodierung in .NET")

-und-

Fallback ist auf DecoderExceptionFallback festgelegt.

Hinweise

Denken Sie daran, dass das Decoder Objekt den Zustand zwischen Aufrufen GetCharsvon . Wenn die Anwendung mit einem Datenstrom fertig ist, sollte der flush Parameter true so festgelegt werden, 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 mit flush "Set" falseaufgerufen wird, speichert der Decoder nachgestellte Bytes am Ende des Datenblocks in einem internen Puffer und verwendet sie im nächsten Decodierungsvorgang. Die Anwendung sollte unmittelbar vor dem Aufrufen GetChars desselben Blocks einen Datenblock aufrufenGetCharCount, sodass 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 Platz wie möglich ausfüllt und die geschriebenen Bytes zurückgibt, sofern das Ausgabearray mindestens zwei Zeichen zulässt. Weitere Kommentare finden Sie auch im Encoding.GetChars Thema.

Weitere Informationen

• GetCharCount(Byte[], Int32, Int32, Boolean)
• Reset()