UTF7Encoding Classe

Definição

Espaço de Nomes:: System.Text

Assemblagens:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Assemblagem:: mscorlib.dll

Assemblagem:: System.Text.Encoding.Extensions.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Representa uma codificação UTF-7 de caracteres Unicode.

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

public class UTF7Encoding : System.Text.Encoding

[System.Serializable]
public class UTF7Encoding : System.Text.Encoding

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

type UTF7Encoding = class
    inherit Encoding

[<System.Serializable>]
type UTF7Encoding = class
    inherit Encoding

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

Public Class UTF7Encoding
Inherits Encoding

Herança: Object

Encoding
UTF7Encoding

Atributos: SerializableAttribute ComVisibleAttribute

Exemplos

O seguinte exemplo de código demonstra como usar a UTF7Encoding para codificar uma cadeia de caracteres Unicode e armazená-los num array de bytes. Note que, quando o array de bytes é decodificado de volta para uma string, nenhum dado é perdido.

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

Observações

A codificação é o processo de transformar um conjunto de caracteres Unicode em uma sequência de bytes. A descodificação é o processo de transformar uma sequência de bytes codificados num conjunto de caracteres Unicode.

A codificação UTF-7 representa caracteres Unicode como sequências de caracteres ASCII de 7 bits. Esta codificação suporta certos protocolos para os quais é necessária, mais frequentemente protocolos de email ou de newsgroups. Como o UTF-7 não é particularmente seguro ou robusto, e a maioria dos sistemas modernos permite codificações de 8 bits, normalmente o UTF-8 deve ser preferido ao UTF-7.

Note

UTF7Encoding não fornece deteção de erros. Por razões de segurança, a aplicação deve usar UTF8Encoding, UnicodeEncoding, ou UTF32Encoding e ativar a deteção de erros.

Para mais informações sobre as UTFs e outras codificações suportadas por System.Text, consulte Codificação de Caracteres no Framework .NET.

O GetByteCount método determina quantos bytes resultam na codificação de um conjunto de caracteres Unicode, e o GetBytes método executa a codificação propriamente dita.

Da mesma forma, o GetCharCount método determina quantos caracteres resultam na decodificação de uma sequência de bytes, e os GetChars métodos e GetString executam a decodificação propriamente dita.

UTF7Encoding corresponde à página de código Windows 65000.

Note

O estado de um objeto codificado em UTF-7 não é preservado se o objeto for serializado e desserializado usando diferentes versões do .NET Framework.

Construtores

Name	Description
UTF7Encoding()	Inicializa uma nova instância da UTF7Encoding classe.
UTF7Encoding(Boolean)	Inicializa uma nova instância da UTF7Encoding classe. Um parâmetro especifica se deve permitir caracteres opcionais.

Propriedades

Name	Description
BodyName	Quando sobrescrito numa classe derivada, obtém um nome para a codificação atual que pode ser usada com as tags do corpo do agente de correio. (Herdado de Encoding)
CodePage	Quando sobrescrito numa classe derivada, obtém o identificador da página de código do atual Encoding. (Herdado de Encoding)
DecoderFallback	Obtém ou define o DecoderFallback objeto para o objeto atual Encoding . (Herdado de Encoding)
EncoderFallback	Obtém ou define o EncoderFallback objeto para o objeto atual Encoding . (Herdado de Encoding)
EncodingName	Quando sobrescrito numa classe derivada, obtém a descrição legível por humanos da codificação atual. (Herdado de Encoding)
HeaderName	Quando sobrescrito numa classe derivada, obtém um nome para a codificação atual que pode ser usado com etiquetas de cabeçalho de agente de correio. (Herdado de Encoding)
IsBrowserDisplay	Quando sobrescrito numa classe derivada, obtém um valor que indica se a codificação atual pode ser usada pelos clientes do navegador para exibir conteúdo. (Herdado de Encoding)
IsBrowserSave	Quando é sobreposto numa classe derivada, obtém um valor que indica se a codificação atual pode ser usada pelos clientes de navegador para guardar conteúdo. (Herdado de Encoding)
IsMailNewsDisplay	Quando é sobreposto numa classe derivada, obtém um valor que indica se a codificação atual pode ser usada por clientes de email e notícias para exibir conteúdo. (Herdado de Encoding)
IsMailNewsSave	Quando é sobreposto numa classe derivada, obtém um valor que indica se a codificação atual pode ser usada por clientes de email e notícias para guardar conteúdo. (Herdado de Encoding)
IsReadOnly	Quando é sobreposto numa classe derivada, obtém um valor que indica se a codificação atual é apenas de leitura. (Herdado de Encoding)
IsSingleByte	Quando sobrescrito numa classe derivada, obtém um valor que indica se a codificação atual utiliza pontos de código de um byte. (Herdado de Encoding)
Preamble	Quando sobrescrito numa classe derivada, devolve um span contendo a sequência de bytes que especifica a codificação utilizada. (Herdado de Encoding)
WebName	Quando é sobreposto numa classe derivada, o nome é registado junto da Internet Assigned Numbers Authority (IANA) para a codificação atual. (Herdado de Encoding)
WindowsCodePage	Quando sobrescrito numa classe derivada, obtém a página de código do sistema operativo Windows que mais corresponde à codificação atual. (Herdado de Encoding)

Métodos

Name	Description
Clone()	Quando sobreposta numa classe derivada, cria-se uma cópia superficial do objeto atual Encoding . (Herdado de Encoding)
Equals(Object)	Obtém um valor que indica se o objeto especificado é igual ao objeto atual UTF7Encoding .
Equals(Object)	Determina se o especificado Object é igual à instância atual. (Herdado de Encoding)
GetByteCount(Char[], Int32, Int32)	Calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir do array de caracteres especificado.
GetByteCount(Char[])	Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos ao codificar todos os caracteres do array de caracteres especificado. (Herdado de Encoding)
GetByteCount(Char*, Int32)	Calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir do ponteiro especificado.
GetByteCount(ReadOnlySpan<Char>)	Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos pela codificação dos caracteres no intervalo de caracteres especificado. (Herdado de Encoding)
GetByteCount(String, Int32, Int32)	Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos ao codificar um conjunto de caracteres a partir da cadeia especificada. (Herdado de Encoding)
GetByteCount(String)	Calcula o número de bytes produzidos ao codificar os caracteres no objeto especificado String .
GetByteCount(String)	Quando sobrescrito numa classe derivada, calcula o número de bytes produzidos pela codificação dos caracteres na cadeia especificada. (Herdado de Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Codifica um conjunto de caracteres do array de caracteres especificado no array de bytes especificado.
GetBytes(Char[], Int32, Int32)	Quando sobrescrito numa classe derivada, codifica um conjunto de caracteres do array de caracteres especificado numa sequência de bytes. (Herdado de Encoding)
GetBytes(Char[])	Quando sobrescrito numa classe derivada, codifica todos os caracteres do array de caracteres especificado numa sequência de bytes. (Herdado de Encoding)
GetBytes(Char, Int32, Byte, Int32)	Codifica um conjunto de caracteres a partir do ponteiro especificado numa sequência de bytes que são armazenados a partir do ponteiro especificado.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Quando sobrescrito numa classe derivada, codifica num espaço de bytes um conjunto de caracteres do intervalo de apenas leitura especificado. (Herdado de Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Codifica um conjunto de caracteres do especificado String para o array de bytes especificado.
GetBytes(String, Int32, Int32, Byte[], Int32)	Quando sobrescrito numa classe derivada, codifica um conjunto de caracteres da cadeia especificada para o array de bytes especificado. (Herdado de Encoding)
GetBytes(String, Int32, Int32)	Quando sobrescrito numa classe derivada, codifica num array de bytes o número de caracteres especificados por `count` na cadeia especificada, começando a partir do especificado `index`. (Herdado de Encoding)
GetBytes(String)	Quando sobrescrito numa classe derivada, codifica todos os caracteres da cadeia especificada numa sequência de bytes. (Herdado de Encoding)
GetCharCount(Byte[], Int32, Int32)	Calcula o número de caracteres produzidos ao descodificar uma sequência de bytes a partir do array de bytes especificado.
GetCharCount(Byte[])	Quando sobrescrito numa classe derivada, calcula o número de caracteres produzidos pela decodificação de todos os bytes no array de bytes especificado. (Herdado de Encoding)
GetCharCount(Byte*, Int32)	Calcula o número de caracteres produzidos ao descodificar uma sequência de bytes a partir do ponteiro de bytes especificado.
GetCharCount(ReadOnlySpan<Byte>)	Quando sobrescrito numa classe derivada, calcula o número de caracteres produzidos ao descodificar o intervalo de bytes de apenas leitura fornecido. (Herdado de Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Descodifica uma sequência de bytes do array de bytes especificado para o array de caracteres especificado.
GetChars(Byte[], Int32, Int32)	Quando sobrescrito numa classe derivada, decodifica uma sequência de bytes do array de bytes especificado num conjunto de caracteres. (Herdado de Encoding)
GetChars(Byte[])	Quando sobrescrito numa classe derivada, descodifica todos os bytes do array de bytes especificado num conjunto de caracteres. (Herdado de Encoding)
GetChars(Byte, Int32, Char, Int32)	Decodifica uma sequência de bytes a partir do ponteiro de byte especificado num conjunto de caracteres que são armazenados a partir do ponteiro especificado.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Quando sobrescrito numa classe derivada, decodifica todos os bytes do intervalo de bytes especificado para apenas leitura num espaço de caracteres. (Herdado de Encoding)
GetDecoder()	Obtém um descodificador que converte uma sequência de bytes codificada em UTF-7 numa sequência de caracteres Unicode.
GetEncoder()	Obtém um codificador que converte uma sequência de caracteres Unicode numa sequência de bytes codificada em UTF-7.
GetHashCode()	Devolve o código hash do objeto atual UTF7Encoding .
GetHashCode()	Devolve o código hash da instância atual. (Herdado de Encoding)
GetMaxByteCount(Int32)	Calcula o número máximo de bytes produzidos codificando o número especificado de caracteres.
GetMaxCharCount(Int32)	Calcula o número máximo de caracteres produzidos ao descodificar o número especificado de bytes.
GetPreamble()	Quando sobrescrito numa classe derivada, devolve uma sequência de bytes que especifica a codificação utilizada. (Herdado de Encoding)
GetString(Byte[], Int32, Int32)	Descodifica um intervalo de bytes de um array de bytes para uma cadeia.
GetString(Byte[], Int32, Int32)	Quando sobrescrito numa classe derivada, decodifica uma sequência de bytes do array de bytes especificado numa cadeia. (Herdado de Encoding)
GetString(Byte[])	Quando sobrescrito numa classe derivada, decodifica todos os bytes do array de bytes especificado numa string. (Herdado de Encoding)
GetString(Byte*, Int32)	Quando é sobreposto numa classe derivada, decodifica um número especificado de bytes começando num endereço especificado numa cadeia. (Herdado de Encoding)
GetString(ReadOnlySpan<Byte>)	Quando sobrescrito numa classe derivada, decodifica todos os bytes do intervalo de bytes especificado numa string. (Herdado de Encoding)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsAlwaysNormalized()	Recebe um valor que indica se a codificação atual está sempre normalizada, usando a forma de normalização por defeito. (Herdado de Encoding)
IsAlwaysNormalized(NormalizationForm)	Quando sobrescrito numa classe derivada, obtém um valor que indica se a codificação atual está sempre normalizada, usando a forma de normalização especificada. (Herdado de Encoding)
MemberwiseClone()	Cria uma cópia superficial do atual Object. (Herdado de Object)
ToString()	Devolve uma cadeia que representa o objeto atual. (Herdado de Object)

Aplica-se a

Ver também

Comentários

Esta página foi útil?