XmlWriterSettings Class

Other Versions

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Specifies a set of features to support on the XmlWriter object created by the XmlWriter::Create method.

Inheritance Hierarchy

System::Object
System.Xml::XmlWriterSettings

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

Syntax

C++

No code example is currently available or this language may not be supported.

The XmlWriterSettings type exposes the following members.

	Name	Description
	XmlWriterSettings	Initializes a new instance of the XmlWriterSettings class.

	Name	Description
	Async	Gets or sets a value that indicates whether asynchronous XmlWriter methods can be used on a particular XmlWriter instance.
	CheckCharacters	Gets or sets a value indicating whether to do character checking.
	CloseOutput	Gets or sets a value indicating whether the XmlWriter should also close the underlying stream or TextWriter when the Close method is called.
	ConformanceLevel	Gets or sets the level of conformance which the XmlWriter complies with.
	Encoding	Gets or sets the text encoding to use.
	Indent	Gets or sets a value indicating whether to indent elements.
	IndentChars	Gets or sets the character string to use when indenting. This setting is used when the Indent property is set to true.
	NamespaceHandling	Gets or sets the NamespaceHandling enumeration used to specify whether to remove duplicate namespace declarations in the XmlWriter. For the duplicate namespace to be removed, the prefix and the namespace have to match.
	NewLineChars	Gets or sets the character string to use for line breaks.
	NewLineHandling	Gets or sets a value indicating whether to normalize line breaks in the output.
	NewLineOnAttributes	Gets or sets a value indicating whether to write attributes on a new line.
	OmitXmlDeclaration	Gets or sets a value indicating whether to write an XML declaration.
	WriteEndDocumentOnClose	Gets or sets a value that indicates whether the XmlWriter will add closing tags to all unclosed element tags when the Close() method is called.

	Name	Description
	Clone	Creates a copy of the XmlWriterSettings instance.
	Equals(Object)	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	Reset	Resets the members of the settings class to their default values.
	ToString	Returns a string that represents the current object. (Inherited from Object.)

In the Microsoft .NET Framework 2.0 release, the Create method is the preferred mechanism for obtaining XmlWriter instances. The Create method uses the XmlWriterSettings class to specify which features to implement in the created XmlWriter object.