omitXMLDeclaration Property

 

Forces the IMXWriter to skip the XML declaration. This can be useful when you want to output fragments of larger XML documents that can be assembled into a single XML document later.

Visual Basic Implementation Syntax

Property Let IMXWriter_omitXMLDeclaration(ByVal RHS As Boolean)  
Property Get IMXWriter_omitXMLDeclaration() As Boolean  

Visual Basic Usage Syntax

oMXXMLWriter.omitXMLDeclaration= boolValue  
boolValue = oMXXMLWriter.omitXMLDeclaration  

C/C++ Syntax

 [propput]  
HRESULT omitXMLDeclaration (  
   [in] VARIANT_BOOL fValue);  
 [propget]  
HRESULT omitXMLDeclaration (  
   [out, retval] VARIANT_BOOL * fValue);  

Parameters

fValue
Boolean.

Return Values

S_OK
The value returned if no errors are reported.

Remarks

Value Description
True Omit XML declaration.
False (default) Provide XML declaration.

This property is read/write.

The omitXMLDeclaration property has no effect on DOM output.

The IXSLProcessor object implements the omitXMLDeclaration property as follows:

  • When set, overrides the omit-xml-declaration setting used in the active XSLT style sheet assigned to the processor. When XML is the output method, this setting controls whether an XML declaration such as <?xml version="1.0"?> appears in processor output.

  • When read, returns the current omit-xml-declaration setting, either VARIANT_TRUE (True) or VARIANT_FALSE (False). If omit-xml-declaration was not specified in the XSLT style sheet, a value of VARIANT_FALSE (False) is returned.

Versioning

Implemented in: MSXML 3.0 and later

Applies to

IMXWriter Interface

See Also

MXHTMLWriter CoClass
MXXMLWriter CoClass
Sample XML File (books.xml)