AllowDocumentFunction Property

MSXML 5.0 SDK

Microsoft XML Core Services (MSXML) 5.0 for Microsoft Office - DOM Reference

AllowDocumentFunction Property

[This property was not implemented in the early versions of MSXML 5.0 used to produce this documentation. Its availability is subject to change in later versions as MSXML 5.0 is released or updated in the future.]

Enables (true) or disables (false) the document function in XLST. Attempts to call the disabled document function will result in an "Access Denied" error. This property is supported in MSXML 3.0 SP4, MSXML 4.0 SP2, and later.

[JScript]

JScript Syntax

domObj.setProperty(strProp, strVal);
strVal= domObj.getProperty(strProp);
[Visual Basic]

Visual Basic Syntax

domObj.setProperty(strProp, strVal)
strVal= domObj.getProperty(strProp)
[C/C++]

C/C++ Syntax

HRESULT setProperty(BSTR strProp, VARIANT strVal);
HRESULT getProperty(BSTR strProp, VARIANT* strVal);

Value

strProp
A BSTR string whose value is "AllowDocumentFunction".
strVal
A VARIANT_BOOL value of true or false. The default value is true in MSXML 3.0 SP4 and MSXML 4.0 SP2. The default value is false in MSXML 5.0 and later.

Remarks

Because the document function is used in an XSLT style sheet, the AllowDocumentFunction property is effective only when it is set on a DOM object that represents an XSLT style sheet. When set, it applies to all the ensuing transformations initiated either by the transformNode or transformNodeToObject method or through the XSLProcessor object.

When the style sheet DOM object is cloned, the value of this property is not propagated to the cloned object. You need to reset this property on the clone if desired.

When you use XSLTemplate, use the value for the AllowDocumentFunction property that is set on the DOM object when the corresponding XSLT style sheet is added (for example, at compile time). Do not use the value that is set when the style sheet is applied.

When this property is set to false, the presence of the document function in an XSLT style sheet does not necessarily generate errors, as long as the function is not invoked in a transformation.

Applies To

Component: MSXML 3.0 SP4, MSXML 4.0 SP2 and later

Interface: IXMLDOMDocument2

Method: setProperty | getProperty