XmlWriter.WriteSurrogateCharEntity(Char, Char) Yöntem

Tanım

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. .

Şunlara uygulanır