Chapter 5 Connector/NET Programming

Table of Contents     [+/-]

5.1 Connecting to MySQL Using Connector/NET     [+/-]

5.1.1 Creating a Connector/NET Connection String

5.1.2 Handling Connection Errors

5.1.3 Using GetSchema on a Connection

5.2 Using MySqlCommand

5.3 Using Connector/NET with Connection Pooling

5.4 Using the Windows Native Authentication Plugin

5.5 Writing a Custom Authentication Plugin

5.6 Using Connector/NET with Table Caching

5.7 Using the Connector/NET with Prepared Statements     [+/-]

5.7.1 Preparing Statements in Connector/NET

5.8 Accessing Stored Procedures with Connector/NET     [+/-]

5.8.1 Using Stored Routines from Connector/NET

5.9 Handling BLOB Data With Connector/NET     [+/-]

5.9.1 Preparing the MySQL Server

5.9.2 Writing a File to the Database

5.9.3 Reading a BLOB from the Database to a File on Disk

5.10 Asynchronous Methods

5.11 Using the Connector/NET Interceptor Classes

5.12 Handling Date and Time Information in Connector/NET     [+/-]

5.12.1 Fractional Seconds

5.12.2 Problems when Using Invalid Dates

5.12.3 Restricting Invalid Dates

5.12.4 Handling Invalid Dates

5.12.5 Handling NULL Dates

5.13 Using the MySqlBulkLoader Class

5.14 Using the Connector/NET Trace Source Object     [+/-]

5.14.1 Viewing MySQL Trace Information

5.14.2 Building Custom Listeners

5.15 Binary/Nonbinary Issues

5.16 Character Set Considerations for Connector/NET

5.17 Using Connector/NET with Crystal Reports     [+/-]

5.17.1 Creating a Data Source

5.17.2 Creating the Report

5.17.3 Displaying the Report

5.18 ASP.NET Provider Model

5.19 Working with Partial Trust / Medium Trust     [+/-]

5.19.1 Evolution of Partial Trust Support Across Connector/NET Versions

5.19.2 Configuring Partial Trust with Connector/NET Library Installed in GAC

5.19.3 Configuring Partial Trust with Connector/NET Library Not Installed in GAC

MySQL Connector/NET comprises several classes that are used to connect to the database, execute queries and statements, and manage query results.

The following are the major classes of Connector/NET:

• MySqlConnection: Represents an open connection to a MySQL database.

• MySqlConnectionStringBuilder: Aids in the creation of a connection string by exposing the connection options as properties.

• MySqlCommand: Represents an SQL statement to execute against a MySQL database.

• MySqlCommandBuilder: Automatically generates single-table commands used to reconcile changes made to a DataSet with the associated MySQL database.

• MySqlDataAdapter: Represents a set of data commands and a database connection that are used to fill a data set and update a MySQL database.

• MySqlDataReader: Provides a means of reading a forward-only stream of rows from a MySQL database.

• MySqlException: The exception that is thrown when MySQL returns an error.

• MySqlHelper: Helper class that makes it easier to work with the provider.

• MySqlTransaction: Represents an SQL transaction to be made in a MySQL database.

In the following sections, you will learn about some common use cases for Connector/NET, including BLOB handling, date handling, and using Connector/NET with common tools such as Crystal Reports.