Encoding Clase

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Runtime.dll

Source:

Encoding.cs

Representa una codificación de caracteres.

public ref class Encoding abstract : ICloneable

public abstract class Encoding : ICloneable

type Encoding = class
    interface ICloneable

Public MustInherit Class Encoding
Implements ICloneable

Herencia

Object

Encoding

Derivado

System.Text.ASCIIEncoding

System.Text.UnicodeEncoding

System.Text.UTF32Encoding

System.Text.UTF7Encoding

System.Text.UTF8Encoding

Implementaciones

ICloneable

Ejemplos

En el ejemplo siguiente se convierte una cadena de una codificación a otra.

Nota

La byte[] matriz es el único tipo de este ejemplo que contiene los datos codificados. Los Char tipos .net y String son Unicode, por lo que la GetChars llamada descodifica los datos de nuevo a Unicode.

using namespace System;
using namespace System::Text;

int main()
{
   String^ unicodeString = "This string contains the unicode character Pi (\u03a0)";
   
   // Create two different encodings.
   Encoding^ ascii = Encoding::ASCII;
   Encoding^ unicode = Encoding::Unicode;
   
   // Convert the string into a byte array.
   array<Byte>^unicodeBytes = unicode->GetBytes( unicodeString );
   
   // Perform the conversion from one encoding to the other.
   array<Byte>^asciiBytes = Encoding::Convert( unicode, ascii, unicodeBytes );
   
   // Convert the new Byte into[] a char and[] then into a string.
   array<Char>^asciiChars = gcnew array<Char>(ascii->GetCharCount( asciiBytes, 0, asciiBytes->Length ));
   ascii->GetChars( asciiBytes, 0, asciiBytes->Length, asciiChars, 0 );
   String^ asciiString = gcnew String( asciiChars );
   
   // Display the strings created before and after the conversion.
   Console::WriteLine( "Original String*: {0}", unicodeString );
   Console::WriteLine( "Ascii converted String*: {0}", asciiString );
}
// The example displays the following output:
//    Original string: This string contains the unicode character Pi (Π)
//    Ascii converted string: This string contains the unicode character Pi (?)

using System;
using System.Text;

class Example
{
   static void Main()
   {
      string unicodeString = "This string contains the unicode character Pi (\u03a0)";

      // Create two different encodings.
      Encoding ascii = Encoding.ASCII;
      Encoding unicode = Encoding.Unicode;

      // Convert the string into a byte array.
      byte[] unicodeBytes = unicode.GetBytes(unicodeString);

      // Perform the conversion from one encoding to the other.
      byte[] asciiBytes = Encoding.Convert(unicode, ascii, unicodeBytes);
         
      // Convert the new byte[] into a char[] and then into a string.
      char[] asciiChars = new char[ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)];
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0);
      string asciiString = new string(asciiChars);

      // Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString);
      Console.WriteLine("Ascii converted string: {0}", asciiString);
   }
}
// The example displays the following output:
//    Original string: This string contains the unicode character Pi (Π)
//    Ascii converted string: This string contains the unicode character Pi (?)

Imports System.Text

Class Example
   Shared Sub Main()
      Dim unicodeString As String = "This string contains the unicode character Pi (" & ChrW(&H03A0) & ")"

      ' Create two different encodings.
      Dim ascii As Encoding = Encoding.ASCII
      Dim unicode As Encoding = Encoding.Unicode

      ' Convert the string into a byte array.
      Dim unicodeBytes As Byte() = unicode.GetBytes(unicodeString)

      ' Perform the conversion from one encoding to the other.
      Dim asciiBytes As Byte() = Encoding.Convert(unicode, ascii, unicodeBytes)

      ' Convert the new byte array into a char array and then into a string.
      Dim asciiChars(ascii.GetCharCount(asciiBytes, 0, asciiBytes.Length)-1) As Char
      ascii.GetChars(asciiBytes, 0, asciiBytes.Length, asciiChars, 0)
      Dim asciiString As New String(asciiChars)

      ' Display the strings created before and after the conversion.
      Console.WriteLine("Original string: {0}", unicodeString)
      Console.WriteLine("Ascii converted string: {0}", asciiString)
   End Sub
End Class
' The example displays the following output:
'    Original string: This string contains the unicode character Pi (Π)
'    Ascii converted string: This string contains the unicode character Pi (?)

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para codificación.

Constructores

Encoding()	Inicializa una nueva instancia de la clase Encoding.
Encoding(Int32)	Inicializa una nueva instancia de la clase Encoding que corresponde a la página de códigos especificada.
Encoding(Int32, EncoderFallback, DecoderFallback)	Inicializa una nueva instancia de la clase Encoding que corresponde a la página de códigos indicada que tiene las estrategias de reserva de codificador y descodificador especificadas.

Propiedades

ASCII	Obtiene una codificación para el juego de caracteres ASCII (de 7 bits).
BigEndianUnicode	Obtiene una codificación para el formato UTF-16 que utiliza el orden de bytes big endian.
BodyName	Cuando se reemplaza en una clase derivada, obtiene un nombre para la codificación actual que se puede utilizar con etiquetas de cuerpo de un programa de correo.
CodePage	Cuando se reemplaza en una clase derivada, obtiene el identificador de la página de códigos de la clase Encoding actual.
DecoderFallback	Obtiene o establece el objeto DecoderFallback para el objeto Encoding actual.
Default	Obtiene la codificación predeterminada para esta implementación de .NET.
EncoderFallback	Obtiene o establece el objeto EncoderFallback para el objeto Encoding actual.
EncodingName	Cuando se reemplaza en una clase derivada, obtiene la descripción inteligible de la codificación actual.
HeaderName	Cuando se reemplaza en una clase derivada, obtiene un nombre para la codificación actual que se puede utilizar con etiquetas de encabezado de un programa de correo.
IsBrowserDisplay	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes del explorador pueden utilizar la codificación actual para mostrar el contenido.
IsBrowserSave	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes del explorador pueden utilizar la codificación actual para guardar el contenido.
IsMailNewsDisplay	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes de correo y de noticias pueden utilizar la codificación actual para mostrar el contenido.
IsMailNewsSave	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes de correo y de noticias pueden utilizar la codificación actual para guardar el contenido.
IsReadOnly	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual es de solo lectura.
IsSingleByte	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual utiliza puntos de código de un solo byte.
Latin1	Obtiene una codificación para el juego de caracteres Latin1 (ISO-8859-1).
Preamble	Cuando se invalida en una clase derivada, devuelve un intervalo que contiene la secuencia de bytes que especifica la codificación utilizada.
Unicode	Obtiene una codificación para el formato UTF-16 utilizando el orden de bytes little endian.
UTF32	Obtiene una codificación para el formato UTF-32 utilizando el orden de bytes little endian.
UTF7	Obsoletos. Obtiene una codificación para el formato UTF-7.
UTF8	Obtiene una codificación para el formato UTF-8.
WebName	Cuando se reemplaza en una clase derivada, obtiene el nombre registrado en IANA (Internet Assigned Numbers Authority) para la codificación actual.
WindowsCodePage	Cuando se reemplaza en una clase derivada, obtiene la página de códigos del sistema operativo Windows que se corresponde mejor con la codificación actual.

Métodos

Clone()	Cuando se reemplaza en una clase derivada, crea una copia superficial del objeto Encoding actual.
Convert(Encoding, Encoding, Byte[])	Convierte una matriz de bytes completa de una codificación a otra.
Convert(Encoding, Encoding, Byte[], Int32, Int32)	Convierte un intervalo de bytes de una matriz de una codificación a otra.
CreateTranscodingStream(Stream, Encoding, Encoding, Boolean)	Crea un elemento Stream que sirve para transcodificar datos entre un elemento Encoding interior y otro Encoding exterior, similar a Convert(Encoding, Encoding, Byte[]).
Equals(Object)	Determina si el objeto Object especificado es igual a la instancia actual.
GetByteCount(Char*, Int32)	Cuando se reemplaza en una clase derivada, calcula el número de bytes que se generan al codificar un juego de caracteres a partir del puntero de caracteres especificado.
GetByteCount(Char[])	Cuando se reemplaza en una clase derivada, calcula el número de bytes que se generan al codificar todos los caracteres de la matriz de caracteres especificada.
GetByteCount(Char[], Int32, Int32)	Cuando se reemplaza en una clase derivada, calcula el número de bytes que se generan al codificar un juego de caracteres de la matriz de caracteres especificada.
GetByteCount(ReadOnlySpan<Char>)	Cuando se invalida en una clase derivada, calcula el número de bytes que se generan al codificar los caracteres del intervalo de caracteres especificado.
GetByteCount(String)	Cuando se reemplaza en una clase derivada, calcula el número de bytes que se generan al codificar los caracteres de la cadena especificada.
GetByteCount(String, Int32, Int32)	Cuando se invalida en una clase derivada, calcula el número de bytes que se generan al codificar un juego de caracteres a partir de la cadena especificada.
GetBytes(Char*, Int32, Byte*, Int32)	Cuando se reemplaza en una clase derivada, codifica un juego de caracteres a partir del puntero de caracteres especificado en una secuencia de bytes que se almacenan a partir del puntero de bytes especificado.
GetBytes(Char[])	Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la matriz de caracteres especificada en una secuencia de bytes.
GetBytes(Char[], Int32, Int32)	Cuando se reemplaza en una clase derivada, codifica un juego de caracteres de la matriz de caracteres especificada en una secuencia de bytes.
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Cuando se reemplaza en una clase derivada, codifica un juego de caracteres de la matriz de caracteres especificada en la matriz de bytes especificada.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Cuando se invalida en una clase derivada, codifica en un intervalo de bytes un juego de caracteres a partir del intervalo de solo lectura especificado.
GetBytes(String)	Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la cadena especificada en una secuencia de bytes.
GetBytes(String, Int32, Int32)	Cuando se invalida en una clase derivada, codifica en una matriz de bytes el número de caracteres especificado por count en la cadena especificada, empezando por el elemento index especificado.
GetBytes(String, Int32, Int32, Byte[], Int32)	Cuando se reemplaza en una clase derivada, codifica un juego de caracteres de la cadena especificada en la matriz de bytes especificada.
GetCharCount(Byte*, Int32)	Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes a partir del puntero de bytes especificado.
GetCharCount(Byte[])	Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar todos los bytes de la matriz de bytes especificada.
GetCharCount(Byte[], Int32, Int32)	Cuando se reemplaza en una clase derivada, calcula el número de caracteres que se generan al descodificar una secuencia de bytes de la matriz de bytes especificada.
GetCharCount(ReadOnlySpan<Byte>)	Cuando se invalida en una clase derivada, calcula el número de caracteres que se generan al descodificar el intervalo de bytes de solo lectura proporcionado.
GetChars(Byte*, Int32, Char*, Int32)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes a partir del puntero de bytes especificado en un juego de caracteres que se almacenan a partir del puntero de caracteres especificado.
GetChars(Byte[])	Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en un juego de caracteres.
GetChars(Byte[], Int32, Int32)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada en un juego de caracteres.
GetChars(Byte[], Int32, Int32, Char[], Int32)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada en la matriz de caracteres especificada.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Cuando se invalida en una clase derivada, descodifica todos los bytes del intervalo de bytes de solo lectura especificado en un intervalo de caracteres.
GetDecoder()	Cuando se reemplaza en una clase derivada, obtiene un descodificador que convierte una secuencia de bytes codificada en una secuencia de caracteres.
GetEncoder()	Cuando se reemplaza en una clase derivada, obtiene un codificador que convierte una secuencia de caracteres Unicode en una secuencia de bytes codificada.
GetEncoding(Int32)	Devuelve la codificación asociada al identificador de página de códigos especificado.
GetEncoding(Int32, EncoderFallback, DecoderFallback)	Devuelve la codificación asociada al identificador de página de códigos especificado. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.
GetEncoding(String)	Devuelve la codificación asociada al nombre especificado de la página de códigos.
GetEncoding(String, EncoderFallback, DecoderFallback)	Devuelve la codificación asociada al nombre especificado de la página de códigos. Los parámetros especifican un controlador de errores para los caracteres que no se pueden codificar y para las secuencias de bytes que no se pueden descodificar.
GetEncodings()	Devuelve una matriz que contiene todas las codificaciones.
GetHashCode()	Devuelve el código hash de la instancia actual.
GetMaxByteCount(Int32)	Cuando se reemplaza en una clase derivada, calcula el número máximo de bytes que se generan al codificar el número de caracteres especificado.
GetMaxCharCount(Int32)	Cuando se reemplaza en una clase derivada, calcula el número máximo de caracteres que se generan al descodificar el número de bytes especificado.
GetPreamble()	Cuando se reemplaza en una clase derivada, devuelve una secuencia de bytes que especifica la codificación utilizada.
GetString(Byte*, Int32)	Cuando se reemplaza en una clase derivada, descodifica un número determinado de bytes a partir de una dirección especificada en una cadena.
GetString(Byte[])	Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en una cadena.
GetString(Byte[], Int32, Int32)	Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada en una cadena.
GetString(ReadOnlySpan<Byte>)	Cuando se invalida en una clase derivada, descodifica todos los bytes del intervalo de bytes especificado en una cadena.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
IsAlwaysNormalized()	Obtiene un valor que indica si la codificación actual siempre se normaliza, utilizando la forma de normalización predeterminada.
IsAlwaysNormalized(NormalizationForm)	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual siempre se normaliza mediante la forma de normalización especificada.
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
RegisterProvider(EncodingProvider)	Registra un proveedor de codificación.
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)
TryGetBytes(ReadOnlySpan<Char>, Span<Byte>, Int32)	Codifica en un intervalo de bytes un conjunto de caracteres del intervalo de solo lectura especificado si el destino es lo suficientemente grande.
TryGetChars(ReadOnlySpan<Byte>, Span<Char>, Int32)	Descodifica en un intervalo de caracteres un conjunto de bytes del intervalo de solo lectura especificado si el destino es lo suficientemente grande.

Métodos de extensión

GetBytes(Encoding, ReadOnlySequence<Char>)	Codifica el elemento ReadOnlySequence<T> especificado en una matriz Byte mediante el elemento Encoding especificado.
GetBytes(Encoding, ReadOnlySequence<Char>, IBufferWriter<Byte>)	Descodifica el elemento ReadOnlySequence<T> especificado en bytes mediante el elemento Encoding especificado y escribe el resultado en writer.
GetBytes(Encoding, ReadOnlySequence<Char>, Span<Byte>)	Codifica el elemento ReadOnlySequence<T> especificado en bytes mediante el elemento Encoding especificado y envía el resultado a bytes.
GetBytes(Encoding, ReadOnlySpan<Char>, IBufferWriter<Byte>)	Codifica el elemento ReadOnlySpan<T> especificado en bytes mediante el elemento Encoding especificado y escribe el resultado en writer.
GetChars(Encoding, ReadOnlySequence<Byte>, IBufferWriter<Char>)	Descodifica el elemento ReadOnlySequence<T> especificado en chars mediante el elemento Encoding especificado y escribe el resultado en writer.
GetChars(Encoding, ReadOnlySequence<Byte>, Span<Char>)	Descodifica el elemento ReadOnlySequence<T> especificado en chars mediante el elemento Encoding especificado y envía el resultado a chars.
GetChars(Encoding, ReadOnlySpan<Byte>, IBufferWriter<Char>)	Descodifica el elemento ReadOnlySpan<T> especificado en chars mediante el elemento Encoding especificado y escribe el resultado en writer.
GetString(Encoding, ReadOnlySequence<Byte>)	Descodifica el elemento ReadOnlySequence<T> especificado en String mediante el elemento Encoding especificado.

Consulte también

• Procedimiento para usar clases de codificación de caracteres en .NET