XmlWriter.WriteString Method (String)
When overridden in a derived class, writes the given text content.
Assembly: System.Xml (in System.Xml.dll)
The text string contains an invalid surrogate pair.
WriteString does the following:
The characters &, <, and > are replaced with &, <, and >, respectively.
The default behavior of an XmlWriter created using Create is to throw an ArgumentException when attempting to write character values in the range 0x-0x1F (excluding white space characters 0x9, 0xA, and 0xD). These invalid XML characters can be written by creating the XmlWriter with the CheckCharacters property set to false. Doing so will result in the characters being replaced with numeric character entities (� through �x1F). Additionally, an XmlTextWriter created with the new operator will replace the invalid characters with numeric character entities by default.
Note Microsoft does not encourage the practice of writing invalid XML characters since many applications that consume XML are not designed to handle invalid characters.
If WriteString is called in the context of an attribute value, double and single quotes are replaced with " and ' respectively.
For example, this input string test<item>test is written out as
If text is either null or String.Empty, this method writes a text node with no data content.
For the asynchronous version of this method, see WriteStringAsync.
The following example writes an XML node.
Option Explicit Option Strict Imports System Imports System.IO Imports System.Xml Public Class Sample Public Shared Sub Main() ' Create a writer to write XML to the console. Dim settings As XmlWriterSettings = new XmlWriterSettings() settings.Indent = true settings.OmitXmlDeclaration = true Dim writer As XmlWriter = XmlWriter.Create(Console.Out, settings) ' Write the book element. writer.WriteStartElement("book") ' Write the title element. writer.WriteStartElement("title") writer.WriteString("Pride And Prejudice") writer.WriteEndElement() ' Write the close tag for the root element. writer.WriteEndElement() ' Write the XML and close the writer. writer.Close() End Sub 'Main End Class 'Sample
Available since 8
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Available since 8.1