XmlWriterSettings.NewLineChars Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Gets or sets the character string to use for line breaks.

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

Syntax

'Declaration
Public Property NewLineChars As String
public string NewLineChars { get; set; }

Property Value

Type: System.String
The character string to use for line breaks. This can be set to any string value. However, to ensure valid XML, you should specify only valid white space characters, such as space characters, tabs, carriage returns, or line feeds. The default is \r\n (carriage return, new line).

Exceptions

Exception Condition
ArgumentNullException

The value assigned to the NewLineChars is nulla null reference (Nothing in Visual Basic).

Remarks

This property only applies to XmlWriter instances that output text content; otherwise, this setting is ignored. The XmlWriter throws an exception if the line break characters would result in invalid XML.

For more information and code examples, see XML Data.

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.