Generates XML to a file or memory variable.
XMLAdapter.ToXML( cXMLDocument [, cSchemaLocation [, lFile [, lIncludeBefore [, lChangesOnly ]]]] )
- Specifies the file or memory variable name for the XML document.
- Specifies the location for a reference to external schema. The default value of cSchemaLocation is empty (""). If cSchemaLocation is empty and external schema has been generated, the value of XMLAdapterXMLSchemaLocation is used as the external schema reference.
- Specifies whether cXMLDocument is a file. The default value of lFile is False (.F.).
Specifies whether to include the diffgr:before section in the DiffGram. The diffgr:before section contains the original version of a row. The default value of lIncludeBefore is False (.F.).
If lIncludeBefore is True (.T.), Visual FoxPro filters deleted records, regardless of the current filter setting, such as
SET FILTER TO NOT DELETED(В )and
SET DELETED ONor
OFF. All deleted records in the table buffer are inserted in the diffgr:before section but have no matching row in the DiffGram DataInstance block. Although you might want to hide deleted rows by using a filter, the DiffGram indicates which rows were deleted so that the data source can be correctly updated. Visual FoxPro disregards lIncludeBeforeif the XMLAdapterВ IsDiffGram property is False (.F.).
- Specifies whether the XML should contain changes only. Visual FoxPro disregards lChangesOnlyif the XMLAdapterВ IsDiffGram property is False (.F.) or if lIncludeBefore is False (.F.).
Applies To: XMLAdapter Class
If the XMLTableВ Alias property is empty, no XML elements are generated for that object, however, the table is included in the schema if one is generated.
For character fields, Visual FoxPro fills any remaining space in the field with white space (0x20). When maps character fields to binary fields and performs encoding, ToXML encodes the trailing white space regardless of the value for the property.
The following property settings affect how ToXML is executed:
Nested XMLВ В В When the XMLAdapterВ RespectNesting property is True (.T.) and a relationship between the tables is specified, ToXML generates nested XML. Nesting is not supported if the IChangesOnly parameter is set to True (.T.).
XML EncodingВ В В When the XMLAdapterВ RespectCursorCP property is True (.T.), XMLAdapterВ UTF8Encoded is False (.F.), and two or more table aliases are referenced in the collection, those tables should use the same code page. If you also set the UseCodePage property, the results generated by ToXML varies. See UseCodePage property for a table that shows the results.
Numeric Overflow ConditionsВ В В An XMLAdapter object does not load XML containing Visual FoxPro-type numeric overflow conditions, for example,
*****.**, in the place of a Numeric or value. The Microsoft XML Core Services (MSXML) parser causes an error similar to the following:
Error 2110 (XML Error): XML Error: XML Parse error: The value of '***' is invalid according to its data type. The element: 'myfield' has an invalid value according to its data type. Line 7, Position 17. <myfield>***</myfield>
If the XMLNameIsXpath property is True (.T.) for XMLAdapter or XMLTable object and the XMLName property is not empty, ToXML fails. ToXML ignores XMLField objects that use XPath expressions.