CodePagesEncodingProvider.Instance Propriedade
Definição
Obtém um provedor de codificação para páginas de código compatíveis com o .NET Framework da área de trabalho, mas não com a plataforma do .NET Framework atual.Gets an encoding provider for code pages supported in the desktop .NET Framework but not in the current .NET Framework platform.
public:
static property System::Text::EncodingProvider ^ Instance { System::Text::EncodingProvider ^ get(); };
public static System.Text.EncodingProvider Instance { get; }
member this.Instance : System.Text.EncodingProvider
Public Shared ReadOnly Property Instance As EncodingProvider
Valor da propriedade
Um provedor de codificação que permite o acesso a codificações sem suporte na plataforma de .NET Framework atual.An encoding provider that allows access to encodings not supported on the current .NET Framework platform.
Comentários
O .NET Framework dá suporte a um grande número de codificações de caracteres e páginas de código.The .NET Framework supports a large number of character encodings and code pages. Você pode obter uma lista completa de codificações chamando o Encoding.GetEncodings método, que está disponível no .NET Framework.You can get a complete list of encodings by calling the Encoding.GetEncodings method, which is available in the .NET Framework. Por outro lado, o .NET Core dá suporte apenas às seguintes codificações por padrão:On the other hand, .NET Core only supports the following encodings by default:
ASCII (página de código 20127), que é retornada pela Encoding.ASCII propriedade.ASCII (code page 20127), which is returned by the Encoding.ASCII property.
ISO-8859-1 (página de código 28591).ISO-8859-1 (code page 28591).
UTF-7 (página de código 65000), que é retornada pela Encoding.UTF7 propriedade.UTF-7 (code page 65000), which is returned by the Encoding.UTF7 property.
UTF-8 (página de código 65001), que é retornada pela Encoding.UTF8 propriedade.UTF-8 (code page 65001), which is returned by the Encoding.UTF8 property.
UTF-16 e UTF-16LE (página de código 1200), que é retornada pela Encoding.Unicode propriedade.UTF-16 and UTF-16LE (code page 1200), which is returned by the Encoding.Unicode property.
UTF-16BE (página de código 1201), que é instanciado chamando o UnicodeEncoding.UnicodeEncoding UnicodeEncoding.UnicodeEncoding Construtor ou com um
bigEndianvalor detrue.UTF-16BE (code page 1201), which is instantiated by calling the UnicodeEncoding.UnicodeEncoding or UnicodeEncoding.UnicodeEncoding constructor with abigEndianvalue oftrue.UTF-32 e UTF-32LE (página de código 12000), que é retornada pela Encoding.UTF32 propriedade.UTF-32 and UTF-32LE (code page 12000), which is returned by the Encoding.UTF32 property.
UTF-32BE (página de código 12001), que é instanciado chamando um UTF32Encoding Construtor que tem um
bigEndianparâmetro e fornecendo um valor detruena chamada do método.UTF-32BE (code page 12001), which is instantiated by calling an UTF32Encoding constructor that has abigEndianparameter and providing a value oftruein the method call.
Para recuperar uma codificação que está presente no .NET Framework na área de trabalho do Windows, mas não no .NET Core, faça o seguinte:To retrieve an encoding that is present in the .NET Framework on the Windows desktop but not in .NET Core, you do the following:
Adicione uma referência ao assembly System.Text.Encoding.CodePages.dll ao seu projeto.Add a reference to the System.Text.Encoding.CodePages.dll assembly to your project.
Obter o EncodingProvider objeto da propriedade estática CodePagesEncodingProvider.Instance .Get the EncodingProvider object from the static CodePagesEncodingProvider.Instance property.
Passe o EncodingProvider objeto para o Encoding.RegisterProvider método para tornar as codificações fornecidas pelo EncodingProvider objeto disponível para o Common Language Runtime.Pass the EncodingProvider object to the Encoding.RegisterProvider method to make the encodings supplied by the EncodingProvider object available to the common language runtime.
Chame uma Encoding.GetEncoding sobrecarga para recuperar a codificação.Call an Encoding.GetEncoding overload to retrieve the encoding. O Encoding.GetEncoding método chamará o EncodingProvider.GetEncoding método correspondente para determinar se ele pode fornecer a codificação solicitada.The Encoding.GetEncoding method will call the corresponding EncodingProvider.GetEncoding method to determine whether it can supply the requested encoding.