Encoding.GetMaxByteCount(Int32) Metodo

public:
 abstract int GetMaxByteCount(int charCount);

public abstract int GetMaxByteCount(int charCount);

abstract member GetMaxByteCount : int -> int

Public MustOverride Function GetMaxByteCount (charCount As Integer) As Integer

Parametri

Restituisce

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

Eccezioni

Esempio

Nell'esempio seguente viene determinato il numero di byte necessari per codificare una matrice di caratteri, codificare i caratteri e visualizzare i byte risultanti.

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // The characters to encode:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    a high-surrogate value (U+D8FF)
      //    a low-surrogate value (U+DCFF)
      char[] myChars = new char[] { 'z', 'a', '\u0306', '\u01FD', '\u03B2', '\uD8FF', '\uDCFF' };

      // Get different encodings.
      Encoding  u7    = Encoding.UTF7;
      Encoding  u8    = Encoding.UTF8;
      Encoding  u16LE = Encoding.Unicode;
      Encoding  u16BE = Encoding.BigEndianUnicode;
      Encoding  u32   = Encoding.UTF32;

      // Encode the entire array, and print out the counts and the resulting bytes.
      PrintCountsAndBytes( myChars, u7 );
      PrintCountsAndBytes( myChars, u8 );
      PrintCountsAndBytes( myChars, u16LE );
      PrintCountsAndBytes( myChars, u16BE );
      PrintCountsAndBytes( myChars, u32 );
   }

   public static void PrintCountsAndBytes( char[] chars, Encoding enc )  {

      // Display the name of the encoding used.
      Console.Write( "{0,-30} :", enc.ToString() );

      // Display the exact byte count.
      int iBC  = enc.GetByteCount( chars );
      Console.Write( " {0,-3}", iBC );

      // Display the maximum byte count.
      int iMBC = enc.GetMaxByteCount( chars.Length );
      Console.Write( " {0,-3} :", iMBC );

      // Encode the array of chars.
      byte[] bytes = enc.GetBytes( chars );

      // Display all the encoded bytes.
      PrintHexBytes( bytes );
   }

   public static void PrintHexBytes( byte[] bytes )  {

      if (( bytes == null ) || ( bytes.Length == 0 ))
        {
            Console.WriteLine( "<none>" );
        }
        else  {
         for ( int i = 0; i < bytes.Length; i++ )
            Console.Write( "{0:X2} ", bytes[i] );
         Console.WriteLine();
      }
   }
}


/* 
This code produces the following output.

System.Text.UTF7Encoding       : 18  23  :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
System.Text.UTF8Encoding       : 12  24  :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
System.Text.UnicodeEncoding    : 14  16  :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
System.Text.UnicodeEncoding    : 14  16  :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
System.Text.UTF32Encoding      : 24  32  :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00

*/

Imports System.Text

Public Class SamplesEncoding   

   Public Shared Sub Main()

      ' The characters to encode:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    a high-surrogate value (U+D8FF)
      '    a low-surrogate value (U+DCFF)
      Dim myChars() As Char = {"z"c, "a"c, ChrW(&H0306), ChrW(&H01FD), ChrW(&H03B2), ChrW(&HD8FF), ChrW(&HDCFF)}
 

      ' Get different encodings.
      Dim u7 As Encoding = Encoding.UTF7
      Dim u8 As Encoding = Encoding.UTF8
      Dim u16LE As Encoding = Encoding.Unicode
      Dim u16BE As Encoding = Encoding.BigEndianUnicode
      Dim u32 As Encoding = Encoding.UTF32

      ' Encode the entire array, and print out the counts and the resulting bytes.
      PrintCountsAndBytes(myChars, u7)
      PrintCountsAndBytes(myChars, u8)
      PrintCountsAndBytes(myChars, u16LE)
      PrintCountsAndBytes(myChars, u16BE)
      PrintCountsAndBytes(myChars, u32)

   End Sub


   Public Shared Sub PrintCountsAndBytes(chars() As Char, enc As Encoding)

      ' Display the name of the encoding used.
      Console.Write("{0,-30} :", enc.ToString())

      ' Display the exact byte count.
      Dim iBC As Integer = enc.GetByteCount(chars)
      Console.Write(" {0,-3}", iBC)

      ' Display the maximum byte count.
      Dim iMBC As Integer = enc.GetMaxByteCount(chars.Length)
      Console.Write(" {0,-3} :", iMBC)

      ' Encode the array of chars.
      Dim bytes As Byte() = enc.GetBytes(chars)

      ' Display all the encoded bytes.
      PrintHexBytes(bytes)

   End Sub


   Public Shared Sub PrintHexBytes(bytes() As Byte)

      If bytes Is Nothing OrElse bytes.Length = 0 Then
         Console.WriteLine("<none>")
      Else
         Dim i As Integer
         For i = 0 To bytes.Length - 1
            Console.Write("{0:X2} ", bytes(i))
         Next i
         Console.WriteLine()
      End If

   End Sub

End Class


'This code produces the following output.
'
'System.Text.UTF7Encoding       : 18  23  :7A 61 2B 41 77 59 42 2F 51 4F 79 32 50 2F 63 2F 77 2D
'System.Text.UTF8Encoding       : 12  24  :7A 61 CC 86 C7 BD CE B2 F1 8F B3 BF
'System.Text.UnicodeEncoding    : 14  16  :7A 00 61 00 06 03 FD 01 B2 03 FF D8 FF DC
'System.Text.UnicodeEncoding    : 14  16  :00 7A 00 61 03 06 01 FD 03 B2 D8 FF DC FF
'System.Text.UTF32Encoding      : 24  32  :7A 00 00 00 61 00 00 00 06 03 00 00 FD 01 00 00 B2 03 00 00 FF FC 04 00

Commenti

Il charCount parametro specifica effettivamente il numero di Char oggetti che rappresentano i caratteri Unicode da codificare, perché .NET usa internamente UTF-16 per rappresentare i caratteri Unicode. Di conseguenza, la maggior parte dei caratteri Unicode può essere rappresentata da un Char oggetto, ma un carattere Unicode rappresentato da una coppia di surrogati, ad esempio, richiede due Char oggetti.

Per calcolare la dimensione esatta della matrice richiesta da GetBytes per archiviare i byte risultanti, è necessario usare il GetByteCount metodo . Per calcolare le dimensioni massime della matrice, usare il GetMaxByteCount metodo . Il GetByteCount metodo in genere consente l'allocazione di meno memoria, mentre il GetMaxByteCount metodo viene generalmente eseguito più velocemente.

GetMaxByteCount recupera un numero peggiore, incluso il caso peggiore per l'oggetto attualmente selezionato EncoderFallback. Se viene scelto un fallback con una stringa potenzialmente grande, recupera valori di grandi dimensioni, GetMaxByteCount in particolare nei casi in cui il caso peggiore per la codifica comporta il cambio di modalità per ogni carattere. Ad esempio, questo può verificarsi per ISO-2022-JP. Per altre informazioni, vedere il post di blog "What's with Encoding.GetMaxByteCount() and Encoding.GetMaxCharCount()?.

Nella maggior parte dei casi, questo metodo recupera valori ragionevoli per stringhe di piccole dimensioni. Per le 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 un buffer più ragionevole sia troppo piccolo. È anche possibile prendere in considerazione un approccio diverso usando GetByteCount o Encoder.Convert.

Quando si usa GetMaxByteCount, è necessario allocare il buffer di output in base alle dimensioni massime del buffer di input. Se le dimensioni del buffer di output sono limitate, è possibile usare il Convert metodo .

Si noti che GetMaxByteCount considera i potenziali surrogati rimasti da un'operazione precedente del decodificatore. A causa del decodificatore, passando un valore pari a 1 al metodo recupera 2 per una codifica a byte singolo, ad esempio ASCII. È consigliabile utilizzare la IsSingleByte proprietà se queste informazioni sono necessarie.

Note per gli implementatori

Tutte le Encoding implementazioni devono garantire che non si verifichino eccezioni di overflow del buffer se i buffer vengono ridimensionati in base ai risultati dei calcoli di questo metodo.

Vedi anche

• GetBytes(Char[])
• GetByteCount(Char[])
• GetEncoder()