Encoding Clase

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

Representa una codificación de caracteres.

public ref class Encoding abstract
public ref class Encoding abstract : ICloneable
public abstract class Encoding
[System.Serializable]
public abstract class Encoding
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public abstract class Encoding : ICloneable
public abstract class Encoding : ICloneable
type Encoding = class
[<System.Serializable>]
type Encoding = class
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Encoding = class
    interface ICloneable
type Encoding = class
    interface ICloneable
Public MustInherit Class Encoding
Public MustInherit Class Encoding
Implements ICloneable
Herencia
Object
Encoding
Derivado
Atributos
SerializableAttribute ComVisibleAttribute
Implementaciones
ICloneable

Ejemplos

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

Note

La byte[] matriz es el único tipo de este ejemplo que contiene los datos codificados. Los tipos /> y .NET descodifica los datos en Unicode.

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 api para codificación.

Constructores

Nombre Description
Encoding()

Inicializa una nueva instancia de la clase Encoding.
Encoding(Int32, EncoderFallback, DecoderFallback)

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

Inicializa una nueva instancia de la Encoding clase que corresponde a la página de códigos especificada.

Propiedades

Nombre Description
ASCII

Obtiene una codificación para el juego de caracteres ASCII (7 bits).
BigEndianUnicode

Obtiene una codificación para el formato UTF-16 que usa 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 usar con etiquetas de cuerpo del agente de correo.
CodePage

Cuando se reemplaza en una clase derivada, obtiene el identificador de página de códigos del objeto actual Encoding.
DecoderFallback

Obtiene o establece el DecoderFallback objeto para el objeto actual Encoding .
Default

Obtiene la codificación predeterminada para esta implementación de .NET.
EncoderFallback

Obtiene o establece el EncoderFallback objeto para el objeto actual Encoding .
EncodingName

Cuando se reemplaza en una clase derivada, obtiene la descripción legible de la codificación actual.
HeaderName

Cuando se reemplaza en una clase derivada, obtiene un nombre para la codificación actual que se puede usar con etiquetas de encabezado del agente de correo.
IsBrowserDisplay

Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes del explorador pueden usar la codificación actual para mostrar contenido.
IsBrowserSave

Cuando se reemplaza en una clase derivada, obtiene un valor que indica si los clientes del explorador pueden usar la codificación actual para guardar contenido.
IsMailNewsDisplay

Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual se puede usar por correo y clientes de noticias para mostrar contenido.
IsMailNewsSave

Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual se puede usar por correo y clientes de noticias para guardar 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 usa puntos de código de un solo byte.
Preamble

Cuando se reemplaza en una clase derivada, devuelve un intervalo que contiene la secuencia de bytes que especifica la codificación usada.
Unicode

Obtiene una codificación para el formato UTF-16 mediante el orden de bytes little endian.
UTF32

Obtiene una codificación para el formato UTF-32 mediante el orden de bytes little endian.
UTF7

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 con la Entidad de números asignados a Internet (IANA) 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 más estrechamente con la codificación actual.

Métodos

Nombre Description
Clone()

Cuando se reemplaza en una clase derivada, crea una copia superficial del objeto actual Encoding .
Convert(Encoding, Encoding, Byte[], Int32, Int32)

Convierte un intervalo de bytes en una matriz de bytes de una codificación a otra.
Convert(Encoding, Encoding, Byte[])

Convierte una matriz de bytes completa de una codificación a otra.
Equals(Object)

Determina si el especificado Object es igual a la instancia actual.
GetByteCount(Char[], Int32, Int32)

Cuando se reemplaza en una clase derivada, calcula el número de bytes generados mediante la codificación de un conjunto de caracteres de la matriz de caracteres especificada.
GetByteCount(Char[])

Cuando se invalida en una clase derivada, calcula el número de bytes generados mediante la codificación de todos los caracteres de la matriz de caracteres especificada.
GetByteCount(Char*, Int32)

Cuando se reemplaza en una clase derivada, calcula el número de bytes generados mediante la codificación de un conjunto de caracteres que comienza en el puntero de caracteres especificado.
GetByteCount(ReadOnlySpan<Char>)

Cuando se reemplaza en una clase derivada, calcula el número de bytes generados mediante la codificación de los caracteres en el intervalo de caracteres especificado.
GetByteCount(String, Int32, Int32)

Cuando se reemplaza en una clase derivada, calcula el número de bytes generados mediante la codificación de un conjunto de caracteres de la cadena especificada.
GetByteCount(String)

Cuando se reemplaza en una clase derivada, calcula el número de bytes generados mediante la codificación de los caracteres de la cadena especificada.
GetBytes(Char[], Int32, Int32, Byte[], Int32)

Cuando se reemplaza en una clase derivada, codifica un conjunto de caracteres de la matriz de caracteres especificada en la matriz de bytes especificada.
GetBytes(Char[], Int32, Int32)

Cuando se reemplaza en una clase derivada, codifica un conjunto de caracteres de la matriz de caracteres especificada en una secuencia de bytes.
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, Byte*, Int32)

Cuando se reemplaza en una clase derivada, codifica un conjunto 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(ReadOnlySpan<Char>, Span<Byte>)

Cuando se reemplaza en una clase derivada, codifica en un intervalo de bytes un conjunto de caracteres del intervalo de solo lectura especificado.
GetBytes(String, Int32, Int32, Byte[], Int32)

Cuando se reemplaza en una clase derivada, codifica un conjunto de caracteres de la cadena especificada en la matriz de bytes especificada.
GetBytes(String, Int32, Int32)

Cuando se reemplaza en una clase derivada, codifica en una matriz de bytes el número de caracteres especificado por en la cadena especificada, empezando por count el especificado index.
GetBytes(String)

Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la cadena especificada en una secuencia de bytes.
GetCharCount(Byte[], Int32, Int32)

Cuando se reemplaza en una clase derivada, calcula el número de caracteres generados al descodificar una secuencia de bytes de la matriz de bytes especificada.
GetCharCount(Byte[])

Cuando se reemplaza en una clase derivada, calcula el número de caracteres generados al descodificar todos los bytes de la matriz de bytes especificada.
GetCharCount(Byte*, Int32)

Cuando se reemplaza en una clase derivada, calcula el número de caracteres producidos al descodificar una secuencia de bytes a partir del puntero de bytes especificado.
GetCharCount(ReadOnlySpan<Byte>)

Cuando se reemplaza en una clase derivada, calcula el número de caracteres generados al descodificar el intervalo de bytes de solo lectura proporcionado.
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(Byte[], Int32, Int32)

Cuando se reemplaza en una clase derivada, descodifica una secuencia de bytes de la matriz de bytes especificada en un conjunto de caracteres.
GetChars(Byte[])

Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en un conjunto de caracteres.
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 conjunto de caracteres que se almacenan a partir del puntero de caracteres especificado.
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 codificada de bytes 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 codificada de bytes.
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 caracteres que no se pueden codificar y secuencias de bytes que no se pueden descodificar.
GetEncoding(Int32)

Devuelve la codificación asociada al identificador de página de códigos especificado.
GetEncoding(String, EncoderFallback, DecoderFallback)

Devuelve la codificación asociada al nombre de página de códigos especificado. Los parámetros especifican un controlador de errores para caracteres que no se pueden codificar y secuencias de bytes que no se pueden descodificar.
GetEncoding(String)

Devuelve la codificación asociada al nombre de página de códigos especificado.
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 generados mediante la codificación del número especificado de caracteres.
GetMaxCharCount(Int32)

Cuando se reemplaza en una clase derivada, calcula el número máximo de caracteres producidos al descodificar el número especificado de bytes.
GetPreamble()

Cuando se reemplaza en una clase derivada, devuelve una secuencia de bytes que especifica la codificación usada.
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(Byte[])

Cuando se invalida en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en una cadena.
GetString(Byte*, Int32)

Cuando se reemplaza en una clase derivada, descodifica un número especificado de bytes a partir de una dirección especificada en una cadena.
GetString(ReadOnlySpan<Byte>)

Cuando se reemplaza 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 mediante el formulario de normalización predeterminado.
IsAlwaysNormalized(NormalizationForm)

Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual siempre se normaliza mediante el formulario de normalización especificado.
MemberwiseClone()

Crea una copia superficial del Objectactual.

(Heredado de Object)
RegisterProvider(EncodingProvider)

Registra un proveedor de codificación.
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también