This tutorial is based on the Table Viewer project that is included with ASE ADO.NET Data Provider. The complete application can be found in your ASE ADO.NET Data Provider installation directory.
For C#:
<install dir>\Samples\CSharp\TableViewer\TableViewer.csproj
For Visual Basic .NET:
<install dir>\Samples\VB.NET\TableViewer\TableViewer.vbproj
The Table Viewer project is more complex than the Simple project. It illustrates the following features:
Connecting to a database
Working with the AseDataAdapter object
More advanced error handling and result checking
For more information about how the sample works, see “Understanding the Table Viewer sample project”.
Running the Table Viewer code sample in Visual
Studio .NET
Start Visual Studio .NET.
Choose File | Open | Project.
Browse to the Samples directory in your ASE ADO.NET Data Provider installation directory. Go to the CSharp or VB.NET directory and open the Table viewer project.
If you have installed ASE ADO.NET Data Provider using the installation program, go directly to step 7.
If you have not used the installation program, then you need to correct references to ASE ADO.NET Data Provider in the project. To do this, delete the existing reference first:
In the Solution Explorer window, verify that the Simple project is expanded.
Expand the References folder.
Right-click Sybase.AseClient.Data.dll and select Remove.
Add a reference to the ASE ADO.NET Data Provider Assembly.
For instructions, see “Adding a reference to the Data Provider assembly”.
To run the TableViewer sample, choose Debug | Start Without Debugging or press Ctrl+F5.
In the Table Viewer dialog box, supply connection information to an Adaptive Server with pubs2 sample database installed. Click Connect.
The application connects to the ASE pubs2 sample database.
In the Table Viewer dialog box, click Execute.
The application retrieves the data from the authors table in the sample database and puts the query results in the Results DataList.
You can also execute other SQL statements from this application. Enter a SQL statement in the SQL Statement pane and click Execute.
Click the X in the upper right-hand corner of the window to terminate the application and disconnect from the sample database.
Running the Table viewer sample project without
Visual Studio
Open a DOS prompt and go to the appropriate sample directory under <install directory>\Samples.
Add the directory with .NET Framework 1.1 binaries to your system path.
Verify that the dll directory under ASE ADO.NET Data Provider installation directory (the default value for this directory is C:\Sybase\ADO.NET\DLL) is included in the system path and the LIB environment variable.
Compile the sample program using the supplied build script build.bat.
To run the program, enter:
tableviewer.exe
In the Table Viewer dialog box, supply connection information to an Adaptive Server with pubs2 sample database installed.
Click Connect.
The application connects to the ASE pubs2 sample database.
In the Table Viewer dialog box, click Execute.
The application retrieves the data from the authors table in the sample database and puts the query results in the Results DataList.
You can also execute other SQL statements from this application: Enter a SQL statement in the SQL Statement pane, and then click Execute.
Click the X in the upper right-hand corner of the window to terminate the application and disconnect from the sample database.
You have now run the application. The next section describes the application code.
