TABLE.RESET Function
Syntax
Arguments
- tablename
The table file's path and name. The .DBF file extension is automatically added to the filename if you do not specify a file extension. To open a set, you must supply the .SET extension.
- file_open_mode|SQL
Optional. Determines the access privileges that apply to the open table file. You can use one of the following system variables:
- Variable
- Function
- FILE_RO_EXCLUSIVE
Read Only (Exclusive)
- FILE_RW_EXCLUSIVE
Read or Write (Exclusive)
- FILE_RO_SHARED
Read Only (Shared)
- FILE_RW_SHARED
Read or Write (Shared)
- alias
Optional. Specifies the alias that the table will have. By default, the table alias is automatically derived from the table name. For example, if the table name is "customer", the first instance of the table that is opened will have an alias of "customer", the second instance will have an alias of "customer0" and so on. It is rare that you would need to specify a specific alias for a table when opening it. If you specify a NULL Alias, Alpha Anywhere automatically computes the alias name.
- encryption
Optional. Only needed if the table has been encrypted, and the default encryption key has not been set (using the DEFAULT_ENCRYPTION_KEY_SET() function), of if the table was encrypted using a different encryption key than the default encryption key.
Description
Open the primary table for the session.
Discussion
The TABLE.RESET() method changes a session's primary table to a different table as specified by Filename. Returns , a pointer to the table that is opened. If Filename refers to a set, references the parent table of the set. Note : The TABLE.RESET() method should only be used in the Interactive window to set the primary table of the Interactive window session. Using TABLE.RESET()in a script attached to an event or button on a form could cause unpredictable results because the table on which the form is based must be the primary table of the session.
Example
This code, executed in the Interactive window, sets the primary table for the Interactive window session to the Customer table.
tbl = table.reset("c:\a5\a_sports\customer.dbf")
table_name = tbl.name_get()
trace.writeln("The current table or set is now: " + table_name)See Also