XmlWriterSettings.NewLineOnAttributes Property

Definition

Gets or sets a value indicating whether to write attributes on a new line.

C#
public bool NewLineOnAttributes { get; set; }

Property Value

true to write attributes on individual lines; otherwise, false. The default is false.

Examples

The following example creates an XmlWriter that writes to an XML file and writes each attribute on a new line.

C#
XmlWriterSettings settings = new XmlWriterSettings();
settings.Indent = true;
settings.OmitXmlDeclaration = true;
settings.NewLineOnAttributes = true;

writer = XmlWriter.Create(Console.Out, settings);

writer.WriteStartElement("order");
writer.WriteAttributeString("orderID", "367A54");
writer.WriteAttributeString("date", "2001-05-03");
writer.WriteElementString("price", "19.95");
writer.WriteEndElement();
    
writer.Flush();

The sample produces the following output:

XML
<order
  orderID="367A54"
  date="2001-05-03">
  <price>19.95</price>
</order>

Remarks

This property only applies to XmlWriter instances that output text content; otherwise, this setting is ignored.

When NewLineOnAttributes is set to true, each attribute is prepended with a new line and one extra level of indentation.

This setting has no effect when the Indent property value is false.

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0