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

setStartMode Method

Performs subsets of larger XSL Transformations (XSLT) by selecting the XSLT mode with which to start. This minimizes the amount of XSLT processing.

The default value of the start mode is the empty string, "".

Copy 
objXSLProcessor.setStartMode(mode, namespaceURI);

Parameters

mode

The desired mode as a string. It must be the base name part of the qualified name.

namespaceURI(optional)

The full namespace URI to fully qualify the start mode name.

Example

JScript
Copy 
var xslt = new ActiveXObject("Msxml2.XSLTemplate.6.0");
var xslDoc = new ActiveXObject("Msxml2.FreeThreadedDOMDocument.6.0");
var xslProc;
xslDoc.async = false;
xslDoc.load("sample2.xsl");
xslt.stylesheet = xslDoc;
var xmlDoc = new ActiveXObject("Msxml2.DOMDocument.6.0");
xmlDoc.async = false;
xmlDoc.load("books.xml");
xslProc = xslt.createProcessor();
xslProc.input = xmlDoc;
xslProc.setStartMode("view");
xslProc.transform();
WScript.Echo(xslProc.output);

The JScript example uses the following file.

Sample2.xsl

XML
Copy 
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
   <xsl:output method="html"/>
   <xsl:param name="param1"/>
  <xsl:template match="/">
      Hello
  </xsl:template>
  <xsl:template match="/" mode="edit">
      In Edit Mode
  </xsl:template>
  <xsl:template match="/" mode="view">
      In View Mode
  </xsl:template>
</xsl:stylesheet>

In View Mode

Copy 
HRESULT setStartMode(BSTR mode, BSTR namespaceURI);

Parameters

mode[in]

The desired mode as a string. It must be the base name part of the qualified name.

namespaceURI[in, optional]

The full namespace URI to fully qualify the start mode name.

Return Values

S_OK

Success

E_FAIL

The value returned if the value of the readyState property is READYSTATE_INTERACTIVE.

E_INVALIDARG

The value returned if the mode base name contains a colon character or is an invalid name.

Using setStartMode is essentially the same as an XSLT style sheet that starts with the following rule.

Copy 
<xsl:template match="/">
   <xsl:apply-templates select="*" mode="{mode}"/>
</xsl:template>

Implemented in: MSXML 3.0 and MSXML 6.0

Did you find this helpful?
(1500 characters remaining)