UTF7Encoding.GetChars Methode

Definition

Namespace:
System.Text
Assemblys:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Assemblys:
netstandard.dll, System.Text.Encoding.Extensions.dll
Assembly:
System.Text.Encoding.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

Decodiert eine Bytesequenz in eine Reihe von Zeichen.

Überlädt

Name Beschreibung
GetChars(Byte*, Int32, Char*, Int32)

Decodiert eine Abfolge von Bytes ab dem angegebenen Bytezeiger in eine Reihe von Zeichen, die beginnend mit dem angegebenen Zeichenzeiger gespeichert werden.
GetChars(Byte[], Int32, Int32, Char[], Int32)

Decodiert eine Abfolge von Bytes aus dem angegebenen Bytearray in das angegebene Zeichenarray.

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

Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs

Wichtig

Diese API ist nicht CLS-kompatibel.

Decodiert eine Abfolge von Bytes ab dem angegebenen Bytezeiger in eine Reihe von Zeichen, die beginnend mit dem angegebenen Zeichenzeiger gespeichert werden.

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

Gibt zurück

Int32

Die tatsächliche Anzahl von Zeichen, die an der durch angegebenen Position geschrieben charswurden.

Attribute
CLSCompliantAttribute SecurityCriticalAttribute ComVisibleAttribute

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-

DecoderFallback ist auf DecoderExceptionFallback festgelegt.

Hinweise

Um die genaue Arraygröße zu berechnen, die erforderlich GetChars ist, um die resultierenden Zeichen zu speichern, verwenden Sie GetCharCount. Um die maximale Arraygröße zu berechnen, sollte die Anwendung verwenden GetMaxCharCount. Die GetCharCount Methode ermöglicht in der Regel die Zuordnung von weniger Arbeitsspeicher, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.

Daten, die konvertiert werden sollen, z. B. Daten, die aus einem Datenstrom gelesen werden, sind möglicherweise nur in sequenziellen Blöcken verfügbar. In diesem Fall oder wenn die Datenmenge so groß ist, dass sie in kleinere Blöcke unterteilt werden muss, sollte die Anwendung die Decoder oder die Encoder von der GetDecoder Methode bzw. methode GetEncoder bereitgestellte Verwenden.

Note

UTF7Encoding stellt keine Fehlererkennung bereit. Wenn ungültige Bytes gefunden werden, UTF7Encoding gibt dies in der Regel die ungültigen Bytes aus. Wenn ein Byte größer als hexadezimale 0x7F ist, wird der Bytewert in ein Unicode-Zeichen erweitert, das Ergebnis wird im chars Array gespeichert, und jede Schichtsequenz wird beendet. Wenn das zu codierenden Byte beispielsweise hexadezimal 0x81 ist, lautet das resultierende Zeichen U+0081. Aus Sicherheitsgründen wird empfohlen, Ihre Anwendungen zu verwenden UTF8Encoding, UnicodeEncodingoder UTF32Encoding die Fehlererkennung zu aktivieren.

Weitere Informationen

Gilt für:

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

Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs
Quelle:
UTF7Encoding.cs

Decodiert eine Abfolge von Bytes aus dem angegebenen Bytearray in das angegebene Zeichenarray.

public:
 override int GetChars(cli::array <System::Byte> ^ bytes, int byteIndex, int byteCount, cli::array <char> ^ chars, int charIndex);
public override int GetChars(byte[] bytes, int byteIndex, int byteCount, char[] chars, int charIndex);
override this.GetChars : byte[] * int * int * char[] * int -> int
Public Overrides 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-

DecoderFallback ist auf DecoderExceptionFallback festgelegt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die GetChars Methode verwendet wird, um einen Bereich von Elementen in einem Bytearray zu decodieren und das Ergebnis in einem Zeichenarray zu speichern.

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        Char[] chars;
        Byte[] bytes = new Byte[] {
             85,  84,  70,  55,  32,  69, 110,
             99, 111, 100, 105, 110, 103,  32,
             69, 120,  97, 109, 112, 108, 101
        };

        UTF7Encoding utf7 = new UTF7Encoding();

        int charCount = utf7.GetCharCount(bytes, 2, 8);
        chars = new Char[charCount];
        int charsDecodedCount = utf7.GetChars(bytes, 2, 8, 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();
    }
}

Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim chars() As Char
        Dim bytes() As Byte = { _
            85,  84,  70,  55,  32,  69, 110, _
            99, 111, 100, 105, 110, 103,  32, _
            69, 120,  97, 109, 112, 108, 101 _
        }
        
        Dim utf7 As New UTF7Encoding()
        
        Dim charCount As Integer = utf7.GetCharCount(bytes, 2, 8)
        chars = New Char(charCount - 1) {}
        Dim charsDecodedCount As Integer = utf7.GetChars(bytes, 2, 8, 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

Hinweise

Um die genaue Arraygröße zu berechnen, die erforderlich GetChars ist, um die resultierenden Zeichen zu speichern, verwenden Sie GetCharCount. Um die maximale Arraygröße zu berechnen, sollte die Anwendung verwenden GetMaxCharCount. Die GetCharCount Methode ermöglicht in der Regel die Zuordnung von weniger Arbeitsspeicher, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.

Daten, die konvertiert werden sollen, z. B. Daten, die aus einem Datenstrom gelesen werden, sind möglicherweise nur in sequenziellen Blöcken verfügbar. In diesem Fall oder wenn die Datenmenge so groß ist, dass sie in kleinere Blöcke unterteilt werden muss, sollte die Anwendung die Decoder oder die Encoder von der GetDecoder Methode bzw. methode GetEncoder bereitgestellte Verwenden.

Note

UTF7Encoding stellt keine Fehlererkennung bereit. Wenn ungültige Bytes gefunden werden, UTF7Encoding gibt dies in der Regel die ungültigen Bytes aus. Wenn ein Byte größer als hexadezimale 0x7F ist, wird der Bytewert in ein Unicode-Zeichen erweitert, das Ergebnis wird im chars Array gespeichert, und jede Schichtsequenz wird beendet. Wenn das zu codierenden Byte beispielsweise hexadezimal 0x81 ist, lautet das resultierende Zeichen U+0081. Aus Sicherheitsgründen wird empfohlen, Ihre Anwendungen zu verwenden UTF8Encoding, UnicodeEncodingoder UTF32Encoding die Fehlererkennung zu aktivieren.

Weitere Informationen

Gilt für: