UTF7Encoding.GetMaxByteCount(Int32) Methode

  • Referenz

Definition

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

Berechnet die maximale Anzahl der Bytes, die beim Codieren der angegebenen Anzahl von Zeichen erzeugt wird.

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

Parameter

charCount
Int32

Die Anzahl der zu codierenden Zeichen.

Gibt zurück

Int32

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

Ausnahmen

ArgumentOutOfRangeException

charCount ist kleiner als Null.

- oder - Die daraus resultierende Byteanzahl ist größer als die maximale Anzahl, die als ganze Zahl zurückgegeben werden kann.

EncoderFallbackException

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

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die GetMaxByteCount Methode verwenden, um die maximale Anzahl von Bytes zurückzugeben, die zum Codieren einer angegebenen Anzahl von Zeichen erforderlich sind.

using namespace System;
using namespace System::Text;
int main()
{
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int charCount = 2;
   int maxByteCount = utf7->GetMaxByteCount( charCount );
   Console::WriteLine( "Maximum of {0} bytes needed to encode {1} characters.", maxByteCount, charCount );
}

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        UTF7Encoding utf7 = new UTF7Encoding();
        int charCount = 2;
        int maxByteCount = utf7.GetMaxByteCount(charCount);
        Console.WriteLine(
            "Maximum of {0} bytes needed to encode {1} characters.",
            maxByteCount,
            charCount
        );
    }
}

Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim utf7 As New UTF7Encoding()
        Dim charCount As Integer = 2
        Dim maxByteCount As Integer = utf7.GetMaxByteCount(charCount)
        Console.WriteLine( _
            "Maximum of {0} bytes needed to encode {1} characters.", _
            maxByteCount, _
            charCount _
        )
    End Sub
End Class

Hinweise

Um die genaue Arraygröße zu berechnen, die erforderlich ist, um GetBytes die resultierende Bytes zu speichern, wird die Anwendung verwendet GetByteCount. Um die maximale Arraygröße zu berechnen, sollte die Anwendung verwenden GetMaxByteCount. Die- GetByteCount Methode ermöglicht im Allgemeinen die Zuordnung von weniger Arbeitsspeicher, während die- GetMaxByteCount Methode im Allgemeinen schneller ausgeführt wird.

GetMaxByteCountist eine Worst-Case-Zahl, einschließlich des schlechtesten Falles für die derzeit ausgewählte .EncoderFallback Wenn ein Fallback mit einer potenziell großen Zeichenfolge ausgewählt wird, GetMaxByteCount 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 der Fangen von Fehlern im seltenen Fall entscheiden, dass ein sinnvollerer Puffer überschritten wird. Möglicherweise möchten Sie auch einen anderen Ansatz mithilfe von GetByteCount oder betrachten Encoder.Convert . Während UTF-7 bei der Codierung von ASCII-Daten sehr effizient ist, ist ein Byte pro Zeichen äußerst ineffizient für andere Daten. Wie oben erwähnt, GetMaxByteCount handelt es sich um einen schlechtesten Fall. Wenn die zu codierenden Daten weitgehend ASCII sind und insbesondere wenn die ASCII-Zeichen zusammen clustern, ist UTF-7 wesentlich effizienter als die zahl, die von dieser Methode zurückgegeben wird.

GetMaxByteCounthat keine Beziehung zu GetChars . Wenn Ihre Anwendung eine ähnliche Funktion benötigt, mit GetCharsder sie verwendet werden soll, sollte sie verwendet GetMaxCharCountwerden.

Hinweis

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

Gilt für

Siehe auch