Click or drag to resize

DbServer.AppendSDF Method

X#
Append new records to the table from an SDF-formatted file.

Namespace:  VO
Assembly:  VORDDClasses (in VORDDClasses.dll) Version: 2.19
Syntax
 VIRTUAL METHOD AppendSDF(
	oFSSource,
	aFieldList,
	cbForBlock,
	cbWhileBlock,
	uScope
) AS USUAL CLIPPER
Request Example View Source

Parameters

oFSSource (Optional)
Type: Usual
A string or filespec object that specifies the source file containing the records to be appended. The source file is opened in shared, read-only mode, and can be open elsewhere in this or some other application.
aFieldList (Optional)
Type: Usual
An array of fields from the source file that are to be included. The default is all fields.
cbForBlock (Optional)
Type: Usual
The condition evaluated for each record in the scope; if TRUE, the record is included in the processing. It provides the same functionality as the FOR clause of record processing commands.
cbWhileBlock (Optional)
Type: Usual
The condition evaluated for each record from the first record until the condition returns FALSE. It provides the same functionality as the WHILE clause of record processing commands.
uScope (Optional)
Type: Usual
The range of records to process, providing the same functionality as the ALL, REST and NEXT clauses of record processing commands.
ValueDescription
DBSCOPEALLThe scope is all the records in the table. This is the default, although if a WHILE condition is specified, the scope becomes DBSCOPEREST.
DBSCOPERESTThe scope is the remaining records in the table from the current position.
<nRecords> The scope is the next nRecords records.

Return Value

Type: Usual
TRUE if successful; otherwise, FALSE (although some records still might have been processed).
Remarks
Sends a NotifyIntentToMove message before the operation.
Sends a NotifyFileChange message, if any record was appended.
See Also