Encoding Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Representa uma codificação de caracteres.
public ref class Encoding abstractpublic ref class Encoding abstract : ICloneablepublic abstract class Encodingpublic abstract class Encoding : ICloneable[System.Serializable]
public abstract class Encoding[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Encoding : ICloneabletype Encoding = classtype Encoding = class
interface ICloneable[<System.Serializable>]
type Encoding = class[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Encoding = class
interface ICloneablePublic MustInherit Class EncodingPublic MustInherit Class Encoding
Implements ICloneable- Herança
-
Encoding
- Derivado
- Atributos
- Implementações
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 ConvertExample
{
static void Run()
{
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 Example1
Shared Sub Run()
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
A classe Encoding representa uma codificação de caracteres.
A codificação é o processo de transformar um conjunto de caracteres Unicode em uma sequência de bytes. Em contraste, a decodificação é o processo de transformar uma sequência de bytes codificados em um conjunto de caracteres Unicode. Para obter informações sobre os formatos de transformação Unicode (UTFs) e outras codificações suportadas pelo Encoding, consulte Character Encoding in .NET.
Encoding destina-se a operar em caracteres Unicode em vez de dados binários arbitrários, como matrizes de bytes. Se você deve codificar dados binários arbitrários em texto, você deve usar um protocolo como uuencode, que é implementado por métodos como Convert.ToBase64CharArray.
O .NET fornece as seguintes implementações da classe Encoding para oferecer suporte a codificações Unicode atuais e outras codificações:
ASCIIEncoding codifica caracteres Unicode como caracteres ASCII únicos de 7 bits. Esta codificação suporta apenas valores de caracteres entre U+0000 e U+007F. Página de código 20127. Também disponível através da propriedade ASCII.
UTF7Encoding codifica caracteres Unicode usando a codificação UTF-7. Esta codificação suporta todos os valores de caracteres Unicode. Página de código 65000. Também disponível através da propriedade UTF7.
UTF8Encoding codifica caracteres Unicode usando a codificação UTF-8. Esta codificação suporta todos os valores de caracteres Unicode. Página de código 65001. Também disponível através da propriedade UTF8.
UnicodeEncoding codifica caracteres Unicode usando a codificação UTF-16. As ordens de bytes do formato little endian e do formato big endian são suportadas. Também disponível através da propriedade Unicode e da propriedade BigEndianUnicode.
UTF32Encoding codifica caracteres Unicode usando a codificação UTF-32. As ordens de bytes little endian (página de código 12000) e big endian (página de código 12001) são suportadas. Também disponível através da propriedade UTF32.
A classe Encoding destina-se principalmente a converter entre diferentes codificações e Unicode. Muitas vezes, uma das classes Unicode derivadas é a escolha correta para seu aplicativo.
Use o método GetEncoding para obter outras codificações e chame o método GetEncodings para obter uma lista de todas as codificações.
Lista de codificações
A tabela a seguir lista as codificações suportadas pelo .NET. Ele lista o número da página de código de cada codificação e os valores das propriedades EncodingInfo.Name e EncodingInfo.DisplayName da codificação. Uma marca de seleção na coluna de suporte do .NET Framework , de suporte do .NET Core ou de suporte do .NET 5 e posterior indica que a página de código é suportada nativamente por essa implementação do .NET, independentemente da plataforma subjacente. Para o .NET Framework, a disponibilidade de outras codificações listadas na tabela depende do sistema operacional. Para .NET Core e .NET 5 e versões posteriores, outras codificações estão disponíveis usando a classe System.Text.CodePagesEncodingProvider ou derivando da classe System.Text.EncodingProvider.
Note
As páginas de código cuja propriedade EncodingInfo.Name corresponde a uma norma internacional não estão necessariamente em plena conformidade com essa norma.
| Página de código | Name | Nome de exibição | Suporte ao .NET Framework | Suporte ao .NET Core | Suporte ao .NET 5 e posterior |
|---|---|---|---|---|---|
| 37 | IBM037 | IBM EBCDIC (US-Canada) | |||
| 437 | IBM437 | OEM Estados Unidos | |||
| 500 | IBM500 | IBM EBCDIC (Internacional) | |||
| 708 | ASMO-708 | Árabe (ASMO 708) | |||
| 720 | DOS-720 | Árabe (DOS) | |||
| 737 | IBM737 | Grego (DOS) | |||
| 775 | IBM775 | Báltico (DOS) | |||
| 850 | IBM850 | Europa Ocidental (DOS) | |||
| 852 | IBM852 | Europa Central (DOS) | |||
| 855 | IBM855 | OEM cirílico | |||
| 857 | IBM857 | Turco (DOS) | |||
| 858 | IBM00858 | OEM Multilingue Latim I | |||
| 860 | IBM860 | Português (DOS) | |||
| 861 | IBM861 | Islandês (DOS) | |||
| 862 | DOS-862 | Hebraico (DOS) | |||
| 863 | IBM863 | Francês Canadiano (DOS) | |||
| 864 | IBM864 | Árabe (864) | |||
| 865 | IBM865 | Nórdico (DOS) | |||
| 866 | CP866 | Cirílico (DOS) | |||
| 869 | IBM869 | Grego, Moderno (DOS) | |||
| 870 | IBM870 | IBM EBCDIC (Latim Multilingue-2) | |||
| 874 | windows-874 | Tailandês (Windows) | |||
| 875 | CP875 | IBM EBCDIC (Grego Moderno) | |||
| 932 | shift_jis | Japonês (Shift-JIS) | |||
| 936 | gb2312 | Chinês simplificado (GB2312) | ✓ | ||
| 949 | ks_c_5601-1987 | Coreano | |||
| 950 | Big5 | Chinês Tradicional (Big5) | |||
| 1026 | IBM1026 | IBM EBCDIC (Turkish Latino-5) | |||
| 1047 | IBM01047 | IBM Latim-1 | |||
| 1140 | IBM01140 | IBM EBCDIC (EUA-Canada-Euro) | |||
| 1141 | IBM01141 | IBM EBCDIC (Germany-Euro) | |||
| 1142 | IBM01142 | IBM EBCDIC (Dinamarca-Norway-Euro) | |||
| 1143 | IBM01143 | IBM EBCDIC (Finlândia-Sweden-Euro) | |||
| 1144 | IBM01144 | IBM EBCDIC (Italy-Euro) | |||
| 1145 | IBM01145 | IBM EBCDIC (Spain-Euro) | |||
| 1146 | IBM01146 | IBM EBCDIC (UK-Euro) | |||
| 1147 | IBM01147 | IBM EBCDIC (France-Euro) | |||
| 1148 | IBM01148 | IBM EBCDIC (International-Euro) | |||
| 1149 | IBM01149 | IBM EBCDIC (Icelandic-Euro) | |||
| 1200 | UTF-16 | Unicode | ✓ | ✓ | ✓ |
| 1201 | UnicodeFFFE | Unicode (Big endian) | ✓ | ✓ | ✓ |
| 1250 | windows-1250 | Europa Central (Windows) | |||
| 1251 | windows-1251 | Cirílico (Windows) | |||
| 1252 | Windows-1252 | Europa Ocidental (Windows) | ✓ | ||
| 1253 | windows-1253 | Grego (Windows) | |||
| 1254 | windows-1254 | Turco (Windows) | |||
| 1255 | windows-1255 | Hebraico (Windows) | |||
| 1256 | windows-1256 | Árabe (Windows) | |||
| 1257 | windows-1257 | Báltico (Windows) | |||
| 1258 | windows-1258 | Vietnamita (Windows) | |||
| 1361 | Johab | Coreano (Johab) | |||
| 10000 | Macintosh | Europa Ocidental (Mac) | |||
| 10001 | X-MAC-Japonês | Japonês (Mac) | |||
| 10002 | X-MAC-Chinesetrad | Chinês Tradicional (Mac) | |||
| 10003 | x-mac-coreano | Coreano (Mac) | ✓ | ||
| 10004 | X-MAC-Árabe | Árabe (Mac) | |||
| 10005 | X-MAC-Hebraico | Hebraico (Mac) | |||
| 10006 | x-mac-grego | Grego (Mac) | |||
| 10007 | x-mac-cirílico | Cirílico (Mac) | |||
| 10008 | x-mac-chinesesimp | Chinês simplificado (Mac) | ✓ | ||
| 10010 | x-mac-romeno | Romeno (Mac) | |||
| 10017 | X-MAC-Ucraniano | Ucraniano (Mac) | |||
| 10021 | X-MAC-Thai | Tailandês (Mac) | |||
| 10029 | X-MAC-CE | Europa Central (Mac) | |||
| 10079 | X-MAC-Islandês | Islandês (Mac) | |||
| 10081 | X-MAC-Turco | Turco (Mac) | |||
| 10082 | X-MAC-Croata | Croata (Mac) | |||
| 12000 | UTF-32 | Unicode (UTF-32) | ✓ | ✓ | ✓ |
| 12001 | UTF-32BE | Unicode (UTF-32, formato Big endian) | ✓ | ✓ | ✓ |
| 20000 | x-Chinese-CNS | Chinês Tradicional (CNS) | |||
| 20001 | X-CP20001 | TCA Taiwan | |||
| 20002 | x-Chinese-Eten | Chinês Tradicional (Eten) | |||
| 20003 | X-CP20003 | IBM5550 Taiwan | |||
| 20004 | X-CP20004 | Teletexto Taiwan | |||
| 20005 | X-CP20005 | Wang Taiwan | |||
| 20105 | x-IA5 | Europa Ocidental (IA5) | |||
| 20106 | x-IA5-German | Alemão (IA5) | |||
| 20107 | x-IA5-Sueco | Sueco (IA5) | |||
| 20108 | x-IA5-Norwegian | Norueguês (IA5) | |||
| 20127 | US-ASCII | US-ASCII | ✓ | ✓ | ✓ |
| 20261 | X-CP20261 | T.61 | |||
| 20269 | X-CP20269 | ISO-6937 | |||
| 20273 | IBM273 | IBM EBCDIC (Alemanha) | |||
| 20277 | IBM277 | IBM EBCDIC (Denmark-Norway) | |||
| 20278 | IBM278 | IBM EBCDIC (Finland-Sweden) | |||
| 20280 | IBM280 | IBM EBCDIC (Itália) | |||
| 20284 | IBM284 | IBM EBCDIC (Espanha) | |||
| 20285 | IBM285 | IBM EBCDIC (Reino Unido) | |||
| 20290 | IBM290 | IBM EBCDIC (katakana japonês) | |||
| 20297 | IBM297 | IBM EBCDIC (França) | |||
| 20420 | IBM420 | IBM EBCDIC (árabe) | |||
| 20423 | IBM423 | IBM EBCDIC (grego) | |||
| 20424 | IBM424 | IBM EBCDIC (hebraico) | |||
| 20833 | x-EBCDIC-KoreanExtended | IBM EBCDIC (coreano estendido) | |||
| 20838 | IBM-Thai | IBM EBCDIC (tailandês) | |||
| 20866 | KOI8-R | Cirílico (KOI8-R) | |||
| 20871 | IBM871 | IBM EBCDIC (islandês) | |||
| 20880 | IBM880 | IBM EBCDIC (russo cirílico) | |||
| 20905 | IBM905 | IBM EBCDIC (turco) | |||
| 20924 | IBM00924 | IBM Latim-1 | |||
| 20932 | EUC-JP | Japonês (JIS 0208-1990 e 0212-1990) | |||
| 20936 | X-CP20936 | Chinês simplificado (GB2312-80) | ✓ | ||
| 20949 | X-CP20949 | Wansung coreano | ✓ | ||
| 21025 | CP1025 | IBM EBCDIC (Serbian-Bulgariancirílico) | |||
| 21866 | Koi8-U | Cirílico (KOI8-U) | |||
| 28591 | ISO-8859-1 | Europa Ocidental (ISO) | ✓ | ✓ | ✓ |
| 28592 | ISO-8859-2 | Europa Central (ISO) | |||
| 28593 | ISO-8859-3 | Latim 3 (ISO) | |||
| 28594 | ISO-8859-4 | Báltico (ISO) | |||
| 28595 | ISO-8859-5 | Cirílico (ISO) | |||
| 28596 | ISO-8859-6 | Árabe (ISO) | |||
| 28597 | ISO-8859-7 | Grego (ISO) | |||
| 28598 | ISO-8859-8 | Hebraico (ISO-Visual) | ✓ | ||
| 28599 | ISO-8859-9 | Turco (ISO) | |||
| 28603 | ISO-8859-13 | Estónio (ISO) | |||
| 28605 | ISO-8859-15 | Latim 9 (ISO) | |||
| 29001 | x-Europa | Europa | |||
| 38598 | ISO-8859-8-I | Hebraico (ISO-Logical) | ✓ | ||
| 50220 | ISO-2022-JP | Japonês (JIS) | ✓ | ||
| 50221 | csISO2022JP | Japonês (JIS-Allow 1 byte Kana) | ✓ | ||
| 50222 | ISO-2022-JP | Japonês (JIS-Allow 1 byte Kana - SO/SI) | ✓ | ||
| 50225 | ISO-2022-KR | Coreano (ISO) | ✓ | ||
| 50227 | X-CP50227 | Chinês simplificado (ISO-2022) | ✓ | ||
| 51932 | EUC-JP | Japonês (EUC) | ✓ | ||
| 51936 | EUC-CN | Chinês simplificado (EUC) | ✓ | ||
| 51949 | EUC-KR | Coreano (EUC) | ✓ | ||
| 52936 | hz-gb-2312 | Chinês simplificado (HZ) | ✓ | ||
| 54936 | GB18030 | Chinês simplificado (GB18030) | ✓ | ||
| 57002 | X-ISCII-DE | ISCII Devanagari | ✓ | ||
| 57003 | X-ISCII-BE | ISCII Bengalesa | ✓ | ||
| 57004 | X-ISCII-TA | ISCII Tâmil | ✓ | ||
| 57005 | x-iscii-te | ISCII Telugu | ✓ | ||
| 57006 | x-iscii-as | ISCII Assamês | ✓ | ||
| 57007 | x-iscii-ou | ISCII Oriya | ✓ | ||
| 57008 | X-Iscii-ka | ISCII Canarês | ✓ | ||
| 57009 | X-Iscii-MA | ISCII Malaiala | ✓ | ||
| 57010 | X-Iscii-gu | ISCII Gujarati | ✓ | ||
| 57011 | X-ISCII-PA | ISCII Punjabi (padrão de codificação de caracteres para scripts indianos, incluindo Punjabi) | ✓ | ||
| 65000 | UTF-7 | Unicode (UTF-7) | ✓ | ✓ | |
| 65001 | UTF-8 | Unicode (UTF-8) | ✓ | ✓ | ✓ |
O exemplo a seguir chama os métodos GetEncoding(Int32) e GetEncoding(String) para obter a codificação da página de código grega do Windows. Ele compara os objetos Encoding retornados pelas chamadas de método para mostrar que eles são iguais e, em seguida, os mapas exibem o ponto de código Unicode e o valor da página de código correspondente para cada caractere no alfabeto grego.
using System;
using System.Text;
public class GetEncodingExample
{
public static void Run()
{
Encoding enc = Encoding.GetEncoding(1253);
Encoding altEnc = Encoding.GetEncoding("windows-1253");
Console.WriteLine($"{enc.EncodingName} = Code Page {altEnc.CodePage}: {enc.Equals(altEnc)}");
string greekAlphabet = "Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η " +
"Θ θ Ι ι Κ κ Λ λ Μ μ Ν ν Ξ ξ " +
"Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ υ " +
"Φ φ Χ χ Ψ ψ Ω ω";
Console.OutputEncoding = Encoding.UTF8;
byte[] bytes = enc.GetBytes(greekAlphabet);
Console.WriteLine("{0,-12} {1,20} {2,20:X2}", "Character",
"Unicode Code Point", "Code Page 1253");
for (int ctr = 0; ctr < bytes.Length; ctr++) {
if (greekAlphabet[ctr].Equals(' '))
continue;
Console.WriteLine("{0,-12} {1,20} {2,20:X2}", greekAlphabet[ctr],
GetCodePoint(greekAlphabet[ctr]), bytes[ctr]);
}
}
private static string GetCodePoint(char ch)
{
string retVal = "u+";
byte[] bytes = Encoding.Unicode.GetBytes(ch.ToString());
for (int ctr = bytes.Length - 1; ctr >= 0; ctr--)
retVal += bytes[ctr].ToString("X2");
return retVal;
}
}
// The example displays the following output:
// Character Unicode Code Point Code Page 1253
// Α u+0391 C1
// α u+03B1 E1
// Β u+0392 C2
// β u+03B2 E2
// Γ u+0393 C3
// γ u+03B3 E3
// Δ u+0394 C4
// δ u+03B4 E4
// Ε u+0395 C5
// ε u+03B5 E5
// Ζ u+0396 C6
// ζ u+03B6 E6
// Η u+0397 C7
// η u+03B7 E7
// Θ u+0398 C8
// θ u+03B8 E8
// Ι u+0399 C9
// ι u+03B9 E9
// Κ u+039A CA
// κ u+03BA EA
// Λ u+039B CB
// λ u+03BB EB
// Μ u+039C CC
// μ u+03BC EC
// Ν u+039D CD
// ν u+03BD ED
// Ξ u+039E CE
// ξ u+03BE EE
// Ο u+039F CF
// ο u+03BF EF
// Π u+03A0 D0
// π u+03C0 F0
// Ρ u+03A1 D1
// ρ u+03C1 F1
// Σ u+03A3 D3
// σ u+03C3 F3
// ς u+03C2 F2
// Τ u+03A4 D4
// τ u+03C4 F4
// Υ u+03A5 D5
// υ u+03C5 F5
// Φ u+03A6 D6
// φ u+03C6 F6
// Χ u+03A7 D7
// χ u+03C7 F7
// Ψ u+03A8 D8
// ψ u+03C8 F8
// Ω u+03A9 D9
// ω u+03C9 F9
Imports System.Text
Module Example2
Public Sub Run()
Dim enc As Encoding = Encoding.GetEncoding(1253)
Dim altEnc As Encoding = Encoding.GetEncoding("windows-1253")
Console.WriteLine("{0} = Code Page {1}: {2}", enc.EncodingName,
altEnc.CodePage, enc.Equals(altEnc))
Dim greekAlphabet As String = "Α α Β β Γ γ Δ δ Ε ε Ζ ζ Η η " +
"Θ θ Ι ι Κ κ Λ λ Μ μ Ν ν Ξ ξ " +
"Ο ο Π π Ρ ρ Σ σ ς Τ τ Υ υ " +
"Φ φ Χ χ Ψ ψ Ω ω"
Console.OutputEncoding = Encoding.UTF8
Dim bytes() As Byte = enc.GetBytes(greekAlphabet)
Console.WriteLine("{0,-12} {1,20} {2,20:X2}", "Character",
"Unicode Code Point", "Code Page 1253")
For ctr As Integer = 0 To bytes.Length - 1
If greekAlphabet(ctr).Equals(" "c) Then Continue For
Console.WriteLine("{0,-12} {1,20} {2,20:X2}", greekAlphabet(ctr),
GetCodePoint(greekAlphabet(ctr)), bytes(ctr))
Next
End Sub
Private Function GetCodePoint(ch As String) As String
Dim retVal As String = "u+"
Dim bytes() As Byte = Encoding.Unicode.GetBytes(ch)
For ctr As Integer = bytes.Length - 1 To 0 Step -1
retVal += bytes(ctr).ToString("X2")
Next
Return retVal
End Function
End Module
' The example displays the following output:
' Character Unicode Code Point Code Page 1253
' Α u+0391 C1
' α u+03B1 E1
' Β u+0392 C2
' β u+03B2 E2
' Γ u+0393 C3
' γ u+03B3 E3
' Δ u+0394 C4
' δ u+03B4 E4
' Ε u+0395 C5
' ε u+03B5 E5
' Ζ u+0396 C6
' ζ u+03B6 E6
' Η u+0397 C7
' η u+03B7 E7
' Θ u+0398 C8
' θ u+03B8 E8
' Ι u+0399 C9
' ι u+03B9 E9
' Κ u+039A CA
' κ u+03BA EA
' Λ u+039B CB
' λ u+03BB EB
' Μ u+039C CC
' μ u+03BC EC
' Ν u+039D CD
' ν u+03BD ED
' Ξ u+039E CE
' ξ u+03BE EE
' Ο u+039F CF
' ο u+03BF EF
' Π u+03A0 D0
' π u+03C0 F0
' Ρ u+03A1 D1
' ρ u+03C1 F1
' Σ u+03A3 D3
' σ u+03C3 F3
' ς u+03C2 F2
' Τ u+03A4 D4
' τ u+03C4 F4
' Υ u+03A5 D5
' υ u+03C5 F5
' Φ u+03A6 D6
' φ u+03C6 F6
' Χ u+03A7 D7
' χ u+03C7 F7
' Ψ u+03A8 D8
' ψ u+03C8 F8
' Ω u+03A9 D9
' ω u+03C9 F9
Se os dados a serem convertidos estiverem disponíveis apenas em blocos sequenciais (como dados lidos de um fluxo) ou se a quantidade de dados for tão grande que precise ser dividida em blocos menores, você deverá usar o Decoder ou o Encoder fornecidos pelo método GetDecoder ou pelo método GetEncoder, respectivamente, de uma classe derivada.
Os codificadores UTF-16 e UTF-32 podem usar a ordem de bytes big endian (byte mais significativo primeiro) ou a ordem de bytes little endian (byte menos significativo primeiro). Por exemplo, a letra maiúscula latina A (U+0041) é serializada da seguinte forma (em hexadecimal):
- UTF-16 big endian ordem de bytes: 00 41
- UTF-16 ordem de bytes little endian: 41 00
- UTF-32 big endian ordem dos bytes: 00 00 00 41
- UTF-32 ordem de bytes little endian: 41 00 00 00
Geralmente, é mais eficiente armazenar caracteres Unicode usando a ordem nativa de bytes. Por exemplo, é melhor usar a ordem de bytes little endian em plataformas little endian, tais como computadores Intel.
O método GetPreamble recupera uma matriz de bytes que inclui a marca de ordem dos bytes (BOM). Se essa matriz de bytes for prefixada a um fluxo codificado, ela ajudará o decodificador a identificar o formato de codificação usado.
Para obter mais informações sobre a ordem de bytes e a marca de ordem de bytes, consulte O padrão Unicode na home page Unicode.
Observe que as classes de codificação permitem erros:
- Mude silenciosamente para um caractere "?"
- Use um caractere "mais adequado".
- Mude para um comportamento específico do aplicativo usando as classes EncoderFallback e DecoderFallback com o caractere de substituição Unicode U+FFFD.
Você deve lançar uma exceção em qualquer erro de fluxo de dados. Um aplicativo usa um sinalizador "throwonerror" quando aplicável ou usa as classes EncoderExceptionFallback e DecoderExceptionFallback. O fallback de melhor ajuste muitas vezes não é recomendado porque pode causar perda de dados ou confusão e é mais lento do que simples substituições de caracteres. Para codificações ANSI, o melhor comportamento de ajuste é o padrão.
Construtores
| Name | Descrição |
|---|---|
| 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 | Descrição |
|---|---|
| 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. |
| Latin1 |
Obtém uma codificação para o conjunto de caracteres Latin1 (ISO-8859-1). |
| 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 |
Obsoleto.
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 | Descrição |
|---|---|
| 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. |
| CreateTranscodingStream(Stream, Encoding, Encoding, Boolean) |
Cria um Stream que serve para transcodificar dados entre um interno Encoding e um externo Encoding, semelhante a Convert(Encoding, Encoding, Byte[]). |
| 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 |
| 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) |
| TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32) |
Codifica num intervalo de bytes um conjunto de caracteres do intervalo de apenas leitura especificado se o destino for suficientemente grande. |
| TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32) |
Descodifica num intervalo de caracteres um conjunto de bytes do intervalo especificado de apenas leitura se o destino for suficientemente grande. |
Métodos da Extensão
| Name | Descrição |
|---|---|
| GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>) |
Decodifica o especificado ReadOnlySequence<T> para |
| GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>) |
Codifica o especificado ReadOnlySequence<T> para |
| GetBytes(Encoding, ReadOnlySequence<Char>) |
Codifica o especificado ReadOnlySequence<T> num Byte array usando o especificado Encoding. |
| GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>) |
Codifica o especificado ReadOnlySpan<T> em |
| GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>) |
Decodifica o especificado ReadOnlySequence<T> para |
| GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>) |
Descodifica o especificado ReadOnlySequence<T> para |
| GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>) |
Decodifica o especificado ReadOnlySpan<T> para |
| GetString(Encoding, ReadOnlySequence<Byte>) |
Descodifica o especificado ReadOnlySequence<T> em um String usando o especificado Encoding. |
