UTF8Encoding.GetMaxCharCount(Int32) Methode

Referenz

Definition

Namespace:: System.Text

Assembly:: System.Text.Encoding.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: UTF8Encoding.cs

Quelle:: UTF8Encoding.cs

Quelle:: UTF8Encoding.cs

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 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 beim Decodieren 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 von GetChars zum Speichern der resultierenden Zeichen erforderlich ist, rufen Sie die GetCharCount -Methode auf. Um die maximale Arraygröße zu berechnen, rufen Sie die -Methode auf GetMaxCharCount . Die GetCharCount -Methode weist im Allgemeinen weniger Arbeitsspeicher zu, während die GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.

GetMaxCharCount ist eine Worst-Case-Zahl, einschließlich des worst case für die derzeit 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 sehr großen Puffern und dem Abfangen von Fehlern wählen, wenn ein sinnvollerer 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 für die Verwendung mit GetBytesbenötigt, sollte sie verwenden GetMaxByteCount.

Hinweis

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

Gilt für:

Freigeben über