Encoding.GetMaxCharCount(Int32) Metódus

Definíció

Névtér:

System.Text

Szerelvények:

netstandard.dll, System.Runtime.dll

Forrás:

Encoding.cs

Származtatott osztályban felülbírálva kiszámítja a megadott bájtszám dekódolásával előállított karakterek maximális számát.

public:
 abstract int GetMaxCharCount(int byteCount);

public abstract int GetMaxCharCount(int byteCount);

abstract member GetMaxCharCount : int -> int

Public MustOverride Function GetMaxCharCount (byteCount As Integer) As Integer

Paraméterek

byteCount

Int32

A dekódolni kívánt bájtok száma.

Válaszok

Int32

A megadott bájtszám dekódolásával előállított karakterek maximális száma.

Kivételek

ArgumentOutOfRangeException

byteCount kisebb, mint nulla.

DecoderFallbackException

Hiba történt (további információ: Acharacter kódolása a .NET)

-és-

DecoderFallback DecoderExceptionFallbackértékre van állítva.

Példák

Az alábbi példa egy karakterláncot bájtok tömbjeként kódol, majd a bájtokat karaktertömbbe dekódolja.

using System;
using System.Text;

public class SamplesEncoding  {

   public static void Main()  {

      // Create two instances of UTF32Encoding: one with little-endian byte order and one with big-endian byte order.
      Encoding u32LE = Encoding.GetEncoding( "utf-32" );
      Encoding u32BE = Encoding.GetEncoding( "utf-32BE" );

      // Use a string containing the following characters:
      //    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)
      String myStr = "za\u0306\u01FD\u03B2";

      // Encode the string using the big-endian byte order.
      byte[] barrBE = new byte[u32BE.GetByteCount( myStr )];
      u32BE.GetBytes( myStr, 0, myStr.Length, barrBE, 0 );

      // Encode the string using the little-endian byte order.
      byte[] barrLE = new byte[u32LE.GetByteCount( myStr )];
      u32LE.GetBytes( myStr, 0, myStr.Length, barrLE, 0 );

      // Get the char counts, and decode the byte arrays.
      Console.Write( "BE array with BE encoding : " );
      PrintCountsAndChars( barrBE, u32BE );
      Console.Write( "LE array with LE encoding : " );
      PrintCountsAndChars( barrLE, u32LE );
   }

   public static void PrintCountsAndChars( byte[] bytes, Encoding enc )  {

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

      // Display the exact character count.
      int iCC  = enc.GetCharCount( bytes );
      Console.Write( " {0,-3}", iCC );

      // Display the maximum character count.
      int iMCC = enc.GetMaxCharCount( bytes.Length );
      Console.Write( " {0,-3} :", iMCC );

      // Decode the bytes and display the characters.
      char[] chars = enc.GetChars( bytes );
      Console.WriteLine( chars );
   }
}


/* 
This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.

BE array with BE encoding : System.Text.UTF32Encoding : 5   12  :zăǽβ
LE array with LE encoding : System.Text.UTF32Encoding : 5   12  :zăǽβ

*/

Imports System.Text

Public Class SamplesEncoding   

   Public Shared Sub Main()

      ' Create two instances of UTF32Encoding: one with little-endian byte order and one with big-endian byte order.
      Dim u32LE As Encoding = Encoding.GetEncoding("utf-32")
      Dim u32BE As Encoding = Encoding.GetEncoding("utf-32BE")

      ' Use a string containing the following characters:
      '    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)
      Dim myStr As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2) 

      ' Encode the string using the big-endian byte order.
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates the array with the exact number of elements required.
      Dim barrBE(u32BE.GetByteCount(myStr) - 1) As Byte
      u32BE.GetBytes(myStr, 0, myStr.Length, barrBE, 0)

      ' Encode the string using the little-endian byte order.
      ' NOTE: In VB.NET, arrays contain one extra element by default.
      '       The following line creates the array with the exact number of elements required.
      Dim barrLE(u32LE.GetByteCount(myStr) - 1) As Byte
      u32LE.GetBytes(myStr, 0, myStr.Length, barrLE, 0)

      ' Get the char counts, and decode the byte arrays.
      Console.Write("BE array with BE encoding : ")
      PrintCountsAndChars(barrBE, u32BE)
      Console.Write("LE array with LE encoding : ")
      PrintCountsAndChars(barrLE, u32LE)

   End Sub


   Public Shared Sub PrintCountsAndChars(bytes() As Byte, enc As Encoding)

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

      ' Display the exact character count.
      Dim iCC As Integer = enc.GetCharCount(bytes)
      Console.Write(" {0,-3}", iCC)

      ' Display the maximum character count.
      Dim iMCC As Integer = enc.GetMaxCharCount(bytes.Length)
      Console.Write(" {0,-3} :", iMCC)

      ' Decode the bytes and display the characters.
      Dim chars As Char() = enc.GetChars(bytes)
      Console.WriteLine(chars)

   End Sub

End Class


'This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.
'
'BE array with BE encoding : System.Text.UTF32Encoding : 5   12  :zăǽβ
'LE array with LE encoding : System.Text.UTF32Encoding : 5   12  :zăǽβ

Megjegyzések

Az eredményként kapott karakterek tárolásához szükséges GetChars pontos tömbméret kiszámításához használja a metódust GetCharCount . A maximális tömbméret kiszámításához használja a metódust GetMaxCharCount . A GetCharCount metódus általában kevesebb memória lefoglalását teszi lehetővé, míg a GetMaxCharCount metódus általában gyorsabban fut.

GetMaxCharCount A rendszer a legrosszabb esetszámot kéri le, beleértve az aktuálisan kiválasztott DecoderFallbackeset legrosszabb esetét is. Ha egy tartalékot egy potenciálisan nagy sztringgel választ ki, GetMaxCharCount nagy értékeket kér le.

A legtöbb esetben ez a módszer a kis sztringek ésszerű számait kéri le. Nagy sztringek esetén előfordulhat, hogy a nagyon nagy pufferek használata és a hibák észlelése között kell választania abban az esetben, ha egy ésszerűbb puffer túl kicsi. Érdemes lehet megfontolni egy másik megközelítést is a vagy a .GetCharCountDecoder.Convert

GetMaxCharCount nincs kapcsolata a .-hez GetBytes. Ha hasonló függvényre van szüksége, GetByteshasználja a következőt GetMaxByteCount: .

A használat GetMaxCharCountsorán a kimeneti puffert a bemeneti puffer maximális mérete alapján kell lefoglalni. Ha a kimeneti puffer mérete korlátozott, használhatja a metódust Decoder.Convert .

Vegye figyelembe, hogy GetMaxCharCount az előző kódolóműveletből származó hátrahagyott bájtok esetében a legrosszabb esetet veszi figyelembe. A legtöbb kódlap esetében a 0 értéknek a metódusnak való átadása 1-nél nagyobb vagy egyenlő értékeket kér le.

Note

GetMaxCharCount(N) nem feltétlenül ugyanaz az érték, mint N* GetMaxCharCount(1)a .

Megjegyzések az implementálókhoz

Minden Encoding implementációnak biztosítania kell, hogy ne történjen puffertúllépési kivétel, ha a pufferek mérete a módszer számításainak eredményei szerint van méretezve.

Lásd még

• GetChars(Byte[])
• GetString(Byte[])
• GetCharCount(Byte[])
• GetDecoder()