Encoding Classe

Definição

Espaço de Nomes:
System.Text
Assemblagens:
mscorlib.dll, System.Text.Encoding.dll
Assemblagem:
mscorlib.dll
Assemblagem:
System.Text.Encoding.dll
Assemblagem:
netstandard.dll

Representa uma codificação de caracteres.

public ref class Encoding abstract
public ref class Encoding abstract : ICloneable
public abstract class Encoding
[System.Serializable]
public abstract class Encoding
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Encoding : ICloneable
public abstract class Encoding : ICloneable
type Encoding = class
[<System.Serializable>]
type Encoding = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Encoding = class
    interface ICloneable
type Encoding = class
    interface ICloneable
Public MustInherit Class Encoding
Public MustInherit Class Encoding
Implements ICloneable
Herança
Object
Encoding
Derivado
Atributos
SerializableAttribute ComVisibleAttribute
Implementações
ICloneable

Exemplos

O exemplo seguinte converte uma cadeia de uma codificação para outra.

Note

O byte[] array é o único tipo neste exemplo que contém os dados codificados. Os tipos .NET Char e String são eles próprios Unicode, pelo que a chamada GetChars decodifica os dados de volta para Unicode.

using System;
using System.Text;

class Example
{
   static void Main()
   {
      string unicodeString = "This string contains the unicode character Pi (\u03a0)";

      // Create two different encodings.
      Encoding ascii = Encoding.ASCII;
      Encoding unicode = Encoding.Unicode;

      // Convert the string into a byte array.
      byte[] unicodeBytes = unicode.GetBytes(unicodeString);

      // Perform the conversion from one encoding to the other.
      byte[] asciiBytes = Encoding.Convert(unicode, ascii, unicodeBytes);
         
      // Convert the new byte[] into a char[] and then into a string.
      char[] asciiChars = new char[ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)];
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0);
      string asciiString = new string(asciiChars);

      // Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString);
      Console.WriteLine("Ascii converted string: {0}", asciiString);
   }
}
// The example displays the following output:
//    Original string: This string contains the unicode character Pi (Π)
//    Ascii converted string: This string contains the unicode character Pi (?)

Imports System.Text

Class Example
   Shared Sub Main()
      Dim unicodeString As String = "This string contains the unicode character Pi (" & ChrW(&H03A0) & ")"

      ' Create two different encodings.
      Dim ascii As Encoding = Encoding.ASCII
      Dim unicode As Encoding = Encoding.Unicode

      ' Convert the string into a byte array.
      Dim unicodeBytes As Byte() = unicode.GetBytes(unicodeString)

      ' Perform the conversion from one encoding to the other.
      Dim asciiBytes As Byte() = Encoding.Convert(unicode, ascii, unicodeBytes)

      ' Convert the new byte array into a char array and then into a string.
      Dim asciiChars(ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)-1) As Char
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0)
      Dim asciiString As New String(asciiChars)

      ' Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString)
      Console.WriteLine("Ascii converted string: {0}", asciiString)
   End Sub
End Class
' The example displays the following output:
'    Original string: This string contains the unicode character Pi (Π)
'    Ascii converted string: This string contains the unicode character Pi (?)

Observações

Para mais informações sobre esta API, consulte Observações Suplementares da API para Codificação.

Construtores

Name Description
Encoding()

Inicializa uma nova instância da Encoding classe.
Encoding(Int32, EncoderFallback, DecoderFallback)

Inicializa uma nova instância da Encoding classe que corresponde à página de código especificada com as estratégias de fallback do codificador e descodificador especificadas.
Encoding(Int32)

Inicializa uma nova instância da Encoding classe que corresponde à página de código especificada.

Propriedades

Name Description
ASCII

Recebe uma codificação para o conjunto de caracteres ASCII (7 bits).
BigEndianUnicode

Recebe uma codificação para o formato UTF-16 que usa a ordem dos bytes big endian.
BodyName

Quando sobrescrito numa classe derivada, obtém um nome para a codificação atual que pode ser usada com as tags do corpo do agente de correio.
CodePage

Quando sobrescrito numa classe derivada, obtém o identificador da página de código do atual Encoding.
DecoderFallback

Obtém ou define o DecoderFallback objeto para o objeto atual Encoding .
Default

Obtém a codificação padrão para esta implementação .NET.
EncoderFallback

Obtém ou define o EncoderFallback objeto para o objeto atual Encoding .
EncodingName

Quando sobrescrito numa classe derivada, obtém a descrição legível por humanos da codificação atual.
HeaderName

Quando sobrescrito numa classe derivada, obtém um nome para a codificação atual que pode ser usado com etiquetas de cabeçalho de agente de correio.
IsBrowserDisplay

Quando sobrescrito numa classe derivada, obtém um valor que indica se a codificação atual pode ser usada pelos clientes do navegador para exibir conteúdo.
IsBrowserSave

Quando é sobreposto numa classe derivada, obtém um valor que indica se a codificação atual pode ser usada pelos clientes de navegador para guardar conteúdo.
IsMailNewsDisplay

Quando é sobreposto numa classe derivada, obtém um valor que indica se a codificação atual pode ser usada por clientes de email e notícias para exibir conteúdo.
IsMailNewsSave

Quando é sobreposto numa classe derivada, obtém um valor que indica se a codificação atual pode ser usada por clientes de email e notícias para guardar conteúdo.
IsReadOnly

Quando é sobreposto numa classe derivada, obtém um valor que indica se a codificação atual é apenas de leitura.
IsSingleByte

Quando sobrescrito numa classe derivada, obtém um valor que indica se a codificação atual utiliza pontos de código de um byte.
Preamble

Quando sobrescrito numa classe derivada, devolve um span contendo a sequência de bytes que especifica a codificação utilizada.
Unicode

Obtém uma codificação para o formato UTF-16 usando a ordem dos bytes little endian.
UTF32

Obtém uma codificação para o formato UTF-32 usando a ordem dos bytes little endian.
UTF7

Recebe uma codificação para o formato UTF-7.
UTF8

Recebe uma codificação para o formato UTF-8.
WebName

Quando é sobreposto numa classe derivada, o nome é registado junto da Internet Assigned Numbers Authority (IANA) para a codificação atual.
WindowsCodePage

Quando sobrescrito numa classe derivada, obtém a página de código do sistema operativo Windows que mais corresponde à codificação atual.

Métodos

Name Description
Clone()

Quando sobreposta numa classe derivada, cria-se uma cópia superficial do objeto atual Encoding .
Convert(Encoding, Encoding, Byte[], Int32, Int32)

Converte um intervalo de bytes num array de bytes de uma codificação para outra.
Convert(Encoding, Encoding, Byte[])

Converte um array inteiro de bytes de uma codificação para outra.
Equals(Object)

Determina se o especificado Object é igual à instância atual.
GetByteCount(Char[], Int32, Int32)

Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir do array de caracteres especificado.
GetByteCount(Char[])

Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos ao codificar todos os caracteres do array de caracteres especificado.
GetByteCount(Char*, Int32)

Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir do ponteiro especificado.
GetByteCount(ReadOnlySpan<Char>)

Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos pela codificação dos caracteres no intervalo de caracteres especificado.
GetByteCount(String, Int32, Int32)

Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir da cadeia especificada.
GetByteCount(String)

Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos pela codificação dos caracteres na cadeia especificada.
GetBytes(Char[], Int32, Int32, Byte[], Int32)

Quando sobrescrito numa classe derivada, codifica um conjunto de caracteres do array de caracteres especificado para o array de bytes especificado.
GetBytes(Char[], Int32, Int32)

Quando sobrescrito numa classe derivada, codifica um conjunto de caracteres do array de caracteres especificado numa sequência de bytes.
GetBytes(Char[])

Quando sobrescrito numa classe derivada, codifica todos os caracteres do array de caracteres especificado numa sequência de bytes.
GetBytes(Char*, Int32, Byte*, Int32)

Quando sobrescrito numa classe derivada, codifica um conjunto de caracteres a partir do ponteiro especificado numa sequência de bytes que são armazenados a partir do ponteiro de byte especificado.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)

Quando sobrescrito numa classe derivada, codifica num espaço de bytes um conjunto de caracteres do intervalo de apenas leitura especificado.
GetBytes(String, Int32, Int32, Byte[], Int32)

Quando sobrescrito numa classe derivada, codifica um conjunto de caracteres da cadeia especificada para o array de bytes especificado.
GetBytes(String, Int32, Int32)

Quando sobrescrito numa classe derivada, codifica num array de bytes o número de caracteres especificados por count na cadeia especificada, começando a partir do especificado index.
GetBytes(String)

Quando sobrescrito numa classe derivada, codifica todos os caracteres da cadeia especificada numa sequência de bytes.
GetCharCount(Byte[], Int32, Int32)

Quando sobrescrito numa classe derivada, calcula o número de caracteres produzidos pela decodificação de uma sequência de bytes a partir do array de bytes especificado.
GetCharCount(Byte[])

Quando sobrescrito numa classe derivada, calcula o número de caracteres produzidos pela decodificação de todos os bytes no array de bytes especificado.
GetCharCount(Byte*, Int32)

Quando sobrescrito numa classe derivada, calcula o número de caracteres produzidos ao decodificar uma sequência de bytes começando no ponteiro de byte especificado.
GetCharCount(ReadOnlySpan<Byte>)

Quando sobrescrito numa classe derivada, calcula o número de caracteres produzidos ao descodificar o intervalo de bytes de apenas leitura fornecido.
GetChars(Byte[], Int32, Int32, Char[], Int32)

Quando sobrescrito numa classe derivada, decodifica uma sequência de bytes do array de bytes especificado para o array de caracteres especificado.
GetChars(Byte[], Int32, Int32)

Quando sobrescrito numa classe derivada, decodifica uma sequência de bytes do array de bytes especificado num conjunto de caracteres.
GetChars(Byte[])

Quando sobrescrito numa classe derivada, descodifica todos os bytes do array de bytes especificado num conjunto de caracteres.
GetChars(Byte*, Int32, Char*, Int32)

Quando sobrescrito numa classe derivada, decodifica uma sequência de bytes a partir do ponteiro de byte especificado para um conjunto de caracteres que são armazenados a partir do ponteiro especificado.
GetChars(ReadOnlySpan<Byte>, Span<Char>)

Quando sobrescrito numa classe derivada, decodifica todos os bytes do intervalo de bytes especificado para apenas leitura num espaço de caracteres.
GetDecoder()

Quando sobrescrito numa classe derivada, obtém-se um descodificador que converte uma sequência codificada de bytes numa sequência de caracteres.
GetEncoder()

Quando sobrescrito numa classe derivada, obtém-se um codificador que converte uma sequência de caracteres Unicode numa sequência codificada de bytes.
GetEncoding(Int32, EncoderFallback, DecoderFallback)

Devolve a codificação associada ao identificador especificado da página de códigos. Os parâmetros especificam um manipulador de erros para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.
GetEncoding(Int32)

Devolve a codificação associada ao identificador especificado da página de códigos.
GetEncoding(String, EncoderFallback, DecoderFallback)

Devolve a codificação associada ao nome da página de código especificado. Os parâmetros especificam um manipulador de erros para caracteres que não podem ser codificados e sequências de bytes que não podem ser decodificadas.
GetEncoding(String)

Devolve a codificação associada ao nome da página de código especificado.
GetEncodings()

Devolve um array que contém todas as codificações.
GetHashCode()

Devolve o código hash da instância atual.
GetMaxByteCount(Int32)

Quando sobrescrito numa classe derivada, calcula o número máximo de bytes produzidos ao codificar o número especificado de caracteres.
GetMaxCharCount(Int32)

Quando sobrescrito numa classe derivada, calcula o número máximo de caracteres produzidos pela decodificação do número especificado de bytes.
GetPreamble()

Quando sobrescrito numa classe derivada, devolve uma sequência de bytes que especifica a codificação utilizada.
GetString(Byte[], Int32, Int32)

Quando sobrescrito numa classe derivada, decodifica uma sequência de bytes do array de bytes especificado numa cadeia.
GetString(Byte[])

Quando sobrescrito numa classe derivada, decodifica todos os bytes do array de bytes especificado numa string.
GetString(Byte*, Int32)

Quando é sobreposto numa classe derivada, decodifica um número especificado de bytes começando num endereço especificado numa cadeia.
GetString(ReadOnlySpan<Byte>)

Quando sobrescrito numa classe derivada, decodifica todos os bytes do intervalo de bytes especificado numa string.
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
IsAlwaysNormalized()

Recebe um valor que indica se a codificação atual está sempre normalizada, usando a forma de normalização por defeito.
IsAlwaysNormalized(NormalizationForm)

Quando sobrescrito numa classe derivada, obtém um valor que indica se a codificação atual está sempre normalizada, usando a forma de normalização especificada.
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
RegisterProvider(EncodingProvider)

Regista um fornecedor de codificação.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também