rg1/server/Sog/3rd/MySql.Data/Framework/netstandard2_0/dataadapter.cs

// Copyright ?2004, 2018, Oracle and/or its affiliates. All rights reserved.
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License, version 2.0, as
// published by the Free Software Foundation.
//
// This program is also distributed with certain software (including
// but not limited to OpenSSL) that is licensed under separate terms,
// as designated in a particular file or component or in included license
// documentation.  The authors of MySQL hereby grant you an
// additional permission to link the program and your derivative works
// with the separately licensed software that they have included with
// MySQL.
//
// Without limiting anything contained in the foregoing, this file,
// which is part of MySQL Connector/NET, is also subject to the
// Universal FOSS Exception, version 1.0, a copy of which can be found at
// http://oss.oracle.com/licenses/universal-foss-exception.
//
// 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, version 2.0, 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

using System;
using System.Data;
using System.Data.Common;
using System.ComponentModel;
using System.Collections.Generic;
using System.Threading.Tasks;
using System.Threading;
using System.Drawing;

namespace MySql.Data.MySqlClient
{
    /// <include file='docs/MySqlDataAdapter.xml' path='docs/class/*'/>
#if NET452
  [ToolboxBitmap(typeof(MySqlDataAdapter), "MySqlClient.resources.dataadapter.bmp")]
#endif
    [DesignerCategory("Code")]
    [Designer("MySql.Data.MySqlClient.Design.MySqlDataAdapterDesigner,MySqlClient.Design")]
    public sealed class MySqlDataAdapter : DbDataAdapter, IDbDataAdapter, IDataAdapter
    {
        private bool loadingDefaults;
        private int updateBatchSize;
        List<IDbCommand> commandBatch;

        /// <summary>
        /// Occurs during Update before a command is executed against the data source. The attempt to update is made, so the event fires.
        /// </summary>
        public event MySqlRowUpdatingEventHandler RowUpdating;

        /// <summary>
        /// Occurs during Update after a command is executed against the data source. The attempt to update is made, so the event fires.
        /// </summary>
        public event MySqlRowUpdatedEventHandler RowUpdated;

        /// <include file='docs/MySqlDataAdapter.xml' path='docs/Ctor/*'/>
        public MySqlDataAdapter()
        {
            this.loadingDefaults = true;
            this.updateBatchSize = 1;
        }

        /// <include file='docs/MySqlDataAdapter.xml' path='docs/Ctor1/*'/>
        public MySqlDataAdapter(MySqlCommand selectCommand)
          : this()
        {
            this.SelectCommand = selectCommand;
        }

        /// <include file='docs/MySqlDataAdapter.xml' path='docs/Ctor2/*'/>
        public MySqlDataAdapter(string selectCommandText, MySqlConnection connection)
          : this()
        {
            this.SelectCommand = new MySqlCommand(selectCommandText, connection);
        }

        /// <include file='docs/MySqlDataAdapter.xml' path='docs/Ctor3/*'/>
        public MySqlDataAdapter(string selectCommandText, string selectConnString)
          : this()
        {
            this.SelectCommand = new MySqlCommand(
                selectCommandText,
              new MySqlConnection(selectConnString));
        }

        #region Properties

        /// <include file='docs/MySqlDataAdapter.xml' path='docs/DeleteCommand/*'/>
        [Description("Used during Update for deleted rows in Dataset.")]
        public new MySqlCommand DeleteCommand
        {
            get { return (MySqlCommand)base.DeleteCommand; }
            set { base.DeleteCommand = value; }
        }

        /// <include file='docs/MySqlDataAdapter.xml' path='docs/InsertCommand/*'/>
        [Description("Used during Update for new rows in Dataset.")]
        public new MySqlCommand InsertCommand
        {
            get { return (MySqlCommand)base.InsertCommand; }
            set { base.InsertCommand = value; }
        }

        /// <include file='docs/MySqlDataAdapter.xml' path='docs/SelectCommand/*'/>
        [Description("Used during Fill/FillSchema")]
        [Category("Fill")]
        public new MySqlCommand SelectCommand
        {
            get { return (MySqlCommand)base.SelectCommand; }
            set { base.SelectCommand = value; }
        }

        /// <include file='docs/MySqlDataAdapter.xml' path='docs/UpdateCommand/*'/>
        [Description("Used during Update for modified rows in Dataset.")]
        public new MySqlCommand UpdateCommand
        {
            get { return (MySqlCommand)base.UpdateCommand; }
            set { base.UpdateCommand = value; }
        }

        internal bool LoadDefaults
        {
            get { return this.loadingDefaults; }
            set { this.loadingDefaults = value; }
        }

        #endregion

        /// <summary>
        /// Open connection if it was closed.
        /// Necessary to workaround "connection must be open and valid" error
        /// with batched updates.
        /// </summary>
        /// <param name="state">Row state</param>
        /// <param name="openedConnections"> list of opened connections 
        /// If connection is opened by this function, the list is updated
        /// </param>
        /// <returns>true if connection was opened</returns>
        private void OpenConnectionIfClosed(
            DataRowState state,
          List<MySqlConnection> openedConnections)
        {
            MySqlCommand cmd = null;
            switch (state)
            {
                case DataRowState.Added:
                    cmd = this.InsertCommand;
                    break;
                case DataRowState.Deleted:
                    cmd = this.DeleteCommand;
                    break;
                case DataRowState.Modified:
                    cmd = this.UpdateCommand;
                    break;
                default:
                    return;
            }

            if (cmd != null && cmd.Connection != null &&
              cmd.Connection.connectionState == ConnectionState.Closed)
            {
                cmd.Connection.Open();
                openedConnections.Add(cmd.Connection);
            }
        }


        protected override int Update(DataRow[] dataRows, DataTableMapping tableMapping)
        {

            List<MySqlConnection> connectionsOpened = new List<MySqlConnection>();

            try
            {
                // Open connections for insert/update/update commands, if 
                // connections are closed.
                foreach (DataRow row in dataRows)
                {
                    this.OpenConnectionIfClosed(row.RowState, connectionsOpened);
                }

                int ret = base.Update(dataRows, tableMapping);

                return ret;
            }
            finally
            {
                foreach (MySqlConnection c in connectionsOpened)
                {
                    c.Close();
                }
            }
        }


        #region Batching Support

        public override int UpdateBatchSize
        {
            get { return this.updateBatchSize; }
            set { this.updateBatchSize = value; }
        }

        protected override void InitializeBatching()
        {
            this.commandBatch = new List<IDbCommand>();
        }

        protected override int AddToBatch(IDbCommand command)
        {
            // the first time each command is asked to be batched, we ask
            // that command to prepare its batchable command text.  We only want
            // to do this one time for each command
            MySqlCommand commandToBatch = (MySqlCommand)command;
            if (commandToBatch.BatchableCommandText == null)
            {
                commandToBatch.GetCommandTextForBatching();
            }

            IDbCommand cloneCommand = (IDbCommand)((ICloneable)command).Clone();
            this.commandBatch.Add(cloneCommand);

            return this.commandBatch.Count - 1;
        }

        protected override int ExecuteBatch()
        {
            int recordsAffected = 0;
            int index = 0;
            while (index < this.commandBatch.Count)
            {
                MySqlCommand cmd = (MySqlCommand)this.commandBatch[index++];
                for (int index2 = index; index2 < this.commandBatch.Count; index2++, index++)
                {
                    MySqlCommand cmd2 = (MySqlCommand)this.commandBatch[index2];
                    if (cmd2.BatchableCommandText == null ||
                      cmd2.CommandText != cmd.CommandText)
                    {
                        break;
                    }

                    cmd.AddToBatch(cmd2);
                }

                recordsAffected += cmd.ExecuteNonQuery();
            }

            return recordsAffected;
        }

        protected override void ClearBatch()
        {
            if (this.commandBatch.Count > 0)
            {
                MySqlCommand cmd = (MySqlCommand)this.commandBatch[0];
                if (cmd.Batch != null)
                {
                    cmd.Batch.Clear();
                }
            }

            this.commandBatch.Clear();
        }

        protected override void TerminateBatching()
        {
            this.ClearBatch();
            this.commandBatch = null;
        }

        protected override IDataParameter GetBatchedParameter(int commandIdentifier, int parameterIndex)
        {
            return (IDataParameter)this.commandBatch[commandIdentifier].Parameters[parameterIndex];
        }

        #endregion

        /// <summary>
        /// Overridden. See <see cref="DbDataAdapter.CreateRowUpdatedEvent"/>.
        /// </summary>
        /// <param name="dataRow"></param>
        /// <param name="command"></param>
        /// <param name="statementType"></param>
        /// <param name="tableMapping"></param>
        /// <returns></returns>
        override protected RowUpdatedEventArgs CreateRowUpdatedEvent(DataRow dataRow, IDbCommand command, StatementType statementType, DataTableMapping tableMapping)
        {
            return new MySqlRowUpdatedEventArgs(dataRow, command, statementType, tableMapping);
        }

        /// <summary>
        /// Overridden. See <see cref="DbDataAdapter.CreateRowUpdatingEvent"/>.
        /// </summary>
        /// <param name="dataRow"></param>
        /// <param name="command"></param>
        /// <param name="statementType"></param>
        /// <param name="tableMapping"></param>
        /// <returns></returns>
        override protected RowUpdatingEventArgs CreateRowUpdatingEvent(DataRow dataRow, IDbCommand command, StatementType statementType, DataTableMapping tableMapping)
        {
            return new MySqlRowUpdatingEventArgs(dataRow, command, statementType, tableMapping);
        }

        /// <summary>
        /// Overridden. Raises the RowUpdating event.
        /// </summary>
        /// <param name="value">A MySqlRowUpdatingEventArgs that contains the event data.</param>
        override protected void OnRowUpdating(RowUpdatingEventArgs value)
        {
            if (this.RowUpdating != null)
            {
                this.RowUpdating(this, (value as MySqlRowUpdatingEventArgs));
            }
        }

        /// <summary>
        /// Overridden. Raises the RowUpdated event.
        /// </summary>
        /// <param name="value">A MySqlRowUpdatedEventArgs that contains the event data. </param>
        override protected void OnRowUpdated(RowUpdatedEventArgs value)
        {
            if (this.RowUpdated != null)
            {
                this.RowUpdated(this, (value as MySqlRowUpdatedEventArgs));
            }
        }


        #region Async
        #region Fill

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill records with.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataSet"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet)
        {
            return this.FillAsync(dataSet, CancellationToken.None);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill records with.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataSet"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(dataSet);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataTable">The name of the <see cref="DataTable"/> to use for table mapping.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(DataTable dataTable)
        {
            return this.FillAsync(dataTable, CancellationToken.None);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataTable">The name of the <see cref="DataTable"/> to use for table mapping.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(DataTable dataTable, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(dataTable);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill with records.</param>
        /// <param name="srcTable">The name of the source table to use for table mapping.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataSet"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet, string srcTable)
        {
            return this.FillAsync(dataSet, srcTable, CancellationToken.None);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill with records.</param>
        /// <param name="srcTable">The name of the source table to use for table mapping.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataSet"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet, string srcTable, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(dataSet, srcTable);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataTable">The <see cref="DataTable"/> to fill with records.</param>
        /// <param name="dataReader">An instance of <see cref="IDataReader"/>.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(DataTable dataTable, IDataReader dataReader)
        {
            return this.FillAsync(dataTable, dataReader, CancellationToken.None);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataTable">The <see cref="DataTable"/> to fill with records.</param>
        /// <param name="dataReader">An instance of <see cref="IDataReader"/>.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(DataTable dataTable, IDataReader dataReader, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(dataTable, dataReader);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataTable">The <see cref="DataTable"/> to fill with records.</param>
        /// <param name="command">The SQL SELECT statement used to retrieve rows from the data source.</param>
        /// <param name="behavior">One of the <see cref="CommandBehavior"/> values.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(DataTable dataTable, IDbCommand command, CommandBehavior behavior)
        {
            return this.FillAsync(dataTable, command, behavior, CancellationToken.None);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataTable">The <see cref="DataTable"/> to fill with records.</param>
        /// <param name="command">The SQL SELECT statement used to retrieve rows from the data source.</param>
        /// <param name="behavior">One of the <see cref="CommandBehavior"/> values.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(DataTable dataTable, IDbCommand command, CommandBehavior behavior, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(dataTable, command, behavior);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <param name="dataTables">The <see cref="DataTable"/>s to fill with records.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(int startRecord, int maxRecords, params DataTable[] dataTables)
        {
            return this.FillAsync(startRecord, maxRecords, CancellationToken.None, dataTables);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <param name="dataTables">The <see cref="DataTable"/>s to fill with records.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(int startRecord, int maxRecords, CancellationToken cancellationToken, params DataTable[] dataTables)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(startRecord, maxRecords, dataTables);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill with records.</param>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <param name="srcTable">The name of the source table to use for table mapping.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataSet"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet, int startRecord, int maxRecords, string srcTable)
        {
            return this.FillAsync(dataSet, startRecord, maxRecords, srcTable, CancellationToken.None);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill with records.</param>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <param name="srcTable">The name of the source table to use for table mapping.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataSet"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet, int startRecord, int maxRecords, string srcTable, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(dataSet, startRecord, maxRecords, srcTable);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill with records.</param>
        /// <param name="srcTable">The name of the source table to use for table mapping.</param>
        /// <param name="dataReader">An instance of <see cref="IDataReader"/>.</param>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataSet"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet, string srcTable, IDataReader dataReader, int startRecord, int maxRecords)
        {
            return this.FillAsync(dataSet, srcTable, dataReader, startRecord, maxRecords, CancellationToken.None);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill with records.</param>
        /// <param name="srcTable">The name of the source table to use for table mapping.</param>
        /// <param name="dataReader">An instance of <see cref="IDataReader"/>.</param>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataSet"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet, string srcTable, IDataReader dataReader, int startRecord, int maxRecords, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(dataSet, srcTable, dataReader, startRecord, maxRecords);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataTables">The <see cref="DataTable"/>s to fill with records.</param>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <param name="command">The SQL SELECT statement used to retrieve rows from the data source.</param>
        /// <param name="behavior">One of the <see cref="CommandBehavior"/> values.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>s.</returns>
        public Task<int> FillAsync(DataTable[] dataTables, int startRecord, int maxRecords, IDbCommand command, CommandBehavior behavior)
        {
            return this.FillAsync(dataTables, startRecord, maxRecords, command, behavior, CancellationToken.None);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataTables">The <see cref="DataTable"/>s to fill with records.</param>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <param name="command">The SQL SELECT statement used to retrieve rows from the data source.</param>
        /// <param name="behavior">One of the <see cref="CommandBehavior"/> values.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>s.</returns>
        public Task<int> FillAsync(DataTable[] dataTables, int startRecord, int maxRecords, IDbCommand command, CommandBehavior behavior, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(dataTables, startRecord, maxRecords, command, behavior);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill with records.</param>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <param name="srcTable">The name of the source table to use for table mapping.</param>
        /// <param name="command">The SQL SELECT statement used to retrieve rows from the data source.</param>
        /// <param name="behavior">One of the <see cref="CommandBehavior"/> values.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet, int startRecord, int maxRecords, string srcTable, IDbCommand command, CommandBehavior behavior)
        {
            return this.FillAsync(dataSet, startRecord, maxRecords, srcTable, command, behavior, CancellationToken.None);
        }

        /// <summary>
        /// Asynchronous version of the Fill method.
        /// </summary>
        /// <param name="dataSet">The <see cref="DataSet"/> to fill with records.</param>
        /// <param name="startRecord">The start record.</param>
        /// <param name="maxRecords">The max number of affected records.</param>
        /// <param name="srcTable">The name of the source table to use for table mapping.</param>
        /// <param name="command">The SQL SELECT statement used to retrieve rows from the data source.</param>
        /// <param name="behavior">One of the <see cref="CommandBehavior"/> values.</param>
        /// <param name="cancellationToken">The cancellation token.</param>
        /// <returns>The number of rows successfully added to or refreshed in the <see cref="DataTable"/>.</returns>
        public Task<int> FillAsync(DataSet dataSet, int startRecord, int maxRecords, string srcTable, IDbCommand command, CommandBehavior behavior, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var fillResult = base.Fill(dataSet, startRecord, maxRecords, srcTable, command, behavior);
                    result.SetResult(fillResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        #endregion

        #region FillSchema

        /// <summary>
        /// Async version of FillSchema
        /// </summary>
        /// <param name="dataSet">DataSet to use</param>
        /// <param name="schemaType">Schema Type</param>
        /// <returns>DataTable[]</returns>
        public Task<DataTable[]> FillSchemaAsync(DataSet dataSet, SchemaType schemaType)
        {
            return this.FillSchemaAsync(dataSet, schemaType, CancellationToken.None);
        }

        public Task<DataTable[]> FillSchemaAsync(DataSet dataSet, SchemaType schemaType, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<DataTable[]>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var schemaResult = base.FillSchema(dataSet, schemaType);
                    result.SetResult(schemaResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of FillSchema
        /// </summary>
        /// <param name="dataSet">DataSet to use</param>
        /// <param name="schemaType">Schema Type</param>
        /// <param name="srcTable">Source Table</param>
        /// <returns>DataTable[]</returns>
        public Task<DataTable[]> FillSchemaAsync(DataSet dataSet, SchemaType schemaType, string srcTable)
        {
            return this.FillSchemaAsync(dataSet, schemaType, srcTable, CancellationToken.None);
        }

        public Task<DataTable[]> FillSchemaAsync(DataSet dataSet, SchemaType schemaType, string srcTable, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<DataTable[]>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var schemaResult = base.FillSchema(dataSet, schemaType, srcTable);
                    result.SetResult(schemaResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of FillSchema
        /// </summary>
        /// <param name="dataSet">DataSet to use</param>
        /// <param name="schemaType">Schema Type</param>
        /// <param name="srcTable">Source Table</param>
        /// <param name="dataReader">DataReader to use</param>
        /// <returns>DataTable[]</returns>
        public Task<DataTable[]> FillSchemaAsync(DataSet dataSet, SchemaType schemaType, string srcTable, IDataReader dataReader)
        {
            return this.FillSchemaAsync(dataSet, schemaType, srcTable, dataReader, CancellationToken.None);
        }

        public Task<DataTable[]> FillSchemaAsync(DataSet dataSet, SchemaType schemaType, string srcTable, IDataReader dataReader, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<DataTable[]>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var schemaResult = base.FillSchema(dataSet, schemaType, srcTable, dataReader);
                    result.SetResult(schemaResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of FillSchema
        /// </summary>
        /// <param name="dataSet">DataSet to use</param>
        /// <param name="schemaType">Schema Type</param>
        /// <param name="command">DBCommand to use</param>
        /// <param name="srcTable">Source Table</param>
        /// <param name="behavior">Command Behavior</param>
        /// <returns>DataTable[]</returns>
        public Task<DataTable[]> FillSchemaAsync(DataSet dataSet, SchemaType schemaType, IDbCommand command, string srcTable, CommandBehavior behavior)
        {
            return this.FillSchemaAsync(dataSet, schemaType, command, srcTable, behavior, CancellationToken.None);
        }

        public Task<DataTable[]> FillSchemaAsync(DataSet dataSet, SchemaType schemaType, IDbCommand command, string srcTable, CommandBehavior behavior, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<DataTable[]>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var schemaResult = base.FillSchema(dataSet, schemaType, command, srcTable, behavior);
                    result.SetResult(schemaResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of FillSchema
        /// </summary>
        /// <param name="dataTable">DataTable to use</param>
        /// <param name="schemaType">Schema Type</param>
        /// <returns>DataTable</returns>
        public Task<DataTable> FillSchemaAsync(DataTable dataTable, SchemaType schemaType)
        {
            return this.FillSchemaAsync(dataTable, schemaType, CancellationToken.None);
        }

        public Task<DataTable> FillSchemaAsync(DataTable dataTable, SchemaType schemaType, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<DataTable>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var schemaResult = base.FillSchema(dataTable, schemaType);
                    result.SetResult(schemaResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of FillSchema
        /// </summary>
        /// <param name="dataTable">DataTable to use</param>
        /// <param name="schemaType">Schema Type</param>
        /// <param name="dataReader">DataReader to use</param>
        /// <returns>DataTable</returns>
        public Task<DataTable> FillSchemaAsync(DataTable dataTable, SchemaType schemaType, IDataReader dataReader)
        {
            return this.FillSchemaAsync(dataTable, schemaType, dataReader, CancellationToken.None);
        }

        public Task<DataTable> FillSchemaAsync(DataTable dataTable, SchemaType schemaType, IDataReader dataReader, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<DataTable>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var schemaResult = base.FillSchema(dataTable, schemaType, dataReader);
                    result.SetResult(schemaResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of FillSchema
        /// </summary>
        /// <param name="dataTable">DataTable to use</param>
        /// <param name="schemaType">Schema Type</param>
        /// <param name="command">DBCommand to use</param>
        /// <param name="behavior">Command Behavior</param>
        /// <returns>DataTable</returns>
        public Task<DataTable> FillSchemaAsync(DataTable dataTable, SchemaType schemaType, IDbCommand command, CommandBehavior behavior)
        {
            return this.FillSchemaAsync(dataTable, schemaType, command, behavior, CancellationToken.None);
        }

        public Task<DataTable> FillSchemaAsync(DataTable dataTable, SchemaType schemaType, IDbCommand command, CommandBehavior behavior, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<DataTable>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var schemaResult = base.FillSchema(dataTable, schemaType, command, behavior);
                    result.SetResult(schemaResult);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        #endregion

        #region Update

        /// <summary>
        /// Async version of Update
        /// </summary>
        /// <param name="dataRows">DataRow[] to use</param>
        /// <returns>int</returns>
        public Task<int> UpdateAsync(DataRow[] dataRows)
        {
            return this.UpdateAsync(dataRows, CancellationToken.None);
        }

        public Task<int> UpdateAsync(DataRow[] dataRows, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var update = base.Update(dataRows);
                    result.SetResult(update);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of Update
        /// </summary>
        /// <param name="dataSet">DataSet to use</param>
        /// <returns>int</returns>
        public Task<int> UpdateAsync(DataSet dataSet)
        {
            return this.UpdateAsync(dataSet, CancellationToken.None);
        }

        public Task<int> UpdateAsync(DataSet dataSet, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var update = base.Update(dataSet);
                    result.SetResult(update);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of Update
        /// </summary>
        /// <param name="dataTable">DataTable to use</param>
        /// <returns>int</returns>
        public Task<int> UpdateAsync(DataTable dataTable)
        {
            return this.UpdateAsync(dataTable, CancellationToken.None);
        }

        public Task<int> UpdateAsync(DataTable dataTable, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var update = base.Update(dataTable);
                    result.SetResult(update);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of Update
        /// </summary>
        /// <param name="dataRows">DataRow[] to use</param>
        /// <param name="tableMapping">Data Table Mapping</param>
        /// <returns>int</returns>
        public Task<int> UpdateAsync(DataRow[] dataRows, DataTableMapping tableMapping)
        {
            return this.UpdateAsync(dataRows, tableMapping, CancellationToken.None);
        }

        public Task<int> UpdateAsync(DataRow[] dataRows, DataTableMapping tableMapping, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var update = base.Update(dataRows, tableMapping);
                    result.SetResult(update);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        /// <summary>
        /// Async version of Update
        /// </summary>
        /// <param name="dataSet">DataSet to use</param>
        /// <param name="srcTable">Source Table</param>
        /// <returns></returns>
        public Task<int> UpdateAsync(DataSet dataSet, string srcTable)
        {
            return this.UpdateAsync(dataSet, srcTable, CancellationToken.None);
        }

        public Task<int> UpdateAsync(DataSet dataSet, string srcTable, CancellationToken cancellationToken)
        {
            var result = new TaskCompletionSource<int>();
            if (cancellationToken == CancellationToken.None || !cancellationToken.IsCancellationRequested)
            {
                try
                {
                    var update = base.Update(dataSet, srcTable);
                    result.SetResult(update);
                }
                catch (Exception ex)
                {
                    result.SetException(ex);
                }
            }
            else
            {
                result.SetCanceled();
            }

            return result.Task;
        }

        #endregion
        #endregion

    }

    /// <summary>
    /// Represents the method that will handle the <see cref="MySqlDataAdapter.RowUpdating"/> event of a <see cref="MySqlDataAdapter"/>.
    /// </summary>
    public delegate void MySqlRowUpdatingEventHandler(object sender, MySqlRowUpdatingEventArgs e);

    /// <summary>
    /// Represents the method that will handle the <see cref="MySqlDataAdapter.RowUpdated"/> event of a <see cref="MySqlDataAdapter"/>.
    /// </summary>
    public delegate void MySqlRowUpdatedEventHandler(object sender, MySqlRowUpdatedEventArgs e);

    /// <summary>
    /// Provides data for the RowUpdating event. This class cannot be inherited.
    /// </summary>
    public sealed class MySqlRowUpdatingEventArgs : RowUpdatingEventArgs
    {
        /// <summary>
        /// Initializes a new instance of the MySqlRowUpdatingEventArgs class.
        /// </summary>
        /// <param name="row">The <see cref="DataRow"/> to 
        /// <see cref="DbDataAdapter.Update(DataSet)"/>.</param>
        /// <param name="command">The <see cref="IDbCommand"/> to execute during <see cref="DbDataAdapter.Update(DataSet)"/>.</param>
        /// <param name="statementType">One of the <see cref="StatementType"/> values that specifies the type of query executed.</param>
        /// <param name="tableMapping">The <see cref="DataTableMapping"/> sent through an <see cref="DbDataAdapter.Update(DataSet)"/>.</param>
        public MySqlRowUpdatingEventArgs(DataRow row, IDbCommand command, StatementType statementType, DataTableMapping tableMapping)
          : base(row, command, statementType, tableMapping)
        {
        }

        /// <summary>
        /// Gets or sets the MySqlCommand to execute when performing the Update.
        /// </summary>
        new public MySqlCommand Command
        {
            get { return (MySqlCommand)base.Command; }
            set { base.Command = value; }
        }
    }

    /// <summary>
    /// Provides data for the RowUpdated event. This class cannot be inherited.
    /// </summary>
    public sealed class MySqlRowUpdatedEventArgs : RowUpdatedEventArgs
    {
        /// <summary>
        /// Initializes a new instance of the MySqlRowUpdatedEventArgs class.
        /// </summary>
        /// <param name="row">The <see cref="DataRow"/> sent through an <see cref="DbDataAdapter.Update(DataSet)"/>.</param>
        /// <param name="command">The <see cref="IDbCommand"/> executed when <see cref="DbDataAdapter.Update(DataSet)"/> is called.</param>
        /// <param name="statementType">One of the <see cref="StatementType"/> values that specifies the type of query executed.</param>
        /// <param name="tableMapping">The <see cref="DataTableMapping"/> sent through an <see cref="DbDataAdapter.Update(DataSet)"/>.</param>
        public MySqlRowUpdatedEventArgs(DataRow row, IDbCommand command, StatementType statementType, DataTableMapping tableMapping)
          : base(row, command, statementType, tableMapping)
        {
        }

        /// <summary>
        /// Gets or sets the MySqlCommand executed when Update is called.
        /// </summary>
        new public MySqlCommand Command
        {
            get { return (MySqlCommand)base.Command; }
        }
    }
}