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.
In caso di override in una classe derivata, genera e scrive l'entità carattere surrogato 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 XmlWriter metodo prima del completamento di un'operazione asincrona precedente. In questo caso, InvalidOperationException viene generata con il messaggio "Un'operazione asincrona è già in corso".
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 viene #x10000 da #x10FFFF. La formula seguente viene usata per generare l'entità carattere surrogato: (highChar -0xD800) * 0x400 + (lowChar -0xDC00) + 0x10000
Sia per HTML che per XML, il set di caratteri del documento (e quindi la notazione di riferimenti a caratteri numerici) è basato su UCS [ISO-10646]. Un singolo riferimento numerico a caratteri in un documento di origine può pertanto corrispondere in alcuni casi a due unità a 16 bit in una stringa (surrogato elevato e surrogato basso). Queste unità a 16 bit vengono definite coppie di surrogati.
Per altre informazioni sui surrogati o sui 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 W3C XML 1.0.
Per la versione asincrona di questo metodo, vedere WriteSurrogateCharEntityAsync.
