Type: System.Xml.XmlParserContext

System.Xml.XmlParserContext Class

Assembly: System.Xml.dll
Namespace: System.Xml

Summary: Provides all the context information required by XmlTextReader or XmlValidatingReader to parse an XML fragment.

C# Syntax:


        public class XmlParserContext

See also:

System.Xml Namespace

System.Xml.XmlParserContext Member List:

Public Constructors

ctor #1	Overloaded: `.ctor(XmlNameTable nt, XmlNamespaceManager nsMgr, string xmlLang, XmlSpace xmlSpace)` Initializes a new instance of the XmlParserContext class with the specified values.
ctor #2	Overloaded: `.ctor(XmlNameTable nt, XmlNamespaceManager nsMgr, string xmlLang, XmlSpace xmlSpace, Encoding enc)` Initializes a new instance of the XmlParserContext class with the specified values.
ctor #3	Overloaded: `.ctor(XmlNameTable nt, XmlNamespaceManager nsMgr, string docTypeName, string pubId, string sysId, string internalSubset, string baseURI, string xmlLang, XmlSpace xmlSpace)` Initializes a new instance of the XmlParserContext class with the specified values.
ctor #4	Overloaded: `.ctor(XmlNameTable nt, XmlNamespaceManager nsMgr, string docTypeName, string pubId, string sysId, string internalSubset, string baseURI, string xmlLang, XmlSpace xmlSpace, Encoding enc)` Initializes a new instance of the XmlParserContext class with the specified values.

Public Properties

BaseURI	Read-write Gets or sets the base URI.
DocTypeName	Read-write Gets or sets the name of the document type declaration.
Encoding	Read-write
InternalSubset	Read-write Gets or sets the internal DTD subset.
NamespaceManager	Read-write Gets or sets the XmlNamespaceManager.
NameTable	Read-write Gets the XmlNameTable used to atomize strings. For more information on atomized strings, see XmlNameTable.
PublicId	Read-write Gets or sets the public identifier.
SystemId	Read-write Gets or sets the system identifier.
XmlLang	Read-write Gets or sets the current xml:lang scope.
XmlSpace	Read-write Gets or sets the current xml:space scope.

Public Methods

Equals (inherited from System.Object)	See base class member description: System.Object.Equals Derived from System.Object, the primary base class for all objects.
GetHashCode (inherited from System.Object)	See base class member description: System.Object.GetHashCode Derived from System.Object, the primary base class for all objects.
GetType (inherited from System.Object)	See base class member description: System.Object.GetType Derived from System.Object, the primary base class for all objects.
ToString (inherited from System.Object)	See base class member description: System.Object.ToString Derived from System.Object, the primary base class for all objects.

Protected Methods

Finalize (inherited from System.Object)	See base class member description: System.Object.Finalize Derived from System.Object, the primary base class for all objects.
MemberwiseClone (inherited from System.Object)	See base class member description: System.Object.MemberwiseClone Derived from System.Object, the primary base class for all objects.

Hierarchy:

System.Object

System.Xml.XmlParserContext

System.Xml.XmlParserContext Member Details

Overloaded ctor #1

Summary: Initializes a new instance of the XmlParserContext class with the specified values.

C# Syntax:


            public XmlParserContext(
   XmlNameTable nt,
   XmlNamespaceManager nsMgr,
   string xmlLang,
   XmlSpace xmlSpace
);

Parameters:

The XmlNameTable to use to atomize strings. If this is null, the name table used to construct the nsMgr is used instead. For more information on atomized strings, see XmlNameTable.

nsMgr

The XmlNamespaceManager to use for looking up namespace information.

xmlLang

The xml:lang scope.

xmlSpace

An XmlSpace value indicating the xml:space scope.

Remarks

If nt and the name table used to construct the nsMgr are not the same, XmlParserContext does not recognize namespaces added to nsMgr and throws an XmlException when it encounters the unrecognized namespaces.

Example

The following example reads an XML fragment. It uses an XmlParserContext and its XmlNamespaceManager to handle namespace matching.

using System;
using System.IO;
using System.Xml;

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

    try
    {
       //Create the XML fragment to be parsed.
       string xmlFrag ="<book> " +
                       "<title>Pride And Prejudice</title>" +
                       "<bk:genre>novel</bk:genre>" +
                       "</book>"; 

       //Create the XmlNamespaceManager that is used to
       //look up namespace information.
       NameTable nt = new NameTable();
       XmlNamespaceManager nsmgr = new XmlNamespaceManager(nt);
       nsmgr.AddNamespace("bk", "urn:sample");

       //Create the XmlParserContext.
       XmlParserContext context = new XmlParserContext(null, nsmgr, null, XmlSpace.None);

       //Implement the reader. 
       reader = new XmlValidatingReader(xmlFrag, XmlNodeType.Element, context);
  
       //Parse the XML fragment.  If they exist, display the   
       //prefix and namespace URI of each element.
       while (reader.Read()){
         if (reader.IsStartElement()){
           if (reader.Prefix==String.Empty)
              Console.WriteLine("<{0}>", reader.LocalName);
           else{
               Console.Write("<{0}:{1}>", reader.Prefix, reader.LocalName);
               Console.WriteLine(" The namespace URI is " + reader.NamespaceURI);
           }
         }
       }
       

     } 

     finally 
     {
        if (reader != null)
          reader.Close();
      }
  }
} // End class