| Microsoft XML SDK 2.6 - XML Reference |  |
| Microsoft XML SDK 2.6 - XML Reference | |
Used for caching compiled XSLT templates.
| createProcessor | Creates a rental-model IXSLProcessor that will use this template. |
| stylesheet | Provides the XSL style sheet to compile into an XSL template. |
Before the Microsoft 2.6 XML Parser (MSXML), every call to transformNode or transformNodeToObject had to recompile the style sheet because the style sheet was simply passed as an XMLDOMNode. You can increase performance by caching the compiled style sheet and reusing it with the XSLTemplate object.
To cache a compiled XSLT style sheet, load an XSLT style sheet into an XSLTemplate object. This object is free-threaded and stateless, so it can be stored in shared .ASP application state. Then to transform a given document using this template, create an XSLProcessor object using the createProcessor method. The XSLProcessor object stores the state for one transform call and has a rental-threading model.
The following C++ example demonstrates the use of a single style sheet with multiple XML files. The style sheet is loaded once and cached into the XSLTemplate object.
BOOL XSLTemplateDemo()
{
BOOL bResult = FALSE;
short sResult = FALSE;
IXMLDOMDocument2 *pStyleSheet=NULL;
IXMLDOMDocument2 *pIXMLDOMDocument2 =NULL;
IXSLTemplate *pIXSLTemplate=NULL;
IXSLProcessor *pIXSLProcessor=NULL;
IXMLDOMDocument2 *pIXMLDOMDocument=NULL;
HRESULT hr;
VARIANT varValue;
try
{
hr = CoCreateInstance(CLSID_XSLTemplate, NULL, CLSCTX_SERVER,
IID_IXSLTemplate, (LPVOID*)(&pIXSLTemplate));
SUCCEEDED(hr) ? 0 : throw hr;
if(pIXSLTemplate)
{
hr=CoCreateInstance(CLSID_FreeThreadedDOMDocument, NULL,
CLSCTX_SERVER, IID_IXMLDOMDocument2,
(LPVOID*)(&pStyleSheet));
SUCCEEDED(hr) ? 0 : throw hr;
if(pStyleSheet)
{
hr=pStyleSheet->put_async(VARIANT_FALSE);
if(SUCCEEDED(hr))
{
hr=pStyleSheet->load(_variant_t(
_T("d:\\inetpub\\wwwroot\\samplexsl.xml")), &sResult);
if(SUCCEEDED(hr) && (sResult==VARIANT_TRUE))
{
hr=pIXSLTemplate->putref_stylesheet(pStyleSheet);
if(SUCCEEDED(hr))
{
hr=pIXSLTemplate->createProcessor(&pIXSLProcessor);
SUCCEEDED(hr) ? 0 : throw hr;
if(pIXSLProcessor)
{
hr=CoCreateInstance(CLSID_DOMDocument, NULL,
CLSCTX_SERVER, IID_IXMLDOMDocument2,
(LPVOID*)(&pIXMLDOMDocument));
SUCCEEDED(hr) ? 0 : throw hr;
if(pIXMLDOMDocument)
{
hr=pIXMLDOMDocument->put_async(VARIANT_FALSE);
if(SUCCEEDED(hr))
{
hr=pIXMLDOMDocument->load(_variant_t(
_T("d:\\inetpub\\wwwroot\\samplexmldtd.xml")),
&sResult);
if(SUCCEEDED(hr) && (sResult==VARIANT_TRUE))
{
hr=pIXSLProcessor->put_input(_variant_t(
pIXMLDOMDocument));
if(SUCCEEDED(hr))
{
hr=pIXSLProcessor->transform(
&sResult);
if(SUCCEEDED(hr)&&(sResult==
VARIANT_TRUE))
{
pIXSLProcessor->get_output(
&varValue);
::MessageBox(NULL,
_bstr_t(varValue),
_T("Transformed
Output"), MB_OK);
}
}
}
}
RELEASE(pIXMLDOMDocument);
}
// Load another document.
hr=CoCreateInstance(CLSID_DOMDocument, NULL,
CLSCTX_SERVER, IID_IXMLDOMDocument2,
(LPVOID*)(&pIXMLDOMDocument2));
SUCCEEDED(hr) ? 0 : throw hr;
if(pIXMLDOMDocument2)
{
hr=pIXMLDOMDocument2->put_async(VARIANT_FALSE);
if(SUCCEEDED(hr))
{
// Load some XML into the document.
hr=pIXMLDOMDocument2->loadXML(
_T("<COLLECTION\ xmlns:dt=\"urn:schemas-
microsoft-\ com:datatypes\">\
<DATE dt:dt=\"datetime\">1998-10-
13T15:56:00\
</DATE><BOOK><TITLE>Cosmos</TITLE> \
<AUTHOR>Carl Sagan</AUTHOR> \
<PUBLISHER>Ballantine Books</PUBLISHER> \
</BOOK> \
</COLLECTION>"), &sResult);
if(SUCCEEDED(hr) && (sResult==VARIANT_TRUE))
{
// Use the same processor.
hr=pIXSLProcessor->put_input(_variant_t(
pIXMLDOMDocument2));
if(SUCCEEDED(hr))
{
hr=pIXSLProcessor->transform(
&sResult);
if(SUCCEEDED(hr)&&(sResult==
VARIANT_TRUE))
{
pIXSLProcessor->get_output(
&varValue);
::MessageBox(NULL,
_bstr_t(varValue),
_T("Transformed
Output"), MB_OK);
}
}
}
}
RELEASE(pIXMLDOMDocument2);
}
RELEASE(pIXSLProcessor);
}
}
}
}
RELEASE(pStyleSheet);
}
RELEASE(pIXSLTemplate);
}
}
catch(...)
{
CHECK_AND_RELEASE(pIXSLProcessor);
CHECK_AND_RELEASE(pIXSLTemplate);
CHECK_AND_RELEASE(pStyleSheet);
CHECK_AND_RELEASE(pIXMLDOMDocument);
CHECK_AND_RELEASE(pIXMLDOMDocument2);
DisplayErrorToUser();
}
return bResult;
}
Implementation: Msxml2.dll, Msxml3.dll
Header and IDL files: Msxml.h, Xmldom.idl
Version-Independent ProgID: Msxml2.XSLTemplate
Version-Independent CLSID: 2933BF94-7B36-11d2-B20E-00C04F983E60
Version-Dependent ProgID: Msxml2.XSLTemplate.2.6
Version-Dependent CLSID: F5078F21-C551-11D3-89B9-0000F81FE221