js editor
Web development
Creates a table-buffered cursor and populates it with changes, which come from the associated DiffGram.
 Note: |
|---|
| ChangesToCursor is supported only for XMLTable objects in the XMLAdapterВ Tables collection. ChangesToCursor disregards XMLField objects when the XMLFieldВ Alias property is empty. |
XMLTable.ChangesToCursor( [ cAlias [, lIncludeUnchangedData [, nCodePage ]]] ) |
Parameters
- cAlias
- Specifies the alias name for the cursor to be created. The value of cAlias defaults to the XMLTableAlias property, including when cAlias is an empty string ("").
- lIncludeUnchangedData
-
Specifies whether to include unchanged data in the created cursor. The following table lists the values for lIncludeUnchangedData.
lIncludeUnchangedData Description False (.F.)
(Default) Do not include unchanged data in the created cursor.
True (.T.)
Include unchanged data in the created cursor.
- nCodePage
- Integer greater than zero (0) specifying a code page. The default value is zero (0).
Remarks
Applies To: XMLTable Class
When mapping binary fields to Character data types, Visual FoxPro fills any remaining white space with 0x00 characters (CHR(0) or zeros) after decoding.
The nCodePage parameter must exist in the list of supported code pages. If nCodePage is zero (0) and the UseCodePage property is False (.F.), the current default code page is used. For more information, see Code Pages Supported by Visual FoxPro and the UseCodePage Property.
If the RespectNesting property of the XMLAdapter is True (.T.), the node for an unchanged record must be an immediate child for the outer table's node. If the table is not nested, the node must be an immediate child for the XMLAdapter node.
The ChangesToCursor method fails if the XMLNameIsXPath property is True (.T.) because it does not support XPath expressions.