ASCIIEncoding.GetMaxCharCount(Int32) Metodo

  • Riferimento

Definizione

Spazio dei nomi:
System.Text
Assembly:
mscorlib.dll, System.Text.Encoding.Extensions.dll
Assembly:
System.Text.Encoding.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll

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.

Esempio

Nell'esempio seguente viene illustrato come usare il metodo per calcolare il GetMaxCharCount numero massimo di caratteri necessari per decodificare un numero specificato di byte.

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

Commenti

Il GetCharCount metodo calcola le dimensioni esatte della matrice richieste dal GetChars metodo per archiviare i caratteri risultanti, mentre il GetMaxCharCount metodo calcola le dimensioni massime della matrice. Il GetCharCount metodo in genere alloca meno memoria, mentre il GetMaxCharCount metodo esegue in genere più velocemente.

GetMaxCharCountRecupera un numero di caso peggiore, incluso il caso peggiore per l'oggetto attualmente selezionato DecoderFallback . Se è presente un fallback del decodificatore che ha una lunghezza massima di fallback di n, il GetMaxCharCount metodo restituisce n * byteCount.

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) .

Si applica a

Vedi anche