/// <summary>
        /// Fill method for populating an entire collection of REOProperties
        /// </summary>
        public virtual void Fill(REOProperties rEOProperties)
        {
            // create the connection to use
            SqlConnection cnn = new SqlConnection(REOProperty.GetConnectionString());


            try
            {
                using (cnn)
                {
                    // open the connection
                    cnn.Open();


                    // create an instance of the reader to fill.
                    SqlDataReader datareader = SqlHelper.ExecuteReader(cnn, "gsp_SelectREOProperties");


                    // Send the collection and data to the object factory
                    CreateObjectsFromData(rEOProperties, datareader);


                    // close the connection
                    cnn.Close();
                }


                // nullify the connection
                cnn = null;
            }
            catch (SqlException sqlex)
            {
                throw sqlex;
            }
        }
        /// <summary>
        /// Deletes the object.
        /// </summary>
        public virtual void Delete(REOProperty deleteObject)
        {
            // create a new instance of the connection
            SqlConnection cnn = new SqlConnection(REOProperty.GetConnectionString());
            // create local variable array for the sql parameters
            SqlParameterHash sqlparams = null;


            try
            {
                // discover the parameters
                sqlparams = SqlHelperParameterCache.GetSpParameterSet(REOProperty.GetConnectionString(), "gsp_DeleteREOProperty");


                // Store the parameter for the Id attribute.
                sqlparams["@id"].Value = deleteObject.Id;


                using (cnn)
                {
                    // open the connection
                    cnn.Open();


                    // Execute the stored proc to perform the delete on the instance.
                    SqlHelper.ExecuteNonQuery(cnn, CommandType.StoredProcedure, "gsp_DeleteREOProperty", sqlparams);


                    // close the connection after usage
                    cnn.Close();
                }


                // nullify the connection var
                cnn = null;
            }
            catch (SqlException sqlex)
            {
                throw sqlex;
            }


            // nullify the reference
            deleteObject = null;
        }
        /// <summary>
        /// Fill method for populating a collection by LOAN_APPLICATION
        /// </summary>
        public void FillByLoanApplication(REOProperties rEOProperties, System.Int64 id)
        {
            // create the connection to use
            SqlConnection cnn = new SqlConnection(REOProperty.GetConnectionString());


            try
            {
                // discover the sql parameters
                SqlParameterHash sqlparams = SqlHelperParameterCache.GetSpParameterSet(REOProperty.GetConnectionString(), "gsp_SelectREOPropertiesByLoanApplication");


                using (cnn)
                {
                    // open the connection
                    cnn.Open();


                    // set the parameters
                    sqlparams["@loanApplicationId"].Value = id;


                    // create an instance of the reader to fill.
                    SqlDataReader datareader = SqlHelper.ExecuteReader(cnn, "gsp_SelectREOPropertiesByLoanApplication", sqlparams);


                    // Send the collection and data to the object factory.
                    CreateObjectsFromData(rEOProperties, datareader);


                    // close the connection
                    cnn.Close();
                }


                // nullify the connection
                cnn = null;
            }
            catch (SqlException sqlex)
            {
                throw sqlex;
            }
        }
        /// <summary>
        /// Fills a single instance with data based on its primary key values.
        /// </summary>
        public virtual void Fill(REOProperty reoproperty, System.Int64 id)
        {
            // create the connection to use
            SqlConnection cnn = new SqlConnection(REOProperty.GetConnectionString());

            try
            {
                // discover the sql parameters
                SqlParameterHash sqlparams = SqlHelperParameterCache.GetSpParameterSet(REOProperty.GetConnectionString(), "gsp_SelectREOProperty");


                using (cnn)
                {
                    // open the connection
                    cnn.Open();


                    // set the parameters
                    sqlparams["@id"].Value = id;


                    // create an instance of the reader to fill.
                    SqlDataReader datareader = SqlHelper.ExecuteReader(cnn, "gsp_SelectREOProperty", sqlparams);


                    if (datareader.Read())
                    {
                        reoproperty.SetMembers(ref datareader);
                    }


                    cnn.Close();                     // close the connection
                }


                // nullify the connection var
                cnn = null;
            }
            catch (SqlException sqlex)
            {
                throw sqlex;
            }
        }
        /// <summary>
        /// Persists the object.
        /// </summary>
        public virtual void Persist(REOProperty persistObject, SqlTransaction sqlTrans)
        {
            // create local variable array for the sql parameters
            SqlParameterHash sqlparams = null;
            // Create a local variable for the connection
            SqlConnection cnn = null;


            // Use the parameter overload or create a new instance
            if (sqlTrans == null)
            {
                cnn = new SqlConnection(REOProperty.GetConnectionString());
            }


            try
            {
                // discover the parameters
                if (persistObject.Persisted)
                {
                    sqlparams = SqlHelperParameterCache.GetSpParameterSet(REOProperty.GetConnectionString(), "gsp_UpdateREOProperty");
                }
                else
                {
                    sqlparams = SqlHelperParameterCache.GetSpParameterSet(REOProperty.GetConnectionString(), "gsp_CreateREOProperty");
                }


                // Store the parameter for the LoanApplicationId attribute.
                if (!persistObject.LoanApplicationIdIsNull)
                {
                    sqlparams["@loanApplicationId"].Value = persistObject.LoanApplicationId;
                }
                // Store the parameter for the StreetAddress attribute.
                if (!persistObject.StreetAddressIsNull)
                {
                    sqlparams["@streetAddress"].Value = persistObject.StreetAddress;
                }
                // Store the parameter for the StreetAddress2 attribute.
                if (!persistObject.StreetAddress2IsNull)
                {
                    sqlparams["@streetAddress2"].Value = persistObject.StreetAddress2;
                }
                // Store the parameter for the City attribute.
                if (!persistObject.CityIsNull)
                {
                    sqlparams["@city"].Value = persistObject.City;
                }
                // Store the parameter for the State attribute.
                if (!persistObject.StateIsNull)
                {
                    sqlparams["@state"].Value = persistObject.State;
                }
                // Store the parameter for the PostalCode attribute.
                if (!persistObject.PostalCodeIsNull)
                {
                    sqlparams["@postalCode"].Value = persistObject.PostalCode;
                }
                // Store the parameter for the CurrentResidenceIndicator attribute.
                sqlparams["@currentResidenceIndicator"].Value = persistObject.CurrentResidenceIndicator;
                // Store the parameter for the LienInstallmentAmount attribute.
                if (!persistObject.LienInstallmentAmountIsNull)
                {
                    sqlparams["@lienInstallmentAmount"].Value = persistObject.LienInstallmentAmount;
                }
                // Store the parameter for the LienUPBAmount attribute.
                if (!persistObject.LienUPBAmountIsNull)
                {
                    sqlparams["@lienUPBAmount"].Value = persistObject.LienUPBAmount;
                }
                // Store the parameter for the MaintenanceExpenseAmount attribute.
                if (!persistObject.MaintenanceExpenseAmountIsNull)
                {
                    sqlparams["@maintenanceExpenseAmount"].Value = persistObject.MaintenanceExpenseAmount;
                }
                // Store the parameter for the MarketValueAmount attribute.
                if (!persistObject.MarketValueAmountIsNull)
                {
                    sqlparams["@marketValueAmount"].Value = persistObject.MarketValueAmount;
                }
                // Store the parameter for the RentalIncomeGrossAmount attribute.
                if (!persistObject.RentalIncomeGrossAmountIsNull)
                {
                    sqlparams["@rentalIncomeGrossAmount"].Value = persistObject.RentalIncomeGrossAmount;
                }
                // Store the parameter for the RentalIncomeNetAmount attribute.
                if (!persistObject.RentalIncomeNetAmountIsNull)
                {
                    sqlparams["@rentalIncomeNetAmount"].Value = persistObject.RentalIncomeNetAmount;
                }
                // Store the parameter for the SubjectIndicator attribute.
                sqlparams["@subjectIndicator"].Value = persistObject.SubjectIndicator;
                // Store the parameter for the BorrowerID attribute.
                if (!persistObject.BorrowerIDIsNull)
                {
                    sqlparams["@borrowerID"].Value = persistObject.BorrowerID;
                }
                // Store the parameter for the LiabilityID attribute.
                if (!persistObject.LiabilityIDIsNull)
                {
                    sqlparams["@liabilityID"].Value = persistObject.LiabilityID;
                }
                // Store the parameter for the GSEPropertyType attribute.
                if (!persistObject.GSEPropertyTypeIsNull)
                {
                    sqlparams["@gSEPropertyType"].Value = persistObject.GSEPropertyType;
                }
                // Store the parameter for the DispositionStatusType attribute.
                if (!persistObject.DispositionStatusTypeIsNull)
                {
                    sqlparams["@dispositionStatusType"].Value = persistObject.DispositionStatusType;
                }
                // Store the parameter for the Id attribute.
                if (!persistObject.Persisted)
                {
                    // store the create only (historical fixed) values
                }
                else
                {
                    // store the update only (historical changeable) values
                    // Store the parameter for the Id attribute.
                    sqlparams["@id"].Value = persistObject.Id;
                }


                if (sqlTrans == null)
                {
                    // Process using the isolated connection
                    using (cnn)
                    {
                        // open the connection
                        cnn.Open();


                        if (!persistObject.Persisted)
                        {
                            persistObject._id = Convert.ToInt64(SqlHelper.ExecuteScalar(cnn, CommandType.StoredProcedure, "gsp_CreateREOProperty", sqlparams));
                        }
                        else
                        {
                            SqlHelper.ExecuteNonQuery(cnn, CommandType.StoredProcedure, "gsp_UpdateREOProperty", sqlparams);
                        }


                        // close the connection after usage
                        cnn.Close();
                    }


                    // nullify the connection var
                    cnn = null;
                }
                else
                {
                    // Process using the shared transaction
                    if (!persistObject.Persisted)
                    {
                        persistObject._id = Convert.ToInt64(SqlHelper.ExecuteScalar(sqlTrans, CommandType.StoredProcedure, "gsp_CreateREOProperty", sqlparams));
                    }
                    else
                    {
                        SqlHelper.ExecuteNonQuery(sqlTrans, CommandType.StoredProcedure, "gsp_UpdateREOProperty", sqlparams);
                    }
                }
            }
            catch (SqlException sqlex)
            {
                throw sqlex;
            }
        }