UTF32Encoding.GetByteCount Método

public:
 override int GetByteCount(System::String ^ s);

public override int GetByteCount(string s);

override this.GetByteCount : string -> int

Public Overrides Function GetByteCount (s As String) As Integer

Parâmetros

Devoluções

O número de bytes produzidos pela codificação dos caracteres especificados.

Exceções

Exemplos

O exemplo seguinte chama os GetMaxByteCount métodos e GetByteCount(String) para calcular o número máximo e real de bytes necessários para codificar uma string. Também mostra o número real de bytes necessários para armazenar um fluxo de bytes com uma marca de ordem de bytes.

using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        String chars = "UTF-32 Encoding Example";
        Encoding enc = Encoding.UTF32;

        Console.WriteLine("Bytes needed to encode '{0}':", chars);
        Console.WriteLine("   Maximum:         {0}",
                          enc.GetMaxByteCount(chars.Length));
        Console.WriteLine("   Actual:          {0}",
                          enc.GetByteCount(chars));
        Console.WriteLine("   Actual with BOM: {0}",
                          enc.GetByteCount(chars) + enc.GetPreamble().Length);
    }
}
// The example displays the following output:
//       Bytes needed to encode 'UTF-32 Encoding Example':
//          Maximum:         96
//          Actual:          92
//          Actual with BOM: 96

Imports System.Text

Module Example
    Public Sub Main()
        Dim chars As String = "UTF-32 Encoding Example"
        Dim enc As Encoding = Encoding.UTF32

        Console.WriteLine("Bytes needed to encode '{0}':", chars)
        Console.WriteLine("   Maximum:         {0}",
                          enc.GetMaxByteCount(chars.Length))
        Console.WriteLine("   Actual:          {0}",
                          enc.GetByteCount(chars))
        Console.WriteLine("   Actual with BOM: {0}",
                          enc.GetByteCount(chars) + enc.GetPreamble().Length)
    End Sub
End Module
' The example displays the following output:
'       Bytes needed to encode 'UTF-32 Encoding Example':
'          Maximum:         96
'          Actual:          92
'          Actual with BOM: 96

Observações

Para calcular o tamanho exato do array necessário GetBytes para armazenar os bytes resultantes, chama-se o GetByteCount método. Para calcular o tamanho máximo do array, chama-se o GetMaxByteCount método. O GetByteCount método geralmente aloca menos memória, enquanto o GetMaxByteCount método geralmente executa mais rapidamente.

Com a deteção de erros, uma sequência inválida faz com que este método execute um ArgumentException. Sem deteção de erros, as sequências inválidas são ignoradas e nenhuma exceção é lançada.

Para garantir que os bytes codificados são devidamente descodificados quando são guardados como ficheiro ou fluxo, pode prefixar um fluxo de bytes codificados com um preâmbulo. Inserir o preâmbulo no início de um fluxo de bytes (como no início de uma série de bytes a ser escrito num ficheiro) é responsabilidade do programador, e o número de bytes no preâmbulo não é refletido no valor devolvido pelo GetByteCount método.

Ver também

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()

public:
 override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
[System.Security.SecurityCritical]
public override int GetByteCount(char* chars, int count);

[System.CLSCompliant(false)]
public override int GetByteCount(char* chars, int count);

[<System.CLSCompliant(false)>]
[<System.Security.SecurityCritical>]
override this.GetByteCount : nativeptr<char> * int -> int

[<System.CLSCompliant(false)>]
override this.GetByteCount : nativeptr<char> * int -> int

Parâmetros

Devoluções

O número de bytes produzidos pela codificação dos caracteres especificados.

Atributos

CLSCompliantAttribute SecurityCriticalAttribute

Exceções

Observações

Para calcular o tamanho exato do array necessário GetBytes para armazenar os bytes resultantes, chama-se o GetByteCount método. Para calcular o tamanho máximo do array, chama-se o GetMaxByteCount. O GetByteCount método geralmente aloca menos memória, enquanto o GetMaxByteCount método geralmente executa mais rapidamente.

Com a deteção de erros, uma sequência inválida faz com que este método lance um ArgumentException. Sem deteção de erros, as sequências inválidas são ignoradas e nenhuma exceção é lançada.

Para garantir que os bytes codificados são decodificados corretamente quando são guardados como ficheiro ou fluxo, pode prefixar um fluxo de bytes codificados com um preâmbulo. Inserir um preâmbulo no início de um fluxo de bytes (como no início de uma série de bytes a ser escrito num ficheiro) é responsabilidade do programador, e o número de bytes no preâmbulo não se reflete no valor devolvido pelo GetByteCount método.

Ver também

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()

public:
 override int GetByteCount(cli::array <char> ^ chars, int index, int count);

public override int GetByteCount(char[] chars, int index, int count);

override this.GetByteCount : char[] * int * int -> int

Public Overrides Function GetByteCount (chars As Char(), index As Integer, count As Integer) As Integer

Parâmetros

Devoluções

O número de bytes produzidos pela codificação dos caracteres especificados.

Exceções

Exemplos

O exemplo seguinte preenche um array com caracteres latinos maiúsculos e minúsculos e chama o GetByteCount(Char[], Int32, Int32) método para determinar o número de bytes necessários para codificar os caracteres latinos minúsculos. Depois, apresenta esta informação juntamente com o número total de bytes necessários caso seja adicionada uma marca de ordem de bytes. Compara este número com o valor devolvido pelo GetMaxByteCount método, que indica o número máximo de bytes necessários para codificar os caracteres latinos minúsculos. O exemplo seguinte preenche um array com uma combinação de caracteres gregos e cirílicos e chama o GetByteCount(Char[], Int32, Int32) método para determinar o número de bytes necessários para codificar os caracteres cirílicos. Depois, apresenta esta informação juntamente com o número total de bytes necessários caso seja adicionada uma marca de ordem de bytes. Compara este número com o valor devolvido pelo GetMaxByteCount método, que indica o número máximo de bytes necessários para codificar os caracteres cirílicos.

using System;
using System.Text;

public class Example
{
   public static void Main()
   {
      int uppercaseStart = 0x0041;
      int uppercaseEnd = 0x005a;
      int lowercaseStart = 0x0061;
      int lowercaseEnd = 0x007a;
      // Instantiate a UTF8 encoding object with BOM support.
      Encoding enc = Encoding.UTF32;

      // Populate array with characters.
      char[] chars = new char[lowercaseEnd - lowercaseStart + uppercaseEnd - uppercaseStart + 2];
      int index = 0;
      for (int ctr = uppercaseStart; ctr <= uppercaseEnd; ctr++) {
         chars[index] = (char)ctr;
         index++;
      }
      for (int ctr = lowercaseStart; ctr <= lowercaseEnd; ctr++) {
         chars[index] = (char)ctr;
         index++;
      }

      // Display the bytes needed for the lowercase characters.
      Console.WriteLine("Bytes needed for lowercase Latin characters:");
      Console.WriteLine("   Maximum:         {0,5:N0}",
                        enc.GetMaxByteCount(lowercaseEnd - lowercaseStart + 1));
      Console.WriteLine("   Actual:          {0,5:N0}",
                        enc.GetByteCount(chars, uppercaseEnd - uppercaseStart + 1,
                                          lowercaseEnd - lowercaseStart + 1));
      Console.WriteLine("   Actual with BOM: {0,5:N0}",
                        enc.GetByteCount(chars, uppercaseEnd - uppercaseStart + 1,
                                          lowercaseEnd - lowercaseStart + 1) +
                                          enc.GetPreamble().Length);
   }
}
// The example displays the following output:
//       Bytes needed for lowercase Latin characters:
//          Maximum:           108
//          Actual:            104
//          Actual with BOM:   108

Imports System.Text

Module Example
   Public Sub Main()
      Dim uppercaseStart As Integer = &h0041
      Dim uppercaseEnd As Integer = &h005a
      Dim lowercaseStart As Integer = &h0061
      Dim lowercaseEnd As Integer = &h007a
      ' Instantiate a UTF8 encoding object with BOM support.
      Dim enc As Encoding = Encoding.UTF32
      
      ' Populate array with characters.
      Dim chars(lowercaseEnd - lowercaseStart + uppercaseEnd - uppercaseStart + 1) As Char
      Dim index As Integer = 0
      For ctr As Integer = uppercaseStart To uppercaseEnd
         chars(index) = ChrW(ctr)
         index += 1
      Next
      For ctr As Integer = lowercaseStart To lowercaseEnd
         chars(index) = ChrW(ctr)
         index += 1
      Next

      ' Display the bytes needed for the lowercase characters.
        Console.WriteLine("Bytes needed for lowercase Latin characters:")
        Console.WriteLine("   Maximum:         {0,5:N0}",
                          enc.GetMaxByteCount(lowercaseEnd - lowercaseStart + 1))
        Console.WriteLine("   Actual:          {0,5:N0}",
                          enc.GetByteCount(chars, uppercaseEnd - uppercaseStart + 1,
                                            lowercaseEnd - lowercaseStart + 1))
        Console.WriteLine("   Actual with BOM: {0,5:N0}",
                          enc.GetByteCount(chars, uppercaseEnd - uppercaseStart + 1,
                                            lowercaseEnd - lowercaseStart + 1) +
                                            enc.GetPreamble().Length)
   End Sub
End Module
' The example displays the following output:
'       Bytes needed for lowercase Latin characters:
'          Maximum:           108
'          Actual:            104
'          Actual with BOM:   108

Observações

Para calcular o tamanho exato do array necessário GetBytes para armazenar os bytes resultantes, chama-se o GetByteCount método. Para calcular o tamanho máximo do array, chama-se o GetMaxByteCount método. O GetByteCount método geralmente aloca menos memória, enquanto o GetMaxByteCount método geralmente executa mais rapidamente.

Com a deteção de erros, uma sequência inválida faz com que este método execute um ArgumentException. Sem deteção de erros, as sequências inválidas são ignoradas e nenhuma exceção é lançada.

Para garantir que os bytes codificados são decodificados corretamente quando são guardados como ficheiro ou fluxo, pode prefixar um fluxo de bytes codificados com um preâmbulo. Inserir um preâmbulo no início de um fluxo de bytes (como no início de uma série de bytes a ser escrito num ficheiro) é responsabilidade do programador, e o número de bytes no preâmbulo não se reflete no valor devolvido pelo GetByteCount método.

Ver também

• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetMaxByteCount(Int32)
• GetEncoder()