/// <summary>
        ///     Inserts a Nettiers.AdventureWorks.Entities.SpecialOffer object into the datasource using a transaction.
        /// </summary>
        /// <param name="transactionManager"><see cref="TransactionManager"/> object</param>
        /// <param name="entity">Nettiers.AdventureWorks.Entities.SpecialOffer object to insert.</param>
        /// <remarks>
        ///		After inserting into the datasource, the Nettiers.AdventureWorks.Entities.SpecialOffer object will be updated
        ///     to refelect any changes made by the datasource. (ie: identity or computed columns)
        /// </remarks>
        /// <returns>Returns true if operation is successful.</returns>
        /// <exception cref="System.Exception">The command could not be executed.</exception>
        /// <exception cref="System.Data.DataException">The <paramref name="transactionManager"/> is not open.</exception>
        /// <exception cref="System.Data.Common.DbException">The command could not be executed.</exception>
        public override bool Insert(TransactionManager transactionManager, Nettiers.AdventureWorks.Entities.SpecialOffer entity)
        {
            SqlDatabase database       = new SqlDatabase(this._connectionString);
            DbCommand   commandWrapper = StoredProcedureProvider.GetCommandWrapper(database, "Sales.usp_adwTiers_SpecialOffer_Insert", _useStoredProcedure);

            database.AddOutParameter(commandWrapper, "@SpecialOfferId", DbType.Int32, 4);
            database.AddInParameter(commandWrapper, "@Description", DbType.String, entity.Description);
            database.AddInParameter(commandWrapper, "@DiscountPct", DbType.Currency, entity.DiscountPct);
            database.AddInParameter(commandWrapper, "@Type", DbType.String, entity.Type);
            database.AddInParameter(commandWrapper, "@Category", DbType.String, entity.Category);
            database.AddInParameter(commandWrapper, "@StartDate", DbType.DateTime, entity.StartDate);
            database.AddInParameter(commandWrapper, "@EndDate", DbType.DateTime, entity.EndDate);
            database.AddInParameter(commandWrapper, "@MinQty", DbType.Int32, entity.MinQty);
            database.AddInParameter(commandWrapper, "@MaxQty", DbType.Int32, (entity.MaxQty.HasValue ? (object)entity.MaxQty  : System.DBNull.Value));
            database.AddOutParameter(commandWrapper, "@Rowguid", DbType.Guid, 16);
            database.AddInParameter(commandWrapper, "@ModifiedDate", DbType.DateTime, entity.ModifiedDate);

            int results = 0;

            //Provider Data Requesting Command Event
            OnDataRequesting(new CommandEventArgs(commandWrapper, "Insert", entity));

            if (transactionManager != null)
            {
                results = Utility.ExecuteNonQuery(transactionManager, commandWrapper);
            }
            else
            {
                results = Utility.ExecuteNonQuery(database, commandWrapper);
            }

            object _specialOfferId = database.GetParameterValue(commandWrapper, "@SpecialOfferId");

            entity.SpecialOfferId = (System.Int32)_specialOfferId;
            object _rowguid = database.GetParameterValue(commandWrapper, "@Rowguid");

            entity.Rowguid = (System.Guid)_rowguid;


            entity.AcceptChanges();

            //Provider Data Requested Command Event
            OnDataRequested(new CommandEventArgs(commandWrapper, "Insert", entity));

            return(Convert.ToBoolean(results));
        }
        /// <summary>
        ///     Update an existing row in the datasource.
        /// </summary>
        /// <param name="transactionManager"><see cref="TransactionManager"/> object</param>
        /// <param name="entity">Nettiers.AdventureWorks.Entities.SpecialOffer object to update.</param>
        /// <remarks>
        ///		After updating the datasource, the Nettiers.AdventureWorks.Entities.SpecialOffer object will be updated
        ///     to refelect any changes made by the datasource. (ie: identity or computed columns)
        /// </remarks>
        /// <returns>Returns true if operation is successful.</returns>
        /// <exception cref="System.Exception">The command could not be executed.</exception>
        /// <exception cref="System.Data.DataException">The <paramref name="transactionManager"/> is not open.</exception>
        /// <exception cref="System.Data.Common.DbException">The command could not be executed.</exception>
        public override bool Update(TransactionManager transactionManager, Nettiers.AdventureWorks.Entities.SpecialOffer entity)
        {
            SqlDatabase database       = new SqlDatabase(this._connectionString);
            DbCommand   commandWrapper = StoredProcedureProvider.GetCommandWrapper(database, "Sales.usp_adwTiers_SpecialOffer_Update", _useStoredProcedure);

            database.AddInParameter(commandWrapper, "@SpecialOfferId", DbType.Int32, entity.SpecialOfferId);
            database.AddInParameter(commandWrapper, "@Description", DbType.String, entity.Description);
            database.AddInParameter(commandWrapper, "@DiscountPct", DbType.Currency, entity.DiscountPct);
            database.AddInParameter(commandWrapper, "@Type", DbType.String, entity.Type);
            database.AddInParameter(commandWrapper, "@Category", DbType.String, entity.Category);
            database.AddInParameter(commandWrapper, "@StartDate", DbType.DateTime, entity.StartDate);
            database.AddInParameter(commandWrapper, "@EndDate", DbType.DateTime, entity.EndDate);
            database.AddInParameter(commandWrapper, "@MinQty", DbType.Int32, entity.MinQty);
            database.AddInParameter(commandWrapper, "@MaxQty", DbType.Int32, (entity.MaxQty.HasValue ? (object)entity.MaxQty : System.DBNull.Value));
            database.AddInParameter(commandWrapper, "@Rowguid", DbType.Guid, entity.Rowguid);
            database.AddInParameter(commandWrapper, "@ModifiedDate", DbType.DateTime, entity.ModifiedDate);

            int results = 0;

            //Provider Data Requesting Command Event
            OnDataRequesting(new CommandEventArgs(commandWrapper, "Update", entity));

            if (transactionManager != null)
            {
                results = Utility.ExecuteNonQuery(transactionManager, commandWrapper);
            }
            else
            {
                results = Utility.ExecuteNonQuery(database, commandWrapper);
            }

            //Stop Tracking Now that it has been updated and persisted.
            if (DataRepository.Provider.EnableEntityTracking)
            {
                EntityManager.StopTracking(entity.EntityTrackingKey);
            }


            entity.AcceptChanges();

            //Provider Data Requested Command Event
            OnDataRequested(new CommandEventArgs(commandWrapper, "Update", entity));

            return(Convert.ToBoolean(results));
        }
        /// <summary>
        /// Convert a nettiers collection to the ws proxy collection.
        /// </summary>
        public static Nettiers.AdventureWorks.Entities.SpecialOffer Convert(Nettiers.AdventureWorks.Entities.SpecialOffer outItem, WsProxy.SpecialOffer item)
        {
            if (item != null && outItem != null)
            {
                outItem.SpecialOfferId = item.SpecialOfferId;
                outItem.Description    = item.Description;
                outItem.DiscountPct    = item.DiscountPct;
                outItem.Type           = item.Type;
                outItem.Category       = item.Category;
                outItem.StartDate      = item.StartDate;
                outItem.EndDate        = item.EndDate;
                outItem.MinQty         = item.MinQty;
                outItem.MaxQty         = item.MaxQty;
                outItem.Rowguid        = item.Rowguid;
                outItem.ModifiedDate   = item.ModifiedDate;

                outItem.AcceptChanges();
            }

            return(outItem);
        }
        /// <summary>
        ///     Update an existing row in the datasource.
        /// </summary>
        /// <param name="transactionManager"><see cref="TransactionManager"/> object</param>
        /// <param name="entity">Nettiers.AdventureWorks.Entities.SpecialOffer object to update.</param>
        /// <remarks></remarks>
        /// <returns>Returns true if operation is successful.</returns>
        public override bool Update(TransactionManager transactionManager, Nettiers.AdventureWorks.Entities.SpecialOffer entity)
        {
            WsProxy.AdventureWorksServices proxy = new WsProxy.AdventureWorksServices();
            proxy.Url = Url;

            try
            {
                WsProxy.SpecialOffer result = proxy.SpecialOfferProvider_Update(Convert(entity));
                Convert(entity, result);
                entity.AcceptChanges();
                return(true);
            }
            catch (SoapException soex)
            {
                System.Diagnostics.Debug.WriteLine(soex);
                throw soex;
            }
            catch (Exception ex)
            {
                System.Diagnostics.Debug.WriteLine(ex);
                throw ex;
            }
        }