XmlWriter.WriteSurrogateCharEntity(Char, Char) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Türetilmiş bir sınıfta geçersiz kılındığında, vekil karakter çifti için vekil karakter varlığını oluşturur ve yazar.
public:
abstract void WriteSurrogateCharEntity(char lowChar, char highChar);
public abstract void WriteSurrogateCharEntity (char lowChar, char highChar);
abstract member WriteSurrogateCharEntity : char * char -> unit
Public MustOverride Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)
Parametreler
- lowChar
- Char
Düşük vekil. Bu, 0xDC00 ile 0xDFFF arasında bir değer olmalıdır.
- highChar
- Char
Yüksek vekil. Bu, 0xD800 ile 0xDBFF arasında bir değer olmalıdır.
Özel durumlar
Geçersiz bir vekil karakter çifti geçirildi.
Önceki XmlWriter bir zaman uyumsuz işlem tamamlanmadan önce bir yöntem çağrıldı. Bu durumda, InvalidOperationException "Zaman uyumsuz bir işlem zaten devam ediyor" iletisiyle oluşturulur.
Açıklamalar
Bu yöntem yalnızca UTF-16 kodlaması kullanan sistemlerde geçerlidir.
Vekil karakter varlığı onaltılık biçimde yazılır. Vekil karakterlerin aralığı #x10FFFF #x10000. Vekil karakter varlığını oluşturmak için aşağıdaki formül kullanılır: (highChar
-0xD800) * 0x400 + (lowChar
-0xDC00) + 0x10000
Hem HTML hem de XML için, belge karakter kümesi (ve dolayısıyla sayısal karakter başvurularının gösterimi) UCS [ISO-10646] tabanlıdır. Bu nedenle, kaynak belgedeki tek bir sayısal karakter başvurusu, bazı durumlarda bir dizedeki iki 16 bitlik bir birimde (yüksek vekil ve düşük vekil) karşılık gelebilir. Bu 16 bitlik birimler vekil çift olarak adlandırılır.
Vekiller veya karakterler hakkında daha fazla bilgi için, konumunda bulunan https://www.unicode.orgUnicode 3.0/Unicode 2.0 standardının 3.7 bölümüne veya W3C XML 1.0 Önerisi'nin 2.2. bölümüne bakın.
Bu yöntemin zaman uyumsuz sürümü için bkz WriteSurrogateCharEntityAsync. .