3rd Party Framework Hosting tutorial
DataGrid ASP.NET Hosting Demo A databound ASP.NET page hosted within Virtuoso's WebDAV repository

## Overview

This tutorial is a demonstration of how Virtuoso hosts the ASP.NET and ADO.NET Frameworks as implemented by Microsoft.NET and Mono. The demo consists of a DataGrid control which uses ADO.NET and Virtuoso's managed Data Provider to retrieve data from the local Virtuoso database hosting this tutorial application.

## Prerequisites

The following prerequisites should be used to ensure computer has the appropriate operating system and software to run the Virtuoso 3rd Party Hosting HO-S-7 tutorial on Windows 2000, XP or operating systems capable of running Mono. (See the Mono project home page for information regarding Mono developed by Ximian).

- Virtuoso Universal Servers Microsoft ASP .Net or Mono ECMA-CLI enabled binary
- CLR from Microsoft ASP .Net Framework SDK
- Review the documentation on CLR Hosting setup in the Runtime Hosting, chapter 15 of the Virtuoso documentation

## Tutorial Example

The HO-S-7 tutorial uses the C# bound .aspx page to demonstrate data retrieval via ADO.NET, and data display using the standard ASP.NET DataGrid control.

The source code for the DataGrid control ("VirtSample.aspx") is viewable by clicking the associated hyperlink in the "View Source" column, and can be executed by clicking the "Run" hyperlink in the "Action" column..

Notes

In this tutorial, the data provider being used is the Virtuoso.NET managed provider, which is installed as part of the Virtuoso installation process. To run this tutorial, the demo instance requires an Access Control List file modification (in this case the .INI file associated with the demo database instance); this involves adding a section-key-value to "DirsAllowed" section-key that points to the location of the OpenLink.Data.Virtuoso.dll assembly (which hosts the managed data provider)

Simply append the file reference "../bin/OpenLink.Data.Virtuoso.dll" to the last entry for the section-key "DirsAllowed". If you have changed the password for "demo" SQL account (you are encouraged to do this at installation time), you will need to Edit the connection string in the Web.config file associated with this application domain and change the password (PWD) in key="ConnectionString" element which is part of the appSettings section,

e.g.:

    <add key="ConnectionString" value="HOST=localhost:1112;UID=demo;PWD=demo;Database=demo" />

The Web.config file is located in one of the following locations depending on the CLR being used for the demonstration

- [http_root]/vad/vsp/tutorial/hosting/ho_s_7/Web.config if you are using server hosting MS.NET CLR.
- mono/lib/mono/machine.config if you are using server-hosting ECMA-CLI (Mono).

For troubleshooting tips, refer to the "Environment Setup" section in "Runtime Hosting", chapter 15 in the Virtuoso documentation.