UnicodeEncoding 생성자

정의

네임스페이스:: System.Text

어셈블리:: mscorlib.dll, System.Text.Encoding.Extensions.dll

어셈블리:: netstandard.dll, System.Text.Encoding.Extensions.dll

어셈블리:: System.Text.Encoding.Extensions.dll

어셈블리:: mscorlib.dll

어셈블리:: netstandard.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

UnicodeEncoding 클래스의 새 인스턴스를 초기화합니다.

오버로드

Name	Description
UnicodeEncoding()	UnicodeEncoding 클래스의 새 인스턴스를 초기화합니다.
UnicodeEncoding(Boolean, Boolean)	UnicodeEncoding 클래스의 새 인스턴스를 초기화합니다. 매개 변수는 big endian 바이트 순서를 사용할지 여부와 메서드가 GetPreamble() 유니코드 바이트 순서 표시를 반환하는지 여부를 지정합니다.
UnicodeEncoding(Boolean, Boolean, Boolean)	UnicodeEncoding 클래스의 새 인스턴스를 초기화합니다. 매개 변수는 big endian 바이트 순서를 사용할지 여부, 유니코드 바이트 순서 표시를 제공할지 여부 및 잘못된 인코딩이 검색될 때 예외를 throw할지 여부를 지정합니다.

UnicodeEncoding()

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

UnicodeEncoding 클래스의 새 인스턴스를 초기화합니다.

public:
 UnicodeEncoding();

public UnicodeEncoding();

Public Sub New ()

예제

다음 예제에서는 새 UnicodeEncoding 인스턴스를 만들고 인코딩의 이름을 표시하는 방법을 보여 줍니다.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {
        UnicodeEncoding unicode = new UnicodeEncoding();
        String encodingName = unicode.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}

Imports System.Text

Class UnicodeEncodingExample

    Public Shared Sub Main()
        Dim uni As New UnicodeEncoding()
        Dim encodingName As String = uni.EncodingName
        Console.WriteLine("Encoding name: " & encodingName)
    End Sub
End Class

설명

이 생성자는 작은 엔디안 바이트 순서를 사용하는 인스턴스를 만들고 유니코드 바이트 순서 표시를 제공하며 잘못된 인코딩이 검색될 때 예외를 throw하지 않습니다.

Caution

보안상의 이유로 생성자를 호출하고 해당 인수를 />로 설정하여 오류 검색을 사용하도록 설정해야 합니다.

적용 대상

UnicodeEncoding(Boolean, Boolean)

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

UnicodeEncoding 클래스의 새 인스턴스를 초기화합니다. 매개 변수는 big endian 바이트 순서를 사용할지 여부와 메서드가 GetPreamble() 유니코드 바이트 순서 표시를 반환하는지 여부를 지정합니다.

public:
 UnicodeEncoding(bool bigEndian, bool byteOrderMark);

public UnicodeEncoding(bool bigEndian, bool byteOrderMark);

new System.Text.UnicodeEncoding : bool * bool -> System.Text.UnicodeEncoding

Public Sub New (bigEndian As Boolean, byteOrderMark As Boolean)

매개 변수

bigEndian: Boolean

true big endian 바이트 순서(가장 중요한 바이트 먼저)를 사용하거나 false 작은 엔디안 바이트 순서(가장 중요하지 않은 바이트 우선)를 사용하려면

byteOrderMark: Boolean

true 메서드가 GetPreamble() 유니코드 바이트 순서 표시를 반환하도록 지정하려면 이고, false그렇지 않으면 .입니다.

예제

다음 예제에서는 little endian 또는 big endian 바이트 순서 및 유니코드 바이트 순서 표시를 지원할지 여부를 지정하는 새 UnicodeEncoding 인스턴스를 만드는 방법을 보여 줍니다.

using System;
using System.Text;

class UnicodeEncodingExample {
    public static void Main() {

        // Create a UnicodeEncoding without parameters.
        UnicodeEncoding unicode = new UnicodeEncoding();

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianBOM = 
            new UnicodeEncoding(false, true);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianBOM));

        // Create a UnicodeEncoding to support little-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeLittleEndianNoBOM =
            new UnicodeEncoding(false, false);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeLittleEndianNoBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianBOM =
            new UnicodeEncoding(true, true);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianBOM));

        // Create a UnicodeEncoding to support big-endian byte ordering
        // and not include the Unicode byte order mark.
        UnicodeEncoding unicodeBigEndianNoBOM =
            new UnicodeEncoding(true, false);
        // Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicode.Equals(unicodeBigEndianNoBOM));
    }

    public static void DescribeEquivalence(Boolean isEquivalent) {
        Console.WriteLine(
            "{0} equivalent encoding.", (isEquivalent ? "An" : "Not an")
        );
    }
}

Imports System.Text

Class UnicodeEncodingExample
    
    Public Shared Sub Main()

        ' Create a UnicodeEncoding without parameters.
        Dim unicodeDefault As New UnicodeEncoding()

        ' Create a UnicodeEncoding to support little-endian byte ordering
        ' and include the Unicode byte order mark.        
        Dim unicodeLittleEndianBOM As New UnicodeEncoding(False, True)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeLittleEndianBOM))
        
        ' Create a UnicodeEncoding to support little-endian byte ordering
        ' and not include the Unicode byte order mark.
        Dim unicodeLittleEndianNoBOM As New UnicodeEncoding(False, False)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeLittleEndianNoBOM))
        
        ' Create a UnicodeEncoding to support big-endian byte ordering
        ' and include the Unicode byte order mark.
        Dim unicodeBigEndianBOM As New UnicodeEncoding(True, True)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeBigEndianBOM))
        
        ' Create a UnicodeEncoding to support big-endian byte ordering
        ' and not include the Unicode byte order mark.
        Dim unicodeBigEndianNoBOM As New UnicodeEncoding(True, False)
        ' Compare this UnicodeEncoding to the UnicodeEncoding without parameters.
        DescribeEquivalence(unicodeDefault.Equals(unicodeBigEndianNoBOM))
    End Sub
    
    
    Public Shared Sub DescribeEquivalence(isEquivalent As Boolean)
        Dim phrase as String
        If isEquivalent Then
            phrase = "An"
        Else
            phrase = "Not an"
        End If
        Console.WriteLine("{0} equivalent encoding.", phrase)
    End Sub
End Class

설명

이 생성자는 잘못된 인코딩이 검색될 때 예외를 throw하지 않는 인스턴스를 만듭니다.

Caution

보안상의 이유로 생성자를 호출하고 해당 인수를 />로 설정하여 오류 검색을 사용하도록 설정해야 합니다.

매개 변수는 byteOrderMark 메서드의 작업을 제어합니다 GetPreamble . 이 경우 true메서드는 UTF-16 형식으로 BOM(유니코드 바이트 순서 표시)을 포함하는 바이트 배열을 반환합니다. 이 경우 false길이가 0인 바이트 배열을 반환합니다. 그러나 설정 byteOrderMark 으로 true 인해 GetBytes 메서드가 바이트 배열의 시작 부분에 BOM의 접두사를 지정하지 않으며 메서드가 BOM의 바이트 수를 바이트 수에 포함시키지 않습니다 GetByteCount .

추가 정보

GetPreamble()

적용 대상

UnicodeEncoding(Boolean, Boolean, Boolean)

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

Source:: UnicodeEncoding.cs

UnicodeEncoding 클래스의 새 인스턴스를 초기화합니다. 매개 변수는 big endian 바이트 순서를 사용할지 여부, 유니코드 바이트 순서 표시를 제공할지 여부 및 잘못된 인코딩이 검색될 때 예외를 throw할지 여부를 지정합니다.

public:
 UnicodeEncoding(bool bigEndian, bool byteOrderMark, bool throwOnInvalidBytes);

public UnicodeEncoding(bool bigEndian, bool byteOrderMark, bool throwOnInvalidBytes);

new System.Text.UnicodeEncoding : bool * bool * bool -> System.Text.UnicodeEncoding

Public Sub New (bigEndian As Boolean, byteOrderMark As Boolean, throwOnInvalidBytes As Boolean)

매개 변수

bigEndian: Boolean

true big endian 바이트 순서를 사용하려면(가장 중요한 바이트 먼저); false 작은 엔디안 바이트 순서를 사용하려면(가장 중요하지 않은 바이트 먼저).

byteOrderMark: Boolean

true 메서드가 GetPreamble() 유니코드 바이트 순서 표시를 반환하도록 지정하려면 이고, false그렇지 않으면 .입니다.

throwOnInvalidBytes: Boolean

true잘못된 인코딩이 검색될 때 예외가 throw되도록 지정하려면 다음을 실행합니다. 그렇지 않으면 . false

예제

다음 예제에서는 오류 검색을 사용하도록 설정하고 사용하지 않는 동작 UnicodeEncoding을 보여 줍니다.

using System;
using System.Text;

public class SamplesUnicodeEncoding  {

   public static void Main()  {

      // Create an instance of UnicodeEncoding using little-endian byte order.
      // This will be used for encoding.
      UnicodeEncoding u16LE     = new UnicodeEncoding( false, true );

      // Create two instances of UnicodeEncoding using big-endian byte order: one with error detection and one without.
      // These will be used for decoding.
      UnicodeEncoding u16withED = new UnicodeEncoding( true, true, true );
      UnicodeEncoding u16noED   = new UnicodeEncoding( true, true, false );

      // Create byte arrays from the same string containing the following characters:
      //    Latin Small Letter Z (U+007A)
      //    Latin Small Letter A (U+0061)
      //    Combining Breve (U+0306)
      //    Latin Small Letter AE With Acute (U+01FD)
      //    Greek Small Letter Beta (U+03B2)
      //    Latin Capital Letter U with  Diaeresis (U+00DC)
      String myStr = "za\u0306\u01FD\u03B2\u00DC";

      // Encode the string using little-endian byte order.
      byte[] myBytes = new byte[u16LE.GetByteCount( myStr )];
      u16LE.GetBytes( myStr, 0, myStr.Length, myBytes, 0 );

      // Decode the byte array with error detection.
      Console.WriteLine( "Decoding with error detection:" );
      PrintDecodedString( myBytes, u16withED );

      // Decode the byte array without error detection.
      Console.WriteLine( "Decoding without error detection:" );
      PrintDecodedString( myBytes, u16noED );
   }

   // Decode the bytes and display the string.
   public static void PrintDecodedString( byte[] bytes, Encoding enc )  {

      try  {
         Console.WriteLine( "   Decoded string: {0}", enc.GetString( bytes, 0, bytes.Length ) );
      }
      catch ( System.ArgumentException e )  {
         Console.WriteLine( e.ToString() );
      }

      Console.WriteLine();
   }
}

Imports System.Text

Public Class SamplesUnicodeEncoding   

   Public Shared Sub Main()

      ' Create an instance of UnicodeEncoding using little-endian byte order.
      ' This will be used for encoding.
      Dim u16LE As New UnicodeEncoding(False, True)

      ' Create two instances of UnicodeEncoding using big-endian byte order: one with error detection and one without.
      ' These will be used for decoding.
      Dim u16withED As New UnicodeEncoding(True, True, True)
      Dim u16noED As New UnicodeEncoding(True, True, False)

      ' Create byte arrays from the same string containing the following characters:
      '    Latin Small Letter Z (U+007A)
      '    Latin Small Letter A (U+0061)
      '    Combining Breve (U+0306)
      '    Latin Small Letter AE With Acute (U+01FD)
      '    Greek Small Letter Beta (U+03B2)
      '    Latin Capital Letter U with  Diaeresis (U+00DC)
      Dim myStr As String = "za" & ChrW(&H0306) & ChrW(&H01FD) & ChrW(&H03B2) & ChrW(&H00DC)

      ' Encode the string using little-endian byte order.
      Dim myBytes(u16LE.GetByteCount(myStr)) As Byte
      u16LE.GetBytes(myStr, 0, myStr.Length, myBytes, 0)

      ' Decode the byte array with error detection.
      Console.WriteLine("Decoding with error detection:")
      PrintDecodedString(myBytes, u16withED)

      ' Decode the byte array without error detection.
      Console.WriteLine("Decoding without error detection:")
      PrintDecodedString(myBytes, u16noED)

   End Sub


   ' Decode the bytes and display the string.
   Public Shared Sub PrintDecodedString(bytes() As Byte, enc As Encoding)

      Try
         Console.WriteLine("   Decoded string: {0}", enc.GetString(bytes, 0, bytes.Length))
      Catch e As System.ArgumentException
         Console.WriteLine(e.ToString())
      End Try

      Console.WriteLine()

   End Sub

End Class

설명

매개 변수인 throwOnInvalidBytestrue경우 잘못된 바이트 시퀀스를 검색하는 메서드가 throw됩니다 System.ArgumentException. 그렇지 않으면 메서드가 예외를 throw하지 않고 잘못된 시퀀스가 무시됩니다.

Caution

보안상의 이유로 이 생성자를 사용하여 클래스의 UnicodeEncoding 인스턴스를 만들고 다음으로 설정 throwOnInvalidBytes 하여 오류 검색을 true켜야 합니다.

추가 정보

GetPreamble()

적용 대상

피드백

이 페이지가 도움이 되었나요?