EncodingMap Property

Gets a Dictionary that is used to map an invalid ContentType.CharSet to a valid replacement System.Text.Encoding.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#
Managed Extensions for C++
C++/CLI

Public Shared ReadOnly Property EncodingMap As Dictionary(Of String,Encoding)

Dim value As Dictionary(Of String,Encoding)
 
value = Part.EncodingMap

public static Dictionary<string,Encoding> EncodingMap {get;}

public: __property static Dictionary<string*,Encoding*>* get_EncodingMap();

public:
static property Dictionary<String^,Encoding^>^ EncodingMap {
   Dictionary<String^,Encoding^>^ get();
}

Remarks

If a decoded charset string doesn't map to a valid System.Text.Encoding.WebName, the charset is converted to lowercase with non-alphanumerics removed and mapped to these replacement Encodings. The default mapping is initialized as follows:

"headers" ---> Encoding.ASCII (used for decoding headers that were incorrectly encoded using a multibyte encoding)
"default" ---> Encoding.Default (the default encoding to use; also used to decode unrecognized charset strings and to initialize HeaderDictionary.Encoding in Japan)
"usascii" ---> Encoding.ASCII
"iso88591" ---> Encoding("iso-8859-1")
"shiftjis" ---> Encoding("shift_jis")
"eucjp" ---> Encoding("euc-jp")
"utf7" ---> Encoding.UTF7
"utf8" ---> Encoding.UTF8
"cp932" ---> Encoding("shift_jis")
"windows31j" ---> Encoding("shift_jis")
"cp1252" ---> Encoding("windows-1252")
"windows1252httpequivcontenttype" ---> Encoding("windows-1252")
"iso2022jp2" ---> Encoding("iso-2022-jp")

Use 'Part.EncodingMap.Add("invalid-charset", Encoding.GetEncoding(/*replacement name or codepage*/))' to map any charset value to a replacement encoding.

When developing applications which target .NET Core or frameworks with limited Encoding sets, references to additional assemblies may be required for the availability of all Encodings listed above. One such assembly is System.Text.Encoding.CodePages which can be installed from NuGet and registered with the code example below (must be called before any Dart class constructors for the Encodings listed above to be included by default).

Example

System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance);

Visual Basic

System.Text.Encoding.RegisterProvider(System.Text.CodePagesEncodingProvider.Instance)

Reference

Part Class
Part Members