Encoding.UTF8 Eigenschaft

public:
 static property System::Text::Encoding ^ UTF8 { System::Text::Encoding ^ get(); };

public static System.Text.Encoding UTF8 { get; }

static member UTF8 : System.Text.Encoding

Public Shared ReadOnly Property UTF8 As Encoding

Eigenschaftswert

Eine Codierung für das UTF-8-Format.

Beispiele

Im folgenden Beispiel wird ein Array definiert, das aus den folgenden Zeichen besteht:

• KLEINER LATEINISCHER BUCHSTABE Z (U+007A)

• KLEINER LATEINISCHER BUCHSTABE A (U+0061)

• KOMBINIEREN VON BREVE (U+0306)

• KLEINER LATEINISCHER BUCHSTABE AE MIT AKUT (U+01FD)

• GRIECHISCHER KLEINER BUCHSTABE BETA (U+03B2)

• Ein Ersatzpaar (U+D800 U+DD54), das GRIECHISCHE ACROPHONIC ATTIC ONE THOUSAND STATERS (U+10154) bildet.

Es zeigt die UTF-16-Codeeinheiten jedes Zeichens an und bestimmt die Anzahl der Bytes, die von einem UTF-8-Encoder zum Codieren des Zeichenarrays erforderlich sind. Anschließend werden die Zeichen codiert und die resultierenden UTF-8-codierten Bytes angezeigt.

using System;
using System.Text;

public class Example
{
   public static void Main()  
   {
      // Create a character array.
      string gkNumber = Char.ConvertFromUtf32(0x10154);
      char[] chars = new char[] { 'z', 'a', '\u0306', '\u01FD', '\u03B2', 
                                  gkNumber[0], gkNumber[1] };

      // Get UTF-8 and UTF-16 encoders.
      Encoding utf8 = Encoding.UTF8;
      Encoding utf16 = Encoding.Unicode;
      
      // Display the original characters' code units.
      Console.WriteLine("Original UTF-16 code units:");
      byte[] utf16Bytes = utf16.GetBytes(chars);
      foreach (var utf16Byte in utf16Bytes)
         Console.Write("{0:X2} ", utf16Byte);
      Console.WriteLine();
         
      // Display the number of bytes required to encode the array.
      int reqBytes  = utf8.GetByteCount(chars);
      Console.WriteLine("\nExact number of bytes required: {0}", 
                    reqBytes);

      // Display the maximum byte count.
      int maxBytes = utf8.GetMaxByteCount(chars.Length);
      Console.WriteLine("Maximum number of bytes required: {0}\n", 
                        maxBytes);

      // Encode the array of chars.
      byte[] utf8Bytes = utf8.GetBytes(chars);

      // Display all the UTF-8-encoded bytes.
      Console.WriteLine("UTF-8-encoded code units:");
      foreach (var utf8Byte in utf8Bytes)
         Console.Write("{0:X2} ", utf8Byte);
      Console.WriteLine();
   }
}
// The example displays the following output:
//       Original UTF-16 code units:
//       7A 00 61 00 06 03 FD 01 B2 03 00 D8 54 DD
//       
//       Exact number of bytes required: 12
//       Maximum number of bytes required: 24
//       
//       UTF-8-encoded code units:
//       7A 61 CC 86 C7 BD CE B2 F0 90 85 94

Imports System.Text

Public Module Example
   Public Sub Main()
      ' Create a character array.
      Dim gkNumber As String = Char.ConvertFromUtf32(&h10154)
      Dim chars() As Char = {"z"c, "a"c, ChrW(&H0306), ChrW(&H01FD), 
                             ChrW(&H03B2), gkNumber(0), gkNumber(1) }
 
      ' Get UTF-8 and UTF-16 encoders.
      Dim utf8 As Encoding = Encoding.UTF8
      Dim utf16 As Encoding = Encoding.Unicode

      ' Display the original characters' code units.
      Console.WriteLine("Original UTF-16 code units:")
      Dim utf16Bytes() As Byte = utf16.GetBytes(chars)
      For Each utf16Byte In utf16Bytes
         Console.Write("{0:X2} ", utf16Byte)
      Next
      Console.WriteLine()

      Console.WriteLine()
      ' Display the number of bytes required to encode the array.
      Dim reqBytes As Integer = utf8.GetByteCount(chars)
      Console.WriteLine("Exact number of bytes required: {0}", 
                        reqBytes)

      ' Display the maximum byte count.
      Dim maxBytes As Integer = utf8.GetMaxByteCount(chars.Length)
      Console.WriteLine("Maximum number of bytes required: {0}", 
                        maxBytes)
      Console.WriteLine()
      
      ' Encode the array of characters.
      Dim utf8Bytes() As Byte = utf8.GetBytes(chars)

      ' Display all the UTF-8-encoded bytes.
      Console.WriteLine("UTF-8-encoded code units:")
      For Each utf8Byte In utf8Bytes
         Console.Write("{0:X2} ", utf8Byte)
      Next
      Console.WriteLine()
   End Sub 
End Module 
' The example displays the following output:
'    Original UTF-16 code units:
'    7A 00 61 00 06 03 FD 01 B2 03 00 D8 54 DD
'    
'    Exact number of bytes required: 12
'    Maximum number of bytes required: 24
'    
'    UTF-8-encoded code units:
'    7A 61 CC 86 C7 BD CE B2 F0 90 85 94

Hinweise

Diese Eigenschaft gibt ein UTF8Encoding Objekt zurück, das Unicode-Zeichen (UTF-16-codiert) in eine Sequenz von 1 bis vier Bytes pro Zeichen codiert und ein UTF-8-codiertes Bytearray mit Unicode-Zeichen (UTF-16-codiert) decodiert. Informationen zu den zeichencodierungen, die von .NET unterstützt werden und welche Unicode-Codierung verwendet werden soll, finden Sie unter Character Encoding in .NET.

Das UTF8Encoding von dieser Eigenschaft zurückgegebene Objekt weist möglicherweise nicht das entsprechende Verhalten für Ihre App auf.

• Es gibt ein UTF8Encoding Objekt zurück, das ein Unicode-Bytereihenfolgezeichen (BOM) bereitstellt. Rufen Sie eine Überladung des UTF8Encoding Konstruktors auf, um eine UTF8-Codierung zu instanziieren, die keine BOM bereitstellt.

• Es gibt ein UTF8Encoding Objekt zurück, das ersatzfallback verwendet, um jede Zeichenfolge zu ersetzen, die nicht codiert werden kann, und jedes Byte, das nicht mit einem Fragezeichen ("?") decodiert werden kann. Stattdessen können Sie den UTF8Encoding.UTF8Encoding(Boolean, Boolean) Konstruktor aufrufen, um ein UTF8Encoding Objekt zu instanziieren, dessen Fallback entweder ein EncoderFallbackException oder ein DecoderFallbackExceptionist, wie das folgende Beispiel veranschaulicht.

  using System;
  using System.Text;
  
  public class Example
  {
     public static void Main()
     {
        Encoding enc = new UTF8Encoding(true, true);
        string value = "\u00C4 \uD802\u0033 \u00AE"; 
  
        try {
           byte[] bytes= enc.GetBytes(value);
           foreach (var byt in bytes)
              Console.Write("{0:X2} ", byt);
           Console.WriteLine();
  
           string value2 = enc.GetString(bytes);
           Console.WriteLine(value2);
        }
        catch (EncoderFallbackException e) {
           Console.WriteLine("Unable to encode {0} at index {1}", 
                             e.IsUnknownSurrogate() ? 
                                String.Format("U+{0:X4} U+{1:X4}", 
                                              Convert.ToUInt16(e.CharUnknownHigh),
                                              Convert.ToUInt16(e.CharUnknownLow)) :
                                String.Format("U+{0:X4}", 
                                              Convert.ToUInt16(e.CharUnknown)),
                             e.Index);
        }                     
     }
  }
  // The example displays the following output:
  //        Unable to encode U+D802 at index 2
  

  Imports System.Text
  
  Module Example
     Public Sub Main()
        Dim enc As Encoding = New UTF8Encoding(True, True)
        Dim value As String = String.Format("{0} {1}{2} {3}", 
                              ChrW(&h00C4), ChrW(&hD802), ChrW(&h0033), ChrW(&h00AE))
        
        Try
           Dim bytes() As Byte = enc.GetBytes(value)
           For Each byt As Byte In bytes
              Console.Write("{0:X2} ", byt)
           Next       
           Console.WriteLine()
           Dim value2 As String = enc.GetString(bytes)
           Console.WriteLine(value2)
        Catch e As EncoderFallbackException
           Console.WriteLine("Unable to encode {0} at index {1}", 
                             If(e.IsUnknownSurrogate(), 
                                String.Format("U+{0:X4} U+{1:X4}", 
                                              Convert.ToUInt16(e.CharUnknownHigh),
                                              Convert.ToUInt16(e.CharUnknownLow)),
                                String.Format("U+{0:X4}", 
                                              Convert.ToUInt16(e.CharUnknown))),
                             e.Index)
        End Try
     End Sub
  End Module
  ' The example displays the following output:
  '       Unable to encode U+D802 at index 2
  

Weitere Informationen

• UTF8Encoding
• GetEncoding(Int32)
• Verwenden von Zeichencodierungsklassen in .NET