UTF8Encoding.GetMaxCharCount(Int32) Methode

  • Referenz

Definition

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

Berechnet die maximale Anzahl der Zeichen, die beim Decodieren der angegebenen Anzahl von Bytes erzeugt werden.

public:
 override int GetMaxCharCount(int byteCount);
public override int GetMaxCharCount (int byteCount);
override this.GetMaxCharCount : int -> int
Public Overrides Function GetMaxCharCount (byteCount As Integer) As Integer

Parameter

byteCount
Int32

Die Anzahl der zu decodierenden Bytes.

Gibt zurück

Int32

Die maximale Anzahl von Zeichen, die beim Decodieren der angegebenen Anzahl von Bytes erzeugt werden.

Ausnahmen

ArgumentOutOfRangeException

byteCount ist kleiner als Null.

- oder - Die sich ergebende Anzahl von Bytes ist höher als die maximale Anzahl, die als ganze Zahl zurückgegeben werden kann.

DecoderFallbackException

Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET). - und - Für DecoderFallback ist DecoderExceptionFallback festgelegt.

Beispiele

Im folgenden Beispiel wird die GetMaxCharCount Methode verwendet, um die maximale Anzahl von Zeichen zurückzugeben, die durch Decodierung einer angegebenen Anzahl von Bytes erzeugt werden.

using namespace System;
using namespace System::Text;
int main()
{
   UTF8Encoding^ utf8 = gcnew UTF8Encoding;
   int byteCount = 8;
   int maxCharCount = utf8->GetMaxCharCount( byteCount );
   Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        UTF8Encoding utf8 = new UTF8Encoding();
        int byteCount = 8;
        int maxCharCount = utf8.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.",
            maxCharCount,
            byteCount
        );
    }
}

Imports System.Text

Class UTF8EncodingExample
    
    Public Shared Sub Main()
        Dim utf8 As New UTF8Encoding()
        Dim byteCount As Integer = 8
        Dim maxCharCount As Integer = utf8.GetMaxCharCount(byteCount)
        Console.WriteLine( _
            "Maximum of {0} characters needed to decode {1} bytes.", _
            maxCharCount, _
            byteCount _
        )
    End Sub
End Class

Hinweise

Um die genaue Arraygröße zu berechnen, die zum GetChars Speichern der resultierenden Zeichen erforderlich ist, rufen Sie die GetCharCount Methode auf. Um die maximale Arraygröße zu berechnen, rufen Sie die GetMaxCharCount Methode auf. Die GetCharCount Methode weist im Allgemeinen weniger Arbeitsspeicher zu, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.

GetMaxCharCount ist eine schlechteste Fallnummer, einschließlich des schlimmsten Falls für die aktuell ausgewählte DecoderFallback. Wenn ein Fallback mit einer potenziell großen Zeichenfolge ausgewählt wird, GetMaxCharCount können große Werte zurückgegeben werden.

In den meisten Fällen gibt diese Methode angemessene Zahlen für kleine Zeichenfolgen zurück. Bei großen Zeichenfolgen müssen Sie möglicherweise zwischen der Verwendung sehr großer Puffer und dem Abfangen von Fehlern im seltenen Fall wählen, dass ein vernünftigerer Puffer überschritten wird. Möglicherweise möchten Sie auch einen anderen Ansatz mithilfe von GetCharCount oder betrachten Encoder.Convert .

GetMaxCharCounthat keine Beziehung zu GetBytes . Wenn Ihre Anwendung eine ähnliche Funktion benötigt, mit der sie verwendet werden GetBytessoll, sollte sie verwendet werden GetMaxByteCount.

Hinweis

GetMaxCharCount(N)ist nicht notwendigerweise derselbe Wert wie N* GetMaxCharCount(1) .

Gilt für

Siehe auch