UnicodeEncoding Konstruktoren

Definition

Namespace:: System.Text

Assemblys:: mscorlib.dll, System.Text.Encoding.Extensions.dll

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

Assembly:: System.Text.Encoding.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Initialisiert eine neue Instanz der UnicodeEncoding-Klasse.

Überlädt

Name	Beschreibung
UnicodeEncoding()	Initialisiert eine neue Instanz der UnicodeEncoding-Klasse.
UnicodeEncoding(Boolean, Boolean)	Initialisiert eine neue Instanz der UnicodeEncoding-Klasse. Parameter geben an, ob die Groß-End-Bytereihenfolge verwendet werden soll und ob die GetPreamble() Methode ein Unicode-Bytereihenfolgezeichen zurückgibt.
UnicodeEncoding(Boolean, Boolean, Boolean)	Initialisiert eine neue Instanz der UnicodeEncoding-Klasse. Parameter geben an, ob die Big Endian Byte-Reihenfolge verwendet werden soll, ob ein Unicode-Bytereihenfolgezeichen angegeben wird und ob eine Ausnahme ausgelöst werden soll, wenn eine ungültige Codierung erkannt wird.

UnicodeEncoding()

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Initialisiert eine neue Instanz der UnicodeEncoding-Klasse.

public:
 UnicodeEncoding();

public UnicodeEncoding();

Public Sub New ()

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine neue UnicodeEncoding Instanz erstellt und der Name der Codierung angezeigt wird.

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

Hinweise

Dieser Konstruktor erstellt eine Instanz, die die kleine Endian Bytereihenfolge verwendet, ein Unicode-Bytereihenfolgezeichen bereitstellt und keine Ausnahme auslöst, wenn eine ungültige Codierung erkannt wird.

Vorsicht

Aus Sicherheitsgründen sollten Sie die Fehlererkennung aktivieren, indem Sie den UnicodeEncoding(Boolean, Boolean, Boolean) Konstruktor aufrufen und dessen throwOnInvalidBytes Argument auf truefestlegen.

Gilt für:

UnicodeEncoding(Boolean, Boolean)

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Initialisiert eine neue Instanz der UnicodeEncoding-Klasse. Parameter geben an, ob die Groß-End-Bytereihenfolge verwendet werden soll und ob die GetPreamble() Methode ein Unicode-Bytereihenfolgezeichen zurückgibt.

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)

Parameter

bigEndian: Boolean

true um die große Endian byte-Reihenfolge (das wichtigste Byte zuerst) zu verwenden oder false die kleine endische Bytereihenfolge (am wenigsten signifikantes Byte zuerst) zu verwenden.

byteOrderMark: Boolean

trueum anzugeben, dass die GetPreamble() Methode ein Unicode-Bytereihenfolgezeichen zurückgibt; andernfalls . false

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine neue UnicodeEncoding Instanz erstellt wird, die angibt, ob die Sortierung von kleinen endischen oder großen Endenbytes und die Unicode-Bytereihenfolge unterstützt werden soll.

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

Hinweise

Dieser Konstruktor erstellt eine Instanz, die keine Ausnahme auslöst, wenn eine ungültige Codierung erkannt wird.

Vorsicht

Der byteOrderMark Parameter steuert den Vorgang der GetPreamble Methode. Wenn truedie Methode ein Bytearray zurückgibt, das das Unicode-Bytereihenfolgezeichen (BOM) im UTF-16-Format enthält. Wenn false, gibt es ein Bytearray der Länge Null zurück. Die Einstellung byteOrderMark führt true jedoch nicht dazu, dass die GetBytes Methode dem BOM am Anfang des Bytearrays vorangestellt wird, und die Methode auch nicht dazu führt, dass die GetByteCount Methode die Anzahl der Bytes in die BOM in der Byteanzahl einschließt.

Weitere Informationen

GetPreamble()

Gilt für:

UnicodeEncoding(Boolean, Boolean, Boolean)

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Quelle:: UnicodeEncoding.cs

Initialisiert eine neue Instanz der UnicodeEncoding-Klasse. Parameter geben an, ob die Big Endian Byte-Reihenfolge verwendet werden soll, ob ein Unicode-Bytereihenfolgezeichen angegeben wird und ob eine Ausnahme ausgelöst werden soll, wenn eine ungültige Codierung erkannt wird.

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)

Parameter

bigEndian: Boolean

true zur Verwendung der großen Enden-Bytereihenfolge (wichtigstes Byte zuerst); false die kleine Endian Bytereihenfolge (am wenigsten signifikantes Byte zuerst) zu verwenden.

byteOrderMark: Boolean

trueum anzugeben, dass die GetPreamble() Methode ein Unicode-Bytereihenfolgezeichen zurückgibt; andernfalls . false

throwOnInvalidBytes: Boolean

trueum anzugeben, dass eine Ausnahme ausgelöst werden soll, wenn eine ungültige Codierung erkannt wird; andernfalls . false

Beispiele

Das folgende Beispiel zeigt das Verhalten von UnicodeEncoding, sowohl bei aktivierter Fehlererkennung als auch ohne.

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

Hinweise

Wenn der throwOnInvalidBytes Parameter lautet true, wird eine Methode, die eine ungültige System.ArgumentExceptionBytesequenz erkennt, ausgelöst. Andernfalls löst die Methode keine Ausnahme aus, und die ungültige Sequenz wird ignoriert.

Vorsicht

Aus Sicherheitsgründen sollten Sie diesen Konstruktor verwenden, um eine Instanz der UnicodeEncoding Klasse zu erstellen und die Fehlererkennung durch Festlegen throwOnInvalidBytes auf .true

Weitere Informationen

GetPreamble()

Gilt für:

Feedback

War diese Seite hilfreich?