Encoding::HeaderName Property
When overridden in a derived class, gets a name for the current encoding that can be used with mail agent header tags.
Assembly: mscorlib (in mscorlib.dll)
If your application needs an encoding for a header name, it should call GetEncoding with the HeaderName property. Often the method retrieves a different encoding from the test encoding furnished in the call. Generally only e-mail applications need to retrieve such an encoding.
Note that WebName returns the name to use to describe an encoding. The HeaderName property defines a different encoding that might work better for an e-mail application, for example. However, use of the property to define the encoding is not recommended.
The following example retrieves the different names for each encoding and displays the encodings with one or more names that are different from EncodingInfo::Name. It displays EncodingName but does not compare against it.
using namespace System; using namespace System::Text; int main() { // Print the header. Console::Write( "Name " ); Console::Write( "CodePage " ); Console::Write( "BodyName " ); Console::Write( "HeaderName " ); Console::Write( "WebName " ); Console::WriteLine( "Encoding.EncodingName" ); // For every encoding, compare the name properties with EncodingInfo.Name. // Display only the encodings that have one or more different names. System::Collections::IEnumerator^ myEnum = Encoding::GetEncodings()->GetEnumerator(); while ( myEnum->MoveNext() ) { EncodingInfo ^ ei = safe_cast<EncodingInfo ^>(myEnum->Current); Encoding^ e = ei->GetEncoding(); if ( !ei->Name->Equals( e->BodyName ) || !ei->Name->Equals( e->HeaderName ) || !ei->Name->Equals( e->WebName ) ) { Console::Write( "{0,-18} ", ei->Name ); Console::Write( "{0,-9} ", e->CodePage ); Console::Write( "{0,-18} ", e->BodyName ); Console::Write( "{0,-18} ", e->HeaderName ); Console::Write( "{0,-18} ", e->WebName ); Console::WriteLine( "{0} ", e->EncodingName ); } } } /* This code produces the following output. Name CodePage BodyName HeaderName WebName Encoding.EncodingName shift_jis 932 iso-2022-jp iso-2022-jp shift_jis Japanese (Shift-JIS) windows-1250 1250 iso-8859-2 windows-1250 windows-1250 Central European (Windows) windows-1251 1251 koi8-r windows-1251 windows-1251 Cyrillic (Windows) Windows-1252 1252 iso-8859-1 Windows-1252 Windows-1252 Western European (Windows) windows-1253 1253 iso-8859-7 windows-1253 windows-1253 Greek (Windows) windows-1254 1254 iso-8859-9 windows-1254 windows-1254 Turkish (Windows) csISO2022JP 50221 iso-2022-jp iso-2022-jp csISO2022JP Japanese (JIS-Allow 1 byte Kana) iso-2022-kr 50225 iso-2022-kr euc-kr iso-2022-kr Korean (ISO) */
Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.