XmlTextWriter.WriteCharEntity(Char) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee dwingt u het genereren van een tekenentiteit af voor de opgegeven Unicode-tekenwaarde.
public:
override void WriteCharEntity(char ch);public override void WriteCharEntity(char ch);override this.WriteCharEntity : char -> unitPublic Overrides Sub WriteCharEntity (ch As Char)Parameters
- ch
- Char
Unicode-teken waarvoor een tekenentiteit moet worden gegenereerd.
Uitzonderingen
Het teken bevindt zich in het tekenbereik van het surrogaatpaar; 0xd800 - 0xdfffof de tekst zou resulteren in een niet-goed opgemaakt XML-document.
De WriteState is Closed.
Voorbeelden
In het volgende voorbeeld wordt de WriteCharEntity methode gebruikt om een e-mailadres te schrijven.
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
Opmerkingen
Note
U wordt aangeraden om XmlWriter-exemplaren te maken met behulp van de XmlWriter.Create-methode en de XmlWriterSettings-klasse om te profiteren van nieuwe functionaliteit.
Met deze methode wordt het Unicode-teken in de hexadecimale verwijzingsindeling voor tekenentiteiten geschreven.
