XmlReader.Create Method (TextReader, XmlReaderSettings, XmlParserContext)
Microsoft Silverlight will reach end of support after October 2021. Learn more.
Creates a new XmlReader instance using the specified TextReader, XmlReaderSettings, and XmlParserContext objects.
Namespace: System.Xml
Assembly: System.Xml (in System.Xml.dll)
Syntax
'Declaration
Public Shared Function Create ( _
input As TextReader, _
settings As XmlReaderSettings, _
inputContext As XmlParserContext _
) As XmlReader
public static XmlReader Create(
TextReader input,
XmlReaderSettings settings,
XmlParserContext inputContext
)
Parameters
- input
Type: System.IO.TextReader
The TextReader from which to read the XML data. Because a TextReader returns a stream of Unicode characters, the encoding specified in the XML declaration is not used by the XmlReader to decode the data stream.
- settings
Type: System.Xml.XmlReaderSettings
The XmlReaderSettings object used to configure the new XmlReader instance. This value can be nulla null reference (Nothing in Visual Basic).
- inputContext
Type: System.Xml.XmlParserContext
The XmlParserContext object that provides 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 nulla null reference (Nothing in Visual Basic).
Return Value
Type: System.Xml.XmlReader
An XmlReader object to read XML data.
Exceptions
Exception | Condition |
---|---|
NullReferenceException | The input value is nulla null reference (Nothing in Visual Basic). |
ArgumentException | The XmlReaderSettings.NameTable and XmlParserContext.NameTable properties both contain values. (Only one of these NameTable properties can be set and used). |
Remarks
For information on working with resolvers, see Working with XmlXapResolver, Working with XmlPreloadedResolver.
Examples
Dim xmlFrag As String = "<item rk:ID='abc-23'>hammer</item> " & _
"<item rk:ID='r2-435'>paint</item>" & _
"<item rk:ID='abc-39'>saw</item>"
' Create the XmlNamespaceManager.
Dim nt As New NameTable()
Dim nsmgr As New XmlNamespaceManager(nt)
nsmgr.AddNamespace("rk", "urn:store-items")
' Create the XmlParserContext.
Dim context As New XmlParserContext(Nothing, nsmgr, Nothing, XmlSpace.None)
' Create the reader.
Dim settings As New XmlReaderSettings()
settings.ConformanceLevel = ConformanceLevel.Fragment
Using reader As XmlReader = XmlReader.Create(New StringReader(xmlFrag), settings, context)
End Using
string xmlFrag = @"<item rk:ID='abc-23'>hammer</item>
<item rk:ID='r2-435'>paint</item>
<item rk:ID='abc-39'>saw</item>";
// Create the XmlNamespaceManager.
NameTable nt = new NameTable();
XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
nsmgr.AddNamespace("rk", "urn:store-items");
// Create the XmlParserContext.
XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);
// Create the reader.
XmlReaderSettings settings = new XmlReaderSettings();
settings.ConformanceLevel = ConformanceLevel.Fragment;
using (XmlReader reader = XmlReader.Create(new StringReader(xmlFrag), settings, context))
{
}
Version Information
Silverlight
Supported in: 5, 4, 3
Silverlight for Windows Phone
Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0
XNA Framework
Supported in: Xbox 360, Windows Phone OS 7.0
Platforms
For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.
See Also