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.
  • 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.