XmlReader::Create Method (String^, XmlReaderSettings^, XmlParserContext^)
Creates a new XmlReader instance by using the specified URI, settings, and context information for parsing.
Assembly: System.Xml (in System.Xml.dll)
public: static XmlReader^ Create( String^ inputUri, XmlReaderSettings^ settings, XmlParserContext^ inputContext )
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.
- inputContext
-
Type:
System.Xml::XmlParserContext^
The context information required to parse the XML fragment. The context information can include the XmlNameTable to use, encoding, namespace scope, the current xml:lang and xml:space scope, base URI, and document type definition.
This value can be null.
| Exception | Condition |
|---|---|
| ArgumentNullException | The inputUri value is null. |
| SecurityException | The XmlReader does not have sufficient permissions to access the location of the XML data. |
| ArgumentException | The XmlReaderSettings::NameTable and XmlParserContext::NameTable properties both contain values. (Only one of these NameTable properties can be set and used). |
| 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 2.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0

