XmlWriter.WriteSurrogateCharEntity(Char, Char) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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 -> unitPublic 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.