The GenerateDoc method regenerates the document as string from
the passed document object model's tree. Typically this tree is
previously obtained through call to the ParseString method and was
modified by the ASP page before calling the GenerateDoc method.
More complex ASP pages may implement advanced tricks by combining
several trees in one or creating the tree from parts obtained from
different sources.
Syntax
stringvar = parser.GenerateDoc( tree [, GenAttribs [, isXML]])
Parameters
tree - VarDictionary collection of collections representing the
document tree. Typically obtained from ParseString method and
modified by the page.
GenAttribs - (optional, default is True). If set to False the
attributes of the nodes in the tree will not be generated. Fastest
way will be used instead. This option is rarely needed and is
recommended only for pages extracting information from HTML pages.
For template oriented usage this option should be always True.
isXML - (optional, default is False). If set to True the self
closing tags will be generated with "/>" at the end -
for compatibility with the XML parsers.
Examples:
Set parser = Server.CreateObject("newObjects.utilctls.TextEmbedParser")
' Use AddTag to configure it
' Pass a HTML to the ParseString method
' Modify the resulting tree
Response.Write parser.GenerateDoc(modified_tree)
Remarks:
Note that TextEmbedParser is HTTML oriented. It is
possible to parse some XML files with it but it is not designed
for that purpose! For example XML assumes case sensitive tags
but HTML tags are case insensitive. However this parser could be
used to extract some information from a HTML file and pack it in
XML. Of course this is not always possible, because HTML is
layout oriented and doesn't describe the contained information.
In some cases it is possible to extract meaningful information
from a set of HTML pages that follow a common design. Then this
parser could be used to extract tags by some characteristics -
such as background color or other visual settings.
|