UnicodeEncoding Konstruktory

Definice

Obor názvů:

System.Text

Sestavení:

netstandard.dll, System.Text.Encoding.Extensions.dll

Inicializuje novou instanci UnicodeEncoding třídy.

Přetížení

Name	Description
UnicodeEncoding()	Inicializuje novou instanci UnicodeEncoding třídy.
UnicodeEncoding(Boolean, Boolean)	Inicializuje novou instanci UnicodeEncoding třídy. Parametry určují, zda se má použít pořadí velkých bajtů endian a zda GetPreamble() metoda vrací znak pořadí bajtů Unicode.
UnicodeEncoding(Boolean, Boolean, Boolean)	Inicializuje novou instanci UnicodeEncoding třídy. Parametry určují, jestli se má použít pořadí velkých bajtů endianu, zda má být zadán znak pořadí bajtů Unicode a zda má být vyvolána výjimka při zjištění neplatného kódování.

UnicodeEncoding()

Zdroj:

UnicodeEncoding.cs

Inicializuje novou instanci UnicodeEncoding třídy.

public:
 UnicodeEncoding();

public UnicodeEncoding();

Public Sub New ()

Příklady

Následující příklad ukazuje, jak vytvořit novou UnicodeEncoding instanci a zobrazit název kódování.

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

Poznámky

Tento konstruktor vytvoří instanci, která používá malé endian bajtové pořadí, poskytuje znak pořadí bajtů Unicode a nevyvolá výjimku při zjištění neplatného kódování.

Caution

Zbezpečnostních UnicodeEncoding(Boolean, Boolean, Boolean)throwOnInvalidBytestrue

UnicodeEncoding(Boolean, Boolean)

Zdroj:

UnicodeEncoding.cs

Inicializuje novou instanci UnicodeEncoding třídy. Parametry určují, zda se má použít pořadí velkých bajtů endian a zda GetPreamble() metoda vrací znak pořadí bajtů Unicode.

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)

Parametry

bigEndian

Boolean

true použít velké endian bajt pořadí (nejvýznamnější bajt první), nebo false použít malé endian bajt pořadí (nejméně významný bajt první).

byteOrderMark

Boolean

true chcete-li určit, že GetPreamble() metoda vrátí znak pořadí bajtů Unicode; jinak , false.

Příklady

Následující příklad ukazuje, jak vytvořit novou UnicodeEncoding instanci určující, zda podporovat malé endian nebo big endian pořadí bajtů a znak pořadí bajtů Unicode.

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

Poznámky

Tento konstruktor vytvoří instanci, která nevyvolá výjimku při zjištění neplatného kódování.

Caution

Zbezpečnostních UnicodeEncoding(Boolean, Boolean, Boolean)throwOnInvalidBytestrue

Parametr byteOrderMark řídí operaci GetPreamble metody. Pokud truemetoda vrátí pole bajtů obsahující znak pořadí bajtů Unicode (BOM) ve formátu UTF-16. Pokud falsevrátí bajtovou matici nulové délky. Nastavení byteOrderMarktrue tak však nezpůsobí GetBytes , aby metoda předpona kusovníku na začátku pole bajtů, ani nezpůsobí GetByteCount , že metoda zahrne počet bajtů do kusovníku v počtu bajtů.

Viz také

• GetPreamble()

UnicodeEncoding(Boolean, Boolean, Boolean)

Zdroj:

UnicodeEncoding.cs

Inicializuje novou instanci UnicodeEncoding třídy. Parametry určují, jestli se má použít pořadí velkých bajtů endianu, zda má být zadán znak pořadí bajtů Unicode a zda má být vyvolána výjimka při zjištění neplatného kódování.

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)

Parametry

bigEndian

Boolean

true použít velké endian bajt pořadí (nejvýznamnější bajt první); false použít malé endian bajt pořadí (nejméně významný bajt první).

byteOrderMark

Boolean

true chcete-li určit, že GetPreamble() metoda vrátí znak pořadí bajtů Unicode; jinak , false.

throwOnInvalidBytes

Boolean

truek určení, že při zjištění neplatného kódování by měla být vyvolána výjimka; v opačném případě . false

Příklady

Následující příklad ukazuje chování , jak s povolenou UnicodeEncodingdetekcí chyb, tak bez.

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

Poznámky

Parametr byteOrderMark řídí operaci GetPreamble metody. Pokud truemetoda vrátí pole bajtů obsahující znak pořadí bajtů Unicode (BOM) ve formátu UTF-16. Pokud falsevrátí bajtovou matici nulové délky. Nastavení byteOrderMarktrue tak však nezpůsobí GetBytes , aby metoda předpona kusovníku na začátku pole bajtů, ani nezpůsobí GetByteCount , že metoda zahrne počet bajtů do kusovníku v počtu bajtů.

throwOnInvalidBytes Pokud je trueparametr , metoda, která zjistí neplatnou bajtovou sekvenci vyvolá System.ArgumentException. V opačném případě metoda nevyvolá výjimku a neplatná sekvence je ignorována.

Caution

Z bezpečnostních důvodů byste měli pomocí tohoto konstruktoru UnicodeEncoding vytvořit instanci třídy a zapnout detekci chyb nastavením throwOnInvalidBytes na true.

Viz také

• GetPreamble()