Encoding.UTF8 Propiedad

Definición

Espacio de nombres:: System.Text

Ensamblados:: mscorlib.dll, System.Text.Encoding.dll

Ensamblado:: mscorlib.dll

Ensamblado:: System.Text.Encoding.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Obtiene una codificación para el formato UTF-8.

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

Valor de propiedad

Encoding

Codificación para el formato UTF-8.

Ejemplos

En el ejemplo siguiente se define una matriz que consta de los siguientes caracteres:

LETRA PEQUEÑA LATINA Z (U+007A)
LETRA PEQUEÑA LATINA A (U+0061)
COMBINAR BREVE (U+0306)
AE DE LETRA PEQUEÑA LATINA CON AGUDO (U+01FD)
LETRA PEQUEÑA GRIEGA BETA (U+03B2)
Un par suplente (U+D800 U+DD54) que forma GRIEGO ACROPHONIC ATTIC ONE THOUSAND STATERS (U+10154).

Muestra las unidades de código UTF-16 de cada carácter y determina el número de bytes requeridos por un codificador UTF-8 para codificar la matriz de caracteres. A continuación, codifica los caracteres y muestra los bytes codificados UTF-8 resultantes.

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

Comentarios

Esta propiedad devuelve un UTF8Encoding objeto que codifica caracteres Unicode (codificados con UTF-16) en una secuencia de uno a cuatro bytes por carácter, y que descodifica una matriz de bytes con codificación UTF-8 en caracteres Unicode (UTF-16-codificados). Para obtener información sobre las codificaciones de caracteres admitidas por .NET y una explicación de la codificación Unicode que se va a usar, vea Character Encoding in .NET.

Es posible que el UTF8Encoding objeto devuelto por esta propiedad no tenga el comportamiento adecuado para la aplicación.

Devuelve un objeto que proporciona una UTF8Encoding marca de orden de bytes Unicode (BOM). Para crear una instancia de una codificación UTF8 que no proporciona una lista de materiales, llame a ninguna sobrecarga del UTF8Encoding constructor.

Devuelve un UTF8Encoding objeto que usa la reserva de reemplazo para reemplazar cada cadena que no puede codificar y cada byte que no se puede descodificar con un carácter de signo de interrogación ("?"). En su lugar, puede llamar al UTF8Encoding.UTF8Encoding(Boolean, Boolean) constructor para crear una instancia de un UTF8Encoding objeto cuya reserva sea o EncoderFallbackException , DecoderFallbackExceptioncomo se muestra en el ejemplo siguiente.

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

Se aplica a

Consulte también

Comentarios

¿Le ha resultado útil esta página?