UnicodeEncoding Konstruktorer

Definition

Namnområde:: System.Text

Sammansättningar:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Sammansättning:: mscorlib.dll

Sammansättning:: System.Text.Encoding.Extensions.dll

Sammansättning:: netstandard.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Initierar en ny instans av UnicodeEncoding klassen.

Överlagringar

Name	Description
UnicodeEncoding()	Initierar en ny instans av UnicodeEncoding klassen.
UnicodeEncoding(Boolean, Boolean)	Initierar en ny instans av UnicodeEncoding klassen. Parametrar anger om du vill använda den stora slutpunktsbyteordningen GetPreamble() och om metoden returnerar ett Unicode-byteordningsmärke.
UnicodeEncoding(Boolean, Boolean, Boolean)	Initierar en ny instans av UnicodeEncoding klassen. Parametrar anger om du vill använda den stora slutpunktsbyteordningen, om du vill ange ett Unicode-byteordningsmärke och om ett undantag ska utlösas när en ogiltig kodning identifieras.

UnicodeEncoding()

Initierar en ny instans av UnicodeEncoding klassen.

public:
 UnicodeEncoding();

public UnicodeEncoding();

Public Sub New ()

Exempel

I följande exempel visas hur du skapar en ny UnicodeEncoding instans och visar namnet på kodningen.

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

Kommentarer

Den här konstruktorn skapar en instans som använder den lilla endianska byteordningen, ger ett Unicode-byteordningsmärke och inte utlöser ett undantag när en ogiltig kodning identifieras.

Caution

Av säkerhetsskäl bör du aktivera felidentifiering genom att anropa UnicodeEncoding(Boolean, Boolean, Boolean) konstruktorn och ange argumentet throwOnInvalidBytes till true.

Gäller för

UnicodeEncoding(Boolean, Boolean)

Initierar en ny instans av UnicodeEncoding klassen. Parametrar anger om du vill använda den stora slutpunktsbyteordningen GetPreamble() och om metoden returnerar ett Unicode-byteordningsmärke.

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)

Parametrar

bigEndian: Boolean

true för att använda den stora endianska byteordningen (mest betydande byte först) eller false för att använda den lilla endianska byteordningen (minst betydande byte först).

byteOrderMark: Boolean

true för att ange att GetPreamble() metoden returnerar en Unicode-byteordningsmarkering, falseannars .

Exempel

I följande exempel visas hur du skapar en ny UnicodeEncoding instans som anger om du vill ha stöd för lite endiansk eller stor endiansk byteordning och Unicode-byteordningsmarkeringen.

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

Kommentarer

Den här konstruktorn skapar en instans som inte utlöser ett undantag när en ogiltig kodning identifieras.

Caution

Av säkerhetsskäl bör du aktivera felidentifiering genom att anropa UnicodeEncoding(Boolean, Boolean, Boolean) konstruktorn och ange argumentet throwOnInvalidBytes till true.

Parametern byteOrderMark styr metodens GetPreamble funktion. Om truereturnerar metoden en bytematris som innehåller Unicode byte order mark (BOM) i UTF-16-format. Om falsereturnerar den en bytematris med noll längd. Om du anger byteOrderMark till true gör GetBytes det dock inte att metoden prefixar bommen i början av bytematrisen, och det gör GetByteCount inte heller att metoden inkluderar antalet byte i strukturlistan i byteantalet.

Se även

GetPreamble()

Gäller för

UnicodeEncoding(Boolean, Boolean, Boolean)

Initierar en ny instans av UnicodeEncoding klassen. Parametrar anger om du vill använda den stora slutpunktsbyteordningen, om du vill ange ett Unicode-byteordningsmärke och om ett undantag ska utlösas när en ogiltig kodning identifieras.

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)

Parametrar

bigEndian: Boolean

true för att använda den stora endianska byteordningen (mest betydande byte först); false för att använda den lilla endianska byteordningen (minst betydande byte först).

byteOrderMark: Boolean

true för att ange att GetPreamble() metoden returnerar en Unicode-byteordningsmarkering, falseannars .

throwOnInvalidBytes: Boolean

trueför att ange att ett undantag ska genereras när en ogiltig kodning identifieras. annars . false

Exempel

I följande exempel visas beteendet UnicodeEncodingför , både med felidentifiering aktiverat och utan.

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

Kommentarer

Om parametern throwOnInvalidBytes är true, genererar System.ArgumentExceptionen metod som identifierar en ogiltig bytesekvens . I annat fall utlöser inte metoden något undantag och den ogiltiga sekvensen ignoreras.

Caution

Av säkerhetsskäl bör du använda den här konstruktorn för att skapa en instans av UnicodeEncoding klassen och aktivera felidentifiering genom att ange throwOnInvalidBytes till true.

Se även

GetPreamble()

Gäller för

Feedback

Var den här sidan till hjälp?