SaveAsFile Method

Description

Saves the Current to a file in it native format.

Return Type

A Boolean value. A Boolean with True when successful.
Failure Returns False.

Failure conditions:
Handler does Not support the function
Handler specific.

Syntax

object.SaveAsFile (sFilePath, [eOverWrite], [sDisplayName])

The SaveAsFile Method syntax has these parts:

Part	Description
object	An expression evaluating to an object of type McDataNodes.
sFilePath	Required. A String value. A filename of a new file to be created with the Node content.
eOverWrite	Optional. A mcDataNodeOverwrites enumeration, as described in settings. Specifies the granularity of the store operation. The McDataSource implementation decides how the object is added to the Current.Node. The default implementation for the McImage actually adds a new McDBNode to the Children collection of the Current.Node. All implementations must overwrite the Current.Node (itself) when any 'remove' option is specified (mcdaton_Remove*).
sDisplayName	Optional. A String value. An identifier specifying a particular McDataSource implementation.

Settings

The settings for eOverWrite are:

Constant		Value	Description
	mcdaton_NoOverwriteMakeNew	0	Default: FALSE - Add new with all content and make new when instead of overwrite.
	mcdaton_Attributes	1	add or overwrite attributes
	mcdaton_AttributesRemoveOld	2	remove any existing attributes (prior to save)
	mcdaton_Data	4	add or overwrite data
	mcdaton_DataRemoveOld	8	remove existing data (prior to save)
	mcdaton_Icons	16	add or overwrite icons
	mcdaton_IconsRemoveOld	32	remove any existing attributes (prior to save)
	mcdaton_Categories	64	add categories
	mcdaton_CategoriesRemoveOld	128	remove any existing categories (prior to save)
	mcdaton_Children	256	add children
	mcdaton_ChildrenRemoveOld	512	remove any existing children (prior to save)
	mcdaton_RemoveOld	682	Overwrite All
	mcdaton_All	1023	Add or Overwrite all
	mcdaton_AllTrue	-1	Legacy support. Same as mcdaton_All.

Remarks

The McDataRef is not saved but the