XmlTextWriter.WriteSurrogateCharEntity(Char, Char) Yöntem

Tanım

Ad Alanı:

System.Xml

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Xml.ReaderWriter.dll

Kaynak:

XmlTextWriter.cs

Vekil karakter çifti için vekil karakter varlığını oluşturur ve yazar.

public:
 override void WriteSurrogateCharEntity(char lowChar, char highChar);

public override void WriteSurrogateCharEntity(char lowChar, char highChar);

override this.WriteSurrogateCharEntity : char * char -> unit

Public Overrides Sub WriteSurrogateCharEntity (lowChar As Char, highChar As Char)

Parametreler

lowChar

Char

Düşük vekil. Bu, ile 0xDC00arasında 0xDFFF bir değer olmalıdır.

highChar

Char

Yüksek vekil. Bu, ile 0xD800arasında 0xDBFF bir değer olmalıdır.

Özel durumlar

Exception

Geçersiz bir vekil karakter çifti geçirildi.

Açıklamalar

Note

XmlWriter öneririz ki, yeni işlevlerden yararlanmak için XmlWriter.Create yöntemi ve XmlWriterSettings sınıfını kullanarak örnekler oluşturun.

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ığı olarak #x10000ayarlanır#x10FFFF. 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, bir kaynak belgedeki tek bir sayısal karakter başvurusu, bazı durumlarda bir dizedeki iki 16 bit birimde (yüksek vekil ve düşük vekil) karşılık gelebilir. Bu 16 bit birimler vekil çift olarak adlandırılır.

Vekiller veya karakterler hakkında daha fazla bilgi için Unicode 3.0/Unicode 2.0 standardının 3.7bölümüne veya W3C XML 1.0 Önerisi'nin 2.2. bölümüne bakın.