Export (0) Print
Expand All

XmlReader.Create Method

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.

  NameDescription
Public method Static member Create(Stream) Creates a new XmlReader instance using the specified stream.
Public method Static member Create(String) Creates a new XmlReader instance with specified URI.
Public method Static member Create(TextReader) Creates a new XmlReader instance with the specified TextReader.
Public method Static member Create(Stream, XmlReaderSettings) Creates a new XmlReader instance with the specified stream and XmlReaderSettings object.
Public method Static member Create(String, XmlReaderSettings) Creates a new instance with the specified URI and XmlReaderSettings.
Public method Static member Create(TextReader, XmlReaderSettings) Creates a new XmlReader instance using the specified TextReader and XmlReaderSettings objects.
Public method Static member Create(XmlReader, XmlReaderSettings) Creates a new XmlReader instance with the specified XmlReader and XmlReaderSettings objects.
Public method Static member Create(Stream, XmlReaderSettings, String) Creates a new XmlReader instance using the specified stream, base URI, and XmlReaderSettings object.
Public method Static member Create(Stream, XmlReaderSettings, XmlParserContext) Creates a new XmlReader instance using the specified stream, XmlReaderSettings, and XmlParserContext objects.
Public method Static member Create(String, XmlReaderSettings, XmlParserContext) Creates a new XmlReader instance using the specified URI, XmlReaderSettings, and XmlParserContext objects.
Public method Static member Create(TextReader, XmlReaderSettings, String) Creates a new XmlReader instance using the specified TextReader, XmlReaderSettings, and base URI.
Public method Static member Create(TextReader, XmlReaderSettings, XmlParserContext) Creates a new XmlReader instance using the specified TextReader, XmlReaderSettings, and XmlParserContext objects.
Top

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 noteSecurity 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.

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


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



// 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);


Community Additions

ADD
Show:
© 2014 Microsoft