UTF7Encoding.GetMaxCharCount(Int32) Methode

Definition

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

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

Ausnahmen

byteCount ist kleiner als Null.

- oder -

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

Es ist ein Fallback aufgetreten (weitere Informationen finden Sie unter Zeichencodierung in .NET).

- und -

Für DecoderFallback ist DecoderExceptionFallback festgelegt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die GetMaxCharCount -Methode verwendet wird, 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()
{
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   int byteCount = 8;
   int maxCharCount = utf7->GetMaxCharCount( byteCount );
   Console::WriteLine( "Maximum of {0} characters needed to decode {1} bytes.", maxCharCount, byteCount );
}
using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        UTF7Encoding utf7 = new UTF7Encoding();
        int byteCount = 8;
        int maxCharCount = utf7.GetMaxCharCount(byteCount);
        Console.WriteLine(
            "Maximum of {0} characters needed to decode {1} bytes.",
            maxCharCount,
            byteCount
        );
    }
}
Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim utf7 As New UTF7Encoding()
        Dim byteCount As Integer = 8
        Dim maxCharCount As Integer = utf7.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, verwendet GetCharCountdie Anwendung . Um die maximale Arraygröße zu berechnen, sollte die Anwendung verwenden GetMaxCharCount. Die- GetCharCount Methode ermöglicht im Allgemeinen die Zuordnung von weniger Arbeitsspeicher, während die- GetMaxCharCount Methode im Allgemeinen schneller ausgeführt wird.

GetMaxCharCount ist eine Worst-Case-Zahl, einschließlich des schlechtesten Falls für den derzeit ausgewählten 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 sich möglicherweise zwischen der Verwendung sehr großer Puffer und dem Abfangen von Fehlern entscheiden, wenn ein vernünftigerer Puffer überschritten wird. Möglicherweise möchten Sie auch einen anderen Ansatz mithilfe von GetCharCount oder betrachten Decoder.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:

Weitere Informationen