Installing DataWindow .NET

The DataWindow .NET common setup program also installs Adaptive Server Anywhere, DataWindow Designer, and context-sensitive help for the DataWindow assembly. For complete installation instructions, see the Installation Guide.

Adding controls to the Toolbox

When you install DataWindow .NET on a computer on which Visual Studio .NET 2005 has already been installed, the installer registers the DataWindow .NET controls so that they display in the Visual Studio toolbox.

In a Windows application, the DataWindowControl, DataStore, and Transaction icons display in the toolbox. In a Web application, the WebDataWindowControl and StreamImageContainer icons display when you select View>Designer from the Visual Studio menu. The DataStore and Transaction icons display when you select View>Component Designer from the menu.

If Visual Studio .NET 2005 is installed after DataWindow .NET, you can register the DataWindow .NET controls manually using the DWToolBoxReg utility. The utility is installed in the DataWindow .NET directory.

To register the controls, change directory to the DataWindow .NET directory and type the following commands, where full_path is the full path to your DataWindow .NET 2.0 installation directory:

DWToolBoxReg -a "full_path\DataWindow.dll"
DWToolBoxReg -a "full_path\WebDataWindow.dll"

These commands add a new tab to the Visual Studio .NET toolbox with the name Sybase DataWindow 2.0. You can use a different name for the tab by adding the -tab option to the command line. For example:

DWToolBoxReg -a "full_path\DataWindow.dll" -tab "DataWindow .NET 2.0"

Use the -r option to remove the tab from the toolbox.

Alternatively, you can create a new tab, right-click on the tab, select Choose Items, browse to your DataWindow .NET 2.0 installation directory, and select DataWindow.dll, and then WebDataWindow.dll.

The DWToolboxReg utility works only in Visual Studio .NET 2005. If you are using another development tool that has a toolbox or tool palette, use the mechanism described in the product’s documentation to add DataWindow .NET controls.

Adding DataWindow references to the solution

When you have created a new application in Visual Studio .NET, open the Solution Explorer, right-click References, and select Add References. In the Add Reference dialog box, click Browse and navigate to the DataWindow .NET 2.0 directory, select DataWindow.dll, DataWindowInterop.dll, and, for an ASP.NET application, WebDataWindow.dll, and click OK.

If you use drag-and-drop to add the controls to a form, the references are created automatically.