Encoding.HeaderName 속성

정의

네임스페이스:

System.Text

어셈블리:

netstandard.dll, System.Runtime.dll

Source:

Encoding.cs

파생 클래스에서 재정의되는 경우 메일 에이전트 헤더 태그와 함께 사용할 수 있는 현재 인코딩의 이름을 가져옵니다.

public:
 virtual property System::String ^ HeaderName { System::String ^ get(); };

public virtual string HeaderName { get; }

member this.HeaderName : string

Public Overridable ReadOnly Property HeaderName As String

속성 값

String

메일 에이전트 헤더 태그와 함께 사용할 현재 Encoding 항목의 이름입니다.

-또는-

현재 Encoding 를 사용할 수 없는 경우 빈 문자열("")입니다.

예제

다음 예제에서는 각 인코딩에 대해 서로 다른 이름을 검색하고 하나 이상의 이름이 다른 EncodingInfo.Name인코딩을 표시합니다. 표시 EncodingName 하지만 비교하지는 않습니다.

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)

*/

Imports System.Text

Public Class SamplesEncoding   

   Public Shared Sub 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.
      Dim ei As EncodingInfo
      For Each ei In  Encoding.GetEncodings()
         Dim e As Encoding = ei.GetEncoding()
         
         If ei.Name <> e.BodyName OrElse ei.Name <> e.HeaderName OrElse ei.Name <> e.WebName Then
            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)
         End If

      Next ei 

   End Sub

End Class


'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)

설명

헤더 이름에 대한 인코딩이 필요한 경우 속성을 사용하여 메서드를 GetEncodingHeaderName 호출해야 합니다. 종종 메서드는 호출에 제공된 테스트 인코딩에서 다른 인코딩을 검색합니다. 일반적으로 전자 메일 애플리케이션만 이러한 인코딩을 검색해야 합니다.

경우에 따라 속성 값 BodyName 은 해당 인코딩을 정의하는 국제 표준에 해당합니다. 그렇다고 구현이 해당 표준을 완전히 준수한다는 의미는 아닙니다.

WebName 인코딩을 설명하는 데 사용할 이름을 반환합니다. 예를 들어 이 속성은 HeaderName 전자 메일 애플리케이션에 더 잘 작동할 수 있는 다른 인코딩을 정의합니다. 그러나 인코딩을 정의하는 데는 속성을 사용하지 않는 것이 좋습니다.

추가 정보

• Name
• BodyName
• EncodingName
• WebName