UTF8Encoding.GetMaxByteCount(Int32) Metodo

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

Parametri

Restituisce

Numero massimo di byte prodotti dalla codifica del numero di caratteri specificato.

Eccezioni

Esempio

Nell'esempio seguente viene utilizzato il GetMaxByteCount metodo per restituire il numero massimo di byte necessari per codificare un numero specificato di caratteri.

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

using System;
using System.Text;

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

Imports System.Text

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

Commenti

Per calcolare la dimensione esatta della matrice richiesta da GetBytes per archiviare i byte risultanti, chiamare il GetByteCount metodo . Per calcolare le dimensioni massime della matrice, chiamare il GetMaxByteCount metodo . Il GetByteCount metodo in genere alloca meno memoria, mentre il GetMaxByteCount metodo viene in genere eseguito più velocemente.

GetMaxByteCount è un numero peggiore, incluso il peggiore dei casi per l'oggetto attualmente selezionato EncoderFallback. Se viene scelto un fallback con una stringa potenzialmente grande, GetMaxByteCount può restituire valori di grandi dimensioni.

Nella maggior parte dei casi, questo metodo restituisce numeri ragionevoli per stringhe di piccole dimensioni. Per stringhe di grandi dimensioni, potrebbe essere necessario scegliere tra l'uso di buffer molto grandi e l'intercettazione di errori nel raro caso in cui venga superato un buffer più ragionevole. È anche possibile prendere in considerazione un approccio diverso usando GetByteCount o Encoder.Convert . Ad esempio, il testo in inglese e molte altre lingue richiede spesso un solo byte UTF-8 per rappresentare un carattere, ma il numero restituito da GetMaxByteCount deve consentire la possibilità che la stringa da convertire sia costituita interamente da caratteri che ognuno richiede quattro byte.

GetMaxByteCountnon ha alcuna relazione con GetChars . Se l'applicazione necessita di una funzione simile da usare con GetChars, deve usare GetMaxCharCount.

Si applica a

Vedi anche

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetByteCount(Char[], Int32, Int32)
• GetEncoder()