UTF7Encoding Clase

Definición

Espacio de nombres:

System.Text

Ensamblado:

mscorlib.dll

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

public ref class UTF7Encoding : System::Text::Encoding

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class UTF7Encoding : System.Text.Encoding

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UTF7Encoding = class
    inherit Encoding

Public Class UTF7Encoding
Inherits Encoding

Herencia

Object

Encoding

UTF7Encoding

Atributos

SerializableAttribute ComVisibleAttribute

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar para UTF7Encoding codificar una cadena de caracteres Unicode y almacenarlos en una matriz de bytes. Observe que cuando la matriz de bytes se descodifica en una cadena, no se pierden 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);
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        ' Create a UTF-7 encoding.
        Dim utf7 As New UTF7Encoding()
        
        ' A Unicode string with two characters outside a 7-bit code range.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside a 7-bit code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte() = utf7.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In  encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
        
        ' Decode bytes back to string.
        ' Notice Pi and Sigma characters are still present.
        Dim decodedString As String = utf7.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class

Comentarios

La codificación 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 caracteres Unicode como secuencias de caracteres ASCII de 7 bits. Esta codificación admite determinados protocolos para los que es necesario, con más frecuencia protocolos de correo electrónico o grupo de noticias. Dado que UTF-7 no es especialmente seguro o robusto, y la mayoría de los sistemas modernos permiten codificaciones de 8 bits, normalmente se debe preferir UTF-8 a UTF-7.

Note

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

Para obtener más información sobre las UDF y otras codificaciones admitidas por System.Text, vea Codificación de caracteres en .NET Framework.

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

Del mismo modo, el GetCharCount método determina cuántos caracteres producen la descodificación de una secuencia de bytes y los GetChars métodos y GetString realizan la descodificación real.

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

Note

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

Constructores

Nombre	Description
UTF7Encoding()	Inicializa una nueva instancia de la clase UTF7Encoding.
UTF7Encoding(Boolean)	Inicializa una nueva instancia de la clase UTF7Encoding. Un parámetro especifica si se permiten caracteres opcionales.

Propiedades

Nombre	Description
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. (Heredado de Encoding)
CodePage	Cuando se reemplaza en una clase derivada, obtiene el identificador de página de códigos del objeto actual Encoding. (Heredado de Encoding)
DecoderFallback	Obtiene o establece el DecoderFallback objeto para el objeto actual Encoding . (Heredado de Encoding)
EncoderFallback	Obtiene o establece el EncoderFallback objeto para el objeto actual Encoding . (Heredado de Encoding)
EncodingName	Cuando se reemplaza en una clase derivada, obtiene la descripción legible de la codificación actual. (Heredado de Encoding)
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. (Heredado de Encoding)
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. (Heredado de Encoding)
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. (Heredado de Encoding)
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. (Heredado de Encoding)
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. (Heredado de Encoding)
IsReadOnly	Cuando se reemplaza en una clase derivada, obtiene un valor que indica si la codificación actual es de solo lectura. (Heredado de Encoding)
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. (Heredado de Encoding)
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. (Heredado de Encoding)
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. (Heredado de Encoding)

Métodos

Nombre	Description
Clone()	Cuando se reemplaza en una clase derivada, crea una copia superficial del objeto actual Encoding . (Heredado de Encoding)
Equals(Object)	Obtiene un valor que indica si el objeto especificado es igual al objeto actual UTF7Encoding .
GetByteCount(Char[], Int32, Int32)	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. (Heredado de Encoding)
GetByteCount(Char*, Int32)	Calcula el número de bytes generados mediante la codificación de un conjunto de caracteres a partir del puntero de caracteres especificado.
GetByteCount(String)	Calcula el número de bytes generados mediante la codificación de los caracteres en el objeto especificado String .
GetBytes(Char[], Int32, Int32, Byte[], Int32)	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. (Heredado de Encoding)
GetBytes(Char[])	Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la matriz de caracteres especificada en una secuencia de bytes. (Heredado de Encoding)
GetBytes(Char*, Int32, Byte*, Int32)	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(String, Int32, Int32, Byte[], Int32)	Codifica un conjunto de caracteres del especificado String en la matriz de bytes especificada.
GetBytes(String)	Cuando se reemplaza en una clase derivada, codifica todos los caracteres de la cadena especificada en una secuencia de bytes. (Heredado de Encoding)
GetCharCount(Byte[], Int32, Int32)	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. (Heredado de Encoding)
GetCharCount(Byte*, Int32)	Calcula el número de caracteres generados por la descodificación de una secuencia de bytes a partir del puntero de bytes especificado.
GetChars(Byte[], Int32, Int32, Char[], Int32)	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. (Heredado de Encoding)
GetChars(Byte[])	Cuando se reemplaza en una clase derivada, descodifica todos los bytes de la matriz de bytes especificada en un conjunto de caracteres. (Heredado de Encoding)
GetChars(Byte*, Int32, Char*, Int32)	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.
GetDecoder()	Obtiene un descodificador que convierte una secuencia codificada UTF-7 de bytes en una secuencia de caracteres Unicode.
GetEncoder()	Obtiene un codificador que convierte una secuencia de caracteres Unicode en una secuencia codificada UTF-7 de bytes.
GetHashCode()	Devuelve el código hash del objeto actual UTF7Encoding .
GetMaxByteCount(Int32)	Calcula el número máximo de bytes producidos al codificar el número especificado de caracteres.
GetMaxCharCount(Int32)	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. (Heredado de Encoding)
GetString(Byte[], Int32, Int32)	Descodifica un intervalo de bytes de una matriz de bytes 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. (Heredado de Encoding)
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. (Heredado de Encoding)
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. (Heredado de Encoding)
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. (Heredado de Encoding)
MemberwiseClone()	Crea una copia superficial del Objectactual. (Heredado de Object)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Consulte también

• Decoder
• Encoder
• Descripción de las codificaciones