UTF32Encoding.Preamble Propiedad

Definición

Espacio de nombres:

System.Text

Ensamblado:

System.Text.Encoding.Extensions.dll

Source:

UTF32Encoding.cs

Obtiene una marca de orden de bytes Unicode codificada en formato UTF-32, si este objeto está configurado para proporcionar uno.

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 de propiedad

ReadOnlySpan<Byte>

Intervalo de bytes que contiene la marca de orden de bytes Unicode, si este objeto está configurado para proporcionar uno; de lo contrario, un intervalo predeterminado.

Comentarios

El objeto UTF32Encoding puede proporcionar un preámbulo, que es un intervalo de bytes que se puede prefijar a la secuencia de bytes resultante del proceso de codificación. Anteponer una secuencia de bytes codificados con una marca de orden de bytes (puntos de código U+0000U+FEFF) ayuda al descodificador a determinar el orden de bytes y el formato de transformación, o UTF. La marca de orden de bytes Unicode (BOM) se serializa de la siguiente manera (en hexadecimal):

• Orden de bytes big endian: 00 00 FE FF

• Pequeño orden de bytes endian: FF FE 00 00

Puede crear una instancia de un objeto UTF32Encoding cuya propiedad Preamble es una lista de materiales válida de las maneras siguientes:

• Recuperando el objeto UTF32Encoding devuelto por la propiedad Encoding.UTF32.

• Al llamar al constructor de UTF32Encoding() sin parámetros para crear instancias de un objeto UTF32Encoding.

• Al proporcionar true como valor del argumento byteOrderMark a los constructores UTF32Encoding y UTF32Encoding.

Se recomienda usar la lista de materiales, ya que proporciona casi cierta identificación de una codificación para archivos que, de lo contrario, han perdido una referencia al objeto UTF32Encoding, como datos web no etiquetados o etiquetados incorrectamente, o archivos de texto aleatorios almacenados cuando una empresa no tenía problemas internacionales u otros datos. A menudo, es posible que se eviten problemas de usuario si los datos se etiquetan de forma coherente y correcta.

En el caso de los estándares que proporcionan un tipo de codificación, una boM es algo redundante. Sin embargo, se puede usar para ayudar a un servidor a enviar el encabezado de codificación correcto. Como alternativa, se puede usar como reserva en caso de que se pierda la codificación.

Hay algunas desventajas en el uso de una lista de materiales. Por ejemplo, saber cómo limitar los campos de base de datos que usan una lista de materiales puede ser difícil. La concatenación de archivos también puede ser un problema, por ejemplo, cuando los archivos se combinan de forma que un carácter innecesario pueda acabar en medio de los datos. Sin embargo, a pesar de las pocas desventajas, se recomienda encarecidamente el uso de una lista de materiales.

Para obtener más información sobre el orden de bytes y la marca de orden de bytes, vea El estándar Unicode en la página principal Unicode.

Importante

Para asegurarse de que los bytes codificados están descodificados correctamente, debe prefijar los bytes codificados con un preámbulo. Tenga en cuenta que el método GetBytes no antepone una lista de materiales a una secuencia de bytes codificados; proporcionar una lista de materiales al principio de una secuencia de bytes adecuada es responsabilidad del desarrollador.