/// <summary>
        ///     Inserts a EmployeeDB.BLL.Countries object into the datasource using a transaction.
        /// </summary>
        /// <param name="transactionManager"><see cref="TransactionManager"/> object</param>
        /// <param name="entity">EmployeeDB.BLL.Countries object to insert.</param>
        /// <remarks>
        ///		After inserting into the datasource, the EmployeeDB.BLL.Countries 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, EmployeeDB.BLL.Countries entity)
        {
            SqlDatabase database       = new SqlDatabase(this._connectionString);
            DbCommand   commandWrapper = StoredProcedureProvider.GetCommandWrapper(database, "dbo.Countries_Insert", _useStoredProcedure);

            database.AddInParameter(commandWrapper, "@CountryCode", DbType.AnsiString, entity.CountryCode);
            database.AddInParameter(commandWrapper, "@Name", DbType.String, entity.Name);

            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);
            }


            entity.OriginalCountryCode = entity.CountryCode;

            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">EmployeeDB.BLL.Countries object to update.</param>
        /// <remarks>
        ///		After updating the datasource, the EmployeeDB.BLL.Countries 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, EmployeeDB.BLL.Countries entity)
        {
            SqlDatabase database       = new SqlDatabase(this._connectionString);
            DbCommand   commandWrapper = StoredProcedureProvider.GetCommandWrapper(database, "dbo.Countries_Update", _useStoredProcedure);

            database.AddInParameter(commandWrapper, "@CountryCode", DbType.AnsiString, entity.CountryCode);
            database.AddInParameter(commandWrapper, "@OriginalCountryCode", DbType.AnsiString, entity.OriginalCountryCode);
            database.AddInParameter(commandWrapper, "@Name", DbType.String, entity.Name);

            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.OriginalCountryCode = entity.CountryCode;

            entity.AcceptChanges();

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

            return(Convert.ToBoolean(results));
        }
        ///<summary>
        ///  Returns a Typed Countries Entity
        ///</summary>
        protected virtual Countries Copy(IDictionary existingCopies)
        {
            if (existingCopies == null)
            {
                // This is the root of the tree to be copied!
                existingCopies = new Hashtable();
            }

            //shallow copy entity
            Countries copy = new Countries();

            existingCopies.Add(this, copy);
            copy.SuppressEntityEvents = true;
            copy.CountryCode          = this.CountryCode;
            copy.OriginalCountryCode  = this.OriginalCountryCode;
            copy.Name = this.Name;


            //deep copy nested objects
            copy.AddressCollection    = (TList <Address>)MakeCopyOf(this.AddressCollection, existingCopies);
            copy.EntityState          = this.EntityState;
            copy.SuppressEntityEvents = false;
            return(copy);
        }