Home Library Learn Downloads Support Community
Sign in | United States - English | |
This topic has not yet been rated - Rate this topic

XmlTextReader.BaseURI Property

.NET Framework 2.0

Gets the base URI of the current node.

Namespace: System.Xml
Assembly: System.Xml (in system.xml.dll)

C#
C++
VB
Copy 
public override string BaseURI { get; }
J#
Copy 
/** @property */
public String get_BaseURI ()
JScript
Copy 
public override function get BaseURI () : String

Property Value

The base URI of the current node.
NoteNote

In the Microsoft .NET Framework version 2.0 release, the recommended practice is to create XmlReader instances using the System.Xml.XmlReader.Create method. This allows you to take full advantage of the new features introduced in this release. For more information, see Creating XML Readers.

A networked XML document is comprised of chunks of data aggregated using various W3C standard inclusion mechanisms and therefore contains nodes that come from different places. DTD entities are an example of this, but this is not limited to DTDs. The base URI tells you where these nodes came from. If there is no base URI for the nodes being returned (for example, they were parsed from an in-memory string), String.Empty is returned.

The following example displays the base URI for each of the nodes.

C#
C++
VB
Copy 
using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    XmlTextReader reader = null;

    try
    {           
        //Load the reader with the XML file.
        reader = new XmlTextReader("http://localhost/baseuri.xml");

        //Parse the file and display the base URI for each node.
        while (reader.Read())
        {
            Console.WriteLine("({0}) {1}", reader.NodeType, reader.BaseURI);
         }           
     }

     finally
     {
       if (reader!=null)
         reader.Close();
     }
  }
} // End class
J#
Copy 
import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{  
    public static void main(String[] args)
    {
        XmlTextReader reader = null;
        try {
            //Load the reader with the XML file.
            reader = new XmlTextReader("http://localhost/baseuri.xml");

            //Parse the file and display the base URI for each node.
            while(reader.Read()) {
                Console.WriteLine("({0}) {1}", reader.get_NodeType(),
                reader.get_BaseURI());
            }
        }
        finally {
            if ( reader != null ) {
                reader.Close();
            }
        }
    } //main
} // End class Sample

The example uses the file, baseuri.xml, as input.

None
Copy 

<!-- XML fragment -->
<book genre="novel">
  <title>Pride And Prejudice</title>
</book>

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

.NET Framework

Supported in: 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0
Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ