Using AlphaDAO with Xbasic
Description
Includes: What is AlphaDAO?, terminology, the AlphaDAO object, and creating an object,
What is AlphaDAO?
AlphaDAO provides Xbasic program access to SQL databases such as Microsoft SQL Server, Oracle, MySQL, and Microsoft Access. This functionality extends the familiar Alpha Anywhere database features that also supported .DBF files.
Terminology
This document refers to SQL databases and tables as "back-end" databases and tables, and to Alpha Anywhere tables as local tables.
Goal of this Document
This document provides a few short examples showing how you can use AlphaDAO in your Xbasic scripts. In the examples that follow we will often show more than one way to achieve the desired goal.
Following the Examples
All of the examples in this document can be followed from Alpha Anywhere's Interactive window, or by creating Xbasic scripts. The examples all use the Alphasports.MDB Microsoft Access database. This database ships with Alpha Anywhere and is located in the c:\Program Files\a5v12\MDBFiles folder. If you want to work with data in a different database, the concepts learned from the example here will still apply to your database. In this document, the code that you should type in the Interactive window, or into your scripts, is shown in blue like this:
conn.close()
The AlphaDAO Objects
AlphaDAO comprises many objects. You will use their properties and methods when you do your programming. Some of these objects are reserved for use by Alpha Software's development engineers. At least 90 percent of the time, you will find that you need only use 4 objects to build your applications. This tutorial will examine these objects:
SQL::Connection
SQL::Arguments
SQL::ResultSet
SQL::CallResult
Advanced developers will occasionally use the following objects and enumerations.
SQL::DataTypeInfo
SQL::IndexColumnInfo
SQL::IndexInfo
SQL::IntermediateType Enumerated Type
SQL::Schema
SQL::TableInfo
Creating an Object
You can create an object by using the DIM statement. Afterwards, you will have to set one or more properties of the object, depending on its type and the context.
dim ti as SQL::TableInfo dim ii as SQL::IndexInfo dim ic as SQL::IndexColumnInfo ti.Name = "MyTable" ii.Name = "Primary_Key" ii.PrimaryKey = .t. ic.Name = "MyColumnName"
Frequently you will find a "child" object to be a property of a "parent" object. In these cases the "parent" object has already "DIMmed" it for you.
See Also