XmlWriter.Create Method (XmlWriter)

 

Creates a new XmlWriter instance using the specified XmlWriter object.

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

public static XmlWriter Create(
	XmlWriter output
)

Parameters

output
Type: System.Xml.XmlWriter

The XmlWriter object that you want to use as the underlying writer.

Return Value

Type: System.Xml.XmlWriter

An XmlWriter object that is wrapped around the specified XmlWriter object.

Exception Condition
ArgumentNullException

The writer value is null.

This method allows you add features to an underlying XmlWriter object. The underlying XmlWriter object can be an object created by the XmlWriter.Create method, or an object created using the XmlTextWriter implementation.

When you use this overload, an XmlWriterSettings object with default settings is used to create the XML writer.

Setting

Default

CheckCharacters

true

CloseOutput

false

ConformanceLevel

ConformanceLevel.Document

Encoding

Encoding.UTF8

Indent

false

IndentChars

Two spaces

NamespaceHandling

Default (no removal)

NewLineChars

\r\n (carriage return, new line)

NewLineHandling

NewLineHandling.Replace

NewLineOnAttributes

false

OmitXmlDeclaration

false

OutputMethod

XmlOutputMethod.Xml

WriteEndDocumentOnClose

true

If you want to specify the features to support on the created XML writer, use an overload that takes an XmlWriterSettings object as one of its arguments, and pass in a XmlWriterSettings object with your custom settings.

Universal Windows Platform
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Return to top
Show: