UTF32Encoding.Preamble Propriedade

Definição

Namespace:

System.Text

Assembly:

System.Text.Encoding.Extensions.dll

Origem:

UTF32Encoding.cs

Obtém uma marca de ordem de bytes Unicode codificada no formato UTF-32, se esse objeto estiver configurado para fornecer um.

public:
 virtual property ReadOnlySpan<System::Byte> Preamble { ReadOnlySpan<System::Byte> get(); };

public override ReadOnlySpan<byte> Preamble { get; }

member this.Preamble : ReadOnlySpan<byte>

Public Overrides ReadOnly Property Preamble As ReadOnlySpan(Of Byte)

Valor da propriedade

ReadOnlySpan<Byte>

Um intervalo de bytes que contém a marca de ordem de bytes Unicode, se esse objeto estiver configurado para fornecer um; caso contrário, um intervalo padrão.

Comentários

O objeto UTF32Encoding pode fornecer um preâmbulo, que é um intervalo de bytes que pode ser prefixado na sequência de bytes resultantes do processo de codificação. A pré-criação de uma sequência de bytes codificados com uma marca de ordem de bytes (pontos de código U+0000U+FEFF) ajuda o decodificador a determinar a ordem de bytes e o formato de transformação ou UTF. A marca de ordem de bytes Unicode (BOM) é serializada da seguinte maneira (em hexadecimal):

• Ordem de bytes big endian: 00 00 FE FF

• Ordem de byte de endian pequeno: FF FE 00 00

Você pode criar uma instância de um objeto UTF32Encoding cuja propriedade Preamble é uma BOM válida das seguintes maneiras:

• Recuperando o objeto UTF32Encoding retornado pela propriedade Encoding.UTF32.

• Chamando o construtor UTF32Encoding() sem parâmetros para instanciar um objeto UTF32Encoding.

• Fornecendo true como o valor do argumento byteOrderMark para os construtores UTF32Encoding e UTF32Encoding.

Recomendamos que você use o BOM, pois ele fornece quase certa identificação de uma codificação para arquivos que, de outra forma, perderam uma referência ao objeto UTF32Encoding, como dados da Web marcados incorretamente ou não marcados, ou arquivos de texto aleatórios armazenados quando uma empresa não tinha preocupações internacionais ou outros dados. Muitas vezes, os problemas do usuário podem ser evitados se os dados forem marcados de forma consistente e correta.

Para padrões que fornecem um tipo de codificação, um BOM é um pouco redundante. No entanto, ele pode ser usado para ajudar um servidor a enviar o cabeçalho de codificação correto. Como alternativa, ele pode ser usado como um fallback caso a codificação seja perdida de outra forma.

Há algumas desvantagens em usar um BOM. Por exemplo, saber como limitar os campos de banco de dados que usam um BOM pode ser difícil. A concatenação de arquivos também pode ser um problema, por exemplo, quando os arquivos são mesclados de forma que um caractere desnecessário possa acabar no meio dos dados. Apesar das poucas desvantagens, no entanto, o uso de um BOM é altamente recomendado.

Para obter mais informações sobre a ordem de byte e a marca de ordem de bytes, consulte o Padrão Unicode na página inicial do Unicode.

Importante

Para garantir que os bytes codificados sejam decodificados corretamente, você deve prefixar bytes codificados com um preâmbulo. Observe que o método GetBytes não anexa um BOM a uma sequência de bytes codificados; fornecer um BOM no início de um fluxo de bytes apropriado é responsabilidade do desenvolvedor.