Encoding.Preamble Özellik

  • Başvuru

Tanım

Ad Alanı:
System.Text
Bütünleştirilmiş Kod:
System.Runtime.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
Encoding.cs
Kaynak:
Encoding.cs
Kaynak:
Encoding.cs

Türetilmiş bir sınıfta geçersiz kılındığında, kullanılan kodlamayı belirten bayt dizisini içeren bir span döndürür.

public:
 virtual property ReadOnlySpan<System::Byte> Preamble { ReadOnlySpan<System::Byte> get(); };
public virtual ReadOnlySpan<byte> Preamble { get; }
member this.Preamble : ReadOnlySpan<byte>
Public Overridable ReadOnly Property Preamble As ReadOnlySpan(Of Byte)

Özellik Değeri

ReadOnlySpan<Byte>

Kullanılan kodlamayı belirten bayt dizisini içeren bayt aralığı veya önceden hazır bilgi gerekli değilse sıfır uzunluklu bir yayılma alanı.

Açıklamalar

İsteğe bağlı olarak, Encoding nesnesi kodlama işleminden kaynaklanan baytlara ön ek olarak eklenebilen bir bayt dizisi olan bir ön bilgi sağlar. Ön cihaz bayt sırası işareti içeriyorsa (Unicode'da, kod noktası U+FEFF'de), kod çözücüye bayt sırasını ve dönüştürme biçimini veya UTF'yi belirlemesine yardımcı olur.

Unicode bayt sırası işareti (BOM) aşağıdaki gibi serileştirilir (onaltılık olarak):

  • UTF-8: EF BB BF

  • UTF-16 büyük endian bayt siparişi: FE FF

  • UTF-16 küçük endian bayt sırası: FF FE

  • UTF-32 büyük endian bayt siparişi: 00 00 FE FF

  • UTF-32 küçük endian bayt siparişi: FF FE 00 00

Ürün reçetesini kullanmanız gerekir çünkü nesneye başvuru Encoding kaybı olan dosyalar için kodlamanın neredeyse belirli bir tanımlamasını sağlar; örneğin, etiketlenmemiş veya yanlış etiketlenmiş web verileri ya da bir işletmenin uluslararası endişeleri veya diğer verileri olmadığında depolanan rastgele metin dosyaları. Genellikle veriler tutarlı ve düzgün etiketlenmişse (tercihen UTF-8 veya UTF-16'da) kullanıcı sorunlarından kaçınılabilir.

Kodlama türü sağlayan standartlar için BOM biraz yedeklidir. Ancak, bir sunucunun doğru kodlama üst bilgisini göndermesine yardımcı olmak için kullanılabilir. Alternatif olarak, kodlamanın aksi takdirde kaybolması durumunda geri dönüş olarak kullanılabilir.

Ürün reçetesi kullanmanın bazı dezavantajları vardır. Örneğin, ürün reçetesi kullanan veritabanı alanlarının nasıl sınırlandığını bilmek zor olabilir. Dosyaların birleştirilmesi de sorun olabilir, örneğin, dosyalar gereksiz bir karakter verilerin ortasında olacak şekilde birleştirildiğinde. Ancak birkaç dezavantaja rağmen bom kullanılması kesinlikle önerilir.

Bayt sırası ve bayt sırası işareti hakkında daha fazla bilgi için, Unicode giriş sayfasındaki Unicode Standardı'na bakın.

Dikkat

Kodlanmış baytların kodunun düzgün bir şekilde çözülmesini sağlamak için kodlanmış baytlara ön ek olarak bir ön ek oluşturmanız gerekir. Ancak, çoğu kodlama bir ön derleme sağlamaz. Kodlanmış baytların kodunun düzgün bir şekilde çözüldiğinden emin olmak için, bir Unicode kodlaması UTF8EncodingUnicodeEncoding( , veya UTF32Encoding) ve bir ön derleme kullanmanız gerekir.

Şunlara uygulanır