XmlReaderSettings.Async Property

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets whether asynchronous XmlReader methods can be used on a particular XmlReader instance.

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

public bool Async { get; set; }

Property Value

Type: System.Boolean

true if asynchronous methods can be used; otherwise, false.

You must set this value to true when you create a new XmlReader instance if you want to use asynchronous XmlReader methods on that instance. After the XmlReader instance is created, the Async property is read-only. The default value of this property is false.

This flag is ignored by the XmlReader.Create overload. This means that if you create a new XmlReader based on an existing XmlReader, the async behavior depends on the input XmlReader, and you cannot use the Async flag to change the async behavior.

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