XmlReader::Create Method (String^, XmlReaderSettings^)
Creates a new XmlReader instance by using the specified URI and settings.
Assembly: System.Xml (in System.Xml.dll)
Parameters
- inputUri
-
Type:
System::String^
The URI for the file containing the XML data. The XmlResolver object on the XmlReaderSettings object is used to convert the path to a canonical data representation. If XmlResolver is null, a new XmlUrlResolver object is used.
- settings
-
Type:
System.Xml::XmlReaderSettings^
The settings for the new XmlReader instance. This value can be null.
| Exception | Condition | ||
|---|---|---|---|
| ArgumentNullException | The inputUri value is null. | ||
| FileNotFoundException | The file specified by the URI cannot be found. | ||
| UriFormatException |
The URI format is not correct. |
By default an XmlUrlResolver with no credentials is used to access any external resources such as a document type definition (DTD), entities, schemas, and so on.
Important |
|---|
Starting with the .NET Framework 4.5.2, no default XmlUrlResolver is provided. If your solution targets the .NET Framework 4.5.2 or later versions, specify an XmlResolver using the XmlReaderSettings::XmlResolver property. |
This means that the XmlReader can access any locations that does not require authentication. If the external resource is located on a network resource that requires authentication, use the XmlReaderSettings::XmlResolver property to specify an XmlResolver with the necessary credentials.
Security Note
|
|---|
You can restrict the resources that the XmlReader can access by setting the XmlResolver property to an XmlSecureResolver object. |
The created XmlReader object expands entity references and performs XML normalization of new line characters.
Available since 8
.NET Framework
Available since 2.0
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1


