Exportar (0) Imprimir
Expandir todo
Este artículo proviene de un motor de traducción automática. Mueva el puntero sobre las frases del artículo para ver el texto original. Más información.
Traducción
Original

UTF8Encoding (Clase)

Representa una codificación UTF-8 de caracteres Unicode.

Espacio de nombres:  System.Text
Ensamblado:  mscorlib (en mscorlib.dll)

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class UTF8Encoding : Encoding

El tipo UTF8Encoding expone los siguientes miembros.

  NombreDescripción
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsUTF8Encoding()Inicializa una nueva instancia de la clase UTF8Encoding.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsUTF8Encoding(Boolean)Inicializa una nueva instancia de la clase UTF8Encoding. Un parámetro especifica si se proporciona una marca de orden de bytes Unicode.
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsUTF8Encoding(Boolean, Boolean)Inicializa una nueva instancia de la clase UTF8Encoding. Algunos parámetros especifican si se proporciona una marca de orden de bytes Unicode y si debe producirse una excepción cuando se detecta una codificación no válida.
Arriba

  NombreDescripción
Propiedad públicaBodyNameCuando 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. (Se hereda de Encoding).
Propiedad públicaCompatible con XNA FrameworkCodePageCuando se reemplaza en una clase derivada, obtiene el identificador de página de códigos de la clase Encoding actual. (Se hereda de Encoding).
Propiedad públicaDecoderFallbackObtiene o establece el objeto DecoderFallback para el objeto Encoding actual. (Se hereda de Encoding).
Propiedad públicaEncoderFallbackObtiene o establece el objeto EncoderFallback para el objeto Encoding actual. (Se hereda de Encoding).
Propiedad públicaEncodingNameCuando se reemplaza en una clase derivada, obtiene la descripción inteligible de la codificación actual. (Se hereda de Encoding).
Propiedad públicaHeaderNameCuando 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. (Se hereda de Encoding).
Propiedad públicaIsBrowserDisplayCuando 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. (Se hereda de Encoding).
Propiedad públicaIsBrowserSaveCuando 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. (Se hereda de Encoding).
Propiedad públicaIsMailNewsDisplayCuando 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. (Se hereda de Encoding).
Propiedad públicaIsMailNewsSaveCuando 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. (Se hereda de Encoding).
Propiedad públicaIsReadOnlyCuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual es de sólo lectura. (Se hereda de Encoding).
Propiedad públicaIsSingleByteCuando 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. (Se hereda de Encoding).
Propiedad públicaCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsWebNameCuando se reemplaza en una clase derivada, obtiene el nombre registrado en IANA (Internet Assigned Numbers Authority) para la codificación actual. (Se hereda de Encoding).
Propiedad públicaWindowsCodePageCuando 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. (Se hereda de Encoding).
Arriba

  NombreDescripción
Método públicoCompatible con XNA FrameworkCloneCuando se reemplaza en una clase derivada, crea una copia superficial del objeto Encoding actual. (Se hereda de Encoding).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsEqualsDetermina si el Object especificado es igual al objeto UTF8Encoding actual. (Invalida a Encoding.Equals(Object)).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsFinalize Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de ser reclamado por la recolección de elementos no utilizados. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetByteCount(Char[])Cuando se reemplaza en una clase derivada, calcula el número de bytes generados al codificar todos los caracteres de la matriz de caracteres especificada. (Se hereda de Encoding).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetByteCount(String)Calcula el número de bytes generado al codificar los caracteres del objeto String especificado. (Invalida a Encoding.GetByteCount(String)).
Método públicoGetByteCount(Char*, Int32)Calcula el número de bytes generado mediante la codificación de un conjunto de caracteres a partir del puntero de caracteres especificado. (Invalida a Encoding.GetByteCount(Char*, Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetByteCount(Char[], Int32, Int32)Calcula el número de bytes generado mediante la codificación de un juego de caracteres de la matriz de caracteres especificada. (Invalida a Encoding.GetByteCount(Char[], Int32, Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetBytes(Char[])Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la matriz de caracteres especificada en una secuencia de bytes. (Se hereda de Encoding).
Método públicoCompatible con XNA FrameworkGetBytes(String)Cuando se invalida en una clase derivada, codifica todos los caracteres de la cadena especificada en una secuencia de bytes. (Se hereda de Encoding).

En XNA Framework, este miembro está invalidado por GetBytes(String).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetBytes(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. (Se hereda de Encoding).
Método públicoGetBytes(Char*, Int32, Byte*, Int32)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. (Invalida a Encoding.GetBytes(Char*, Int32, Byte*, Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetBytes(Char[], Int32, Int32, Byte[], Int32)Codifica un juego de caracteres de la matriz de caracteres determinada en la matriz de bytes especificada. (Invalida a Encoding.GetBytes(Char[], Int32, Int32, Byte[], Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetBytes(String, Int32, Int32, Byte[], Int32)Codifica un juego de caracteres del objeto String especificado en la matriz de bytes especificada. (Invalida a Encoding.GetBytes(String, Int32, Int32, Byte[], Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetCharCount(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. (Se hereda de Encoding).
Método públicoGetCharCount(Byte*, Int32)Calcula el número de caracteres generado descodificando una secuencia de bytes a partir del puntero de byte especificado. (Invalida a Encoding.GetCharCount(Byte*, Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetCharCount(Byte[], Int32, Int32)Calcula el número de caracteres generado mediante la descodificación de una secuencia de bytes a partir de la matriz de bytes especificada. (Invalida a Encoding.GetCharCount(Byte[], Int32, Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetChars(Byte[])Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en un juego de caracteres. (Se hereda de Encoding).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetChars(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. (Se hereda de Encoding).
Método públicoGetChars(Byte*, Int32, Char*, Int32)Descodifica una secuencia de bytes a partir del puntero de byte especificado en un conjunto de caracteres que se almacenan a partir del puntero de carácter especificado. (Invalida a Encoding.GetChars(Byte*, Int32, Char*, Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetChars(Byte[], Int32, Int32, Char[], Int32)Descodifica una secuencia de bytes de la matriz de bytes especificada en la matriz de caracteres especificada. (Invalida a Encoding.GetChars(Byte[], Int32, Int32, Char[], Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetDecoderObtiene un descodificador que convierte una secuencia de bytes codificada en UTF-8 en una secuencia de caracteres Unicode. (Invalida a Encoding.GetDecoder()).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetEncoderObtiene un codificador que convierte una secuencia de caracteres Unicode en una secuencia de bytes codificada en UTF-8. (Invalida a Encoding.GetEncoder()).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetHashCodeDevuelve el código hash de la instancia actual. (Invalida a Encoding.GetHashCode()).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetMaxByteCountCalcula el número máximo de bytes generado mediante la codificación del número de caracteres especificado. (Invalida a Encoding.GetMaxByteCount(Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetMaxCharCountCalcula el número máximo de caracteres generado mediante la descodificación del número de bytes especificado. (Invalida a Encoding.GetMaxCharCount(Int32)).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetPreambleDevuelve una marca de orden de bytes Unicode codificada en formato UTF-8 si el constructor empleado para esta instancia solicita una marca de orden de bytes. (Invalida a Encoding.GetPreamble()).
Método públicoGetString(Byte[])Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en una cadena. (Se hereda de Encoding).
Método públicoCompatible con XNA FrameworkGetString(Byte[], Int32, Int32)Descodifica un intervalo de bytes de una matriz de bytes en una cadena. (Invalida a Encoding.GetString(Byte[], Int32, Int32)).

En XNA Framework 3.0, este miembro se hereda de Encoding.GetString(Byte[], Int32, Int32).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsGetType Obtiene el Type de la instancia actual. (Se hereda de Object).
Método públicoIsAlwaysNormalized()Obtiene un valor que indica si la codificación actual siempre se normaliza, utilizando la forma de normalización predeterminada. (Se hereda de Encoding).
Método públicoIsAlwaysNormalized(NormalizationForm)Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual siempre se normaliza, utilizando la forma de normalización especificada. (Se hereda de Encoding).
Método protegidoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsMemberwiseClone Crea una copia superficial del Object actual. (Se hereda de Object).
Método públicoCompatible con XNA FrameworkCompatible con Biblioteca de clases portableCompatible con .NET para aplicaciones de la Tienda WindowsToString Retorna una cadena que representa al objeto actual. (Se hereda de Object).
Arriba

Codificar es el proceso de transformar un conjunto de caracteres Unicode en una secuencia de bytes. La descodificación es el proceso de transformar una secuencia de bytes codificados en un conjunto de caracteres Unicode.

UTF-8 es la codificación Unicode que representa cada punto de código como una secuencia de uno a cuatro bytes. Para obtener más información sobre UTF y otras codificaciones admitidos por System.Text, vea Codificación de caracteres en .NET Framework.

El método GetByteCount determina cuántos bytes resultan de codificar un conjunto de caracteres Unicode, y el método GetBytes realiza la codificación real.

Igualmente, el método GetCharCount determina el número de caracteres resultante en la descodificación de una secuencia de bytes, y los métodos GetChars y GetString realizan la descodificación real.

UTF8Encoding corresponde a la página de códigos 65001 de Windows.

El codificador puede usar el orden de bytes big-endian (primero el byte más significativo) o el orden de bytes little-endian (primero el byte menos significativo). Generalmente es más eficaz almacenar caracteres Unicode utilizando el orden de bytes nativo. Por ejemplo, es mejor usar el orden de bytes little-endian en plataformas little-endian, como los equipos Intel.

Opcionalmente, la clase UTF8Encoding proporciona un preámbulo que es una matriz de bytes que se puede anteponer a la secuencia de bytes resultante del proceso de codificación. Si el preámbulo contiene una marca de orden de bytes (BOM), ayudará al descodificador a determinar el orden de bytes y el formato de la transformación o UTF. El método GetPreamble recupera una matriz de bytes que pueden incluir BOM. Para obtener más información sobre el orden de bytes y la marca de orden de bytes, vea The Unicode Standard en Unicode home page

NotaNota

Para habilitar la detección de errores y hacer que la instancia de clase sea más segura, debe usar en la aplicación el constructor UTF8Encoding que toma un parámetro throwOnInvalidBytes y establecer ese parámetro en true. Con la detección de errores, un método que detecte una secuencia de caracteres o de bytes no válida produce una excepción ArgumentException. Sin la detección de errores, no se producirá excepción alguna y, por lo general, se omitirá la secuencia no válida.

NotaNota

El estado de un objeto UTF-8 codificado no se conserva si el objeto se serializa y se deserializa utilizando distintas versiones de .NET Framework.

En el siguiente ejemplo se muestra la forma de utilizar una clase UTF8Encoding para codificar una cadena de caracteres Unicode y guardarlos en una matriz de bytes. Advierta que cuando encodedBytes se vuelve a descodificar y se convierte en cadena no hay pérdida de datos.


using System;
using System.Text;

class UTF8EncodingExample {
    public static void Main() {
        // Create a UTF-8 encoding.
        UTF8Encoding utf8 = new UTF8Encoding();

        // A Unicode string with two characters outside an 8-bit code range.
        String unicodeString =
            "This unicode string contains two characters " +
            "with codes outside an 8-bit code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = utf8.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();

        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = utf8.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}


.NET Framework

Compatible con: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Compatible con: 4, 3.5 SP1

Biblioteca de clases portable

Compatible con: Biblioteca de clases portable

.NET para aplicaciones de la Tienda Windows

Compatible con: Windows 8

.NET para aplicaciones de Windows Phone

Compatible con: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (no se admite el rol Server Core), Windows Server 2008 R2 (se admite el rol Server Core con SP1 o versiones posteriores; no se admite Itanium)

.NET Framework no admite todas las versiones de todas las plataformas. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Adiciones de comunidad

AGREGAR
Mostrar:
© 2015 Microsoft