This documentation is archived and is not being maintained.

XmlWriter.WriteNode Method (XPathNavigator, Boolean)

Note: This method is new in the .NET Framework version 2.0.

Copies everything from the XPathNavigator object to the writer. The position of the XPathNavigator remains unchanged.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

public virtual void WriteNode (
	XPathNavigator navigator,
	bool defattr
)
public void WriteNode (
	XPathNavigator navigator, 
	boolean defattr
)
public function WriteNode (
	navigator : XPathNavigator, 
	defattr : boolean
)

Parameters

navigator

The XPathNavigator to copy from.

defattr

true to copy the default attributes; otherwise, false.

Exception typeCondition

ArgumentNullException

navigator is a null reference (Nothing in Visual Basic).

The following table shows the supported XPath node types for this method.

XPathNodeType

WriteNode Behavior

Root

Writes out all the nodes irrespective of type. That is, the writer consumes the XPathNavigator and writes out all the nodes from the root node (including attributes, processing instructions, comments and so on.)

Element

Writes out the element node and any attribute nodes.

Attribute

No operation. Use WriteStartAttribute or WriteAttributeString instead.

Text

Writes out the text node.

Namespace

No operation. Use the WriteStartAttribute or WriteAttributeString method to write the namespace declaration.

ProcessingInstruction

Writes out the processing instruction node.

Comment

Writes out the comment node.

SignificantWhitespace

Writes out the significant white space node.

Whitespace

Writes out the white space node.

The following example uses the WriteNode method to copy a book node from one document to another.

The example uses the books.xml file as input.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0
Show: