AdsSQLServer Class

Construct a server object.

A string representing the alias of the work area.

A symbol representing the alias of a DBServer object.

A logical value indicating whether the server is positioned at the beginning of the file, on the first record.

**Missing documentation **

A constant, identifying the mode of automatic concurrency control for this data server, determining when and how records are locked and released:

An array containing the structure of this data server, whose length (that is, number of elements) is equal to the number of fields in the server.

Return the original dbstructure array from the DbServer object.

A logical value indicating whether the current record is marked as deleted.

A string representing the name of the database driver in use with this server.

A logical value indicating whether the server is positioned at the end of the file, on the last record

An Error object identifying the error condition after the last operation.

Returns the internal ErrorInfo object, regardless of the last operation produced an error or not.

The number of fields in the server.

This returns an empty array. For servers that were painted in the DbServer editor this returns the array of DataFields.

The FileSpec object that defines the path and file name of the DBF file.

A string representing the current active filter.

The "FOR block" component of the "general server scope," which affects several bulk processing methods if they are called with no explicit scope.

A logical value indicating whether the previous search operation succeeded.

A numeric value representing the length of the database file header.

**Missing documentation **

The hyperlabel connected to this data server. From the hyperlabel, you can retrieve additional information about the data server

A string representing the default index extension based on the database driver currently linked (for example, ".NTX" for the DBFNTX driver).

This returns an empty array. For servers that were painted in the DbServer editor this returns the array of Indexes.

The number of records in the current database file.

The last modification date of the DBF file used in the server.

This returns the memo extension of the file (if any). For example DBT or FPT.

This returns the name of the DbServer.

A symbol representing the name of this data server.

This returns the OLE extension of the file (if any). For example DFL.

A key value representing the record of the bottom boundary in the range of key values that will be included in the controlling order's current scope.

The key value of the current record from the controlling order.

A key value representing the record of the top boundary in the range of key values that will be included in the controlling order's current scope.

This returns a DBSTRUCT array based on the DataFields and Fieldspecs that were painter in the server editor.

A string representing the name of the database driver in use with this server.

This returns the list of RDDs that were passed to the DbServer constructor.

A logical value indicating whether the file was opened as a read-only file. This is determined by an instantiation parameter of the server.

The number of records in the current database file.

A numeric value representing the current record number, identifying the position of the record pointer.

A numeric value representing the record length of the server in bytes.

The returns the array of children that were registered with SetRelation()

The setting that determines how often the DbServer object should retry operations that fail.

An array of record numbers that are currently locked.

The "scope" component of the "general server scope," which affects several bulk processing methods if they are called with no explicit scope. The initial value of the scope is NIL.

The workarea number of the parent area when the dbserver is a child in a relation.

A logical value indicating whether the server is sharable or exclusive.

A HyperLabel object identifying the status after the last operation. If

Return the Extension for the opened DBF. This is normally .DBF but may be different if a file with a different extension was opened.

A logical value indicating whether the server is currently open

The "WHILE block" component of the "general server scope," which affects several bulk processing methods if they are called with no explicit scope

A number representing the workarea of the server

Append a blank record to the end of this data server (the new record becomes the current position and is ready for assignment of data values).

Append a blank record to the table; this blank record becomes the current position and is ready for assignment of data values. The record is automatically locked if the Append() method returns TRUE.

Append new records to the table from another DBF file.

Append new records to the table from a delimited file, such as the "comma-separated-value" (CSV) file format.

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

Return the descriptive label defined for this data server.

Calculate the average of a series of numeric expressions, based on the number of actual records involved.

Export the contents of a binary large object (BLOB) pointer to a file.

Retrieve data stored in a BLOB file without referencing a specific field.

Import a file into a BLOB file and return a pointer to the data.

Put data in a BLOB file without referencing a specific field.

Copy the contents of a BLOB, identified by its memo field number, to a file.

Get the contents of a BLOB, identified by its memo field number.

Read the contents of a file as a BLOB, identified by a memo field number.

Retrieve the data from the root area of a BLOB file.

Obtain a lock on the root area of a BLOB file.

Store data in the root area of a BLOB file.

Release the lock on a BLOB file's root area.

Clear a filter condition specified with the DBServer:SetFilter() method.

Clear all indexes currently associated with the server.

Clear the LOCATE condition of the server, if any.

Set or clear the boundaries for scoping key values in the controlling order.

Clear all active relations held by this server to other servers.

Clear the settings that define the default scope for multi-record operations.

Close the database file and its associated index files.

Commit all changes to disk from the buffer, ensuring that all buffers are flushed.

Create a unique alias based on the filename and an optional numeric suffix

Resume a pending DBServer:Locate() operation, searching for the next record that matches (like the DBContinue() function).

Copy records to another DBF file.

Copy records to a delimited file.

Copy records to an SDF file.

Create a DBF file with the same record layout as the server object to which the message is sent.

Return the number of records that match a specified scope.

Create an index file with an order in it.

Create an order within an existing index file. The behavior depends on which driver is used.

Retrieve the data field object at the specified field position.

Delete the current record in this data server.

Delete the current record or the records specified with the scoping parameters.

Delete all records of the table.

Delete an order from an index file.

Provide a method for handling error conditions raised during database processing.

Evaluate a code block for each record matching a scope and condition. If neither conditions nor scope is passed to the method, it is subject to the general server scope.

Get the contents of a field that is identified by its position.

Read an array of bytes direct from the workarea buffer.

Return the contents of a specified field according to the formatting specifications of its FieldSpec object.

Return the hyperlabel of a specified field.

Return and optionally change information about a field.

Return the name of a specified field as a string.

Return the position of a specified field within the data server, as a number starting with 1.

Set the value of a field identified by its position.

Write an array of bytes direct to the workarea buffer.

Return the FieldSpec object in the specified field.

Return the status of a field after the last operation.

Return the name of a specified field.

Perform all the validations defined to the FieldSpec object of a field (for example, required, maximum and minimum digits, maximum and minimum value, validation rule) and return the result of the test.

Lock the table used by this server for exclusive access.

Retrieve an array of values from a field in the server, subject to the currently active selection, if any.

Retrieve the code block of the current LOCATE condition, or NIL if no code block is set.

Retrieve a two-column array of values from two fields in the server, subject to the currently active selection, if any.

Position the data server at the last record.

Position the data server at a specified record number.

Position the data server at the first record.

Return the key expression of a specified single-order index.

Return the ordinal position of the controlling order in the order list. (Similar to the IndexOrd() function.)

Return and optionally change information about a data server.

Join this DBServer object with another DBServer object and place the results in the file specified.

Search sequentially for a record matching a condition. If neither conditions nor scope is passed to the method, it is subject to the general server scope.

Lock the current record. This method is identical to invoking RLock() with the current record number as a parameter.

Lock all the records in the currently active selection.

Provide a general error interception that is automatically called (in any class) whenever an access reference is made to a non-existent exported instance variable. In the DBServer class, it is used to implement the virtual field variable.
Important! NoIVarGet() should not be called directly; it is called by the system for handling invalid references.

Provide a general error interception that is automatically called (in any class) whenever an assignment reference is made to a non-existent exported instance variable. In the DBServer class, it is used to implement the virtual field variable.
Important! NoIVarPut() should not be called directly; it is called by the system for handling invalid references.

An event handler that responds to events that have occurred in methods of this server, or in other servers that are linked to this server in some way. The standard implementation notifies all the server's clients of the event.
Important! This method is automatically called by the various action methods of the data server, and should normally not be called by application code.

Return and optionally change the descending flag of an order.

Return and optionally change information about orders and index files.

Return the status of the unique flag for a given order.

Add a key to a custom built order.

Return the number of keys in an order.

Delete a key from a custom built order.

Move to a record specified by its logical record number in the controlling order.

Get the logical record number of the current record.

Set the boundaries for scoping key values in the controlling order.

Move the record pointer to the next or previous unique key in the controlling order.

Remove deleted records from a database file.

Implement customized initialization code for the window.

Implement customized initialization code for the server.

Return and optionally change settings controlled directly by the RDD.

Recall those deleted records indicated by a specified scope.

Recall all deleted records in the table.

Retrieve information about the indicated record.

Reread the current record from the database, discarding any changes that have been made.

Requery the SQL statement

Register an object as a client of this data server, so that it receives notification messages from the server about certain actions.

Recreate all active indexes for this server.

Return the linking expression of a specified relation.

Replace one or several fields with a new expression, for all records that match a specified scope.

Resume the broadcasting of Notify messages to the server's attached clients (after DBServer:SuspendNotification() has been called).

Lock a record for exclusive write access; other users can still make read-only reference to the record.

Determine if the current record in this data server has any pending updates and lock it for exclusive write access if there are none.

Undo the changes made to this data server within the current transaction.

Move to the next record having a specified key value in the controlling order.

Move to the record having the specified key value in the controlling order.

Select the workarea that the DbServer uses.

Assign a DataField object to a specified field.

Set a filter condition.

Open an index file and select its order as the controlling order, if this is the first index being opened.

Select an order from one of the open index files as the controlling order.

Set conditions that is applied to index and order creation. If SetOrderCondition() has not been called, order creation is subject to the general server scope. If neither has been set, orders are not conditional.

Set a relation from this server to the child server.

Set a selective relation from this server to the child server; standard database operations are restricted to those records that match the relation.

Move the record pointer forward or backward a specified number of records.

Copy records to another database file in sorted order. If neither conditions nor scope is passed to the method, it is subject to the general server scope.

Calculate the sum of a series of numeric expressions.

Suspend the broadcasting of Notify messages to the server's attached clients.

Aggregate records by key value, producing grouped summarizations, and write the aggregate records to another database.

Remove all locks held on this data server.

Release a specified lock or all locks.

Remove the registration of an object as a client of this data server, so that it no longer receives notification messages from the server about certain actions.

Update this server with data from another server or table.

Update this server with data from another server or table.

Permanently remove all records from the server and release the disk space.