ASCIIEncoding.GetMaxCharCount(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 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.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie Sie die GetMaxCharCount Methode verwenden, um die maximale Anzahl von Zeichen zu berechnen, die erforderlich sind, um eine angegebene Anzahl von Bytes zu entschlüsseln.

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

using System;
using System.Text;

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

Imports System.Text

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

Hinweise

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

GetMaxCharCountRuft die Anzahl der schlechtesten Fälle ab, einschließlich des ungünstigsten Falls für den aktuell ausgewählten DecoderFallback . Wenn ein Decoder-Fallback vorhanden ist, der eine maximale Fallbacklänge von n aufweist, gibt die GetMaxCharCount Methode n * byteCount zurück.

GetMaxCharCounthat keine Beziehung zu GetBytes . Wenn Ihre Anwendung eine ähnliche Funktion benötigt, mit GetBytesder sie verwendet werden soll, sollte sie verwendet GetMaxByteCountwerden.

Hinweis

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

Gilt für

Siehe auch