UnicodeEncoding.GetMaxCharCount(Int32) Metodo

Definizione

Spazio dei nomi:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Origine:

UnicodeEncoding.cs

Calcola il numero massimo di caratteri prodotti dalla decodifica del numero di byte specificato.

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

Parametri

byteCount

Int32

Numero di byte da decodificare.

Restituisce

Int32

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

Eccezioni

ArgumentOutOfRangeException

byteCount è minore di zero.

-oppure-

Il numero di byte ottenuto è maggiore del numero massimo che può essere restituito come valore integer.

DecoderFallbackException

Si è verificato un fallback (per altre informazioni, vedere Codifica dei caratteri in .NET)

-e-

DecoderFallback è impostato su DecoderExceptionFallback.

Esempio

Nell'esempio seguente viene illustrato come utilizzare il GetMaxCharCount metodo per restituire il numero massimo di caratteri prodotti decodificando un numero specificato di byte.

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

using System;
using System.Text;

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

Imports System.Text

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

Commenti

Per calcolare la dimensione esatta della matrice richiesta da GetChars per archiviare i caratteri risultanti, l'applicazione usa GetCharCount. Per calcolare le dimensioni massime della matrice, l'applicazione deve usare GetMaxCharCount. Il GetCharCount metodo in genere alloca meno memoria, mentre il GetMaxCharCount metodo viene in genere eseguito più velocemente.

GetMaxCharCountRecupera un numero di caso peggiore, incluso il caso peggiore per l'oggetto attualmente selezionato DecoderFallback . Se un fallback viene scelto con una stringa potenzialmente grande, GetMaxCharCount Recupera i valori di grandi dimensioni.

Nella maggior parte dei casi, questo metodo recupera numeri ragionevoli per le 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 GetCharCount o Convert .

GetMaxCharCountnon ha alcuna relazione con GetBytes . Se l'applicazione necessita di una funzione simile da usare con GetBytes, deve usare GetMaxByteCount.

Nota

GetMaxCharCount(N)non è necessariamente lo stesso valore di N* GetMaxCharCount(1) .

Vedi anche

• GetChars(Byte[], Int32, Int32, Char[], Int32)
• GetString(Byte[], Int32, Int32)
• GetCharCount(Byte[], Int32, Int32)
• GetDecoder()