UnicodeEncoding.GetEncoder Metod

Definition

Namnområde:

System.Text

Sammansättning:

mscorlib.dll

Hämtar en kodare som konverterar en sekvens med Unicode-tecken till en UTF-16-kodad sekvens med byte.

public:
 override System::Text::Encoder ^ GetEncoder();

[System.Runtime.InteropServices.ComVisible(false)]
public override System.Text.Encoder GetEncoder();

[<System.Runtime.InteropServices.ComVisible(false)>]
override this.GetEncoder : unit -> System.Text.Encoder

Public Overrides Function GetEncoder () As Encoder

Returer

Encoder

Ett Encoder objekt som konverterar en sekvens med Unicode-tecken till en UTF-16-kodad sekvens med byte.

Attribut

ComVisibleAttribute

Exempel

I följande exempel används en kodare och en avkodare för att koda en sträng till en matris med byte och sedan avkoda byteen till en matris med tecken.

using System;
using System.Text;

public class SamplesUnicodeEncoding  {

   public static void Main()  {

      // Get an encoder and a decoder from UnicodeEncoding.
      UnicodeEncoding u16 = new UnicodeEncoding( false, true, true );
      Encoder myEnc = u16.GetEncoder();
      Decoder myDec = u16.GetDecoder();

      // The characters to encode:
      //    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)
      char[] myChars = new char[5] { 'z', 'a', '\u0306', '\u01FD', '\u03B2' };
      Console.Write( "The original characters : " );
      Console.WriteLine( myChars );

      // Encode the character array.
      int iBC  = myEnc.GetByteCount( myChars, 0, myChars.Length, true );
      byte[] myBytes = new byte[iBC];
      myEnc.GetBytes( myChars, 0, myChars.Length, myBytes, 0, true );

      // Print the resulting bytes.
      Console.Write( "Using the encoder       : " );
      for ( int i = 0; i < myBytes.Length; i++ )
         Console.Write( "{0:X2} ", myBytes[i] );
      Console.WriteLine();

      // Decode the byte array back into an array of characters.
      int iCC  = myDec.GetCharCount( myBytes, 0, myBytes.Length, true );
      char[] myDecodedChars = new char[iCC];
      myDec.GetChars( myBytes, 0, myBytes.Length, myDecodedChars, 0, true );

      // Print the resulting characters.
      Console.Write( "Using the decoder       : " );
      Console.WriteLine( myDecodedChars );
   }
}


/* 
This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.

The original characters : za??ß
Using the encoder       : 7A 00 61 00 06 03 FD 01 B2 03
Using the decoder       : za??ß

*/

Imports System.Text

Public Class SamplesUnicodeEncoding   

   Public Shared Sub Main()

      ' Get an encoder and a decoder from UnicodeEncoding.
      Dim u16 As New UnicodeEncoding(False, True, True)
      Dim myEnc As Encoder = u16.GetEncoder()
      Dim myDec As Decoder = u16.GetDecoder()

      ' The characters to encode:
      '    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)
      Dim myChars() As Char = {"z"c, "a"c, ChrW(&H0306), ChrW(&H01FD), ChrW(&H03B2)}
      Console.Write("The original characters : ")
      Console.WriteLine(myChars)

      ' Encode the character array.
      Dim iBC As Integer = myEnc.GetByteCount(myChars, 0, myChars.Length, True)
      ' NOTE: In Visual Basic, arrays contain one extra element by default.
      '       The following line creates an array with the exact number of elements required.
      Dim myBytes(iBC - 1) As Byte
      myEnc.GetBytes(myChars, 0, myChars.Length, myBytes, 0, True)

      ' Print the resulting bytes.
      Console.Write("Using the encoder       : ")
      Dim i As Integer
      For i = 0 To myBytes.Length - 1
         Console.Write("{0:X2} ", myBytes(i))
      Next i
      Console.WriteLine()

      ' Decode the byte array back into an array of characters.
      Dim iCC As Integer = myDec.GetCharCount(myBytes, 0, myBytes.Length, True)
      ' NOTE: In Visual Basic, arrays contain one extra element by default.
      '       The following line creates an array with the exact number of elements required.
      Dim myDecodedChars(iCC - 1) As Char
      myDec.GetChars(myBytes, 0, myBytes.Length, myDecodedChars, 0, True)

      ' Print the resulting characters.
      Console.Write("Using the decoder       : ")
      Console.WriteLine(myDecodedChars)

   End Sub

End Class


'This code produces the following output.  The question marks take the place of characters that cannot be displayed at the console.
'
'The original characters : za??ß
'Using the encoder       : 7A 00 61 00 06 03 FD 01 B2 03
'Using the decoder       : za??ß

Kommentarer

Metoden Encoder.GetBytes konverterar sekventiella teckenblock till sekventiella block med byte på ett sätt som liknar metoden för den GetBytes här klassen. Ett objekt upprätthåller dock Encoder tillståndsinformation mellan anrop så att det korrekt kan koda teckensekvenser som sträcker sig över block. Objektet Encoder bevarar också avslutande tecken i slutet av datablocken och använder de avslutande tecknen i nästa kodningsåtgärd. Ett datablock kan till exempel sluta med en oöverträffad hög surrogat, och den matchande låga surrogaten kan finnas i nästa datablock. GetDecoder Därför och GetEncoder är användbara för nätverksöverföring och filåtgärder, eftersom dessa åtgärder ofta hanterar datablock i stället för en fullständig dataström.

Om felidentifiering är aktiverat, dvs. parametern throwOnInvalidBytes för konstruktorn är inställd på true, aktiveras även felidentifiering i objektet Encoder som returneras av den här metoden. Om felidentifiering är aktiverat och en ogiltig sekvens påträffas är kodarens tillstånd odefinierat och bearbetningen måste stoppas.

Se även

• Encoder
• GetBytes(String, Int32, Int32, Byte[], Int32)
• GetByteCount(Char[], Int32, Int32)
• GetDecoder()
• Förstå kodningar