UTF8Encoding.GetCharCount Methode
Definition
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.
Berechnet die Anzahl der Zeichen, die durch Decodieren einer Bytesequenz erzeugt werden.
Überlädt
| Name | Beschreibung |
|---|---|
| GetCharCount(Byte*, Int32) |
Berechnet die Anzahl der Zeichen, die durch Decodieren einer Bytesequenz erzeugt werden, beginnend mit dem angegebenen Bytezeiger. |
| GetCharCount(Byte[], Int32, Int32) |
Berechnet die Anzahl der Zeichen, die durch Decodieren einer Bytesequenz aus dem angegebenen Bytearray erzeugt werden. |
GetCharCount(Byte*, Int32)
Wichtig
Diese API ist nicht CLS-kompatibel.
Berechnet die Anzahl der Zeichen, die durch Decodieren einer Bytesequenz erzeugt werden, beginnend mit dem angegebenen Bytezeiger.
public:
override int GetCharCount(System::Byte* bytes, int count);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetCharCount(byte* bytes, int count);[System.CLSCompliant(false)]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
[System.Runtime.InteropServices.ComVisible(false)]
public override int GetCharCount(byte* bytes, int count);[System.CLSCompliant(false)]
public override int GetCharCount(byte* bytes, int count);[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetCharCount : nativeptr<byte> * int -> int[<System.CLSCompliant(false)>]
override this.GetCharCount : nativeptr<byte> * int -> intParameter
- bytes
- Byte*
Ein Zeiger auf das erste Byte, das decodiert werden soll.
- count
- Int32
Die Anzahl der Bytes, die decodiert werden sollen.
Gibt zurück
Die Anzahl der Zeichen, die durch Decodieren der angegebenen Bytesequenz erzeugt werden.
- Attribute
Ausnahmen
bytes ist null.
count ist kleiner als 0 (null).
-oder-
Die resultierende Anzahl von Bytes ist größer als die maximale Zahl, die als ganze Zahl zurückgegeben werden kann.
Fehlererkennung ist aktiviert und bytes enthält eine ungültige Bytesequenz.
Ein Fallback ist aufgetreten (weitere Informationen finden Sie unter "Zeichencodierung in .NET")
-und-
DecoderFallback ist auf DecoderExceptionFallback festgelegt.
Hinweise
Rufen Sie die Methode auf, um die genaue Arraygröße zu berechnen, die zum GetChars Speichern der GetCharCount resultierenden Zeichen erforderlich ist. Rufen Sie die Methode auf, um die GetMaxCharCount maximale Arraygröße zu berechnen. Die GetCharCount Methode weist in der Regel weniger Arbeitsspeicher zu, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.
Bei der Fehlererkennung führt eine ungültige Sequenz dazu, dass diese Methode eine ArgumentException Ausnahme auslöst. Ohne Fehlererkennung werden ungültige Sequenzen ignoriert, und es wird keine Ausnahme ausgelöst.
Weitere Informationen
Gilt für:
GetCharCount(Byte[], Int32, Int32)
Berechnet die Anzahl der Zeichen, die durch Decodieren einer Bytesequenz aus dem angegebenen Bytearray erzeugt werden.
public:
override int GetCharCount(cli::array <System::Byte> ^ bytes, int index, int count);public override int GetCharCount(byte[] bytes, int index, int count);override this.GetCharCount : byte[] * int * int -> intPublic Overrides Function GetCharCount (bytes As Byte(), index As Integer, count As Integer) As IntegerParameter
- bytes
- Byte[]
Das Bytearray, das die Abfolge von Bytes enthält, die decodiert werden sollen.
- index
- Int32
Der Index des ersten zu decodierenden Bytes.
- count
- Int32
Die Anzahl der Bytes, die decodiert werden sollen.
Gibt zurück
Die Anzahl der Zeichen, die durch Decodieren der angegebenen Bytesequenz erzeugt werden.
Ausnahmen
bytes ist null.
index oder count ist kleiner als Null.
-oder-
index und count keinen gültigen Bereich in bytes.
-oder-
Die resultierende Anzahl von Bytes ist größer als die maximale Zahl, die als ganze Zahl zurückgegeben werden kann.
Fehlererkennung ist aktiviert und bytes enthält eine ungültige Bytesequenz.
Ein Fallback ist aufgetreten (weitere Informationen finden Sie unter "Zeichencodierung in .NET")
-und-
DecoderFallback ist auf DecoderExceptionFallback festgelegt.
Beispiele
Im folgenden Beispiel wird die GetCharCount Methode verwendet, um die Anzahl der Zeichen zurückzugeben, die durch Decodieren eines Bereichs von Elementen in einem Bytearray erzeugt werden.
using System;
using System.Text;
class UTF8EncodingExample {
public static void Main() {
Byte[] bytes = new Byte[] {
85, 84, 70, 56, 32, 69, 110,
99, 111, 100, 105, 110, 103, 32,
69, 120, 97, 109, 112, 108, 101
};
UTF8Encoding utf8 = new UTF8Encoding();
int charCount = utf8.GetCharCount(bytes, 2, 8);
Console.WriteLine(
"{0} characters needed to decode bytes.", charCount
);
}
}
Imports System.Text
Class UTF8EncodingExample
Public Shared Sub Main()
Dim bytes() As Byte = { _
85, 84, 70, 56, 32, 69, 110, _
99, 111, 100, 105, 110, 103, 32, _
69, 120, 97, 109, 112, 108, 101 _
}
Dim utf8 As New UTF8Encoding()
Dim charCount As Integer = utf8.GetCharCount(bytes, 2, 8)
Console.WriteLine("{0} characters needed to decode bytes.", charCount)
End Sub
End Class
Hinweise
Rufen Sie die Methode auf, um die genaue Arraygröße zu berechnen, die zum GetChars Speichern der GetCharCount resultierenden Zeichen erforderlich ist. Rufen Sie die Methode auf, um die GetMaxCharCount maximale Arraygröße zu berechnen. Die GetCharCount Methode weist in der Regel weniger Arbeitsspeicher zu, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.
Bei der Fehlererkennung führt eine ungültige Sequenz dazu, dass diese Methode eine ArgumentException Ausnahme auslöst. Ohne Fehlererkennung werden ungültige Sequenzen ignoriert, und es wird keine Ausnahme ausgelöst.