Esta documentación está archivada y no tiene mantenimiento.

UTF7Encoding (Clase)

Actualización: noviembre 2007

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

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

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class UTF7Encoding : Encoding
/** @attribute SerializableAttribute */ 
/** @attribute ComVisibleAttribute(true) */
public class UTF7Encoding extends Encoding
public class UTF7Encoding extends Encoding

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.

La codificación UTF-7 representa los caracteres Unicode como secuencias de caracteres ASCII de 7 bits. Esta codificación admite ciertos protocolos para los que es necesario, normalmente los protocolos de correo electrónico o de grupos de noticias. Como UTF-7 no es particularmente seguro o robusto, se debería preferir UTF-8 antes que UTF-7.

xt103dh3.alert_note(es-es,VS.90).gifNota:

UTF7Encoding no proporciona detección de errores. Por razones de seguridad, se debe usar UTF8Encoding, UnicodeEncodingo UTF32Encoding en la aplicación y habilitar la detección de errores.

Para obtener más información sobre UFT y otras codificaciones que System.Text admite, vea Introducción a las codificaciones y Utilizar codificación Unicode.

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.

UTF7Encoding corresponde a la página de códigos 65000 de Windows.

xt103dh3.alert_note(es-es,VS.90).gifNota:

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

En el ejemplo de código siguiente se muestra la forma de utilizar UTF7Encoding para codificar una cadena de caracteres Unicode y guardarlos en una matriz de bytes. Tenga en cuenta que cuando se descodifica la matriz de bytes y se convierte nuevamente en una cadena, no hay pérdida de datos.

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        // Create a UTF-7 encoding.
        UTF7Encoding utf7 = new UTF7Encoding();

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

        // Encode the string.
        Byte[] encodedBytes = utf7.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 = utf7.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}


import System.*;
import System.Text.*;

class UTF7EncodingExample
{
    public static void main(String[] args)
    {
        // Create a UTF-7 encoding.
        UTF7Encoding utf7 = new UTF7Encoding();

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

        // Encode the string.
        ubyte encodedBytes[] = utf7.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        for(int iCtr = 0; iCtr < encodedBytes.length; iCtr++) {
            ubyte b = encodedBytes[iCtr];
            Console.Write("[{0}]", String.valueOf(b));
        }
        Console.WriteLine();

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


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.

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC, Xbox 360

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.

.NET Framework

Compatible con: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 3.5, 2.0, 1.0

XNA Framework

Compatible con: 2.0, 1.0
Mostrar: