XmlReader::Create Method (Stream^, XmlReaderSettings^, XmlParserContext^)
Creates a new XmlReader instance using the specified stream, settings, and context information for parsing.
Assembly: System.Xml (in System.Xml.dll)
public: static XmlReader^ Create( Stream^ input, XmlReaderSettings^ settings, XmlParserContext^ inputContext )
Parameters
- input
-
Type:
System.IO::Stream^
The stream that contains the XML data.
The XmlReader scans the first bytes of the stream looking for a byte order mark or other sign of encoding. When encoding is determined, the encoding is used to continue reading the stream, and processing continues parsing the input as a stream of (Unicode) characters.
- 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 input value is null. |
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. |
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 use one of the following methods to control which resources the XmlReader can access:
-or-
|
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

