XmlReaderSettings.IgnoreWhitespace Property (System.Xml)

Switch View :

Classic

Lightweight

ScriptFree

Site Feedback

.NET Framework Class Library

XmlReaderSettings.IgnoreWhitespace Property

Gets or sets a value indicating whether to ignore insignificant white space.

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

Syntax

Visual Basic

Public Property IgnoreWhitespace As Boolean
	Get
	Set

public bool IgnoreWhitespace { get; set; }

Visual C++

public:
property bool IgnoreWhitespace {
	bool get ();
	void set (bool value);
}

member IgnoreWhitespace : bool with get, set

Property Value

Type: System.Boolean
true to ignore white space; otherwise false. The default is false.

Remarks

White space that is not considered to be significant includes spaces, tabs, and blank lines used to set apart the markup for greater readability. An example of this is white space in element content.

This property setting does not affect white space between markup in a mixed content mode, or white space that occurs within the scope of an xml:space='preserve' attribute.

Examples

The following creates a settings object that can be used to construct a reader that strips processing instructions, comments, and insignificant white space.

Visual Basic


' Set the reader settings.
Dim settings as XmlReaderSettings = new XmlReaderSettings()
settings.IgnoreComments = true
settings.IgnoreProcessingInstructions = true
settings.IgnoreWhitespace = true


// Set the reader settings.
XmlReaderSettings settings = new XmlReaderSettings();
settings.IgnoreComments = true;
settings.IgnoreProcessingInstructions = true;
settings.IgnoreWhitespace = true;

Visual C++


// Set the reader settings.
XmlReaderSettings^ settings = gcnew XmlReaderSettings;
settings->IgnoreComments = true;
settings->IgnoreProcessingInstructions = true;
settings->IgnoreWhitespace = true;

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Portable Class Library

Supported in: Portable Class Library

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Reference

XmlReaderSettings Class

System.Xml Namespace

Other Resources

Creating XML Readers