.NET Developer Tip
(Receive this column in your inbox,
click Edit your Profile to subscribe.)
The XmlTextReader class
Peter G. Aitken
The whole reason for Microsoft's .NET framework is to allow the different machines, no matter where they are or who made them, communicate with one another. So it's a good idea, if you're going to be programming for that framework, to understand how one of the universal languages, XML, works in .NET. This tip, excerpted from InformIT, explains one the classes you need for XML, the XMLTextReader Class.
The XmlTextReader class is designed for fast, resource nonintensive access to the contents of an XML file. Unlike the XmlDocument class, the XMLTextReader class does not create a node tree of the entire document in memory. Rather, it processes the XML as a forward-only stream. The entire XML document is never available at the same time (as is the case with the XmlDocument class) -- your code can extract individual items from the XML file as they stream by.
In some ways the XmlTextReader class is similar to the SAX model covered in Chapter 11, and in fact, the .NET programmer would tend to use the XmlTextReader class for the same types of processing that SAX would be used for. There is a major difference between the two models, however. SAX uses a push model in which the XML processor uses events to inform the host program that node data is available, and the program can use the data or not as its needs dictate. The data is pushed from the XML processor to the host, and it can be accepted or ignored. As an analogy, think of a Chinese dim sum restaurant where the available food is brought around on carts and you select what you want.
In contrast, the XmlTextReader class uses a pull model. The host program requests that the XML processor read a node, and then requests data from that
To continue reading for free, register below or login
To read more you must become a member of SearchSOA.com
node as needed. The host program pulls the data from the processor as it is needed. Pull processing is analogous to a traditional restaurant where you request items from a menu. A pull model has numerous advantages over a push model for XML processing. Perhaps most important is that a push model can easily be built on top of a pull model, while the reverse is not true.
The XmlTextReader class operates by stepping through the nodes of an XML document, one at a time, under the control of the host program. At any given time, there is a current node. For the current node, the host program can determine the type of the node, its attributes (if any), its data, and so on. Once the needed information about the current node has been obtained, the program will step to the next node. In this manner the entire XML file can be processed.
The XmlTextReader class has a large number of public properties and methods. The ones you will need most often are explained in the tables.
Commonly Needed Properties of the XmlTextReader Class
[TABLE] Commonly Needed Methods of the XmlTextReader Class
[TABLE]XmlNodeType Values Returned by the NodeType Property
[TABLE]The basic steps required to use the XmlTextReader class are as follows:
The listing presents an example of using the XmlTextReader class. It is an ASP Web page, with the script components written using the C# language. The script opens an XML file and processes it using the XmlTextReader class. The root element in the file, its child element, and their attributes and data are formatted as HTML and written to the output for display in the browser.
The script defines a class called DisplayXmlFile that does all of the work. This class contains one public method, ReadDoc(), that is passed the name of the XML file to be processed and returns the HTML to be displayed in the document. It also contains two private methods: ProcessXml(), which performs the actual processing of the XML file, and Spaces(), which is a utility function to provide indentation to format the output.
The script also contains a procedure named Page_Load(). This is an event procedure that is called automatically when the browser first loads the page. Code in this procedure creates an instance of the DisplayXml class, and then calls its ReadDoc() method, passing the name of the XML file to be processed. The HTML returned by this method is displayed by assigning it to the InnerHTML property of a <div> element in the page.
Listing: Using the XmlTextReader Class to Read Data from an XML File
To read the article from which this tip is excerpted, click over to InformIT. You have to register there, but the registration is free.
For More Information:
