XmlReader.Create Method (String, XmlReaderSettings)
Creates a new instance with the specified URI and XmlReaderSettings.
Namespace: System.Xml
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 XmlReaderSettings object used to configure 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. 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.
The following example creates an XmlReader object that supports document type definition (DTD) validation.
// Set the validation settings. XmlReaderSettings settings = new XmlReaderSettings(); settings.DtdProcessing = DtdProcessing.Parse; settings.ValidationType = ValidationType.DTD; settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack); // Create the XmlReader object. XmlReader reader = XmlReader.Create("itemDTD.xml", settings); // Parse the file. while (reader.Read()) {}
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
