File: virtclientref.xml

package info (click to toggle)
virtuoso-opensource 7.2.5.1%2Bdfsg1-0.3
links: PTS, VCS
area: main
in suites: bookworm
size: 285,240 kB
sloc: ansic: 641,220; sql: 490,413; xml: 269,570; java: 83,893; javascript: 79,900; cpp: 36,927; sh: 31,653; cs: 25,702; php: 12,690; yacc: 10,227; lex: 7,601; makefile: 7,129; jsp: 4,523; awk: 1,697; perl: 1,013; ruby: 1,003; python: 326
file content (7764 lines) | stat: -rw-r--r-- 237,048 bytes
parent folder | download | duplicates (2)
<?xml version="1.0" encoding="ISO-8859-1"?>

<!--
 -  
 -  This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
 -  project.
 -  
 -  Copyright (C) 1998-2018 OpenLink Software
 -  
 -  This project is free software; you can redistribute it and/or modify it
 -  under the terms of the GNU General Public License as published by the
 -  Free Software Foundation; only version 2 of the License, dated June 1991.
 -  
 -  This program is distributed in the hope that it will be useful, but
 -  WITHOUT ANY WARRANTY; without even the implied warranty of
 -  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
 -  General Public License for more details.
 -  
 -  You should have received a copy of the GNU General Public License along
 -  with this program; if not, write to the Free Software Foundation, Inc.,
 -  51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
 -  
 -  
-->

  <sect1 id="virtclientref">
      <title>ADO.Net Data Provider</title>
      <sect2 id="virtclientrefintro">
        <title>Introduction</title>
        <para>Virtuoso includes an ADO.NET 2.x &amp; 3.x  data providers compatible with Visual Studio
2008 and Entity Frameworks, that provides access to native Virtuoso data (SQL, XML, and RDF) in
addition to any Virtuoso Linked Tables from external <link linkend="vdbengineodbcod">ODBC</link>
and <link linkend="vdbengineodtjd">JDBC</link> accessible data sources.
Known-compatible external data sources include <link linkend="vdbenginemc">Oracle (versions 7.x to 11.x)</link>,
<link linkend="vdbenginemsqls">Microsoft SQL Server (6.x to 2005)</link>,
<link linkend="vdbenginedb2">IBM DB2</link>, <link linkend="vdbenginesyb">Sybase (4.2 to 15.x)</link>,
<link linkend="vdbengineinf">IBM Informix (5.x to 11.x)</link>,
<link linkend="vdbengineing">Ingres (6.4 to 9.x)</link>,
<link linkend="vdbenginepr">Progress (7.x to 10.x)</link>,
<link linkend="vdbenginemsql">MySQL</link>,
<link linkend="vdbenginepsql">PostgreSQL</link> and <link linkend="vdbenginefirebd">Firebird</link>.</para>
        <para><emphasis>Benefits</emphasis></para>
        <para>This provider equips Microsoft .NET based applications, development environments,
and programming languages with conceptual entity-based access to native and heterogeneous data sources.</para>
        <para><emphasis>Features</emphasis></para>
        <itemizedlist mark="bullet">
          <listitem>ADO.NET 3.5 compliance</listitem>
          <listitem>.NET Entity Frameworks compatibility</listitem>
          <listitem>Full integration with Visual Studio 2008</listitem>
          <listitem>ADO.NET Data Services compatibility</listitem>
          <listitem>LINQ to Entities compatibility </listitem>
          <listitem>High-Performance &amp; Scalability </listitem>
          <listitem>High Security</listitem>
          <listitem>Support for Native and 3rd party ODBC and JDBC accessible RDBMS engines and Web Services</listitem>
          <listitem>Tested against all major .NET applications and development environments</listitem>
          <listitem>Support for Microsoft Siliverlight versions 2 and 3</listitem>
          <listitem>Support for .Net RIA Services</listitem>
        </itemizedlist>
      </sect2>
      <sect2 id="virtclientrefinstallandconfig">
        <title>Installation &amp; Configuration</title>
        <para>There are two installation types to consider:</para>
        <itemizedlist mark="bullet">
          <listitem>If you have an existing Virtuoso instance, or will install Virtuoso on a different
host, you only need to install of the <link linkend="virtclientrefinstallandconfigonwin">ADO.Net Provider Client</link> on the Visual Studio host.</listitem>
          <listitem>If you have no existing Virtuoso instance, you can
<link linkend="virtclientrefinstallandconfigvirt">install both the ADO.Net Provider Client and the Virtuoso Universal Server</link> on the Visual Studio host.</listitem>
        </itemizedlist>
        <sect3 id="virtclientrefinstallandconfigonwin"><title>Installation of the ADO.Net Provider Client on Windows</title>
          <para>The Virtuoso ADO.Net Provider is part of the Virtuoso Client Connectivity Kit installer,
and if the target Virtuoso Server installation  already exists on the network this is the only component
that needs to be installed.
          </para>
          <orderedlist>
            <listitem>Download and run the Virtuoso Client Connectivity Kit installer for your target Windows OS:
              <itemizedlist mark="bullet">
                <listitem><ulink url="http://download.openlinksw.com/download/login.vsp?pfam=2&amp;pform=26&amp;pcat=51&amp;prod=virtuoso-connect-psnl&amp;os=i686-generic-win-32&amp;release-dbms=5.0-virt50">Windows 98/NT/2000/XP/2003/Vista/2008 (32 Bit) (x86)</ulink></listitem>
                <listitem><ulink url="http://download.openlinksw.com/download/login.vsp?pfam=2&amp;pform=26&amp;pcat=51&amp;prod=virtuoso-connect-psnl&amp;os=x86_64-generic-win-64&amp;release-dbms=5.0-virt50">Windows XP/2003/Vista/2008 (64 Bit) (x86_64) </ulink></listitem>
              </itemizedlist>
            </listitem>
            <listitem>Choose the "run" button to allow the signed "Virtuoso Client Connectivity kit" installer to start.
              <figure id="ado1" float="1">
                <title>Run</title>
                <graphic fileref="ui/ado1.png"/>
              </figure>
            </listitem>
            <listitem>Choose the "Next" button to begin the installation process.
              <figure id="ado3" float="1">
                <title>Installation: Next</title>
                <graphic fileref="ui/ado3.png"/>
              </figure>
            </listitem>
            <listitem>Check the "I agree with license agreement" checkbox and choose the "Next" button.
              <figure id="ado4" float="1">
                <title>Installation: Agree license</title>
                <graphic fileref="ui/ado4.png"/>
              </figure>
            </listitem>
            <listitem>Choose the "Custom" option to manually select what components are installed and in which location, or choose the "Typical" or "Complete" options as recommended and skip to step 7.
              <figure id="ado5" float="1">
                <title>Custom Install</title>
                <graphic fileref="ui/ado5.png"/>
              </figure>
            </listitem>
            <listitem>If the "Custom" option what chosen, select the installation directory or leave default and choose the "Next" button to continue.
              <figure id="ado6" float="1">
                <title>Installation</title>
                <graphic fileref="ui/ado6.png"/>
              </figure>
            </listitem>
            <listitem>Select which of the ADO.NET Providers are to be installed and choose "Next" to continue.
              <figure id="ado7" float="1">
                <title>ADO.NET Providers</title>
                <graphic fileref="ui/ado7.png"/>
              </figure>
            </listitem>
            <listitem>The installer is now ready to begin the installation, choose the "Install" button to commence the process.
              <figure id="ado8" float="1">
                <title>Install</title>
                <graphic fileref="ui/ado8.png"/>
              </figure>
            </listitem>
            <listitem>The installation was successfully completed.
              <figure id="ado10" float="1">
                <title>Completed installation</title>
                <graphic fileref="ui/ado10.png"/>
              </figure>
            </listitem>
            <listitem>The installation of the Provider can be verified by checking the %WINDOWS%\assembly folder and checking that the Provider(s) chosen for installation is(are) listed - "virtado3" and/or "virtado2".
              <figure id="" float="1">
                <title>Provider</title>
                <graphic fileref="ui/adon8.png"/>
              </figure>
            </listitem>
          </orderedlist>
          <para>The installation of the ADO.Net Provider Client is complete.</para>

          <sect4 id="virtclientrefinstallandconfigonwinuninst">
            <title>Uninstallation</title>
            <orderedlist>
              <listitem>If you attempt to run the installer again, the following message will be displayed.
                <figure id="adon9" float="1">
                  <title>Installer message</title>
                  <graphic fileref="ui/adon9.png"/>
                </figure>
              </listitem>
              <listitem>The Provider can be uninstalled from the "Control Panel" -> "Programs and Features"
menu, by selecting the "Virtuoso Client Connectivity kit" from the list of installed components and clicking
the "unistall" option presented.
                <figure id="ado11" float="1">
                  <title>Uninstall</title>
                  <graphic fileref="ui/ado11.png"/>
                </figure>
              </listitem>
              <listitem>Choose "Yes" to uninstall the Virtuoso ADO.Net Provider.
                <figure id="ado12" float="1">
                  <title>Uninstall</title>
                  <graphic fileref="ui/ado12.png"/>
                </figure>
              </listitem>
            </orderedlist>
          </sect4>
        </sect3>
        <sect3 id="virtclientrefinstallandconfigvirt"><title>Installation of the ADO.Net Provider Client and Virtuoso Universal Server on Windows</title>
          <para>If both the ADO.Net Provider client and Virtuoso Server are to be installed on the same
Windows machine, then the Virtuoso Universal Server installer can be used as it includes all the Virtuoso
client and server components available in a single installer. An instance in which this particular
installation type is require would be when using the Provider to provide Entity Framework connectivity
to the remote database schema objects.</para>
          <orderedlist>
            <listitem>Download and run the Virtuoso Universal Server installer for your target Windows OS:
              <itemizedlist mark="bullet">
                <listitem><ulink url="http://download.openlinksw.com/download/login.vsp?pfam=2&amp;pform=26&amp;pcat=47&amp;prod=virtuoso-uim-unisvr-psnl&amp;os=i686-generic-win-32&amp;os2=i686-generic-win-32&amp;xpfam=virtuoso&amp;xpform=personal&amp;xpcat=unisvr&amp;xos=i686-generic-win-32&amp;xprod=virtuoso-uim-unisvr-psnl&amp;release-dbms=5.0-virt50&amp;proceed=Next+%3E">Windows 98/NT/2000/XP/2003/Vista/2008 (32 Bit) (x86)</ulink></listitem>
                <listitem><ulink url="http://download.openlinksw.com/download/login.vsp?pfam=2&amp;pform=26&amp;pcat=47&amp;prod=virtuoso-uim-unisvr-psnl&amp;os=x86_64-generic-win-64&amp;os2=x86_64-generic-win-64&amp;xpfam=virtuoso&amp;xpform=personal&amp;xpcat=unisvr&amp;xos=x86_64-generic-win-64&amp;xprod=virtuoso-uim-unisvr-psnl&amp;release-dbms=5.0-virt50&amp;proceed=Next+%3E">Windows XP/2003/Vista/2008 (64 Bit) (x86_64)</ulink></listitem>
              </itemizedlist>
            </listitem>
            <listitem>Choose the "run" button to allow the signed "Virtuoso Universal Server" installer to start.
              <figure id="adow1" float="1">
                <title>Run</title>
                <graphic fileref="ui/adow1.png"/>
              </figure>
            </listitem>
            <listitem>Choose the "Next" button to begin the installation process.
              <figure id="adow3" float="1">
                <title>Next</title>
                <graphic fileref="ui/adow3.png"/>
              </figure>
            </listitem>
            <listitem>Check the "I agree with license agreement" checkbox and choose the "Next" button.
              <figure id="adow4" float="1">
                <title>Agree license</title>
                <graphic fileref="ui/adow4.png"/>
              </figure>
            </listitem>
            <listitem>Choose the "Custom" option to manually select what components are installed and in which location, or choose the "Typical" or "Complete" options as recommended and skip to step 7.
              <figure id="adow5" float="1">
                <title>Custom option</title>
                <graphic fileref="ui/adow5.png"/>
              </figure>
            </listitem>
            <listitem>If the "Custom" option what chosen, select the installation directory or leave default and choose the "Next" button to continue.
              <figure id="adow6" float="1">
                <title>Installation directory</title>
                <graphic fileref="ui/adow6.png"/>
              </figure>
            </listitem>
            <listitem>Select which of the ADO.NET Providers are to be installed and choose "Next" to continue.
              <figure id="adow8" float="1">
                <title>ADO.NET Providers</title>
                <graphic fileref="ui/adow8.png"/>
              </figure>
            </listitem>
            <listitem>The installer is now ready to begin the installation, choose the "Install" button to commence the process.
              <figure id="adow9" float="1">
                <title>Begin installation</title>
                <graphic fileref="ui/adow9.png"/>
              </figure>
            </listitem>
            <listitem>The installation was successfully completed.
              <figure id="adow11" float="1">
                <title>Installation completed</title>
                <graphic fileref="ui/adow11.png"/>
              </figure>
            </listitem>
            <listitem>Post installation the Virtuoso Server can be started by running the "Virtuoso Service Manager" which gets added to the Windows "Icons Tray" in the status bar.
              <figure id="adow12" float="1">
                <title>Post installation</title>
                <graphic fileref="ui/adow12.png"/>
              </figure>
            </listitem>
            <listitem>Double click on the  "Virtuoso Service Manager" icon in the "Icons Tray" to load the application, select the "OpenLink Virtuoso Server" instance and press the "Start" button to run the Service.
              <figure id="adow13" float="1">
                <title>Virtuoso Service Manager</title>
                <graphic fileref="ui/adow13.png"/>
              </figure>
            </listitem>
            <listitem>Once the Virtuoso service has successfully started, it is *recommended* that the default "dba" and "dav" passwords be changed to secure values by loading the URL "http://example.com/install" in a Web Browser which loads the following page for making these changes.
              <figure id="adow15" float="1">
                <title>Defaults</title>
                <graphic fileref="ui/adow15.png"/>
              </figure>
            </listitem>
            <listitem>The Virtuoso Server is now available for use.
              <figure id="adow16" float="1">
                <title>Virtuoso Server</title>
                <graphic fileref="ui/adow16.png"/>
              </figure>
            </listitem>
            <listitem>The installation of the ADO.Net Provider can be verified by checking the %WINDOWS%\assembly folder and checking that the Provider(s) chosen for installation is(are) listed &mdash; "virtado3" and/or "virtado2".
              <figure id="adon8" float="1">
                <title>Installation verification</title>
                <graphic fileref="ui/adon8.png"/>
              </figure>
            </listitem>
          </orderedlist>
          <para>The installation of the ADO.Net Provider Client and Virtuoso Universal Server is complete.</para>
          <sect4 id="virtclientrefinstallandconfigvirtuninst">
            <title>Uninstallation</title>
            <orderedlist>
              <listitem>If you attempt to run the installer again, the following message will be displayed.
                <figure id="adon9" float="1">
                  <title>Installer message</title>
                  <graphic fileref="ui/adon9.png"/>
                </figure>
              </listitem>
              <listitem>The Provider can be uninstalled from the "Control Panel" -> "Programs and Features" menu, by selecting the "Virtuoso Client Connectivity kit" from the list of installed components and clicking the "unistall" option presented.
                <figure id="ado11" float="1">
                  <title>Uninstall</title>
                  <graphic fileref="ui/ado11.png"/>
                </figure>
              </listitem>
              <listitem>Choose "Yes" to uninstall the Virtuoso ADO.Net Provider.
                <figure id="ado13" float="1">
                  <title>Uninstall</title>
                  <graphic fileref="ui/ado13.png"/>
                </figure>
              </listitem>
            </orderedlist>
          </sect4>
        </sect3>
      </sect2>
      <sect2 id="virtclientrefprogrammersguide">
        <title>Programmers Guide</title>
        <sect3 id="virtclientrefprogrammersguidewalk"><title>Sample Walk through Applications</title>
<itemizedlist mark="bullet">
  <listitem><link linkend="installvsgrid">Using Visual Studio 2008 to Build a Data Grid Form Application</link></listitem>
  <listitem><link linkend="installvsent">Using Visual Studio 2008 to Build an Entity Frameworks based Windows Form Application</link></listitem>
  <listitem><link linkend="installusado">Using Visual Studio 2008 to Build an ADO.NET Data Services based Application</link></listitem>
  <listitem><link linkend="installwfas">Windows Form Application for accessing Virtuoso RDF data via SPASQL using the Virtuoso ADO.Net Provider</link></listitem>
  <listitem><link linkend="installcrweb">Web Data Service Application for accessing Virtuoso RDF data via SPASQL using the Virtuoso ADO.Net Provider</link></listitem>
  <listitem><link linkend="installsilver">Creating a Silverlight Application to consume the service</link></listitem>
  <listitem><link linkend="installnetriadd">Creating A Simple .NET RIA Services Application to Display Data from Virtuoso</link></listitem>
  <listitem><link linkend="installnetriavd">Creating a .Net RIA Services Application that will Update Virtuoso Data</link></listitem>

</itemizedlist>
        </sect3>
        <sect3 id="virtclientrefprogrammersguideentfr"><title>Using Entity Frameworks, ADO.NET, the Virtuoso Virtual Database Engine</title>
          <para>Virtuoso's in-built virtual database engine for ODBC and JDBC accessible databases enables it
to act as bridge between Entity Frameworks &amp; ADO.NET based client applications. Thus, you simply link
external databases into Virtuoso using the browser based Conductor UI or programmatically using SQL
extensions. Once the external tables a linked/attached, they inherit the functionality prowess of Virtuoso,
and this particular use case scenario, complete compatibility with Entity Frameworks and ADO.NET 3.5.</para>
<itemizedlist mark="bullet">
  <listitem><link linkend="vdbenginemc">Using Microsoft Entity Frameworks to Access Oracle Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbenginepr">Using Microsoft Entity Frameworks to Access Progress Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbengineing">Using Microsoft Entity Frameworks to Access Ingres Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbengineinf">Using Microsoft Entity Frameworks to Access Informix Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbenginedb2">Using Microsoft Entity Frameworks to Access DB2 Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbenginesyb">Using Microsoft Entity Frameworks to Access Sybase Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbenginemsql">Using Microsoft Entity Frameworks to Access MySQL Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbenginepsql">Using Microsoft Entity Frameworks to Access PostgreSQL Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbengineodtjd">Using Microsoft Entity Frameworks to Access JDBC Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbengineodbcod">Using Microsoft Entity Frameworks to Access ODBC Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbenginefirebd">Using Microsoft Entity Frameworks to Access Firebird Schema Objects with Virtuoso</link></listitem>
  <listitem><link linkend="vdbenginemsqls">Using Microsoft Entity Frameworks to Access Microsoft SQL Server Schema Objects with Virtuoso</link></listitem>
</itemizedlist>
        </sect3>
      <sect3 id="vcrvirtdbtype">
	<title>VirtDbType Enumeration</title>

	<para>Specifies Virtuoso data types.</para>

	<section>
	  <title>Members</title>

	  <table>
	    <tgroup cols="2">
	      <thead>
		<row>
		  <entry>Member name</entry>
		  <entry>Description</entry>
		</row>
	      </thead>
	      <tbody>
		<row>
		  <entry><constant>Binary</constant></entry>
		  <entry>BINARY data. This maps to an <type>Array</type> of type <type>Byte</type>.</entry>
		</row>
		<row>
		  <entry><constant>Char</constant></entry>
		  <entry>CHAR data. This maps to <type>String</type>.</entry>
		</row>
		<row>
		  <entry><constant>Date</constant></entry>
		  <entry>DATE data. This maps to <type>DateTime</type>.</entry>
		</row>
		<row>
		  <entry><constant>DateTime</constant></entry>
		  <entry>DATETIME data. This maps to <type>DateTime</type>.</entry>
		</row>
		<row>
		  <entry><constant>Decimal</constant></entry>
		  <entry>This is equal to <constant>Numeric</constant>.</entry>
		</row>
		<row>
		  <entry><constant>Double</constant></entry>
		  <entry>DOUBLE PRECISION data. This maps to <type>Double</type>.</entry>
		</row>
		<row>
		  <entry><constant>Float</constant></entry>
		  <entry>This is equal to Double.</entry>
		</row>
		<row>
		  <entry><constant>Integer</constant></entry>
		  <entry>INTEGER data. This maps to <type>Int32</type></entry>
		</row>
		<row>
		  <entry><constant>LongBinary</constant></entry>
		  <entry>LONG BINARY data. This maps to an <type>Array</type> of type <type>Byte</type>.</entry>
		</row>
		<row>
		  <entry><constant>LongNVarChar</constant></entry>
		  <entry>LONG NVARCHAR data. This maps to <type>String</type>.</entry>
		</row>
		<row>
		  <entry><constant>LongVarChar</constant></entry>
		  <entry>LONG VARCHAR data. This maps to <type>String</type>.</entry>
		</row>
		<row>
		  <entry><constant>NChar</constant></entry>
		  <entry>NChar data. This maps to <type>String</type>.</entry>
		</row>
		<row>
		  <entry><constant>Numeric</constant></entry>
		  <entry>NUMERIC data. This maps to <type>Decimal</type></entry>
		</row>
		<row>
		  <entry><constant>NVarChar</constant></entry>
		  <entry>NVARCHAR data. This maps to <type>String</type>.</entry>
		</row>
		<row>
		  <entry><constant>Real</constant></entry>
		  <entry>REAL data, This maps to <type>Single</type>.</entry>
		</row>
		<row>
		  <entry><constant>SmallInt</constant></entry>
		  <entry>SMALLINT data. This maps to <type>Int16</type></entry>
		</row>
		<row>
		  <entry><constant>Time</constant></entry>
		  <entry>TIME data. This maps to <type>TimeSpan</type></entry>
		</row>
		<row>
		  <entry><constant>TimeStamp</constant></entry>
		  <entry>TIMESTAMP data. This maps to an <type>Array</type> of type <type>Byte</type>.</entry>
		</row>
		<row>
		  <entry><constant>VarBinary</constant></entry>
		  <entry>VARBINARY data. This maps to an <type>Array</type> of type <type>Byte</type>.</entry>
		</row>
		<row>
		  <entry><constant>VarChar</constant></entry>
		  <entry>VARCHAR data. This maps to <type>String</type>.</entry>
		</row>
	      </tbody>
	    </tgroup>
	  </table>

	</section>

      </sect3>

      <sect3 id="vcrvirtuosocommandclass">
	<title>VirtuosoCommand Class</title>

	<para>Represents an SQL statement or stored procedure to execute against a Virtuoso database.
This class cannot be inherited.</para>

  <figure id="virtprovider001" float="0"><title>Virtuoso .Net Provider VirtuosoCommand Class</title>
    <graphic fileref="VirtProviderClassHier.jpg" /></figure>

  <!--simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.MarshalByRefObject</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.ComponentModel.Component</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoCommand</member>
	</simplelist-->

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoCommand</classname>
	  </ooclass>
	  <ooclass>
	    <classname>Component</classname>
	  </ooclass>
	  <oointerface>
	    <interfacename>ICloneable</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>IDbCommand</interfacename>
	  </oointerface>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>The VirtuosoCommand class provides the following methods for executing
commands against a Virtuoso database:</para>
	  <table>
	    <tgroup cols="2">
	      <thead>
		<row>
		  <entry>Item</entry>
		  <entry>Description</entry>
		</row>
	      </thead>
	      <tbody>
		<row>
		  <entry>ExecuteReader</entry>
		  <entry>Executes commands that return rows.</entry>
		</row>
		<row>
		  <entry>ExecuteNonQuery</entry>
		  <entry>Executes commands such as SQL INSERT, DELETE, UPDATE, and SET statements.</entry>
		</row>
		<row>
		  <entry>ExecuteScalar</entry>
		  <entry>Retrieves a single value (for example, an aggregate value) from a database.</entry>
		</row>
	      </tbody>
	    </tgroup>
	  </table>

	</section>

	<section>
	  <title>VirtuosoCommand Constructor</title>

	  <para>Initializes a new instance of the VirtuosoCommand class.</para>

	  <section>
	    <title>VirtuosoCommand Constructor ()</title>

	    <para>Initializes a new instance of the VirtuosoCommand class.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoCommand</methodname>
	      <void/>
	    </constructorsynopsis>

	    <section>
	      <title>Remarks</title>

	      <para>The base constructor initializes all fields to their default values.
The following table shows initial property values for an instance of VirtuosoCommand.</para>

	      <table>
		<tgroup cols="2">
		  <thead>
		    <row>
		      <entry>Properties</entry>
		      <entry>Initial Value</entry>
		    </row>
		  </thead>
		  <tbody>
		    <row>
		      <entry>CommandText</entry>
		      <entry>empty string ("")</entry>
		    </row>
		    <row>
		      <entry>CommandTimeout</entry>
		      <entry>30</entry>
		    </row>
		    <row>
		      <entry>CommandType</entry>
		      <entry>CommandType.Text</entry>
		    </row>
		    <row>
		      <entry>Connection</entry>
		      <entry>null</entry>
		    </row>
		  </tbody>
		</tgroup>
	      </table>

	      <para>You can change the value for any of these properties through a separate call to the property.</para>

	    </section>

	  </section>

	  <section>
	    <title>VirtuosoCommand Constructor (string)</title>

	    <para>Initializes a new instance of the VirtuosoCommand class with the text of the query.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoCommand</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">cmdText</parameter>
	      </methodparam>
	    </constructorsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>cmdText</term>
		  <listitem>
		    The text of the query.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	  </section>

	  <section>
	    <title>VirtuosoCommand Constructor (string, VirtuosoConnection)</title>

	    <para>Initializes a new instance of the VirtuosoCommand class with the text of the query and
an VirtuosoConnection object.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoCommand</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">cmdText</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>VirtuosoConnection</type>
		<parameter moreinfo="none">connection</parameter>
	      </methodparam>
	    </constructorsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>cmdText</term>
		  <listitem>
		    The text of the query.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>connection</term>
		  <listitem>
		    A VirtuosoConnection object that represents the connection to a Virtuoso database.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	  </section>

	  <section>
	    <title>ConnectionString Property</title>

	    <para>The Virtuoso ADO.NET Provider ConnectionString property implements the 
	    IDbConnection.ConnectionString property to get or set the string used to open a Virtuoso 
	    database connection, and includes the source database name and other parameters needed to 
	    establish the initial connection. The default value is an empty string.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>ConnectionString</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>Includes the source database name and other parameters needed to establish the 
	      initial connection. The default value is an empty string.</para>
	      <para>ConnectionString has the following syntax: Each connection string is a sequence of settings 
	      Individual settings are separated by semicolons. Each setting is a pair of name and value delimited 
	      by the equal sign. Whitespace is ignored on either side of both names and values. Names are case 
	      insensitive. The value part can be quoted by either single or double quote characters or remain 
	      unquoted at all. However if it includes a semicolon, single quote, or double quote characters, 
	      it must be enclosed in either type of quotes. To embed the same character that is used for 
	      enclosing the value the character within the value must be doubled.</para>
	      
	      <para>The following table lists the valid names for values within the ConnectionString:</para>

	      <table>
		      <tgroup cols="3">
		        <thead>
		          <row>
		            <entry>Name</entry>
		            <entry>Default</entry>
		            <entry>Description</entry>		            
		          </row>
		        </thead>
		        <tbody>
		          <row>
		            <entry>Connect Timeout or<br/>Connection Timeout</entry>
		            <entry>15</entry>
		            <entry>The number of seconds to wait for a connection to the server before terminating the attempt and generating an error.</entry>		            
		          </row>
		          <row>
		            <entry>Connection Lifetime</entry>
		            <entry>0</entry>
		            <entry>When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by connection lifetime. Useful in clustered configurations to force load balancing between a running server and a server just brought on-line.</entry>		            
		          </row>
		          <row>
		            <entry>Charset</entry>
		            <entry>utf-16</entry>
		            <entry>Specifies the character set to be used by the provider when passing string values to and from the database. Must be set to utf-8 to handle Unicode strings passed in SPARQL/SPASQL queries of RDF data.</entry>		            
		          </row>
		          <row>
		            <entry>Data Source or<br/>Server or<br/>Address or<br/>Network Address or<br/>Host</entry>
		            <entry></entry>
		            <entry>The name or network address of the instance of Virtuoso server to which to connect. Can take comma delimited list of instances for connection fail over.</entry>		            
		          </row>
		          <row>
		            <entry>Encrypt</entry>
		            <entry>false</entry>
		            <entry>Specifies if the connection must be SSL encrypted. Currently encryption only works with an ODBC-based provider.</entry>		            
		          </row>
		          <row>
		            <entry>Enlist</entry>
		            <entry>true</entry>
		            <entry>When true, the pooler automatically enlists the connection in the creation thread's current transaction context.</entry>		            
		          </row>
		          <row>
		            <entry>Initial Catalog or<br/>Database</entry>
		            <entry></entry>
		            <entry>The name of the database.</entry>		            
		          </row>
		          <row>
		            <entry>Max Pool Size</entry>
		            <entry>100</entry>
		            <entry>The maximum number of connections allowed in the pool.</entry>		            
		          </row>
		          <row>
		            <entry>Min Pool Size</entry>
		            <entry>0</entry>
		            <entry>The minimum number of connections allowed in the pool.</entry>		            
		          </row>
		          <row>
		            <entry>Password or<br/>Pwd</entry>
		            <entry></entry>
		            <entry>The password for the Virtuoso account logging on. </entry>		            
		          </row>
		          <row>
		            <entry>Persist Security Info</entry>
		            <entry>false</entry>
		            <entry>When set to 'false', security-sensitive information, such as the password, is not returned as part of the connection if the connection is open or has ever been in an open State. Resetting the connection string resets all connection string values including the password.</entry>		            
		          </row>
		          <row>
		            <entry>Pooling</entry>
		            <entry>true</entry>
		            <entry>	When true, the VirtuosoConnection object is drawn from the appropriate pool, or if necessary, is created and added to the appropriate pool.</entry>		            
		          </row>
		          <row>
		            <entry>RoundRobin</entry>
		            <entry>false</entry>
		            <entry>Enables load balancing in which case the server for the connection is chosen at random from the comma delimited provided as for a Failover connection.</entry>		            
		          </row>
		          <row>
		            <entry>User ID or<br/>Uid</entry>
		            <entry></entry>
		            <entry>The Virtuoso login name.</entry>		            
		          </row>		          
		        </tbody>
		      </tgroup>
	      </table>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbCommand.ConnectionString</para>
	    </section>
 
      <section>
	      <title>Remarks</title>
	       <para>The <emphasis>ConnectionString</emphasis> is similar to an OLE DB connection string, but 
	       is not identical. Unlike OLE DB or ADO, the connection string that is returned is the same as the 
	       user set <emphasis>ConnectionString</emphasis> minus security information if the 
	       <emphasis>Persist Security Info</emphasis> value is set to <emphasis>false</emphasis> (default). 
	       The Virtuoso ADO.NET Data Provider neither persists nor returns the password in a connection 
	       string unless you set <emphasis>Persist Security Info</emphasis> to true.</para>
	       <para>The <emphasis>ConnectionString</emphasis> property can be set only when the connection is 
	       closed. Many of the connection string values have corresponding read-only properties. When the 
	       connection string is set, all of these properties are updated, except when an error is detected; 
	       in this case, none of the properties are updated. <emphasis>VirtuosoConnection</emphasis> 
	       properties return only those settings contained in the <emphasis>ConnectionString</emphasis>.</para>
	       <para>Resetting the <emphasis>ConnectionString</emphasis> on a closed connection resets all 
	       connection string values (and related properties) including the password. For example, if you set a 
	       connection string that includes "<emphasis>Database=Demo</emphasis>", and then reset the connection 
	       string to "<emphasis>Data Source=myserver;User ID=dba;Password=dba</emphasis>", the Database 
	       property is no longer set to <emphasis>Demo</emphasis>.</para>	      
	       <para>The connection string is parsed immediately after being set. If errors in syntax are found 
	       when parsing, a runtime exception (e.g., <emphasis>ArgumentException</emphasis>) is generated. 
	       Other errors can be found only when an attempt is made to open the connection.</para>	       
	    </section>
	    
	  </section>
	  
	  <section>
	    <title>VirtuosoCommand Constructor (string, VirtuosoConnection, VirtuosoTransaction)</title>

	    <para>Initializes a new instance of the VirtuosoCommand class with the text of the query,
an VirtuosoConnection object, and the VirtuosoTransaction.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoCommand</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">cmdText</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>VirtuosoConnection</type>
		<parameter moreinfo="none">connection</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>VirtuosoTransaction</type>
		<parameter moreinfo="none">transaction</parameter>
	      </methodparam>
	    </constructorsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>cmdText</term>
		  <listitem>
		    The text of the query.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>connection</term>
		  <listitem>
		    A VirtuosoConnection object that represents the connection to a Virtuoso database.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>transaction</term>
		  <listitem>
		    The VirtuosoTransaction in which the VirtuosoCommand executes.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>CommandText Property</title>

	    <para>Gets or sets the SQL statement or stored procedure to execute against the Virtuoso database.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>CommandText</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The SQL statement or stored procedure to execute. The default value is an empty string ("").</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbCommand.CommandText</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When the CommandType property is set to StoredProcedure, the CommandText property
should be set using standard ODBC stored procedure escape sequences. Setting the CommandText to the name
of the stored procedure does not function as it does for some other .NET data providers.</para>

	      <para>The Virtuoso .NET Data Provider does not support named parameters for passing parameters
to a SQL statement or a stored procedure called by an OleDbCommand when CommandType is set to Text. In this case,
the question mark (?) placeholder must be used. For example:</para>

	      <informalexample>
		<programlisting format="linespecific">SELECT * FROM Customers WHERE CustomerID = ?</programlisting>
	      </informalexample>

	      <para>As a result, the order in which VirtuosoParameter objects are added to the
VirtuosoParameterCollection must directly correspond to the position of the question mark placeholder
for the parameter.</para>

	    </section>

	  </section>

	  <section>
	    <title>CommandTimeout Property</title>

	    <para>Gets or sets the wait time before terminating an attempt to execute a command and generating
an error.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <varname>CommandTimeout</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The time (in seconds) to wait for the command to execute. The default is 30 seconds.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbCommand.CommandTimeout</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>A value of zero (0) specifies no limit to the wait time, rather than no wait time, and
therefore should be avoided.</para>
	    </section>

	  </section>

	  <section>
	    <title>CommandType Property</title>

	    <para>Gets or sets a value indicating how the CommandText property is interpreted.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>CommandType</type>
	      <varname>CommandType</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>One of the System.Data.CommandType values. The default is Text.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbCommand.CommandType</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When the CommandType property is set to StoredProcedure, you should set the CommandText
property to the full ODBC call syntax. The command then executes this stored procedure when you call one of
the Execute methods (for example, ExecuteReader or ExecuteNonQuery).</para>

	      <para>The Connection, CommandType and CommandText properties cannot be set if the current
connection is performing an execute or fetch operation.</para>

	      <para>The Virtuoso .NET Data Provider does not support passing named parameters to an SQL
statement or to a stored procedure called by a VirtuosoCommand. In either of these cases, use the question
mark (?) placeholder. For example:</para>

	      <informalexample>
		<programlisting format="linespecific">SELECT * FROM Customers WHERE CustomerID = ?</programlisting>
	      </informalexample>

	      <para>The order in which VirtuosoParameter objects are added to the VirtuosoParameterCollection
must directly correspond to the position of the question mark placeholder for the parameter.</para>

	    </section>

	  </section>

	  <section>
	    <title>Connection Property</title>

	    <para>Gets or sets the VirtuosoConnection used by this instance of the VirtuosoCommand.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoConnection</type>
	      <varname>Connection</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The connection to a Virtuoso database. The default is a null value.</para>
	    </section>

	  </section>

	  <section>
	    <title>Parameters Property</title>

	    <para>Gets the VirtuosoParameterCollection.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoParameterCollection</type>
	      <varname>Connection</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The parameters of the SQL statement or stored procedure. The default is an empty collection.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>When CommandType is set to Text, the Virtuoso .NET Data Provider does not support passing named
parameters to an SQL statement or to a stored procedure called by an VirtuosoCommand. In either of these cases, use
the question mark (?) placeholder. For example:</para>

	      <informalexample>
		<programlisting format="linespecific">SELECT * FROM Customers WHERE CustomerID = ?</programlisting>
	      </informalexample>

	      <para>The order in which VirtuosoParameter objects are added to the VirtuosoParameterCollection must
directly correspond to the position of the question mark placeholder for the parameter in the command text.</para>

	      <note><title>Note:</title>
		If the parameters in the collection do not match the requirements of the query to be executed,
		an error may result.
	      </note>

	    </section>

	  </section>

	  <section>
	    <title>Transaction Property</title>

	    <para>Gets or sets the VirtuosoTransaction within which the VirtuosoCommand executes.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoTransaction</type>
	      <varname>Transaction</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>A VirtuosoTransaction. The default is a null value.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>You cannot set the Transaction property if it is already set to a specific value,
and the command is in the process of executing. If you set the transaction property to an
VirtuosoTransaction object that is not connected to the same VirtuosoConnection as the VirtuosoCommand object,
an exception will be thrown the next time you attempt to execute a statement.</para>
	    </section>

	  </section>

	  <section>
	    <title>UpdatedRowSource Property</title>

	    <para>Gets or sets how command results are applied to the DataRow when used by the Update method
of the DbDataAdapter.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>UpdateRowSource</type>
	      <varname>UpdatedRowSource</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>One of the System.Data.UpdateRowSource values.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbCommand.UpdatedRowSource</para>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>Cancel Method</title>

	    <para>Attempts to cancel the execution of an VirtuosoCommand.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Cancel</methodname>
	      <void/>
	    </methodsynopsis>
	  </section>

	  <section>
	    <title>Implements</title>
	    <para>IDbCommand.Cancel</para>
	  </section>

	  <section>
	    <title>Remarks</title>
	    <para>If there is nothing to cancel, nothing happens. However, if there is a command in process,
and the attempt to cancel fails, no exception is generated.</para>
	  </section>

	  <section>
	    <title>CreateParameter Method</title>

	    <para>Creates a new instance of a VirtuosoParameter object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoParameter</type>
	      <methodname>CreateParameter</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>A VirtuosoParameter object.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The CreateParameter method is a strongly-typed version of IDbCommand.CreateParameter.</para>
	    </section>

	  </section>

	  <section>
	    <title>ExecuteNonQuery Method</title>

	    <para>Executes an SQL statement against the Connection and returns the number of rows affected.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <methodname>ExecuteNonQuery</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>For UPDATE, INSERT, and DELETE statements, the return value is the number of rows
affected by the command. For all other types of statements, the return value is -1.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbCommand.ExecuteNonQuery</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>You can use ExecuteNonQuery to perform catalog operations (for example, querying the structure
of a database or creating database objects such as tables); or to change the data in a database, without using a
DataSet, by executing UPDATE, INSERT, or DELETE statements.</para>

	      <para>Although ExecuteNonQuery does not return any rows, any output parameters or return values mapped
to parameters are populated with data.</para>
	    </section>

	  </section>

	  <section>
	    <title>ExecuteReader Method</title>

	    <para>Sends the CommandText to the Connection and builds a VirtuosoDataReader.</para>

	    <section>
	      <title>ExecuteReader Method ()</title>

	      <para>Sends the CommandText to the Connection and builds a VirtuosoDataReader.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>VirtuosoDataReader</type>
		<methodname>ExecuteReader</methodname>
		<void/>
	      </methodsynopsis>

	      <section>
		<title>Return Value</title>
		<para>A VirtuosoDataReader object.</para>
	      </section>

	    </section>

	    <section>
	      <title>ExecuteReader Method (CommandBehavior)</title>

	      <para>Sends the CommandText to the Connection and builds a VirtuosoDataReader using
one of the CommandBehavior values.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>VirtuosoDataReader</type>
		<methodname>ExecuteReader</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>CommandBehavior</type>
		  <parameter moreinfo="none">behavior</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>behavior</term>
		    <listitem>
		      One of the System.Data.CommandBehavior values.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>A VirtuosoDataReader object.</para>
	      </section>

	    </section>

	  </section>

	  <section>
	    <title>ExecuteScalar Method</title>

	    <para>Executes the query, and returns the first column of the first row in the resultset
returned by the query. Extra columns or rows are ignored.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>object</type>
	      <methodname>ExecuteScalar</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>The first column of the first row in the resultset.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbCommand.ExecuteScalar</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>Use the ExecuteScalar method to retrieve a single value (for example, an aggregate value)
from a database. This requires less code than using the ExecuteReader method, and then performing the operations
necessary to generate the single value using the data returned by a VirtuosoDataReader.</para>

	      <para>A typical ExecuteScalar query can be formatted as in the following C# example:</para>

	      <informalexample>
		<programlisting format="linespecific">
command.CommandText = "select count(*) from foobar";
int count = (int) command.ExecuteScalar();
</programlisting>
	      </informalexample>

	    </section>

	  </section>

	  <section>
	    <title>ICloneable.Clone Method</title>

	    <para>This member supports the .NET Framework infrastructure and is not intended to be used directly
from your code.</para>

	    <methodsynopsis>
	      <type>object</type>
	      <methodname>ICloneable.Clone</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>IDbCommand.CreateParameter Method</title>

	    <para>This member supports the .NET Framework infrastructure and is not intended to be used directly
from your code.</para>

	    <methodsynopsis>
	      <type>IDbDataParameter</type>
	      <methodname>IDbCommand.CreateParameter</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>IDbCommand.ExecuteReader Method</title>

	    <para>This member supports the .NET Framework infrastructure and is not intended to be used directly
from your code.</para>

	    <section>
	      <title>IDbCommand.ExecuteReader Method ()</title>

	      <para>This member supports the .NET Framework infrastructure and is not intended to be used directly
from your code.</para>

	      <methodsynopsis>
		<type>IDataReader</type>
		<methodname>IDbCommand.ExecuteReader</methodname>
		<void/>
	      </methodsynopsis>

	    </section>

	    <section>
	      <title>IDbCommand.ExecuteReader Method (CommandBehavior)</title>

	      <para>This member supports the .NET Framework infrastructure and is not intended to be used directly
from your code.</para>

	      <methodsynopsis>
		<type>IDataReader</type>
		<methodname>IDbCommand.ExecuteReader</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>CommandBehavior</type>
		  <parameter moreinfo="none">behavior</parameter>
		</methodparam>
	      </methodsynopsis>

	    </section>

	  </section>

	  <section>
	    <title>Prepare Method</title>

	    <para>Creates a prepared (or compiled) version of the command at the Virtuoso server.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Prepare</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Implements</title>
	      <para>IDbCommand.Prepare</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtcmdbuildr">
	<title>VirtuosoCommandBuilder Class</title>

	<para>Provides a means of automatically generating single-table commands used to reconcile changes
made to a DataSet with the associated Virtuoso database. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.MarshalByRefObject</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.ComponentModel.Component</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoCommandBuilder</member>
	</simplelist>

	<classsynopsis>
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoCommandBuilder</classname>
	  </ooclass>
	  <ooclass>
	    <classname>Component</classname>
	  </ooclass>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>The VirtuosoDataAdapter does not automatically generate the SQL statements required to reconcile
changes made to a DataSet associated with the data source. However, you can create a VirtuosoCommandBuilder object
that generates SQL statements for single-table updates if you set the SelectCommand property of the VirtuosoDataAdapter.
Then, the VirtuosoCommandBuilder generates any additional SQL statements that you do not set.</para>

	  <para>The relationship between a VirtuosoDataAdapter and its corresponding VirtuosoCommandBuilder is always
one-to-one. To create this correspondence, you set the DataAdapter property of the VirtuosoCommandBuilder object.
This causes the VirtuosoCommandBuilder to register itself as a listener for RowUpdating events on the specified
VirtuosoDataAdapter object.</para>

	  <para>To generate INSERT, UPDATE, or DELETE statements, the VirtuosoCommandBuilder uses the SelectCommand
property to retrieve a required set of metadata. If you change the value of SelectCommand after the metadata
has been retrieved (for example, after the first update), you then should call the RefreshSchema method to update
the  metadata.</para>

	  <para>The VirtuosoCommandBuilder also uses the Connection, CommandTimeout, and Transaction properties
referenced by the SelectCommand. The user should call RefreshSchema if any of these properties are modified, or
if the value of the SelectCommand property itself is changed. Otherwise the InsertCommand, UpdateCommand, and
DeleteCommand properties retain their previous values.</para>

	  <para>If you call Dispose, the VirtuosoCommandBuilder is disassociated from the VirtuosoDataAdapter,
and the generated commands are no longer used.</para>

	</section>

	<section>
	  <title>VirtuosoCommandBuilder Constructor</title>

	  <section>
	    <title>VirtuosoCommandBuilder Constructor ()</title>

	    <para>Initializes a new instance of the VirtuosoCommandBuilder class.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoCommandBuilder</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>VirtuosoCommandBuilder Constructor (VirtuosoDataAdapter)</title>

	    <para>Initializes a new instance of the VirtuosoCommandBuilder class with the associated
VirtuosoDataAdapter object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoCommandBuilder</methodname>
	      <methodparam>
		<type>VirtuosoDataAdapter</type>
		<parameter>adapter</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>adapter</term>
		  <listitem>
		    A VirtuosoDataAdapter object to associate with this VirtuosoCommandBuilder.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The VirtuosoCommandBuilder registers itself as a listener for RowUpdating events that are
generated by the VirtuosoDataAdapter specified in this property.</para>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>DataAdapter Property</title>

	    <para>Gets or sets a VirtuosoDataAdapter object for which SQL statements are automatically generated.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoDataAdapter</type>
	      <varname>DataAdapter</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>A VirtuosoDataAdapter object.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The VirtuosoCommandBuilder registers itself as a listener for RowUpdating events that are generated
by the VirtuosoDataAdapter specified in this property.</para>
	    </section>

	  </section>

	  <section>
	    <title>QuotePrefix Property</title>

	    <para>Gets or sets the beginning character or characters to use when working with database objects
(for example, tables or columns) whose names contain characters such as spaces.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>QuotePrefix</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The beginning character or characters to use. The default is an empty string.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Database objects in Virtuoso servers can contain any valid characters, including spaces, commas,
and semicolons. To accommodate this capability, use the QuotePrefix and QuoteSuffix properties to specify delimiters
such as a left bracket and a right bracket to encapsulate the object name.</para>
	    </section>

	  </section>

	  <section>
	    <title>QuoteSuffix Property</title>

	    <para>Gets or sets the ending character or characters to use when working with database objects
(for example, tables or columns) whose names contain characters such as spaces.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>QuotePrefix</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The ending character or characters to use. The default is an empty string.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Database objects in Virtuoso servers can contain any valid characters, including spaces, commas,
and semicolons. To accommodate this capability, use the QuotePrefix and QuoteSuffix properties to specify delimiters
such as a left bracket and a right bracket to encapsulate the object name.</para>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>DeriveParameters Method</title>

	    <para>Retrieves parameter information from the stored procedure specified in the VirtuosoCommand and
populates the Parameters collection of the specified VirtuosoCommand object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <modifier>static</modifier>
	      <void/>
	      <methodname>DeriveParameters</methodname>
	      <methodparam>
		<type>VirtuosoCommand</type>
		<parameter>command</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>command</term>
		  <listitem>
		    The VirtuosoCommand referencing the stored procedure from which the parameter information is to be
		    derived. The derived parameters are added to the Parameters collection of the VirtuosoCommand.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para><methodname>DeriveParameters</methodname> overwrites any existing parameter information for
the VirtuosoCommand. <methodname>DeriveParameters</methodname> requires an extra call to the data server to obtain
the information. If the parameter information is known in advance, it is more efficient to populate the parameters
collection by setting the information explicitly.</para>

	      <para>For more information, see "Using Stored Procedures with a Command" in the
Microsoft .NET Framework SDK documentation.</para>

	    </section>

	  </section>

	  <section>
	    <title>Dispose Method</title>

	    <para>Releases the unmanaged and, optionally, the managed resources used by the VirtuosoCommandBuilder.</para>

	    <methodsynopsis>
	      <modifier>protected</modifier>
	      <modifier>override</modifier>
	      <void/>
	      <methodname>Dispose</methodname>
	      <methodparam>
		<type>bool</type>
		<parameter>disposing</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>disposing</term>
		  <listitem>
		    <literal>true</literal> to release both managed and unmanaged resources;
<literal>false</literal> to release only unmanaged resources.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>This method is called by the public Dispose method and the Finalize method. Dispose() invokes
the protected Dispose(Boolean) method with the disposing parameter set to true. Finalize invokes Dispose with
disposing set to false.</para>

	      <para>When the disposing parameter is true, the method releases all resources held by any managed objects
that this VirtuosoCommand references. It does this by invoking the Dispose() method of each referenced object.</para>

	      <para>For more information about Dispose and Finalize, see "Cleaning Up Unmanaged Resources," and "Overriding the Finalize Method," in the .NET Framework SDK documentation.</para>

	    </section>

	  </section>

	  <section>
	    <title>GetDeleteCommand Method</title>

	    <para>Gets the automatically generated VirtuosoCommand object required to perform deletions on
the Virtuoso database.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoCommand</type>
	      <methodname>GetDeleteCommand</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>The automatically generated VirtuosoCommand object required to perform deletions.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>You can use the GetDeleteCommand method for informational or troubleshooting purposes because
it returns the VirtuosoCommand object to be executed.</para>

	      <para>You can also use GetDeleteCommand as the basis of a modified command. For example, you might call
GetDeleteCommand and modify the CommandTimeout value, and then explicitly set that on the VirtuosoDataAdapter.</para>

	      <para>After the SQL statement is first generated, you must explicitly call RefreshSchema if you change
the statement in any way. Otherwise, the GetDeleteCommand still will be using information from the previous statement,
which might not be correct. The SQL statements are first generated when the application calls either Update or
GetDeleteCommand.</para>

	    </section>

	  </section>

	  <section>
	    <title>GetInsertCommand Method</title>

	    <para>Gets the automatically generated VirtuosoCommand object required to perform insertions on
the Virtuoso database.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoCommand</type>
	      <methodname>GetInsertCommand</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>The automatically generated VirtuosoCommand object required to perform insertions.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>You can use the GetInsertCommand method for informational or troubleshooting purposes because
it returns the VirtuosoCommand object to be executed.</para>

	      <para>You can also use GetInsertCommand as the basis of a modified command. For example, you might call
GetInsertCommand and modify the CommandTimeout value, and then explicitly set that on the VirtuosoDataAdapter.</para>

	      <para>After the SQL statement is first generated, you must explicitly call RefreshSchema if you change
the statement in any way. Otherwise, the GetInsertCommand still will be using information from the previous statement,
which might not be correct. The SQL statements are first generated when the application calls either Update or
GetInsertCommand.</para>

	    </section>

	  </section>

	  <section>
	    <title>GetUpdateCommand Method</title>

	    <para>Gets the automatically generated VirtuosoCommand object required to perform updates on
the Virtuoso database.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoCommand</type>
	      <methodname>GetUpdateCommand</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>The automatically generated VirtuosoCommand object required to perform updates.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>You can use the GetUpdateCommand method for informational or troubleshooting purposes because
it returns the VirtuosoCommand object to be executed.</para>

	      <para>You can also use GetUpdateCommand as the basis of a modified command. For example, you might call
GetUpdateCommand and modify the CommandTimeout value, and then explicitly set that on the VirtuosoDataAdapter.</para>

	      <para>After the SQL statement is first generated, you must explicitly call RefreshSchema if you change
the statement in any way. Otherwise, the GetUpdateCommand still will be using information from the previous statement,
which might not be correct. The SQL statements are first generated when the application calls either Update or
GetUpdateCommand.</para>

	    </section>

	  </section>

	  <section>
	    <title>RefreshSchema Method</title>

	    <para>Refreshes the database schema information used to generate INSERT, UPDATE, or DELETE statements.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>RefreshSchema</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Remarks</title>
	      <para>You should call RefreshSchema whenever the SelectCommand value of the VirtuosoDataAdapter changes.</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtconnclass">
	<title>VirtuosoConnection Class</title>

	<para>Represents an open connection to a Virtuoso database. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.MarshalByRefObject</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.ComponentModel.Component</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoConnection</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoConnection</classname>
	  </ooclass>
	  <ooclass>
	    <classname>Component</classname>
	  </ooclass>
	  <oointerface>
	    <interfacename>ICloneable</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>IDbConnection</interfacename>
	  </oointerface>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>A VirtuosoConnection object represents a unique session to a Virtuoso database server.</para>

	  <para>The VirtuosoConnection object uses native resources such as network connection handles.
You should always explicitly close any open VirtuosoConnection objects by calling Close or Dispose before
the VirtuosoConnection object goes out of scope. Not doing so leaves the freeing of these native resources
to garbage collection, which may not free them immediately. This, in turn, may eventually cause the
underlying driver to run out of resources or reach a maximum limit, resulting in sporadic failures.
For example, you might encounter Maximum Connections-related errors while a number of connections are
waiting to be deleted by the garbage collector. Explicitly closing the connections by calling Close or
Dispose allows a more efficient use of native resources, enhancing scalability and improving overall
application performance.</para>

	</section>

	<section>
	  <title>VirtuosoConnection Constructor</title>

	  <para>Initializes a new instance of the VirtuosoConnection class.</para>

	  <section>
	    <title>VirtuosoConnection Constructor ()</title>

	    <para>Initializes a new instance of the VirtuosoConnection class.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoConnection</methodname>
	      <void/>
	    </constructorsynopsis>

	    <section>
	      <title>Remarks</title>

	      <para>When a new instance of VirtuosoConnection is created, the read/write properties are set
to the following initial values unless they are specifically set using their associated keywords in the
ConnectionString property.</para>

	      <table>
		<tgroup cols="2">
		  <thead>
		    <row>
		      <entry>Properties</entry>
		      <entry>Initial Value</entry>
		    </row>
		  </thead>
		  <tbody>
		    <row>
		      <entry>ConnectionString</entry>
		      <entry>empty string ("")</entry>
		    </row>
		    <row>
		      <entry>ConnectionTimeout</entry>
		      <entry>15</entry>
		    </row>
		    <row>
		      <entry>Database</entry>
		      <entry>empty string ("")</entry>
		    </row>
		  </tbody>
		</tgroup>
	      </table>

	      <para>You can change the value for these properties only by using the ConnectionString property</para>

	    </section>

	  </section>

	  <section>
	    <title>VirtuosoConnection Constructor (string)</title>

	    <para>Initializes a new instance of the VirtuosoConnection class with the specified connection string.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoConnection</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">connectionString</parameter>
	      </methodparam>
	    </constructorsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>connectionString</term>
		  <listitem>
		    The connection used to open the Virtuoso database.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When a new instance of VirtuosoConnection is created, the read/write properties are set
to the following initial values unless they are specifically set using their associated keywords in the
ConnectionString property.</para>

	      <table>
		<tgroup cols="2">
		  <thead>
		    <row>
		      <entry>Properties</entry>
		      <entry>Initial Value</entry>
		    </row>
		  </thead>
		  <tbody>
		    <row>
		      <entry>ConnectionString</entry>
		      <entry>connectionString</entry>
		    </row>
		    <row>
		      <entry>ConnectionTimeout</entry>
		      <entry>15</entry>
		    </row>
		    <row>
		      <entry>Database</entry>
		      <entry>empty string ("")</entry>
		    </row>
		  </tbody>
		</tgroup>
	      </table>

	      <para>You can change the value for these properties only by using the ConnectionString property</para>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>ConnectionString Property</title>

	    <para>Gets or sets the string used to open a Virtuoso database.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>ConnectionString</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The connection string that includes the source database name, and other parameters
needed to establish the initial connection. The default value is an empty string.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbConnection.ConnectionString</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>The ConnectionString is similar to an OLE DB connection string, but is not identical.
Unlike OLE DB or ADO, the connection string that is returned is the same as the user-set ConnectionString
minus security information if the <varname>Persist Security</varname> Info value is set to
<literal>false</literal> (default). The Virtuoso .NET Data Provider does not persist or return the
password in a connection string unless you set <varname>Persist Security Info</varname> to true.</para>

	      <para>The ConnectionString property can be set only when the connection is closed. Many of
the connection string values have corresponding read-only properties. When the connection string is set,
all of these properties are updated, except when an error is detected. In this case, none of the properties
are updated. VirtuosoConnection properties return only those settings contained in the ConnectionString.</para>

	      <para>Resetting the ConnectionString on a closed connection resets all connection string values
(and related properties) including the password. For example, if you set a connection string that includes
"Database=Demo", and then reset the connection string to "Data Source=myserver;User ID=dba;Password=dba",
the Database property is no longer set to northwind.</para>

	      <para>The connection string is parsed immediately after being set. If errors in syntax are found
when parsing, a runtime exception, such as ArgumentException, is generated. Other errors can be found only when
an attempt is made to Open the connection.</para>

	      <para>Connection string has the following syntax. Each connection string is a sequence of settings
Individual settings are separated by semicolons. Each setting is a pair of name and value delimited by the equal
sign. Whitespace is ignored on either side of both names and values. Names are case insensitive. The value part
can be quoted by either single or double quote characters or remain unquoted at all. However if it includes a
semicolon, single quote, or double quote characters, it must be enclosed in either type of quotes. To embed the
same character that is used for enclosing the value the character within the value must be doubled.</para>

	      <para>The following table lists the valid names for values within the ConnectionString.</para>

	      <table>
		<tgroup cols="3">
		  <thead>
		    <row>
 		      <entry>Name</entry>
		      <entry>Default</entry>
		      <entry>Description</entry>
		    </row>
		  </thead>
		  <tbody>
		    <row>
 		      <entry>
                        <simpara>Connect&nbsp;Timeout</simpara>
			<simpara>-or-</simpara>
			<simpara>Connection&nbsp;Timeout</simpara>
                      </entry>
		      <entry>15</entry>
		      <entry>The length of time (in seconds) to wait for a connection to the server before
terminating the attempt and generating an error.</entry>
		    </row>
		    <row>
 		      <entry>Connection&nbsp;Lifetime</entry>
		      <entry>0</entry>
		      <entry>When a connection is returned to the pool, its creation time is compared with
the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified
by connection lifetime. Useful in clustered configurations to force load balancing between a running server
and a server just brought on-line.</entry>
		    </row>
		    <row>
 		      <entry>
                        <simpara>Data&nbsp;Source</simpara>
			<simpara>-or-</simpara>
			<simpara>Server</simpara>
			<simpara>-or-</simpara>
			<simpara>Address</simpara>
			<simpara>-or-</simpara>
			<simpara>Network&nbsp;Address</simpara>
		      </entry>
		      <entry></entry>
		      <entry>The name or network address of the instance of Virtuoso server to which to connect.</entry>
		    </row>
		    <row>
 		      <entry>Encrypt</entry>
		      <entry>false</entry>
		      <entry>Specifies if the connection must be SSL encrypted. Currently encryption only works
with an ODBC-based provider.</entry>
		    </row>
		    <row>
 		      <entry>Enlist</entry>
		      <entry>true</entry>
		      <entry>When true, the pooler automatically enlists the connection in the creation thread's
current transaction context.</entry>
		    </row>
		    <row>
 		      <entry>
                        <simpara>Initial&nbsp;Catalog</simpara>
                        <simpara>-or-</simpara>
                        <simpara>Database</simpara>
                      </entry>
		      <entry></entry>
		      <entry>The name of the database.</entry>
		    </row>
		    <row>
 		      <entry>Max&nbsp;Pool&nbsp;Size</entry>
		      <entry>100</entry>
		      <entry>The maximum number of connections allowed in the pool.</entry>
		    </row>
		    <row>
 		      <entry>Min&nbsp;Pool&nbsp;Size</entry>
		      <entry>0</entry>
		      <entry>The minimum number of connections allowed in the pool.</entry>
		    </row>
		    <row>
 		      <entry>
			<simpara>Password</simpara>
			<simpara>-or-</simpara>
			<simpara>Pwd</simpara>
		      </entry>
		      <entry></entry>
		      <entry>The password for the Virtuoso account logging on.</entry>
		    </row>
		    <row>
 		      <entry>Persist Security Info</entry>
		      <entry>false</entry>
		      <entry>When set to 'false', security-sensitive information, such as the password,
is not returned as part of the connection if the connection is open or has ever been in an open State.
Resetting the connection string resets all connection string values including the password</entry>
		    </row>
		    <row>
 		      <entry>Pooling</entry>
		      <entry>true</entry>
		      <entry>When true, the VirtuosoConnection object is drawn from the appropriate pool,
or if necessary, is created and added to the appropriate pool.</entry>
		    </row>
		    <row>
 		      <entry>
                        <simpara>User ID</simpara>
			<simpara>-or-</simpara>
                        <simpara>Uid</simpara>
                      </entry>
		      <entry></entry>
		      <entry>The Virtuoso login name.</entry>
		    </row>
		  </tbody>
		</tgroup>
	      </table>

	    </section>

	  </section>

	  <section>
	    <title>ConnectionTimeout Property</title>

	    <para>Gets or sets the time to wait while trying to establish a connection before terminating
the attempt and generating an error.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <varname>ConnectionTimeout</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The time (in seconds) to wait for a connection to open. The default value is 15 seconds.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbConnection.ConnectionTimeout</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>A value of 0 indicates no limit, and should be avoided in a ConnectionString because an attempt
to connect will wait indefinitely.</para>
	    </section>

	  </section>

	  <section>
	    <title>Database Property</title>

	    <para>Gets the name of the current database or the database to be used after a connection is opened.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>Database</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The name of the current database or the name of the database to be used once
a connection is open. The default value is an empty string.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbConnection.Database</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Initially, the Database property is set in the connection string. The Database property
can be updated by using the ChangeDatabase method.</para>
	    </section>

	  </section>

	  <section>
	    <title>State Property</title>

	    <para>Gets the current state of the connection.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>ConnectionState</type>
	      <varname>State</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>A bitwise combination of the ConnectionState values. The default is Closed.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The allowed state changes are:</para>

	      <itemizedlist>
		<listitem>
		  From Closed to Open, using the Open method of the connection object.
		</listitem>
		<listitem>
		  From Open to Closed, using either the Close method or the Dispose method of the connection object.
		</listitem>
	      </itemizedlist>

	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>BeginTransaction Method</title>

	    <para>Begins a database transaction.</para>

	    <section>
	      <title>BeginTransaction Method ()</title>

	      <para>Begins a database transaction.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>VirtuosoTransaction</type>
		<methodname>BeginTransaction</methodname>
		<void/>
	      </methodsynopsis>

	      <section>
		<title>Return Value</title>
		<para>An object representing the new transaction.</para>
	      </section>

	      <section>
		<title>Remarks</title>

		<para>To commit or roll back the transaction, you must explicitly use the Commit or Rollback methods.</para>

		<para>To ensure that the Virtuoso .NET Data Provider transaction management model performs correctly,
avoid using other transaction management models, such as those provided by the data source.</para>
	      </section>

	    </section>

	    <section>
	      <title>BeginTransaction Method (IsolationLevel)</title>

	      <para>Begins a database transaction with the specified isolation level.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>VirtuosoTransaction</type>
		<methodname>BeginTransaction</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>IsolationLevel</type>
		  <parameter moreinfo="none">isoLevel</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>isoLevel</term>
		    <listitem>
		      The isolation level under which the transaction should run.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>An object representing the new transaction.</para>
	      </section>

	      <section>
		<title>Remarks</title>

		<para>To commit or roll back the transaction, you must explicitly use the Commit or Rollback methods.</para>

		<para>To ensure that the Virtuoso .NET Data Provider transaction management model performs correctly,
avoid using other transaction management models, such as those provided by the data source.</para>
	      </section>

	    </section>

	  </section>

	  <section>
	    <title>ChangeDatabase Method</title>

	    <para>Changes the current database for an open VirtuosoConnection.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>ChangeDatabase</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">database</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>database</term>
		  <listitem>
		    The name of the database to use in place of the current database.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbConnection.ChangeDatabase</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The value parameter must contain a valid database name, and cannot contain a null value,
an empty string (""), or a string with only blank characters.</para>
	    </section>

	  </section>

	  <section>
	    <title>Close Method</title>

	    <para>Closes the connection to the database. This is the preferred method of closing any open connection.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Close</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Implements</title>
	      <para>IDbConnection.Close</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>The Close method rolls back any pending transactions. It then releases the connection
to the connection pool, or closes the connection if connection pooling is disabled.</para>

	      <para>An application can call Close more than one time. No exception is generated.</para>

	    </section>

	  </section>

	  <section>
	    <title>CreateCommand Method</title>

	    <para>Creates and returns a VirtuosoCommand object associated with the VirtuosoConnection.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoCommand</type>
	      <methodname>CreateCommand</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>A VirtuosoCommand object.</para>
	    </section>

	  </section>

	  <section>
	    <title>EnlistDistributedTransaction Method</title>

	    <para>Enlists in the specified transaction as a distributed transaction.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>EnlistDistributedTransaction</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>ITransaction</type>
		<parameter moreinfo="none">transaction</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>transaction</term>
		  <listitem>
		    <para>A reference to an existing transaction in which to enlist or null to unenlist.</para>
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>You can enlist in an existing distributed transaction using the EnlistDistributedTransaction
method if auto-enlistment is disabled. Enlisting in an existing distributed transaction ensures that, if the
transaction is committed or rolled back, modifications made by the code at the data source are also committed or
 rolled back.</para>
	    </section>

	  </section>

	  <section>
	    <title>ICloneable.Clone Method</title>

	    <para>This member supports the Microsoft .NET Framework infrastructure and is not intended
to be used directly from your code.</para>

	    <methodsynopsis>
	      <type>object</type>
	      <methodname>ICloneable.Clone</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>IDbConnection.BeginTransaction Method</title>

	    <para>This member supports the Microsoft .NET Framework infrastructure and is not intended
to be used directly from your code.</para>

	    <section>
	      <title>IDbConnection.BeginTransaction Method ()</title>

	      <para>This member supports the Microsoft .NET Framework infrastructure and is not intended
to be used directly from your code.</para>

	      <methodsynopsis>
		<type>IDbTransaction</type>
		<methodname>IDbConnection.BeginTransaction</methodname>
		<void/>
	      </methodsynopsis>

	    </section>

	    <section>
	      <title>IDbConnection.BeginTransaction Method (IsolationLevel)</title>

	      <para>This member supports the Microsoft .NET Framework infrastructure and is not intended
to be used directly from your code.</para>

	      <methodsynopsis>
		<type>IDbTransaction</type>
		<methodname>IDbConnection.BeginTransaction</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>IsolationLevel</type>
		  <parameter moreinfo="none">isoLevel</parameter>
		</methodparam>
	      </methodsynopsis>

	    </section>

	  </section>

	  <section>
	    <title>IDbConnection.CreateCommand Method</title>

	    <para>This member supports the Microsoft .NET Framework infrastructure and is not intended
to be used directly from your code.</para>

	    <methodsynopsis>
	      <type>IDbCommand</type>
	      <methodname>IDbConnection.CreateCommand</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>Open Method</title>

	    <para>Opens a database connection with the property settings specified by the ConnectionString.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Open</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Implements</title>
	      <para>IDbConnection.Open</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>The VirtuosoConnection draws an open connection from the connection pool if one is available.
Otherwise, it establishes a new connection to an instance of Virtuoso server.</para>

	      <note><title>Note:</title>
		<para>If the VirtuosoConnection goes out of scope, it is not closed. Therefore, you must explicitly
close the connection by calling Close or Dispose.</para>
	      </note>

	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtdataadaclass">
	<title>VirtuosoDataAdapter Class</title>

	<para>Represents a set of data commands and a connection to a data source that are used to fill the
DataSet and update the data source. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.MarshalByRefObject</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.ComponentModel.Component</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.Data.Common.DataAdapter</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.Data.Common.DbDataAdapter</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoDataAdapter</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoDataAdapter</classname>
	  </ooclass>
	  <ooclass>
	    <classname>DbDataAdapter</classname>
	  </ooclass>
	  <oointerface>
	    <interfacename>IDbDataAdapter</interfacename>
	  </oointerface>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Microsoft Visual Basic) members of this type are safe
for multithreaded operations. Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>The VirtuosoDataAdapter serves as a bridge between a DataSet and data source for
retrieving and saving data. The VirtuosoDataAdapter provides this bridge by using Fill to load data
from the data source into the DataSet, and using Update to send changes made in the DataSet back to
the data source.</para>

	  <para>The VirtuosoDataAdapter also includes the SelectCommand, InsertCommand, DeleteCommand,
UpdateCommand, and TableMappings properties to facilitate loading and updating of data.</para>

	</section>

	<section>
	  <title>VirtuosoDataAdapter Constructor</title>

	  <section>
	    <title>VirtuosoDataAdapter Constructor ()</title>

	    <para>Initializes a new instance of the VirtuosoDataAdapter class.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoDataAdapter</methodname>
	      <void/>
	    </constructorsynopsis>

	    <section>
	      <title>Remarks</title>

	      <para>When you create an instance of VirtuosoDataAdapter, the following read/write properties
are set to their default values, as shown in the table.</para>

	      <table>
		<tgroup cols="2">
		  <thead>
		    <row>
		      <entry>Properties</entry>
		      <entry>Default Value</entry>
		    </row>
		  </thead>
		  <tbody>
		    <row>
		      <entry>MissingMappingAction</entry>
		      <entry>MissingMappingAction.Passthrough</entry>
		    </row>
		    <row>
		      <entry>MissingSchemaAction</entry>
		      <entry>MissingSchemaAction.Add</entry>
		    </row>
		  </tbody>
		</tgroup>
	      </table>

	      <para>You can change the value of any of these properties through a separate call to the property.</para>

	    </section>

	  </section>

	  <section>
	    <title>VirtuosoDataAdapter Constructor (VirtuosoCommand)</title>

	    <para>Initializes a new instance of the VirtuosoDataAdapter class with the specified VirtuosoCommand
as the SelectCommand property.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoDataAdapter</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>VirtuosoCommand</type>
		<parameter moreinfo="none">selectCommand</parameter>
	      </methodparam>
	    </constructorsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>selectCommand</term>
		  <listitem>
		    A VirtuosoCommand that is an SQL SELECT statement or stored procedure, and is set as the
		    SelectCommand property of the VirtuosoDataAdapter.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>This implementation of the VirtuosoDataAdapter constructor sets the SelectCommand property
to the value specified in the selectCommand parameter.</para>

	      <para>When you create an instance of VirtuosoDataAdapter, the following read/write properties
are set to their default values, as shown in the table.</para>

	      <table>
		<tgroup cols="2">
		  <thead>
		    <row>
		      <entry>Properties</entry>
		      <entry>Default Value</entry>
		    </row>
		  </thead>
		  <tbody>
		    <row>
		      <entry>MissingMappingAction</entry>
		      <entry>MissingMappingAction.Passthrough</entry>
		    </row>
		    <row>
		      <entry>MissingSchemaAction</entry>
		      <entry>MissingSchemaAction.Add</entry>
		    </row>
		  </tbody>
		</tgroup>
	      </table>

	      <para>You can change the value of any of these properties through a separate call to the property.</para>

	    </section>

	  </section>

	  <section>
	    <title>VirtuosoDataAdapter Constructor (string, VirtuosoConnection)</title>

	    <para>Initializes a new instance of the VirtuosoDataAdapter class with an SQL SELECT statement
and a VirtuosoConnection.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoDataAdapter</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">selectCommandText</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>VirtuosoConnection</type>
		<parameter moreinfo="none">selectConnection</parameter>
	      </methodparam>
	    </constructorsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>selectCommandText</term>
		  <listitem>
		    A string that is a SQL SELECT statement or stored procedure to be used by the SelectCommand
		    property of the VirtuosoDataAdapter.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>selectConnection</term>
		  <listitem>
		    A VirtuosoConnection that represents the connection.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	  </section>

	  <section>
	    <title>VirtuosoDataAdapter Constructor (string, string)</title>

	    <para>Initializes a new instance of the VirtuosoDataAdapter class with an SQL SELECT statement and
a connection string.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoDataAdapter</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">selectCommandText</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">selectConnectionString</parameter>
	      </methodparam>
	    </constructorsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>selectCommandText</term>
		  <listitem>
		    A string that is a SQL SELECT statement or stored procedure to be used by the SelectCommand
		    property of the VirtuosoDataAdapter.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>selectConnectionString</term>
		  <listitem>
		    The connection string.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>DeleteCommand</title>

	    <para>Gets or sets an SQL statement or stored procedure used to delete records in the data source.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoCommand</type>
	      <varname>DeleteCommand</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>A VirtuosoCommand used during an update operation to delete records in the database
that correspond to deleted rows in the DataSet.</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When DeleteCommand is assigned to a previously created VirtuosoCommand, the VirtuosoCommand
is not cloned. The DeleteCommand maintains a reference to the previously created VirtuosoCommand object.</para>

	    </section>

	  </section>

	  <section>
	    <title>InsertCommand</title>

	    <para>Gets or sets an SQL statement or stored procedure used to insert new records in the data source.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoCommand</type>
	      <varname>InsertCommand</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>A VirtuosoCommand used during an update operation to insert records in the database
that correspond to new rows in the DataSet.</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When InsertCommand is assigned to a previously created VirtuosoCommand, the VirtuosoCommand
is not cloned. The InsertCommand maintains a reference to the previously created VirtuosoCommand object.</para>

	    </section>

	  </section>

	  <section>
	    <title>SelectCommand</title>

	    <para>Gets or sets an SQL statement or stored procedure used to select records in the data source.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoCommand</type>
	      <varname>SelectCommand</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>A VirtuosoCommand used during Fill to select records from the database for placement in the DataSet.</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When SelectCommand is assigned to a previously created VirtuosoCommand, the VirtuosoCommand
is not cloned. The SelectCommand maintains a reference to the previously created VirtuosoCommand object.</para>

	      <para>If the SelectCommand does not return any rows, no tables are added to the DataSet, and no
exception is raised.</para>

	    </section>

	  </section>

	  <section>
	    <title>UpdateCommand</title>

	    <para>Gets or sets an SQL statement or stored procedure used to update records in the data source.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoCommand</type>
	      <varname>UpdateCommand</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>A VirtuosoCommand used during an update operation to update records in the database
that correspond to modified rows in the DataSet.</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When UpdateCommand is assigned to a previously created VirtuosoCommand, the VirtuosoCommand
is not cloned. The UpdateCommand maintains a reference to the previously created VirtuosoCommand object.</para>

	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>CreateRowUpdatedEvent</title>

	    <para>This member overrides DbDataAdapter.CreateRowUpdatedEvent.</para>

	    <methodsynopsis>
	      <modifier>protected</modifier>
	      <modifier>override</modifier>
	      <type>RowUpdatedEventArgs</type>
	      <methodname>CreateRowUpdatedEvent</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>DataRow</type>
		<parameter moreinfo="none">dataRow</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>IDbCommand</type>
		<parameter moreinfo="none">command</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>StatementType</type>
		<parameter moreinfo="none">statementType</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>DataTableMapping</type>
		<parameter moreinfo="none">tableMapping</parameter>
	      </methodparam>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>CreateRowUpdatingEvent</title>

	    <para>This member overrides DbDataAdapter.CreateRowUpdatingEvent.</para>

	    <methodsynopsis>
	      <modifier>protected</modifier>
	      <modifier>override</modifier>
	      <type>RowUpdatedEventArgs</type>
	      <methodname>CreateRowUpdatingEvent</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>DataRow</type>
		<parameter moreinfo="none">dataRow</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>IDbCommand</type>
		<parameter moreinfo="none">command</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>StatementType</type>
		<parameter moreinfo="none">statementType</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>DataTableMapping</type>
		<parameter moreinfo="none">tableMapping</parameter>
	      </methodparam>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>OnRowUpdated</title>

	    <para>Raises the RowUpdated event.</para>

	    <methodsynopsis>
	      <modifier>protected</modifier>
	      <modifier>override</modifier>
	      <void/>
	      <methodname>OnRowUpdated</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>RowUpdatedEventArgs</type>
		<parameter moreinfo="none">value</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>value</term>
		  <listitem>
		    <para>A System.Data.Common.RowUpdatedEventArgs object that contains the event data.</para>
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Raising an event invokes the event handler through a delegate. For an overview,
see "Raising an Event" in the Microsoft .NET Framework SDK documentation.</para>
	    </section>

	  </section>

	  <section>
	    <title>OnRowUpdating</title>

	    <para>Raises the RowUpdating event.</para>

	    <methodsynopsis>
	      <modifier>protected</modifier>
	      <modifier>override</modifier>
	      <void/>
	      <methodname>OnRowUpdating</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>RowUpdatingEventArgs</type>
		<parameter moreinfo="none">value</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>value</term>
		  <listitem>
		    <para>A System.Data.Common.RowUpdatingEventArgs object that contains the event data.</para>
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Raising an event invokes the event handler through a delegate. For an overview,
see "Raising an Event" in the Microsoft .NET Framework SDK documentation.</para>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Events</title>

	  <section>
	    <title>RowUpdated</title>

	    <para>Occurs during an Update operation after a command is executed against the data source.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <modifier>event</modifier>
	      <type>VirtuosoRowUpdatedEventHandler</type>
	      <varname>RowUpdated</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Event Data</title>

	      <para>The event handler receives an argument of type VirtuosoRowUpdatedEventArgs containing data
related to this event. The following VirtuosoRowUpdatedEventArgs properties provide information specific
to this event.</para>

	      <table>
		<tgroup cols="2">
		  <thead>
		    <row>
		      <entry>Property</entry>
		      <entry>Description</entry>
		    </row>
		  </thead>
		  <tbody>
		    <row>
		      <entry>Command</entry>
		      <entry>Gets the VirtuosoCommand executed when Update is called.</entry>
		    </row>
		    <row>
		      <entry>Errors (inherited from RowUpdatedEventArgs)</entry>
		      <entry>Gets any errors generated by the .NET data provider when the Command was executed.</entry>
		    </row>
		    <row>
		      <entry>RecordsAffected (inherited from RowUpdatedEventArgs)</entry>
		      <entry>Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.</entry>
		    </row>
		    <row>
		      <entry>Row (inherited from RowUpdatedEventArgs)</entry>
		      <entry>Gets the DataRow sent through an Update.</entry>
		    </row>
		    <row>
		      <entry>StatementType (inherited from RowUpdatedEventArgs)</entry>
		      <entry>Gets the type of SQL statement executed.</entry>
		    </row>
		    <row>
		      <entry>Status (inherited from RowUpdatedEventArgs)</entry>
		      <entry>Gets the UpdateStatus of the Command.</entry>
		    </row>
		    <row>
		      <entry>TableMapping (inherited from RowUpdatedEventArgs)</entry>
		      <entry>Gets the DataTableMapping sent through an Update.</entry>
		    </row>
		  </tbody>
		</tgroup>
	      </table>

	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When using the Update method, there are two events that occur per data row updated.
The order of execution is as follows:</para>

	      <orderedlist inheritnum="ignore" continuation="restarts">
		<listitem>
		  The values in the DataRow are moved to the parameter values.
		</listitem>
		<listitem>
		  The OnRowUpdating event is raised.
		</listitem>
		<listitem>
		  The command executes.
		</listitem>
		<listitem>
		  If the UpdateRowSource enumeration is set to FirstReturnedRecord, the first returned result
		  is placed in the DataRow.
		</listitem>
		<listitem>
		  If there are output parameters, they are placed in the DataRow.
		</listitem>
		<listitem>
		  The OnRowUpdated event is raised.
		</listitem>
		<listitem>
		  AcceptChanges is called.
		</listitem>
	      </orderedlist>

	    </section>

	  </section>

	  <section>
	    <title>RowUpdating</title>

	    <para>Occurs during an Update operation before a command is executed against the data source.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <modifier>event</modifier>
	      <type>VirtuosoRowUpdatingEventHandler</type>
	      <varname>RowUpdating</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Event Data</title>

	      <para>The event handler receives an argument of type VirtuosoRowUpdatingEventArgs containing data
related to this event. The following VirtuosoRowUpdatingEventArgs properties provide information specific to this
event.</para>

	      <table>
		<tgroup cols="2">
		  <thead>
		    <row>
		      <entry>Property</entry>
		      <entry>Description</entry>
		    </row>
		  </thead>
		  <tbody>
		    <row>
		      <entry>Command</entry>
		      <entry>Gets or sets the VirtuosoCommand to execute when Update is called.</entry>
		    </row>
		    <row>
		      <entry>Errors (inherited from RowUpdatingEventArgs)</entry>
		      <entry>Gets any errors generated by the .NET data provider when the Command executes.</entry>
		    </row>
		    <row>
		      <entry>Row (inherited from RowUpdatingEventArgs)</entry>
		      <entry>Gets the DataRow to send through an Update.</entry>
		    </row>
		    <row>
		      <entry>StatementType (inherited from RowUpdatingEventArgs)</entry>
		      <entry>Gets the type of SQL statement to execute.</entry>
		    </row>
		    <row>
		      <entry>Status (inherited from RowUpdatingEventArgs)</entry>
		      <entry>Gets the UpdateStatus of the Command.</entry>
		    </row>
		    <row>
		      <entry>TableMapping (inherited from RowUpdatingEventArgs)</entry>
		      <entry>Gets the DataTableMapping to send through the Update.</entry>
		    </row>
		  </tbody>
		</tgroup>
	      </table>

	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When using the Update method, there are two events that occur per data row updated.
The order of execution is as follows:</para>

	      <orderedlist inheritnum="ignore" continuation="restarts">
		<listitem>
		  The values in the DataRow are moved to the parameter values.
		</listitem>
		<listitem>
		  The OnRowUpdating event is raised.
		</listitem>
		<listitem>
		  The command executes.
		</listitem>
		<listitem>
		  If the UpdateRowSource enumeration is set to FirstReturnedRecord, the first returned result
		  is placed in the DataRow.
		</listitem>
		<listitem>
		  If there are output parameters, they are placed in the DataRow.
		</listitem>
		<listitem>
		  The OnRowUpdated event is raised.
		</listitem>
		<listitem>
		  AcceptChanges is called.
		</listitem>
	      </orderedlist>

	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtdatareadrclass">
	<title>VirtuosoDataReader Class</title>

	<para>Provides a means of reading a forward-only stream of rows from a Virtuoso database. This class cannot
be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.MarshalByRefObject</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoDataReader</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoDataReader</classname>
	  </ooclass>
	  <ooclass>
	    <classname>MarshalByRefObject</classname>
	  </ooclass>
	  <oointerface>
	    <interfacename>IDataReader</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>IDataRecord</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>IDisposable</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>IEnumerable</interfacename>
	  </oointerface>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>To create a VirtuosoDataReader, you must call the ExecuteReader method of the VirtuosoCommand object,
rather than directly using a constructor.</para>

	  <para>Changes made to a resultset by another process or thread while data is being read may be visible to
the user of the VirtuosoDataReader. However, the precise behavior is both driver and timing dependent.</para>

	  <para>IsClosed and RecordsAffected are the only properties that you can call after the VirtuosoDataReader
is closed. In some cases, you must call Close before you can call RecordsAffected.</para>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>Depth Property</title>

	    <para>Gets a value indicating the depth of nesting for the current row.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <varname>Depth</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The depth of nesting for the current row.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataReader.Depth</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The outermost table has a depth of zero. The Virtuoso .NET Data Provider does not support
nesting and always returns zero.</para>
	    </section>

	  </section>

	  <section>
	    <title>FieldCount Property</title>

	    <para>Gets the number of columns in the current row.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <varname>FieldCount</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>When not positioned in a valid record set, 0; otherwise the number of columns in the current record.
The default is -1.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.FieldCount</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>After executing a query that does not return rows, FieldCount returns 0.</para>
	    </section>

	  </section>

	  <section>
	    <title>IsClosed Property</title>

	    <para>Gets a value indicating whether the data reader is closed.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>bool</type>
	      <varname>IsClosed</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para><literal>true</literal> if the VirtuosoDataReader is closed; otherwise,
<literal>false</literal>.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataReader.IsClosed</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>IsClosed and RecordsAffected are the only properties that you can call after the
VirtuosoDataReader is closed.</para>
	    </section>

	  </section>

	  <section>
	    <title>Item Property</title>

	    <section>
	      <title>Item Property (int)</title>

	      <para>Gets the value of the specified column in its native format given the column ordinal.</para>

	      <fieldsynopsis>
		<modifier>public</modifier>
		<type>object</type>
		<varname>this[int i]</varname>
	      </fieldsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>i</term>
		    <listitem>
		      <para>The zero-based column ordinal.</para>
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Property Value</title>
		<para>The value of the specified column in its native format.</para>
	      </section>

	      <section>
		<title>Implements</title>
		<para>IDataRecord.Item</para>
	      </section>

	    </section>

	    <section>
	      <title>Item Property (string)</title>

	      <para>Gets the value of the specified column in its native format given the column name.</para>

	      <fieldsynopsis>
		<modifier>public</modifier>
		<type>object</type>
		<varname>this[string name]</varname>
	      </fieldsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>name</term>
		    <listitem>
		      <para>The column name.</para>
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Property Value</title>
		<para>The value of the specified column in its native format.</para>
	      </section>

	      <section>
		<title>Implements</title>
		<para>IDataRecord.Item</para>
	      </section>

	    </section>

	  </section>

	  <section>
	    <title>RecordsAffected Property</title>

	    <para>Gets the number of rows changed, inserted, or deleted by execution of the SQL statement.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <varname>RecordsAffected</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The number of rows changed, inserted, or deleted; 0 if no rows were affected or the statement
failed; and -1 for SELECT statements.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataReader.RecordsAffected</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>IsClosed and RecordsAffected are the only properties that you can call after the
VirtuosoDataReader is closed.</para>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>Close Method</title>

	    <para>Closes the VirtuosoDataReader object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Close</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Implements</title>
	      <para>IDataReader.Close</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>You must explicitly call the Close method when you are through using the VirtuosoDataReader
to use the associated VirtuosoConnection for any other purpose.</para>

	      <para>The Close method fills in the values for output parameters, return values and RecordsAffected.</para>

	    </section>

	  </section>

	  <section>
	    <title>GetBoolean Method</title>

	    <para>Gets the value of the specified column as a Boolean.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>bool</type>
	      <methodname>GetBoolean</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>A Boolean that is the value of the column.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetBoolean</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetByte Method</title>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>byte</type>
	      <methodname>GetByte</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a byte.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetByte</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetBytes Method</title>

	    <para>Reads a stream of bytes from the specified column offset into the buffer as an array,
starting at the given buffer offset.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>long</type>
	      <methodname>GetBytes</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>long</type>
		<parameter moreinfo="none">fieldOffset</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>byte[]</type>
		<parameter moreinfo="none">buffer</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">bufferOffset</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">length</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>fieldOffset</term>
		  <listitem>
		    The index within the field from which to begin the read operation.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>buffer</term>
		  <listitem>
		    The buffer into which to read the stream of bytes.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>bufferOffset</term>
		  <listitem>
		    The index for buffer to begin the read operation.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>length</term>
		  <listitem>
		    The number of bytes to read.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The actual number of bytes read.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetBytes</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>GetBytes returns the number of available bytes in the field. In most cases this is the exact
length of the field. However, the number returned may be less than the true length of the field if GetBytes has
already been used to obtain bytes from the field. This may be the case, for example, if the VirtuosoDataReader is
reading a large data structure into a buffer. For more information, see the SequentialAccess setting of
System.Data.CommandBehavior in the Microsoft .NET Framework SDK documentation.</para>

	      <para>If you pass a buffer that is a null value, GetBytes returns the length of the field in bytes.</para>

	    </section>

	  </section>

	  <section>
	    <title>GetChar Method</title>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>char</type>
	      <methodname>GetChar</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a character.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetChar</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetChars Method</title>

	    <para>Reads a stream of characters from the specified column offset into the buffer as an array,
starting at the given buffer offset.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>long</type>
	      <methodname>GetChars</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>long</type>
		<parameter moreinfo="none">fieldOffset</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>char[]</type>
		<parameter moreinfo="none">buffer</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">bufferOffset</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">length</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>fieldOffset</term>
		  <listitem>
		    The index within the field from which to begin the read operation.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>buffer</term>
		  <listitem>
		    The buffer into which to copy data..
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>bufferOffset</term>
		  <listitem>
		    The index for buffer to begin the read operation.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>length</term>
		  <listitem>
		    The number of characters to read.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The actual number of characters read.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetChars</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>GetChars returns the number of available characters in the field. In most cases this is the
exact length of the field. However, the number returned may be less than the true length of the field if GetChars
has already been used to obtain characters from the field. This may be the case, for example, if the
VirtuosoDataReader is reading a large data structure into a buffer. For more information, see the SequentialAccess
setting of System.Data.CommandBehavior in the Microsoft .NET Framework SDK documentation.</para>

	      <para>If you pass a buffer that is a null value. GetChars returns the length of the field in
characters.</para>

	    </section>

	  </section>

	  <section>
	    <title>GetData Method</title>

	    <para>Not currently supported.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>IDataReader</type>
	      <methodname>GetData</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetData</para>
	    </section>

	  </section>

	  <section>
	    <title>GetDataTypeName Method</title>

	    <para>Gets the name of the source data type.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <methodname>GetDataTypeName</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The name of the source data type.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetDataTypeName</para>
	    </section>

	  </section>

	  <section>
	    <title>GetDateTime Method</title>

	    <para>Gets the value of the specified column as a DateTime object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>DateTime</type>
	      <methodname>GetDateTime</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a DateTime object.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetDateTime</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetDecimal Method</title>

	    <para>Gets the value of the specified column as a Decimal object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>decimal</type>
	      <methodname>GetDecimal</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a Decimal object.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetDecimal</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetDouble Method</title>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>double</type>
	      <methodname>GetDouble</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a double-precision floating point number.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetDouble</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetFieldType Method</title>

	    <para>Gets the Type that is the data type of the object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>Type</type>
	      <methodname>GetFieldType</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The Type that is the data type of the object.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetFieldType</para>
	    </section>

	  </section>

	  <section>
	    <title>GetFloat Method</title>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>float</type>
	      <methodname>GetFloat</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a single-precision floating-point number.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetFloat</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetGuid Method</title>

	    <para>Gets the value of the specified column as a globally-unique identifier (GUID).</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>Guid</type>
	      <methodname>GetGuid</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a GUID.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetGuid</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetInt16 Method</title>

	    <para>Gets the value of the specified column as a 16-bit signed integer.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>short</type>
	      <methodname>GetInt16</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a 16-bit signed integer.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetInt16</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetInt32 Method</title>

	    <para>Gets the value of the specified column as a 32-bit signed integer</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <methodname>GetInt32</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a 32-bit signed integer.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetInt32</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetInt64 Method</title>

	    <para>Gets the value of the specified column as a 64-bit signed integer.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>long</type>
	      <methodname>GetInt64</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a 64-bit signed integer.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetInt64</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetName Method</title>

	    <para>Gets the name of the specified column.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <methodname>GetName</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>A string that is the name of the specified column.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetName</para>
	    </section>
	  </section>

	  <section>
	    <title>GetOrdinal Method</title>

	    <para>Gets the column ordinal, given the name of the column.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <methodname>GetOrdinal</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">name</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>name</term>
		  <listitem>
		    The name of the column.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The zero-based column ordinal.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetOrdinal</para>
	    </section>

<!--
	    <section>
	      <title>Remarks</title>

GetOrdinal performs a case-sensitive lookup first. If it fails, a second case-insensitive search is made.

GetOrdinal is kana-width insensitive.

Because ordinal-based lookups are more efficient than named lookups, it is inefficient to call GetOrdinal within a loop. Save time by calling GetOrdinal once and assigning the results to an integer variable for use within the loop.

	    </section>
-->

	  </section>

	  <section>
	    <title>GetSchemaTable Method</title>

	    <para>Returns a DataTable that describes the column metadata of the VirtuosoDataReader.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>DataTable</type>
	      <methodname>GetSchemaTable</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>A DataTable that describes the column metadata.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataReader.GetSchemaTable</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>For the GetSchemaTable method returns metadata about each column in the following order:</para>

	      <table>
		<tgroup cols="2">
		  <thead>
		    <row>
		      <entry>DataReader Column</entry>
		      <entry>Description</entry>
		    </row>
		  </thead>
		  <tbody>
		    <row>
		      <entry>ColumnName</entry>
		      <entry>The name of the column; this might not be unique. If the column name cannot be determined,
a null value is returned. This name always reflects the most recent naming of the column in the current view or command
text.</entry>
		    </row>
		    <row>
		      <entry>ColumnOrdinal</entry>
		      <entry>The ordinal of the column. This is zero for the bookmark column of the row, if any. Other
columns are numbered starting with one. This column cannot contain a null value.</entry>
		    </row>
		    <row>
		      <entry>ColumnSize</entry>
		      <entry>The maximum possible length of a value in the column. For columns that use a fixed-length
data type, this is the size of the data type.</entry>
		    </row>
		    <row>
		      <entry>NumericPrecision</entry>
		      <entry>If ProviderType is a numeric data type, this is the maximum precision of the column.
The precision depends on the definition of the column. If ProviderType is not a numeric data type, this is a null
value.</entry>
		    </row>
		    <row>
		      <entry>NumericScale</entry>
		      <entry>If ProviderType is decimal, the number of digits to the right of the decimal point.
Otherwise, this is a null value.</entry>
		    </row>
		    <row>
		      <entry>DataType</entry>
		      <entry>Maps to the .Net Framework type of the column.</entry>
		    </row>
		    <row>
		      <entry>ProviderType</entry>
		      <entry>The indicator of the column's data type. If the data type of the column varies from
row to row, this must be Object. This column cannot contain a null value.</entry>
		    </row>
		    <row>
		      <entry>IsLong</entry>
		      <entry>Set if the column contains a Binary Long Object (BLOB) that contains very long data.</entry>
		    </row>
		    <row>
		      <entry>AllowDBNull</entry>
		      <entry>Set if the consumer can set the column to a null value or if the provider cannot determine
whether or not the consumer can set the column to a null value. Otherwise, not set. A column may contain null values,
even if it cannot be set to a null value.</entry>
		    </row>
		    <row>
		      <entry>IsReadOnly</entry>
		      <entry><literal>true</literal> if the column can be modified; otherwise
<literal>false</literal>.</entry>
		    </row>
		    <row>
		      <entry>IsRowVersion</entry>
		      <entry></entry>
		    </row>
		    <row>
		      <entry>IsUnique</entry>
		      <entry><literal>true</literal>: No two rows in the base table-the table returned in
BaseTableName-can have the same value in this column. IsUnique is guaranteed to be true if the column
constitutes a key by itself or if there is a constraint of type UNIQUE that applies only to this column.
<literal>false</literal>: The column can contain duplicate values in the base table. The default of this
column is <literal>false</literal>.</entry>
		    </row>
		    <row>
		      <entry>IsKey</entry>
		      <entry><literal>true</literal>: The column is one of a set of columns in the rowset that,
taken together, uniquely identify the row. The set of columns with IsKey set to <literal>true</literal> must
uniquely identify a row in the rowset. There is no requirement that this set of columns is a minimal set of
columns. This set of columns may be generated from a base table primary key, a unique constraint or a unique
index. <literal>false</literal>: The column is not required to uniquely identify the row.</entry>
		    </row>
		    <row>
		      <entry>IsAutoIncrement</entry>
		      <entry><literal>true</literal>: The column assigns values to new rows in fixed increments.
<literal>false</literal>: The column does not assign values to new rows in fixed increments. The default of this
column is <literal>false</literal>.</entry>
		    </row>
		    <row>
		      <entry>BaseSchemaName</entry>
		      <entry>The name of the schema in the data store that contains the column. A null value if
the base schema name cannot be determined. The default of this column is a null value.</entry>
		    </row>
		    <row>
		      <entry>BaseCatalogName</entry>
		      <entry>The name of the catalog in the data store that contains the column. NULL if the base
catalog name cannot be determined. The default of this column is a null value.</entry>
		    </row>
		    <row>
		      <entry>BaseTableName</entry>
		      <entry>The name of the table or view in the data store that contains the column. A null value
if the base table name cannot be determined. The default of this column is a null value.</entry>
		    </row>
		    <row>
		      <entry>BaseColumnName</entry>
		      <entry>The name of the column in the data store. This might be different than the column name
returned in the ColumnName column if an alias was used. A null value if the base column name cannot be determined or
if the rowset column is derived, but not identical to, a column in the data store. The default of this column is
a null value.</entry>
		    </row>
		  </tbody>
		</tgroup>
	      </table>

	    </section>

	  </section>

	  <section>
	    <title>GetString Method</title>

	    <para>Gets the value of the specified column as a string.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <methodname>GetString</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value of the specified column as a string.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetString</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Call IsDBNull to check for null values before calling this method.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetValue Method</title>

	    <para>Gets the value of the column at the specified ordinal in its native format.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>object</type>
	      <methodname>GetValue</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The value to return.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetValue</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>This method returns DBNull for null database columns.</para>
	    </section>

	  </section>

	  <section>
	    <title>GetValues Method</title>

	    <para>Gets all the attribute columns in the current row.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <methodname>GetValues</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>object[]</type>
		<parameter moreinfo="none">values</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>values</term>
		  <listitem>
		    An array of type Object into which to copy the attribute columns.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>The number of instances of Object in the array.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.GetValues</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>For most applications, the GetValues method provides an efficient means for retrieving
all columns, rather than retrieving each column individually.</para>

	      <para>You can pass an Object array that contains fewer than the number of columns contained
in the resulting row. Only the amount of data the Object array holds is copied to the array. You can also
pass an Object array whose length is more than the number of columns contained in the resulting row.</para>

	      <para>This method returns DBNull for null database columns.</para>

	    </section>

	  </section>

	  <section>
	    <title>IDisposable.Dispose Method</title>

	    <para>This member supports the Microsoft .NET Framework infrastructure and is not intended to be
used directly from your code.</para>

	    <methodsynopsis>
	      <void/>
	      <methodname>IDisposable.Dispose</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>IEnumerable.GetEnumerator Method</title>

	    <para>This member supports the Microsoft .NET Framework infrastructure and is not intended to be
used directly from your code.</para>

	    <methodsynopsis>
	      <type>IEnumerable</type>
	      <methodname>IEnumerable.GetEnumerator</methodname>
	      <void/>
	    </methodsynopsis>
	  </section>

	  <section>
	    <title>IsDBNull Method</title>

	    <para>Gets a value indicating whether the column contains non-existent or missing values.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>bool</type>
	      <methodname>IsDBNull</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based column ordinal.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para><literal>true</literal> if the specified column value is equivalent to DBNull;
otherwise, <literal>false</literal>.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataRecord.IsDBNull</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>To avoid raising an error, call this method to check for null column values before calling
the typed Get methods (for example, GetByte, GetChar, and so on).</para>
	    </section>

	  </section>

	  <section>
	    <title>NextResult Method</title>

	    <para>Advances the VirtuosoDataReader to the next result, when reading the results
of batch SQL statements.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>bool</type>
	      <methodname>NextResult</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para><literal>true</literal> if there are more result sets; otherwise, <literal>false</literal>.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataReader.NextResult</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>Used to process multiple results, which can be generated by executing batch SQL statements.</para>

	      <para>By default, the VirtuosoDataReader is positioned on the first result.</para>

	    </section>

	  </section>

	  <section>
	    <title>Read Method</title>

	    <para>Advances the VirtuosoDataReader to the next record.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>bool</type>
	      <methodname>Read</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para><literal>true</literal> if there are more rows; otherwise, <literal>false</literal>.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataReader.Read</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>The default position of the VirtuosoDataReader is prior to the first record. Therefore,
you must call Read to begin accessing any data.</para>

	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirterrclass">
	<title>VirtuosoError Class</title>

	<para>Collects information relevant to a warning or error returned by Virtuoso server. This class cannot
be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;VirtuosoError</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoError</classname>
	  </ooclass>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>This class is created by the Virtuoso .NET Data Provider when an error occurs. An instance of
VirtuosoError is created and managed by the VirtuosoErrorCollection, which in turn is created by the
VirtuosoException class.</para>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>Message</title>

	    <para>Gets a short description of the error.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>Message</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>A description of the error.</para>
	    </section>

	  </section>

	  <section>
	    <title>SQLState</title>

	    <para>Gets the five-character error code that follows the ANSI SQL standard for the database.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>SQLState</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The five-character error code, which identifies the source of the error.</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirterrcollclass">
	<title>VirtuosoErrorCollection Class</title>

	<para>Collects all errors generated by the Virtuoso .NET Data Provider. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;VirtuosoErrorCollection</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoErrorCollection</classname>
	  </ooclass>
	  <oointerface>
	    <interfacename>ICollection</interfacename>
	  </oointerface>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>
	  <para>This class is created by VirtuosoException to collect instances of the VirtuosoError class.
VirtuosoErrorCollection always contains at least one instance of the VirtuosoError class.</para>
	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>Count Property</title>

	    <para>Gets the number of errors in the collection.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <varname>Count</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The total number of errors in the collection.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>ICollection.Count</para>
	    </section>

	  </section>

	  <section>
	    <title>Item Property</title>

	    <para>Gets the error at the specified index.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoError</type>
	      <varname>this[int i]</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The zero-based index of the error to retrieve.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Property Value</title>
	      <para>A VirtuosoError that contains the error at the specified index.</para>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>CopyTo Method</title>

	    <para>Copies the elements of the VirtuosoErrorCollection into an array, starting at the given index
within the array.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>CopyTo</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>Array</type>
		<parameter moreinfo="none">array</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">i</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>array</term>
		  <listitem>
		    The array into which to copy the elements.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>i</term>
		  <listitem>
		    The starting index of array.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>ICollection.CopyTo</para>
	    </section>

	  </section>

	  <section>
	    <title>GetEnumerator Method</title>

	    <para>This member supports the Microsoft .NET Framework infrastructure and is not intended to be
used directly from your code.</para>

	    <methodsynopsis>
	      <type>IEnumerable</type>
	      <methodname>IEnumerable.GetEnumerator</methodname>
	      <void/>
	    </methodsynopsis>
	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtexcepclass">
	<title>VirtuosoException Class</title>

	<para>The exception that is thrown when Virtuoso server returns a warning or error. This class cannot be
inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.Exception</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.SystemException</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoException</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoException</classname>
	  </ooclass>
	  <ooclass>
	    <classname>SystemException</classname>
	  </ooclass>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>This class is created whenever the Virtuoso .NET Data Provider encounters an error generated by
the server (Client-side errors are raised as standard common language runtime exceptions.). It always contains
at least one instance of VirtuosoError.</para>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>Errors Property</title>

	    <para>Gets a collection of one or more VirtuosoError objects that give detailed information about
exceptions generated by the Virtuoso .NET Data Provider.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoErrorCollection</type>
	      <varname>Errors</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The collected instances of the VirtuosoError class.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>This property is a wrapper for the VirtuosoErrorCollection.</para>
	    </section>

	  </section>

	  <section>
	    <title>Message Property</title>

	    <para>Gets the text describing the error.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>Message</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The text describing the error.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>This is a wrapper for the Message property of the first VirtuosoError in the Errors property.</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtinfmsgevtargclass">
	<title>VirtuosoInfoMessageEventArgs Class</title>

	<para>Provides data for the InfoMessage event. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.EventArgs</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoInfoMessageEventArgs</member>
	</simplelist>

	<classsynopsis>
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoInfoMessageEventArgs</classname>
	  </ooclass>
	  <ooclass>
	    <classname>EventArgs</classname>
	  </ooclass>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>
	  <para>The InfoMessage event contains a VirtuosoErrorCollection collection with warnings sent from the
Virtuoso srver.</para>
	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>Errors Property</title>

	    <para>Gets the collection of warnings sent from the Virtuoso server.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoErrorCollection</type>
	      <varname>Errors</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The collection of warnings sent from the server.</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtinfmsgevthndlrdel">
	<title>VirtuosoInfoMessageEventHandler Delegate</title>

	<para>Represents the method that will handle the InfoMessage event of a VirtuosoConnection.</para>

	<methodsynopsis>
	  <modifier>public</modifier>
	  <modifier>delegate</modifier>
	  <void/>
	  <methodname>VirtuosoInfoMessageEventHandler</methodname>
	  <methodparam>
	    <type>object</type>
	    <parameter>sender</parameter>
	  </methodparam>
	  <methodparam>
	    <type>VirtuosoInfoMessageEventArgs</type>
	    <parameter>e</parameter>
	  </methodparam>
	</methodsynopsis>

	<section>
	  <title>Parameters</title>
	  <para>The declaration of your event handler must have the same parameters as the VirtuosoInfoMessageEventHandler
delegate declaration. </para>
	  <variablelist>
	    <varlistentry>
	      <term>sender</term>
	      <listitem>
		The source of the event.
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term>e</term>
	      <listitem>
		A VirtuosoInfoMessageEventArgs object that contains the event data.
	      </listitem>
	    </varlistentry>
	  </variablelist>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>When you create a VirtuosoInfoMessageEventArgs delegate, you identify the method that will handle
the event. To associate the event with your event handler, add an instance of the delegate to the event. The event
handler is called whenever the event occurs, unless you remove the delegate. For more information about event handler
delegates, see "Events and Delegates" in the .NET Framework SDK documentation.</para>

	</section>

      </sect3>

      <sect3 id="vcrvirtparamclass">
	<title>VirtuosoParameter Class</title>

	<para>Represents a parameter to an VirtuosoCommand and optionally, its mapping to a DataColumn.
This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.MarshalByRefObject</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoParameter</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoParameter</classname>
	  </ooclass>
	  <ooclass>
	    <classname>MarshalByRefObject</classname>
	  </ooclass>
	  <oointerface>
	    <interfacename>IDbDataParameter</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>IDataParameter</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>ICloneable</interfacename>
	  </oointerface>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>VirtuosoParameter Constructor</title>

	  <section>
	    <title>VirtuosoParameter Constructor ()</title>

	    <para>Initializes a new instance of the VirtuosoParameter class.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoParameter</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>VirtuosoParameter Constructor (string, object)</title>

	    <para>Initializes a new instance of the VirtuosoParameter class with the parameter name and value.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoParameter</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">parameterName</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>object</type>
		<parameter moreinfo="none">object</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>parameterName</term>
		  <listitem>
		    The name of the parameter to map.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>value</term>
		  <listitem>
		    An Object that is the value of the VirtuosoParameter.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>When you specify an Object in the value parameter, the VirtDbType is inferred from
the .NET Framework type of the Object.</para>
	    </section>

	  </section>

	  <section>
	    <title>VirtuosoParameter Constructor (string, VirtDbType)</title>

	    <para>Initializes a new instance of the VirtuosoParameter class with the parameter name and the data type.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoParameter</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">parameterName</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>VirtDbType</type>
		<parameter moreinfo="none">dbType</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>parameterName</term>
		  <listitem>
		    The name of the parameter to map.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>dbType</term>
		  <listitem>
		    One of the VirtDbType values.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The data type, and if appropriate, Size and Precision are inferred from the value of the
dbType parameter.</para>
	    </section>

	  </section>

	  <section>
	    <title>VirtuosoParameter Constructor (string, VirtDbType, int)</title>

	    <para>Initializes a new instance of the VirtuosoParameter class with the parameter name,
the VirtDbType, and the size.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoParameter</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">parameterName</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>VirtDbType</type>
		<parameter moreinfo="none">dbType</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">size</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>parameterName</term>
		  <listitem>
		    The name of the parameter to map.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>dbType</term>
		  <listitem>
		    One of the VirtDbType values.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>size</term>
		  <listitem>
		    The width of the parameter.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The Size is inferred from the value of the dbType parameter if it is not explicitly set
in the size parameter.</para>
	    </section>

	  </section>

	  <section>
	    <title>VirtuosoParameter Constructor (string, VirtDbType, int, string)</title>

	    <para>Initializes a new instance of the VirtuosoParameter class with the parameter name, VirtDbType, size,
and source column name.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoParameter</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">parameterName</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>VirtDbType</type>
		<parameter moreinfo="none">dbType</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">size</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">sourceColumn</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>parameterName</term>
		  <listitem>
		    The name of the parameter to map.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>dbType</term>
		  <listitem>
		    One of the VirtDbType values.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>size</term>
		  <listitem>
		    The width of the parameter.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>sourceColumn</term>
		  <listitem>
		    The name of the source column.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The Size is inferred from the value of the dbType parameter if it is not explicitly set
in the size parameter.</para>
	    </section>

	  </section>

	  <section>
	    <title>VirtuosoParameter Constructor (string, VirtDbType, int, ParameterDirection, Boolean, Byte, Byte, String, DataRowVersion, Object)</title>

	    <para>Initializes a new instance of the VirtuosoParameter class with the parameter name,
the type of the parameter, the size of the parameter, a ParameterDirection, the precision of the parameter,
the scale of the parameter, the source column, a DataRowVersion to use, and the value of the parameter.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoParameter</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">parameterName</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>VirtDbType</type>
		<parameter moreinfo="none">dbType</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">size</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>ParameterDirection</type>
		<parameter moreinfo="none">direction</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>bool</type>
		<parameter moreinfo="none">isNullable</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>byte</type>
		<parameter moreinfo="none">precision</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>byte</type>
		<parameter moreinfo="none">scale</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>string</type>
		<parameter moreinfo="none">sourceColumn</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>DataRowVersion</type>
		<parameter moreinfo="none">sourceVersion</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>object</type>
		<parameter moreinfo="none">value</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>parameterName</term>
		  <listitem>
		    The name of the parameter to map.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>dbType</term>
		  <listitem>
		    One of the VirtDbType values.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>size</term>
		  <listitem>
		    The width of the parameter.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>direction</term>
		  <listitem>
		    One of the System.Data.ParameterDirection values.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>isNullable</term>
		  <listitem>
		    <literal>true</literal> if the value of the field can be null, otherwise <literal>false</literal>.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>precision</term>
		  <listitem>
		    The total number of digits to the left and right of the decimal point to which Value is resolved.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>scale</term>
		  <listitem>
		    The total number of decimal places to which Value is resolved.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>sourceColumn</term>
		  <listitem>
		    The name of the source column.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>sourceVersion</term>
		  <listitem>
		    One of the System.Data.DataRowVersion values.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>value</term>
		  <listitem>
		    An Object that is the value of the VirtuosoParameter.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The Size and Precision are inferred from the value of the dbType parameter if they are not
explicitly set in the size and precision parameters.</para>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>DbType Property</title>

	    <para>Gets or sets the DbType of the parameter.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>DbType</type>
	      <varname>DbType</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>One of the System.Data.DbType values. The default is String.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataParameter.DbType</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>The VirtDbType and DbType are linked. Therefore, setting the DbType changes the VirtDbType to
a supporting VirtDbType.</para>

	      <para>For a list of the supported data types, see the appropriate VirtDbType member.</para>

	    </section>

	  </section>

	  <section>
	    <title>Direction Property</title>

	    <para>Gets or sets a value indicating whether the parameter is input-only, output-only, bidirectional,
or a stored procedure return value parameter.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>ParameterDirection</type>
	      <varname>Direction</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>One of the System.Data.ParameterDirection values. The default is Input.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataParameter.Direction</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>If the ParameterDirection is Output, and execution of the associated VirtuosoCommand does not
return a value, the VirtuosoParameter will contain a null value. Null values are handled using the DBNull class.
After the last row from the last resultset is read, the Output, InputOut, and ReturnValue parameters are updated.</para>

	    </section>

	  </section>

	  <section>
	    <title>IsNullable Property</title>

	    <para>Gets or sets a value indicating whether the parameter accepts null values.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>bool</type>
	      <varname>IsNullable</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para><literal>true</literal> if null values are accepted; otherwise, <literal>false</literal>.
The default is <literal>false</literal>.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataParameter.IsNullable</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Null values are handled using the System.DBNull class.</para>
	    </section>

	  </section>

	  <section>
	    <title>ParameterName Property</title>

	    <para>Gets or sets the name of the VirtuosoParameter.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>ParameterName</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The name of the VirtuosoParameter. The default is an empty string ("").</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataParameter.ParameterName</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Instead of named parameters, the Virtuoso .NET Data Provider uses positional parameters that are
marked with a question mark (?) in the syntax of the command text. Parameter objects in the VirtuosoParameterCollection
and the actual parameters accepted by the stored procedure or parameterized SQL statement correspond to each other
based on the order in which the VirtuosoParameter objects are inserted into the collection rather than by parameter
name. Parameter names can be supplied, but will be ignored during parameter object binding.</para>
	    </section>

	  </section>

	  <section>
	    <title>Precision Property</title>

	    <para>Gets or sets the maximum number of digits used to represent the Value property.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>byte</type>
	      <varname>Precision</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The maximum number of digits used to represent the Value property. The default value is 0.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbDataParameter.Precision</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>The Precision property is used only for decimal and numeric input parameters.</para>

	    </section>

	  </section>

	  <section>
	    <title>Scale Property</title>

	    <para>Gets or sets the number of decimal places to which Value is resolved.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>byte</type>
	      <varname>Scale</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The number of decimal places to which Value is resolved. The default is 0.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbDataParameter.Scale</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The Scale property is used only for decimal and numeric input parameters.</para>
	    </section>

	  </section>

	  <section>
	    <title>Size Property</title>

	    <para>Gets or sets the maximum size, in bytes, of the data within the column.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <varname>Size</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The maximum size, in bytes, of the data within the column. The default value is inferred from
the parameter value.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbDataParameter.Size</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>The Size property is used for binary and string types.</para>

	      <para>For variable-length data types, the Size property describes the maximum amount of data to transmit
to the server. For example, for a string value, the Size property could be used to limit the amount of data sent to the
server to the first one hundred bytes.</para>

	      <para>For nonstring data types and ANSI string data, the Size property refers to the number of bytes.
For Unicode string data, the Size property refers to the number of characters. The count for strings does not include
the terminating character.</para>

	      <para>If not explicitly set, the value of Size is inferred from the actual size of the specified parameter
value.</para>

	      <para>For fixed-width data types, the value of Size is ignored. It can be retrieved for informational
purposes, and returns the maximum amount of bytes the provider uses when transmitting the value of the parameter to
the server.</para>

	    </section>

	  </section>

	  <section>
	    <title>SourceColumn Property</title>

	    <para>Gets or sets the name of the source column mapped to the DataSet and used for loading or returning
the Value.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>string</type>
	      <varname>SourceColumn</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The name of the source column that will be used to set the value of this parameter. The default
is an empty string ("").</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataParameter.SourceColumn</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>When SourceColumn is set to anything other than an empty string, the value of the parameter is
retrieved from the column with the SourceColumn name. If Direction is set to Input, the value is taken from the DataSet.
If Direction is set to Output, the value is taken from the data source. A Direction of InputOutput is a combination
of both.</para>

	    </section>

	  </section>

	  <section>
	    <title>SourceVersion Property</title>

	    <para>Gets or sets the DataRowVersion to use when loading Value.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>DataRowVersion</type>
	      <varname>DataRowVersion</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>One of the System.Data.DataRowVersion values. The default is Current.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataParameter.SourceVersion</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>The SourceVersion is used by UpdateCommand during an Update operation to determine whether the
parameter value is set to Current or Original. This allows primary keys to be updated. This property is ignored by
InsertCommand and DeleteCommand.</para>

	      <para>This property is set to the version of the DataRow used by either the Item property
(DataRow indexer), or the GetChildRows method of the DataRow object.</para>

	    </section>

	  </section>

	  <section>
	    <title>Value Property</title>

	    <para>Gets or sets the value of the parameter.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>object</type>
	      <varname>Value</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>An Object that is the value of the parameter. The default value is null.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDataParameter.Value</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>For input parameters, the value is bound to the VirtuosoCommand that is sent to the server.
For output and return-value parameters, the value is set on completion of the VirtuosoCommand and after the
VirtuosoDataReader is closed.</para>

	      <para>When sending a null parameter value to the server, the user must specify DBNull, not null.
A null value in the system is an empty object that has no value. DBNull is used to represent null values.</para>

	      <para>If the application specifies the database type, the bound value is converted to that type when
the provider sends the data to the server. The provider attempts to convert any type of value if it supports the
IConvertible interface. Conversion errors may result if the specified type is not compatible with the value.</para>

	      <para>Both the DbType and VirtDbType properties can be inferred by setting Value. If applicable,
the size, precision and scale will also be inferred from Value.</para>

	      <para>The Value property is overwritten by the Update method.</para>

	    </section>

	  </section>

	  <section>
	    <title>VirtDbType Property</title>

	    <para>Gets or sets the VirtDbType of the parameter.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtDbType</type>
	      <varname>VirtDbType</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>One of the VirtDbType values. The default is NVarChar.</para>
	    </section>

	    <section>
	      <title>Remarks</title>

	      <para>The VirtDbType and DbType are linked. Therefore, setting the DbType changes the VirtDbType
to a supporting VirtDbType.</para>

	      <para>For a list of the supported data types, see the appropriate VirtDbType member. For more information,
see "Using Parameters with a DataAdapter" in the Microsoft .NET Framework SDK documentation.</para>

	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>ICloneable.Clone Method</title>

	    <para>This member supports the Microsoft .NET Framework infrastructure and is not intended to be used
directly from your code.</para>

	    <methodsynopsis>
	      <type>object</type>
	      <methodname>ICloneable.Clone</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>ToString Method</title>

	    <para>Gets a string containing the ParameterName.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <modifier>override</modifier>
	      <type>string</type>
	      <methodname>ToString</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>A string containing the ParameterName.</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtparamcollclass">
	<title>VirtuosoParameterCollection Class</title>

	<para>Represents a collection of parameters relevant to a VirtuosoCommand as well as their respective mappings
to columns in a DataSet. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.MarshalByRefObject</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoParameterCollection</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoParameterCollection</classname>
	  </ooclass>
	  <ooclass>
	    <classname>MarshalByRefObject</classname>
	  </ooclass>
	  <oointerface>
	    <interfacename>IDataParameterCollection</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>ICollection</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>IEnumerable</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>IList</interfacename>
	  </oointerface>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>Count Property</title>

	    <para>Gets the number of VirtuosoParameter objects in the collection.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>int</type>
	      <varname>Count</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The number of VirtuosoParameter objects in the collection.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>ICollection.Count</para>
	    </section>

	  </section>

	  <section>
	    <title>Item Property</title>

	    <section>
	      <title>Item Property (int)</title>

	      <para>Gets or sets the VirtuosoParameter at the specified index.</para>

	      <fieldsynopsis>
		<modifier>public</modifier>
		<type>object</type>
		<varname>this[int i]</varname>
	      </fieldsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>index</term>
		    <listitem>
		      The zero-based index of the parameter to retrieve.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Property Value</title>
		<para>The VirtuosoParameter at the specified index.</para>
	      </section>

	    </section>

	    <section>
	      <title>Item Property (string)</title>

	      <para>Gets or sets the VirtuosoParameter with the specified name.</para>

	      <fieldsynopsis>
		<modifier>public</modifier>
		<type>object</type>
		<varname>this[string parameterName]</varname>
	      </fieldsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>parameterName</term>
		    <listitem>
		      The name of the parameter to retrieve.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Property Value</title>
		<para>The VirtuosoParameter with the specified name.</para>
	      </section>

	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>Add Method</title>

	    <section>
	      <title>Add Method (object)</title>

	      <para>Adds the specified VirtuosoParameter object to the VirtuosoParameterCollection.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>int</type>
		<methodname>Add</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>object</type>
		  <parameter moreinfo="none">value</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>value</term>
		    <listitem>
		      The VirtuosoParameter to add to the collection.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>The index in the collection of the new VirtuosoParameter object.</para>
	      </section>

	      <section>
		<title>Implements</title>
		<para>IList.Add</para>
	      </section>

	    </section>

	    <section>
	      <title>Add Method (VirtuosoParameter)</title>

	      <para>Adds the specified VirtuosoParameter object to the VirtuosoParameterCollection.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>VirtuosoParameter</type>
		<methodname>Add</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>VirtuosoParameter</type>
		  <parameter moreinfo="none">value</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>value</term>
		    <listitem>
		      The VirtuosoParameter to add to the collection.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>A reference to the new VirtuosoParameter object.</para>
	      </section>

	    </section>

	    <section>
	      <title>Add Method (string, object)</title>

	      <para>Adds a VirtuosoParameter to the VirtuosoParameterCollection with the specified parameter name
and value.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>VirtuosoParameter</type>
		<methodname>Add</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>string</type>
		  <parameter moreinfo="none">parameterName</parameter>
		</methodparam>
		<methodparam choice="req" rep="norepeat">
		  <type>object</type>
		  <parameter moreinfo="none">value</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>parameterName</term>
		    <listitem>
		      The name of the parameter.
		    </listitem>
		  </varlistentry>
		  <varlistentry>
		    <term>value</term>
		    <listitem>
		      The Value of the VirtuosoParameter to add to the collection.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>The new VirtuosoParameter object.</para>
	      </section>

	    </section>

	    <section>
	      <title>Add Method (string, VirtDbType)</title>

	      <para>Adds a VirtuosoParameter to the VirtuosoParameterCollection with the specified parameter name
and data type.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>VirtuosoParameter</type>
		<methodname>Add</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>string</type>
		  <parameter moreinfo="none">parameterName</parameter>
		</methodparam>
		<methodparam choice="req" rep="norepeat">
		  <type>VirtDbType</type>
		  <parameter moreinfo="none">dbType</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>parameterName</term>
		    <listitem>
		      The name of the parameter.
		    </listitem>
		  </varlistentry>
		  <varlistentry>
		    <term>value</term>
		    <listitem>
		      One of the VirtDbType values.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>The new VirtuosoParameter object.</para>
	      </section>

	    </section>

	    <section>
	      <title>Add Method (string, VirtDbType, int)</title>

	      <para>Adds a VirtuosoParameter to the VirtuosoParameterCollection with the specified parameter name,
data type, and parameter size.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>VirtuosoParameter</type>
		<methodname>Add</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>string</type>
		  <parameter moreinfo="none">parameterName</parameter>
		</methodparam>
		<methodparam choice="req" rep="norepeat">
		  <type>VirtDbType</type>
		  <parameter moreinfo="none">dbType</parameter>
		</methodparam>
		<methodparam choice="req" rep="norepeat">
		  <type>int</type>
		  <parameter moreinfo="none">size</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>parameterName</term>
		    <listitem>
		      The name of the parameter.
		    </listitem>
		  </varlistentry>
		  <varlistentry>
		    <term>value</term>
		    <listitem>
		      One of the VirtDbType values.
		    </listitem>
		  </varlistentry>
		  <varlistentry>
		    <term>size</term>
		    <listitem>
		      The size of the parameter (width of the column).
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>The new VirtuosoParameter object.</para>
	      </section>

	    </section>

	    <section>
	      <title>Add Method (string, VirtDbType, int, string)</title>

	      <para>Adds a VirtuosoParameter to the VirtuosoParameterCollection with the specified parameter name,
data type, parameter size, and source column name.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>VirtuosoParameter</type>
		<methodname>Add</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>string</type>
		  <parameter moreinfo="none">parameterName</parameter>
		</methodparam>
		<methodparam choice="req" rep="norepeat">
		  <type>VirtDbType</type>
		  <parameter moreinfo="none">dbType</parameter>
		</methodparam>
		<methodparam choice="req" rep="norepeat">
		  <type>int</type>
		  <parameter moreinfo="none">size</parameter>
		</methodparam>
		<methodparam choice="req" rep="norepeat">
		  <type>string</type>
		  <parameter moreinfo="none">sourceColumn</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>parameterName</term>
		    <listitem>
		      The name of the parameter.
		    </listitem>
		  </varlistentry>
		  <varlistentry>
		    <term>value</term>
		    <listitem>
		      One of the VirtDbType values.
		    </listitem>
		  </varlistentry>
		  <varlistentry>
		    <term>size</term>
		    <listitem>
		      The size of the parameter (width of the column).
		    </listitem>
		  </varlistentry>
		  <varlistentry>
		    <term>sourceColumn</term>
		    <listitem>
		      The name of the source column.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>The new VirtuosoParameter object.</para>
	      </section>

	    </section>

	  </section>

	  <section>
	    <title>Clear Method</title>

	    <para>Removes all items from the collection.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Clear</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Implements</title>
	      <para>IList.Clear</para>
	    </section>

	  </section>

	  <section>
	    <title>Contains Method</title>

	    <section>
	      <title>Contains Method (object)</title>

	      <para>Gets a value indicating whether a VirtuosoParameter object exists in the collection.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>bool</type>
		<methodname>Contains</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>object</type>
		  <parameter moreinfo="none">value</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>value</term>
		    <listitem>
		      The value of the VirtuosoParameter object to find.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para><literal>true</literal> if the collection contains the VirtuosoParameter;
otherwise, <literal>false</literal>.</para>
	      </section>

	      <section>
		<title>Implements</title>
		<para>IList.Contains</para>
	      </section>

	    </section>

	    <section>
	      <title>Contains Method (string)</title>

	      <para>Gets a value indicating whether a VirtuosoParameter object with the specified parameter name
exists in the collection.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>bool</type>
		<methodname>Contains</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>string</type>
		  <parameter moreinfo="none">parameterName</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>parameterName</term>
		    <listitem>
		      The name of the VirtuosoParameter object to find.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para><literal>true</literal> if the collection contains the VirtuosoParameter;
otherwise, <literal>false</literal>.</para>
	      </section>

	      <section>
		<title>Implements</title>
		<para>IDataParameterCollection.Contains</para>
	      </section>

	    </section>

	  </section>

	  <section>
	    <title>CopyTo Method</title>

	    <para>Copies VirtuosoParameter objects from the VirtuosoParameterCollection to the specified array.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>CopyTo</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>Array</type>
		<parameter moreinfo="none">array</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">index</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>array</term>
		  <listitem>
		    The array into which to copy the VirtuosoParameter objects.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>index</term>
		  <listitem>
		    The starting index of the array.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>ICollection.CopyTo</para>
	    </section>

	  </section>

	  <section>
	    <title>GetEnumerator Method</title>

	    <para>This member supports the Microsoft .NET Framework infrastructure and is not intended to be used
directly from your code.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>IEnumerator</type>
	      <methodname>GetEnumerator</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>IndexOf Method</title>

	    <section>
	      <title>IndexOf Method (object)</title>

	      <para>Gets the location in the collection of a VirtuosoParameter object.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>int</type>
		<methodname>IndexOf</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>object</type>
		  <parameter moreinfo="none">value</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>value</term>
		    <listitem>
		      The VirtuosoParameter object to find.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>The zero-based location of the VirtuosoParameter in the collection.</para>
	      </section>

	      <section>
		<title>Implements</title>
		<para>IList.IndexOf</para>
	      </section>

	    </section>

	    <section>
	      <title>IndexOf Method (string)</title>

	      <para>Gets the location in the collection of the VirtuosoParameter object with the specified parameter
name.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<type>int</type>
		<methodname>IndexOf</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>string</type>
		  <parameter moreinfo="none">parameterName</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>parameterName</term>
		    <listitem>
		      The name of the VirtuosoParameter object to find.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Return Value</title>
		<para>The zero-based location of the VirtuosoParameter in the collection.</para>
	      </section>

	      <section>
		<title>Implements</title>
		<para>IDataParameterCollection.IndexOf</para>
	      </section>

	    </section>

	  </section>

	  <section>
	    <title>Insert Method</title>

	    <para>Inserts a VirtuosoParameter into the collection at the specified index.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Insert</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>int</type>
		<parameter moreinfo="none">index</parameter>
	      </methodparam>
	      <methodparam choice="req" rep="norepeat">
		<type>object</type>
		<parameter moreinfo="none">value</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>index</term>
		  <listitem>
		    The zero-based index where the parameter is to be inserted within the collection.
		  </listitem>
		</varlistentry>
		<varlistentry>
		  <term>value</term>
		  <listitem>
		    The VirtuosoParameter to add to the collection.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IList.Insert</para>
	    </section>

	  </section>

	  <section>
	    <title>Remove Method</title>

	    <para>Removes the specified VirtuosoParameter from the collection.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Remove</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>object</type>
		<parameter moreinfo="none">value</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>value</term>
		  <listitem>
		    The VirtuosoParameter object to remove from the collection.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IList.Remove</para>
	    </section>

	  </section>

	  <section>
	    <title>RemoveAt Method</title>

	    <section>
	      <title>RemoveAt Method (int)</title>

	      <para>Removes the VirtuosoParameter at the specified index from the collection.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<void/>
		<methodname>RemoveAt</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>int</type>
		  <parameter moreinfo="none">index</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>index</term>
		    <listitem>
		      The zero-based index of the parameter to remove.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Implements</title>
		<para>IList.RemoveAt</para>
	      </section>

	    </section>

	    <section>
	      <title>RemoveAt Method (string)</title>

	      <para>Removes the VirtuosoParameter with the specified name from the collection.</para>

	      <methodsynopsis>
		<modifier>public</modifier>
		<void/>
		<methodname>RemoveAt</methodname>
		<methodparam choice="req" rep="norepeat">
		  <type>string</type>
		  <parameter moreinfo="none">parameterName</parameter>
		</methodparam>
	      </methodsynopsis>

	      <section>
		<title>Parameters</title>
		<variablelist>
		  <varlistentry>
		    <term>parameterName</term>
		    <listitem>
		      The name of the parameter to remove.
		    </listitem>
		  </varlistentry>
		</variablelist>
	      </section>

	      <section>
		<title>Implements</title>
		<para>IDataParameterCollection.RemoveAt</para>
	      </section>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtpermclass">
	<title>VirtuosoPermission Class</title>

	<para>Provides the capability for the Virtuoso .NET Data Provider to ensure that a user has a security level
adequate to access a data source. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.Security.CodeAccessPermission</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoPermission</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoPermission</classname>
	  </ooclass>
	  <ooclass>
	    <classname>CodeAccessPermission</classname>
	  </ooclass>
	  <oointerface>
	    <interfacename>IUnrestrictedPermission</interfacename>
	  </oointerface>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>VirtuosoPermission Constructor</title>

	  <section>
	    <title>VirtuosoPermission Constructor ()</title>

	    <para>Initializes a new instance of the VirtuosoPermission class.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoPermission</methodname>
	      <void/>
	    </constructorsynopsis>

	  </section>

	  <section>
	    <title>VirtuosoPermission Constructor (PermissionState)</title>

	    <para>Initializes a new instance of the VirtuosoPermission class.</para>

	    <constructorsynopsis>
	      <modifier>public</modifier>
	      <methodname>VirtuosoPermission</methodname>
	      <methodparam choice="req" rep="norepeat">
		<type>PermissionState</type>
		<parameter moreinfo="none">state</parameter>
	      </methodparam>
	    </constructorsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>state</term>
		  <listitem>
		    One of the System.Security.Permissions.PermissionState values.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>Copy Method</title>

	    <para>Creates and returns an identical copy of the current permission object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <modifier>override</modifier>
	      <type>IPermission</type>
	      <methodname>Copy</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>A copy of the current permission object.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IPermission.Copy</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>A copy of a permission object represents the same access to resources as the original
permission object.</para>
	    </section>
	  </section>

	  <section>
	    <title>FromXml Method</title>

	    <para>Reconstructs a security object with a specified state from an XML encoding.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <modifier>override</modifier>
	      <void/>
	      <methodname>FromXml</methodname>
	      <methodparam>
		<type>SecurityElement</type>
		<parameter>securityElement</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>securityElement</term>
		  <listitem>
		    The XML encoding to use to reconstruct the security object.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>ISecurityEncodable.FromXml</para>
	    </section>

	  </section>

	  <section>
	    <title>Intersect Method</title>

	    <para>Returns a new permission object representing the intersection of the current permission
object and the specified permission object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <modifier>override</modifier>
	      <type>IPermission</type>
	      <methodname>Intersect</methodname>
	      <methodparam>
		<type>IPermission</type>
		<parameter>target</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>target</term>
		  <listitem>
		    A permission object to intersect with the current permission object. It must be of the same
		    type as the current permission object.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>A new permission object that represents the intersection of the current permission object
and the specified permission object. This new permission object is a null reference (Nothing in Visual Basic)
if the intersection is empty.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IPermission.Intersect</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The intersection of two permissions is a permission that describes the set of operations
they both describe in common. Only a demand that passes both original permissions will pass the intersection.</para>
	    </section>

	  </section>

	  <section>
	    <title>IsSubsetOf Method</title>

	    <para>Returns a value indicating whether the current permission object is a subset of the specified
permission object.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <modifier>override</modifier>
	      <type>bool</type>
	      <methodname>IsSubsetOf</methodname>
	      <methodparam>
		<type>IPermission</type>
		<parameter>target</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>target</term>
		  <listitem>
		    A permission object that is to be tested for the subset relationship. This object must be of
		    the same type as the current permission object.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para><literal>true</literal> if the current permission object is a subset of the specified
permission object; otherwise <literal>false</literal>.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IPermission.IsSubsetOf</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The current permission object is a subset of the specified permission object if the current
permission object specifies a set of operations that is wholly contained by the specified permission object.
For example, a permission that represents access to C:\example.txt is a subset of a permission that represents
access to C:\. If this method returns true, the current permission object represents no more access to the
protected resource than does the specified permission object.</para>
	    </section>

	  </section>

	  <section>
	    <title>IsUnrestricted Method</title>

	    <para>Returns a value indicating whether the permission can be represented as unrestricted without
any knowledge of the permission semantics.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <type>bool</type>
	      <methodname>IsUnrestricted</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para><literal>true</literal> if the VirtuosoPermission instance was created with
PermissionState.Unrestricted; otherwise, <literal>false</literal>.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IUnrestrictedPermission.IsUnrestricted</para>
	    </section>

	  </section>

	  <section>
	    <title>ToXml Method</title>

	    <para>Creates an XML encoding of the security object and its current state.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <modifier>override</modifier>
	      <type>SecurityElement</type>
	      <methodname>ToXml</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>An XML encoding of the security object, including any state information.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>ISecurityEncodable.ToXml</para>
	    </section>

	  </section>

	  <section>
	    <title>Union Method</title>

	    <para>Creates a permission that is the union of the permission and the specified permission.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <modifier>override</modifier>
	      <type>IPermission</type>
	      <methodname>Union</methodname>
	      <methodparam>
		<type>IPermission</type>
		<parameter>target</parameter>
	      </methodparam>
	    </methodsynopsis>

	    <section>
	      <title>Parameters</title>
	      <variablelist>
		<varlistentry>
		  <term>target</term>
		  <listitem>
		    A permission to combine with the current permission. It must be of the same type as
		    the current permission.
		  </listitem>
		</varlistentry>
	      </variablelist>
	    </section>

	    <section>
	      <title>Return Value</title>
	      <para>A new permission that represents the union of the current permission and the specified
permission.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The result of a call to Union is a permission that represents all the operations
represented by both the current permission and the specified permission. Any demand that passes either permission
passes their union.</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtpermattr">
	<title>VirtuosoPermissionAttribute</title>

	<para>Allows security actions for VirtuosoPermission to be applied to code using declarative security.
This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.Attribute</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.Security.Permissions.SecurityAttribute</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.Security.Permissions.CodeAccessSecurityAttribute</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoPermissionAttribute</member>
	</simplelist>

	<classsynopsis>
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoPermissionAttribute</classname>
	  </ooclass>
	  <ooclass>
	    <classname>CodeAccessSecurityAttribute</classname>
	  </ooclass>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>VirtuosoPermissionAttribute Constructor</title>

	  <para>Initializes a new instance of the VirtuosoPermissionAttribute class.</para>

	  <constructorsynopsis>
	    <modifier>public</modifier>
	    <methodname>VirtuosoPermissionAttribute</methodname>
	  </constructorsynopsis>

	  <section>
	    <title>Parameters</title>
	    <variablelist>
	      <varlistentry>
		<term>action</term>
		<listitem>
		  One of the SecurityAction values representing an action that can be performed using declarative
		  security.
		</listitem>
	      </varlistentry>
	    </variablelist>
	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>CreatePermission Method</title>

	    <para>Returns a VirtuosoPermission object that is configured according to the attribute properties.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <modifier>override</modifier>
	      <type>IPermission</type>
	      <methodname>CreatePermission</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Return Value</title>
	      <para>A VirtuosoPermission object.</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtrowupdevtargclass">
	<title>VirtuosoRowUpdatedEventArgs Class</title>

	<para>Provides data for the RowUpdated event. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.EventArgs</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.Data.Common.RowUpdatedEventArgs</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoRowUpdatedEventArgs</member>
	</simplelist>

	<classsynopsis>
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoRowUpdatedEventArgs</classname>
	  </ooclass>
	  <ooclass>
	    <classname>RowUpdatedEventArgs</classname>
	  </ooclass>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>VirtuosoRowUpdatedEventArgs Constructor</title>

	  <para>Initializes a new instance of the VirtuosoRowUpdatedEventArgs class.</para>

	  <constructorsynopsis>
	    <modifier>public</modifier>
	    <methodname>VirtuosoRowUpdatedEventArgs</methodname>
	    <methodparam>
	      <type>DataRow</type>
	      <parameter>row</parameter>
	    </methodparam>
	    <methodparam>
	      <type>IDbCommand</type>
	      <parameter>command</parameter>
	    </methodparam>
	    <methodparam>
	      <type>StatementType</type>
	      <parameter>statementType</parameter>
	    </methodparam>
	    <methodparam>
	      <type>DataTableMapping</type>
	      <parameter>tableMapping</parameter>
	    </methodparam>
	  </constructorsynopsis>

	  <section>
	    <title>Parameters</title>
	    <variablelist>
	      <varlistentry>
		<term>row</term>
		<listitem>
		  The DataRow sent through an Update.
		</listitem>
	      </varlistentry>
	      <varlistentry>
		<term>command</term>
		<listitem>
		  The IDbCommand executed when Update is called.
		</listitem>
	      </varlistentry>
	      <varlistentry>
		<term>statementType</term>
		<listitem>
		  One of the StatementType values that specifies the type of query executed.
		</listitem>
	      </varlistentry>
	      <varlistentry>
		<term>tableMapping</term>
		<listitem>
		  The DataTableMapping sent through an Update.
		</listitem>
	      </varlistentry>
	    </variablelist>
	  </section>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>Command Property</title>

	    <para>Gets the VirtuosoCommand executed when Update is called.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <modifier>new</modifier>
	      <type>VirtuosoCommand</type>
	      <varname>Command</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The VirtuosoCommand executed when Update is called.</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtrowupdevthndlrdel">
	<title>VirtuosoRowUpdatedEventHandler Delegate</title>

	<para>Represents the method that will handle the RowUpdated event of a VirtuosoDataAdapter.</para>

	<methodsynopsis>
	  <modifier>public</modifier>
	  <modifier>delegate</modifier>
	  <void/>
	  <methodname>VirtuosoRowUpdatedEventHandler</methodname>
	  <methodparam>
	    <type>object</type>
	    <parameter>sender</parameter>
	  </methodparam>
	  <methodparam>
	    <type>VirtuosoRowUpdatedEventArgs</type>
	    <parameter>e</parameter>
	  </methodparam>
	</methodsynopsis>

	<section>
	  <title>Parameters</title>
	  <para>The declaration of your event handler must have the same parameters as the VirtuosoRowUpdatedEventHandler
delegate declaration. </para>
	  <variablelist>
	    <varlistentry>
	      <term>sender</term>
	      <listitem>
		The source of the event.
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term>e</term>
	      <listitem>
		A VirtuosoRowUpdatedEventArgs object that contains the event data.
	      </listitem>
	    </varlistentry>
	  </variablelist>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>The handler is not required perform any action, and your code should avoid generating exceptions or
allowing exceptions to propagate to the calling method. Any exceptions that do reach the caller are ignored. When you
create a VirtuosoRowUpdatedEventHandler delegate, you identify the method that will handle the event. To associate
the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever
the event occurs, unless you remove the delegate. For more information about event handler delegates,
see "Events and Delegates" in the .NET Framework SDK documentation.</para>

	</section>

      </sect3>

      <sect3 id="vcrvirtrowupsevtargsclass">
	<title>VirtuosoRowUpdatingEventArgs Class</title>

	<para>Provides data for the RowUpdating event. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.EventArgs</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;System.Data.Common.RowUpdatingEventArgs</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoRowUpdatingEventArgs</member>
	</simplelist>

	<classsynopsis>
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoRowUpdatingEventArgs</classname>
	  </ooclass>
	  <ooclass>
	    <classname>RowUpdatingEventArgs</classname>
	  </ooclass>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>VirtuosoRowUpdatingEventArgs Constructor</title>

	  <para>Initializes a new instance of the VirtuosoRowUpdatingEventArgs class.</para>

	  <constructorsynopsis>
	    <modifier>public</modifier>
	    <methodname>VirtuosoRowUpdatingEventArgs</methodname>
	    <methodparam>
	      <type>DataRow</type>
	      <parameter>row</parameter>
	    </methodparam>
	    <methodparam>
	      <type>IDbCommand</type>
	      <parameter>command</parameter>
	    </methodparam>
	    <methodparam>
	      <type>StatementType</type>
	      <parameter>statementType</parameter>
	    </methodparam>
	    <methodparam>
	      <type>DataTableMapping</type>
	      <parameter>tableMapping</parameter>
	    </methodparam>
	  </constructorsynopsis>

	  <section>
	    <title>Parameters</title>
	    <variablelist>
	      <varlistentry>
		<term>row</term>
		<listitem>
		  The DataRow sent through an Update.
		</listitem>
	      </varlistentry>
	      <varlistentry>
		<term>command</term>
		<listitem>
		  The IDbCommand executed when Update is called.
		</listitem>
	      </varlistentry>
	      <varlistentry>
		<term>statementType</term>
		<listitem>
		  One of the StatementType values that specifies the type of query executed.
		</listitem>
	      </varlistentry>
	      <varlistentry>
		<term>tableMapping</term>
		<listitem>
		  The DataTableMapping sent through an Update.
		</listitem>
	      </varlistentry>
	    </variablelist>
	  </section>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>Command Property</title>

	    <para>Gets or sets the VirtuosoCommand executed when Update is called.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <modifier>new</modifier>
	      <type>VirtuosoCommand</type>
	      <varname>Command</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The VirtuosoCommand executed when Update is called.</para>
	    </section>

	  </section>

	</section>

      </sect3>

      <sect3 id="vcrvirtrowupdingevthndlrdel">
	<title>VirtuosoRowUpdatingEventHandler Delegate</title>

	<para>Represents the method that will handle the RowUpdating event of a VirtuosoDataAdapter.</para>

	<methodsynopsis>
	  <modifier>public</modifier>
	  <modifier>delegate</modifier>
	  <void/>
	  <methodname>VirtuosoRowUpdatingEventHandler</methodname>
	  <methodparam>
	    <type>object</type>
	    <parameter>sender</parameter>
	  </methodparam>
	  <methodparam>
	    <type>VirtuosoRowUpdatingEventArgs</type>
	    <parameter>e</parameter>
	  </methodparam>
	</methodsynopsis>

	<section>
	  <title>Parameters</title>
	  <para>The declaration of your event handler must have the same parameters as the VirtuosoRowUpdatingEventHandler
delegate declaration. </para>
	  <variablelist>
	    <varlistentry>
	      <term>sender</term>
	      <listitem>
		The source of the event.
	      </listitem>
	    </varlistentry>
	    <varlistentry>
	      <term>e</term>
	      <listitem>
		A VirtuosoRowUpdatingEventArgs object that contains the event data.
	      </listitem>
	    </varlistentry>
	  </variablelist>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>The handler is not required perform any action, and your code should avoid generating exceptions or
allowing exceptions to propagate to the calling method. Any exceptions that do reach the caller are ignored. When you
create a VirtuosoRowUpdatingEventHandler delegate, you identify the method that will handle the event. To associate
the event with your event handler, add an instance of the delegate to the event. The event handler is called whenever
the event occurs, unless you remove the delegate. For more information about event handler delegates,
see "Events and Delegates" in the .NET Framework SDK documentation.</para>

	</section>

      </sect3>

      <sect3 id="vcrvirttransclass">
	<title>VirtuosoTransaction Class</title>

	<para>Represents a transaction to be made at a Virtuoso database. This class cannot be inherited.</para>

	<simplelist type="vert">
	  <member>System.Object</member>
	  <member>&nbsp;&nbsp;&nbsp;System.MarshalByRefObject</member>
	  <member>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;VirtuosoTransaction</member>
	</simplelist>

	<classsynopsis class="class">
	  <ooclass>
	    <modifier>public</modifier>
	    <modifier>sealed</modifier>
	    <modifier>class</modifier>
	    <classname>VirtuosoTransaction</classname>
	  </ooclass>
	  <ooclass>
	    <classname>MarshalByRefObject</classname>
	  </ooclass>
	  <oointerface>
	    <interfacename>IDbTransaction</interfacename>
	  </oointerface>
	  <oointerface>
	    <interfacename>IDisposable</interfacename>
	  </oointerface>
	</classsynopsis>

	<section>
	  <title>Thread Safety</title>
	  <para>Any public static (Shared in Visual Basic) members of this type are safe for multithreaded operations.
Any instance members are not guaranteed to be thread safe.</para>
	</section>

	<section>
	  <title>Remarks</title>

	  <para>The application creates a VirtuosoTransaction object by calling BeginTransaction on
the VirtuosoConnection object. All subsequent operations associated with the transaction (for example,
committing or aborting the transaction), are performed on the VirtuosoTransaction object.</para>

	</section>

	<section>
	  <title>Properties</title>

	  <section>
	    <title>Connection</title>

	    <para>Gets the VirtuosoConnection object associated with the transaction.</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>VirtuosoConnection</type>
	      <varname>Connection</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The VirtuosoConnection object to associate with the transaction.</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>A single application may have multiple database connections, each with zero or more transactions.
This property enables you to determine the connection object associated with a particular transaction.</para>
	    </section>

	  </section>

	  <section>
	    <title>IsolationLevel</title>

	    <para>Specifies the IsolationLevel for this transaction</para>

	    <fieldsynopsis>
	      <modifier>public</modifier>
	      <type>IsolationLevel</type>
	      <varname>IsolationLevel</varname>
	    </fieldsynopsis>

	    <section>
	      <title>Property Value</title>
	      <para>The IsolationLevel for this transaction.</para>
	    </section>

	    <section>
	      <title>Implements</title>
	      <para>IDbTransaction.IsolationLevel</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>Parallel transactions are not supported. Therefore, the IsolationLevel applies
to the entire transaction.</para>
	    </section>

	  </section>

	</section>

	<section>
	  <title>Methods</title>

	  <section>
	    <title>Commit Method</title>

	    <para>Commits the database transaction.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Commit</methodname>
	      <void/>
	    </methodsynopsis>

	  </section>

	  <section>
	    <title>Dispose Method</title>

	    <para>Releases the unmanaged resources used by the VirtuosoTransaction and optionally
releases the managed resources.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Dispose</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Implements</title>
	      <para>IDisposable.Dispose</para>
	    </section>

	  </section>

	  <section>
	    <title>Rollback Method</title>

	    <para>Rolls back a transaction from a pending state.</para>

	    <methodsynopsis>
	      <modifier>public</modifier>
	      <void/>
	      <methodname>Rollback</methodname>
	      <void/>
	    </methodsynopsis>

	    <section>
	      <title>Implements</title>
	      <para>IDbTransaction.Rollback</para>
	    </section>

	    <section>
	      <title>Remarks</title>
	      <para>The transaction can be rolled back only from a pending state
(after BeginTransaction has been called, but before Commit is called).</para>
	    </section>

	  </section>

	</section>

      </sect3>
      </sect2>

  </sect1>

<!--
Local Variables:
mode: xml
sgml-parent-document: ("./virtclientdotnet.xml" "set" "set" "book")
sgml-default-dtd-file: "./virtclientdotnet.ced"
End:
-->