XmlTextWriter.WriteCharEntity(Char) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erzwingt die Generierung einer Zeichenentität für den angegebenen Unicode-Zeichenwert.
public:
override void WriteCharEntity(char ch);public override void WriteCharEntity(char ch);override this.WriteCharEntity : char -> unitPublic Overrides Sub WriteCharEntity (ch As Char)Parameter
- ch
- Char
Unicode-Zeichen, für das eine Zeichenentität generiert werden soll.
Ausnahmen
Das Zeichen befindet sich im Ersatzpaarzeichenbereich; 0xd800 - 0xdfffoder der Text würde zu einem nicht wohlgeformten XML-Dokument führen.
WriteState ist Closed.
Beispiele
Im folgenden Beispiel wird die WriteCharEntity Methode verwendet, um eine E-Mail-Adresse zu schreiben.
using System;
using System.Xml;
public class Sample {
public static void Main() {
XmlTextWriter writer = null;
try {
writer = new XmlTextWriter (Console.Out);
// Write an element.
writer.WriteStartElement("address");
// Write an email address using entities
// for the @ and . characters.
writer.WriteString("someone");
writer.WriteCharEntity('@');
writer.WriteString("example");
writer.WriteCharEntity('.');
writer.WriteString("com");
writer.WriteEndElement();
}
finally {
// Close the writer.
if (writer != null)
writer.Close();
}
}
}
Imports System.Xml
Public Class Sample
Public Shared Sub Main()
Dim writer As XmlTextWriter = Nothing
Try
writer = new XmlTextWriter(Console.Out)
' Write an element.
writer.WriteStartElement("address")
' Write an email address using entities
' for the @ and . characters.
writer.WriteString("someone")
writer.WriteCharEntity("@"c)
writer.WriteString("example")
writer.WriteCharEntity("."c)
writer.WriteString("com")
writer.WriteEndElement()
Finally
' Close the writer.
If writer IsNot Nothing
writer.Close()
End If
End Try
End Sub
End Class
Hinweise
Note
Wir empfehlen Ihnen, XmlWriter Instanzen mithilfe der XmlWriter.Create Methode und der XmlWriterSettings Klasse zu erstellen, um von neuen Funktionen zu profitieren.
Diese Methode schreibt das Unicode-Zeichen im Hexadezimalzeichen-Entitätsreferenzformat.
