Condividi tramite


XmlWriter.WriteSurrogateCharEntity(Char, Char) Metodo

Definizione

Quando ne viene eseguito l'override in una classe derivata, genera e scrive l'entità carattere surrogata per la coppia di caratteri surrogati.

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)

Parametri

lowChar
Char

Surrogato basso. Deve essere un valore compreso tra 0xDC00 e 0xDFFF.

highChar
Char

Surrogato alto. Deve essere un valore compreso tra 0xD800 e 0xDBFF.

Eccezioni

È stata passata una coppia di caratteri surrogati non valida.

È stato chiamato un metodo della classe XmlWriter prima del completamento di un'operazione asincrona precedente. In questo caso, viene generata l'eccezione InvalidOperationException con il messaggio "È già in corso un'operazione asincrona".

Commenti

Questo metodo è applicabile solo nei sistemi che usano la codifica UTF-16.

L'entità carattere surrogato viene scritta in formato esadecimale. L'intervallo per i caratteri surrogati è #x10000 per #x10FFFF. La formula seguente viene usata per generare l'entità carattere surrogato: ( -0xD800) * 0x400 + (highChar``lowChar -0xDC00) + 0x10000

Per HTML e XML, il set di caratteri del documento (e quindi la notazione dei riferimenti numerici dei caratteri) è basato su UCS [ISO-10646]. Un singolo riferimento numerico di carattere in un documento di origine può quindi corrispondere a due unità a 16 bit in una stringa (un surrogato elevato e un surrogato basso). Queste unità a 16 bit vengono definite coppia surrogata.

Per altre informazioni sui surrogati o i caratteri, vedere la sezione 3.7 dello standard Unicode 3.0/Unicode 2.0 disponibile in https://www.unicode.orgo nella sezione 2.2 della raccomandazione XML W3C XML 1.0.

Per la versione asincrona di questo metodo, vedere WriteSurrogateCharEntityAsync.

Si applica a