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

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Инициализирует новый экземпляр класса UnicodeEncoding.

Перегрузки

Имя	Описание
UnicodeEncoding()	Инициализирует новый экземпляр класса UnicodeEncoding.
UnicodeEncoding(Boolean, Boolean)	Инициализирует новый экземпляр класса UnicodeEncoding. Параметры указывают, следует ли использовать порядок байтов больших байтов и возвращает ли GetPreamble() метод знак порядка байтов Юникода.
UnicodeEncoding(Boolean, Boolean, Boolean)	Инициализирует новый экземпляр класса UnicodeEncoding. Параметры указывают, следует ли использовать порядок байтов больших байтов, указывать ли метку порядка байтов Юникода и вызывать ли исключение при обнаружении недопустимой кодировки.

UnicodeEncoding()

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: 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

Этот конструктор создает экземпляр, использующий маленький байтовый порядок байтов, предоставляет знак порядка байтов Юникода и не создает исключение при обнаружении недопустимой кодировки.

Предостережение

По соображениям безопасности следует включить обнаружение ошибок, вызвав UnicodeEncoding(Boolean, Boolean, Boolean) конструктор и задав его throwOnInvalidBytes аргумент true.

Применяется к

UnicodeEncoding(Boolean, Boolean)

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Инициализирует новый экземпляр класса UnicodeEncoding. Параметры указывают, следует ли использовать порядок байтов больших байтов и возвращает ли 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 для использования порядка байтов большого байта (наиболее значимый байт первым) или false для использования небольшого порядка байтов (наименее значимый байт первым).

byteOrderMark: Boolean

true Значение , чтобы указать, что GetPreamble() метод возвращает знак порядка байтов Юникода; в противном случае false.

Примеры

В следующем примере показано, как создать новый 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

Параметр byteOrderMark управляет операцией GetPreamble метода. Если trueметод возвращает массив байтов, содержащий знак порядка байтов Юникода (BOM) в формате UTF-16. Если falseон возвращает массив байтов нулевой длины. Однако параметр byteOrderMark не true приводит GetBytes к префиксу метода BOM в начале массива байтов, а также не приводит GetByteCount к тому, что метод включает число байтов в BOM в число байтов.

См. также раздел

GetPreamble()

Применяется к

UnicodeEncoding(Boolean, Boolean, Boolean)

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Исходный код:: UnicodeEncoding.cs

Инициализирует новый экземпляр класса UnicodeEncoding. Параметры указывают, следует ли использовать порядок байтов больших байтов, указывать ли метку порядка байтов Юникода и вызывать ли исключение при обнаружении недопустимой кодировки.

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 для использования порядка байтов большого байта (наиболее значимый байт в первую очередь); false для использования небольшого порядка байтов байтов (наименее значимый байт первым).

byteOrderMark: Boolean

throwOnInvalidBytes: Boolean

true Значение , чтобы указать, что исключение должно возникать при обнаружении недопустимой кодировки; 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

throwOnInvalidBytes Если параметр имеет значениеtrue, метод, который обнаруживает недопустимую последовательность байтовSystem.ArgumentException. В противном случае метод не создает исключение, а недопустимая последовательность игнорируется.

Предостережение

По соображениям безопасности этот конструктор следует использовать для создания экземпляра UnicodeEncoding класса и включения обнаружения ошибок, установив для throwOnInvalidBytesпараметра значение true .

См. также раздел

GetPreamble()

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

UnicodeEncoding Конструкторы

Определение

Перегрузки

UnicodeEncoding()

Примеры

Комментарии

Применяется к

UnicodeEncoding(Boolean, Boolean)

Параметры

Примеры

Комментарии

См. также раздел

Применяется к

UnicodeEncoding(Boolean, Boolean, Boolean)

Параметры

Примеры

Комментарии

См. также раздел

Применяется к