Encoding.HeaderName Propiedad

Definición

Espacio de nombres:

System.Text

Ensamblados:

netstandard.dll, System.Runtime.dll

Source:

Encoding.cs

Cuando se reemplaza en una clase derivada, obtiene un nombre para la codificación actual que se puede utilizar con etiquetas de encabezado de un programa de correo.

C#

public virtual string HeaderName { get; }

Valor de propiedad

String

Nombre del objeto Encoding actual que se debe usar con las etiquetas de encabezado de un agente de correo.

o bien

Una cadena vacía (""), si no se puede usar la clase Encoding actual.

Ejemplos

En el ejemplo siguiente se recuperan los nombres diferentes para cada codificación y se muestran las codificaciones con uno o más nombres distintos de EncodingInfo.Name . Muestra EncodingName pero no se compara con él.

C#

using System;
using System.Text;

public class SamplesEncoding  {

   public static void 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.
      foreach( EncodingInfo ei in Encoding.GetEncodings() )  {
         Encoding e = ei.GetEncoding();

         if (( ei.Name != e.BodyName ) || ( ei.Name != e.HeaderName ) || ( ei.Name != 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)

*/

Comentarios

Si necesita una codificación para un nombre de encabezado, debe llamar al GetEncoding método con la HeaderName propiedad. A menudo, el método recupera una codificación diferente de la codificación de prueba proporcionada en la llamada. Por lo general, solo las aplicaciones de correo electrónico necesitan recuperar este tipo de codificación.

En algunos casos, el valor de la BodyName propiedad corresponde al estándar internacional que define esa codificación. Esto no significa que la implementación esté completa con esa norma.

Tenga en cuenta que WebName devuelve el nombre que se va a usar para describir una codificación. La HeaderName propiedad define una codificación diferente que podría funcionar mejor para una aplicación de correo electrónico, por ejemplo. Sin embargo, no se recomienda el uso de la propiedad para definir la codificación.

Se aplica a

Consulte también

• Name
• BodyName
• EncodingName
• WebName