Condividi tramite

CodePagesEncodingProvider Classe

Definizione

Spazio dei nomi:
System.Text
Assembly:
System.Text.Encoding.CodePages.dll
Pacchetto:
System.Text.Encoding.CodePages v11.0.0-preview.2.26159.112
Origine:
CodePagesEncodingProvider.cs
Origine:
CodePagesEncodingProvider.cs
Origine:
CodePagesEncodingProvider.cs
Origine:
CodePagesEncodingProvider.cs
Origine:
CodePagesEncodingProvider.cs
Origine:
CodePagesEncodingProvider.cs

Fornisce l'accesso a un provider di codifica per le tabelle codici che altrimenti sono disponibili solo in .NET Framework desktop.

public ref class CodePagesEncodingProvider sealed
public ref class CodePagesEncodingProvider sealed : System::Text::EncodingProvider
[System.Security.SecurityCritical]
public sealed class CodePagesEncodingProvider
public sealed class CodePagesEncodingProvider : System.Text.EncodingProvider
[<System.Security.SecurityCritical>]
type CodePagesEncodingProvider = class
type CodePagesEncodingProvider = class
    inherit EncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Public NotInheritable Class CodePagesEncodingProvider
Inherits EncodingProvider
Ereditarietà
Object
CodePagesEncodingProvider
Ereditarietà
Object
EncodingProvider
CodePagesEncodingProvider
Attributi
SecurityCriticalAttribute

Commenti

.NET Framework per il desktop di Windows supporta un ampio set di codifiche Unicode e tabella codici. .NET Core supporta invece solo le codifiche seguenti:

  • ASCII (tabella codici 20127), restituita dalla Encoding.ASCII proprietà .

  • ISO-8859-1 (tabella codici 28591).

  • UTF-7 (tabella codici 65000), restituita dalla Encoding.UTF7 proprietà .

  • UTF-8 (tabella codici 65001), restituita dalla Encoding.UTF8 proprietà .

  • UTF-16 e UTF-16LE (tabella codici 1200), restituita dalla Encoding.Unicode proprietà .

  • UTF-16BE (tabella codici 1201), di cui viene creata un'istanza chiamando il UnicodeEncoding.UnicodeEncoding costruttore o UnicodeEncoding.UnicodeEncoding con il bigEndian valore true.

  • UTF-32 e UTF-32LE (tabella codici 12000), restituita dalla Encoding.UTF32 proprietà .

  • UTF-32BE (tabella codici 12001), di cui viene creata un'istanza chiamando un UTF32Encoding costruttore con un bigEndian parametro e fornendo un valore di true nella chiamata al metodo.

Oltre alla tabella codici 20127, le codifiche della tabella codici non sono supportate.

La CodePagesEncodingProvider classe estende EncodingProvider per rendere queste tabelle codici disponibili per .NET Core. Per usare queste tabelle codici aggiuntive, eseguire le operazioni seguenti:

Dopo la registrazione di un EncodingProvider oggetto, le codifiche supportate sono disponibili chiamando gli overload di Encoding.GetEncoding. Non è consigliabile chiamare gli EncodingProvider.GetEncoding overload.

Impatto sul comportamento di codifica predefinito

La registrazione CodePagesEncodingProvider influisce anche sul comportamento di GetEncoding(Int32) quando viene chiamato con un codepage argomento di 0 in .NET (Core):

  • In Windows restituisce GetEncoding(0) la codifica corrispondente alla tabella codici attiva del sistema, che corrisponde allo stesso comportamento di .NET Framework.
  • Nelle piattaforme non Windows restituisce GetEncoding(0) UTF-8, mantenendo la coerenza multipiattaforma.

Quando non viene registrato alcun provider di codifica, GetEncoding(0) restituisce UTF-8 in tutte le piattaforme in .NET Core e versioni successive.

Proprietà

Nome Descrizione
Instance

Ottiene un provider di codifica per le tabelle codici supportate in .NET Framework desktop ma non nella piattaforma .NET Framework corrente.

Metodi

Nome Descrizione
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetEncoding(Int32, EncoderFallback, DecoderFallback)

Restituisce la codifica associata all'identificatore della tabella codici specificato. I parametri specificano un gestore errori per i caratteri che non possono essere codificati e sequenze di byte che non possono essere decodificate.

(Ereditato da EncodingProvider)
GetEncoding(Int32)

Restituisce la codifica associata all'identificatore della tabella codici specificato.
GetEncoding(String, EncoderFallback, DecoderFallback)

Restituisce la codifica associata al nome specificato. I parametri specificano un gestore errori per i caratteri che non possono essere codificati e sequenze di byte che non possono essere decodificate.

(Ereditato da EncodingProvider)
GetEncoding(String)

Restituisce la codifica associata al nome della tabella codici specificato.
GetEncodings()

Restituisce una matrice che contiene tutte le codifiche supportate da CodePagesEncodingProvider.
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene il Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale del Objectcorrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a