0 out of 1 rated this helpful - Rate this topic

XmlReader.Create Method

.NET Framework 4.5

Creates a new XmlReader instance.

This member is overloaded. For complete information about this member, including syntax, usage, and examples, click a name in the overload list.

Overload List

	Name	Description
	Create(Stream)	Creates a new XmlReader instance using the specified stream.
	Create(String)	Creates a new XmlReader instance with specified URI.
	Create(TextReader)	Creates a new XmlReader instance with the specified TextReader.
	Create(Stream, XmlReaderSettings)	Creates a new XmlReader instance with the specified stream and XmlReaderSettings object.
	Create(String, XmlReaderSettings)	Creates a new instance with the specified URI and XmlReaderSettings.
	Create(TextReader, XmlReaderSettings)	Creates a new XmlReader instance using the specified TextReader and XmlReaderSettings objects.
	Create(XmlReader, XmlReaderSettings)	Creates a new XmlReader instance with the specified XmlReader and XmlReaderSettings objects.
	Create(Stream, XmlReaderSettings, String)	Creates a new XmlReader instance using the specified stream, base URI, and XmlReaderSettings object.
	Create(Stream, XmlReaderSettings, XmlParserContext)	Creates a new XmlReader instance using the specified stream, XmlReaderSettings, and XmlParserContext objects.
	Create(String, XmlReaderSettings, XmlParserContext)	Creates a new XmlReader instance using the specified URI, XmlReaderSettings, and XmlParserContext objects.
	Create(TextReader, XmlReaderSettings, String)	Creates a new XmlReader instance using the specified TextReader, XmlReaderSettings, and base URI.
	Create(TextReader, XmlReaderSettings, XmlParserContext)	Creates a new XmlReader instance using the specified TextReader, XmlReaderSettings, and XmlParserContext objects.

Top

Remarks

Although Microsoft .NET Framework includes concrete implementations of the XmlReader class, such as the XmlTextReader, XmlNodeReader, and the XmlValidatingReader classes, in the 2.0 release the recommended practice is to create XmlReader instances using the Create method. For more information, see Creating XML Readers.

Security Note
By default the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. This means that, by default, the XmlReader can access any locations that do not require credentials. You can use one of the following methods to control which resources the XmlReader can access: Restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object. -or- Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Security Note

By default the XmlReader uses an XmlUrlResolver object with no user credentials to open resources. This means that, by default, the XmlReader can access any locations that do not require credentials. You can use one of the following methods to control which resources the XmlReader can access:

Restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object.

-or-

Do not allow the XmlReader to open any external resources by setting the XmlResolver property to null.

Caution
In synchronous mode, the Create method will read the first chunk of data from the buffer of the File, Stream, or Text reader, which may throw an exception if an IO operation fails. In asynchronous mode, the first IO operation occurs with a read operation, so exceptions that arise will be throw when the read operation occurs.

Examples

The following example uses an XmlUrlResolver with default credentials to access a file.

C++

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

C++

// Create a resolver with default credentials.
XmlUrlResolver resolver = new XmlUrlResolver();
resolver.Credentials = System.Net.CredentialCache.DefaultCredentials;

// Set the reader settings object to use the resolver.
settings.XmlResolver = resolver;

// Create the XmlReader object.
XmlReader reader = XmlReader.Create("http://ServerName/data/books.xml", settings);

Reference

XmlReader Class

System.Xml Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)