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.
An XmlWriter method was called before a previous asynchronous operation finished. In this case, InvalidOperationException is thrown with the message “An asynchronous operation is already in progress.”
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 Nothing 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
.NET FrameworkSupported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0
.NET Framework Client ProfileSupported in: 4, 3.5 SP1
Portable Class LibrarySupported in: Portable Class Library
.NET for Windows Store appsSupported in: Windows 8
.NET for Windows Phone appsSupported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1
Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)