// transfer model object to data object
 // links:
 //  docLink: http://sql2x.org/documentationLink/95875d99-b7f7-4a9e-baa4-3fbe9925d8a2
 public static void ModelToData(CrudeDefaultSystemSettingRefModel model, CrudeDefaultSystemSettingRefData data)
 {
     data.DefaultSystemSettingRcd  = model.DefaultSystemSettingRcd;
     data.DefaultSystemSettingName = model.DefaultSystemSettingName;
     data.DefaultUserId            = model.DefaultUserId;
     data.DateTime = model.DateTime;
 }
        // update all object members on a row in table based on primary key
        // links:
        //  docLink: http://sql2x.org/documentationLink/ce75e72e-fb16-4f4e-a2e6-dbd079dfa206
        public void Update(CrudeDefaultSystemSettingRefContract contract)
        {
            var data = new CrudeDefaultSystemSettingRefData();

            ContractToData(contract, data);
            data.Update();
        }
 // copy all columns from a serialized data object to a SOAP Contract
 // links:
 //  docLink: http://sql2x.org/documentationLink/7553d6dd-da65-4a72-84c8-81f2f99ef4f5
 public static void DataToContract(CrudeDefaultSystemSettingRefData data, CrudeDefaultSystemSettingRefContract contract)
 {
     contract.DefaultSystemSettingRcd  = data.DefaultSystemSettingRcd;
     contract.DefaultSystemSettingName = data.DefaultSystemSettingName;
     contract.DefaultUserId            = data.DefaultUserId;
     contract.DateTime = data.DateTime;
 }
        // update all object members on a row in table based on primary key, on a transaction
        // the transaction and or connection state is not changed in any way other than what SqlClient does to it.
        // it is the callers responsibility to commit or rollback the transaction
        // links:
        //  docLink: http://sql2x.org/documentationLink/b798ad6b-f4b8-466a-9086-6588a814fcf3
        public void Update(CrudeDefaultSystemSettingRefContract contract, SqlConnection connection, SqlTransaction transaction)
        {
            var data = new CrudeDefaultSystemSettingRefData();

            ContractToData(contract, data);
            data.Update(connection, transaction);
        }
        // transfer model to data and insert
        // links:
        //  docLink: http://sql2x.org/documentationLink/17cd8423-3c78-459f-a45b-773fcfbc3b7d
        public void Insert(CrudeDefaultSystemSettingRefModel model)
        {
            var data = new CrudeDefaultSystemSettingRefData();

            ModelToData(model, data);
            data.Insert();
        }
        // transfer model to data and update
        // links:
        //  docLink: http://sql2x.org/documentationLink/658fda50-2ad3-414e-9299-2b399d17a057
        public void Update(CrudeDefaultSystemSettingRefModel model)
        {
            var data = new CrudeDefaultSystemSettingRefData();

            ModelToData(model, data);
            data.Update();
        }
        // transfer model to data and update, on a transaction
        // links:
        //  docLink: http://sql2x.org/documentationLink/aa07e05b-edc8-4e09-bf93-bf2a40c93c09
        public void Update(CrudeDefaultSystemSettingRefModel model, SqlConnection connection, SqlTransaction transaction)
        {
            var data = new CrudeDefaultSystemSettingRefData();

            ModelToData(model, data);
            data.Update(connection, transaction);
        }
 // transfer model list to data list
 // links:
 //  crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
 //  docLink: http://sql2x.org/documentationLink/1d6a48d9-fe39-4397-b8fa-a332da164cbf
 // parameters:
 //  CrudeDefaultSystemSettingRefData: key of table CrudeDefaultSystemSettingRefData
 public static void ModelListToDataList(List <CrudeDefaultSystemSettingRefModel> modelList, List <CrudeDefaultSystemSettingRefData> dataList)
 {
     foreach (CrudeDefaultSystemSettingRefModel model in modelList)
     {
         var data = new CrudeDefaultSystemSettingRefData();
         ModelToData(model, data);
         dataList.Add(data);
     }
 }
 // copy all rows from a List of SOAP Contracts to a List of serialized data objects
 // links:
 //  docLink: http://sql2x.org/documentationLink/1c6c6b9c-e201-4590-8c69-d38a0ad2a9f7
 public static void ContractListToDataList(List <CrudeDefaultSystemSettingRefContract> contractList, List <CrudeDefaultSystemSettingRefData> dataList)
 {
     foreach (CrudeDefaultSystemSettingRefContract contract in contractList)
     {
         var data = new CrudeDefaultSystemSettingRefData();
         CrudeDefaultSystemSettingRefService.ContractToData(contract, data);
         dataList.Add(data);
     }
 }
Example #10
0
        // fetch all from table into new List of class instances, only populating specific columns,
        //  with a limit on number of returned rows and order by columns starting at a specific row
        // links:
        //  docLink: http://sql2x.org/documentationLink/12d2812e-e963-4f26-8014-48c4e9cfb3ae
        public static List <CrudeDefaultSystemSettingRefData> FetchAllWithLimitAndOffset(int limit, int offset)
        {
            var dataList = new List <CrudeDefaultSystemSettingRefData>();

            // create query against default_system_setting_ref
            // this will be ansi sql and parameterized
            // parameterized queries are a good way of preventing sql injection
            //   and to make sure the query plan is pre-compiled
            // links:
            // docLink: http://sql2x.org/documentationLink/21eca289-4747-4a75-b0a2-1a58457be608
            string sql = @" select default_system_setting_rcd, default_system_setting_name, default_user_id, date_time
                            from [default_system_setting_ref]
                            order by default_system_setting_name";

            // open standard connection
            // the connection is found in web.config
            // the connection is closed upon completion of the reader
            // links:
            // docLink: http://sql2x.org/documentationLink/c3e624a4-8479-4c17-bec7-ec09f3abbe64
            using (var conn = new SqlConnection(Conn.ConnectionString)) {
                conn.Open();

                using (var command = new SqlCommand(sql, conn)) {
                    // execute query against default_system_setting_ref
                    // if the query fails in the preprocessor of sql server
                    //   an exception will be raised
                    // links:
                    // docLink: http://sql2x.org/documentationLink/6507b543-adbc-4863-810b-8db439f40d5c
                    IDataReader reader = command.ExecuteReader(CommandBehavior.SingleResult);

                    int count = 0;

                    // read all rows returned from the query of default_system_setting_ref
                    // read all columns from the datareader and
                    //   populate the List of C# objects with them
                    // links:
                    // docLink: http://sql2x.org/documentationLink/fcd15e2f-df3f-44d8-8a13-d2e93d97f685
                    while (reader.Read())
                    {
                        if ((count >= offset) && (count <= offset + limit))
                        {
                            var data = new CrudeDefaultSystemSettingRefData();
                            data.Populate(reader);
                            dataList.Add(data);
                        }
                        count++;
                        if (count > limit + offset)
                        {
                            break;
                        }
                    }
                }

                return(dataList);
            }
        }
        // fetch by Primary key into current object
        // links:
        //  crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
        //  docLink: http://sql2x.org/documentationLink/bbab4791-c9e7-49bf-90d5-fca19b1fedaa
        // parameters:
        //  defaultSystemSettingRcd: primary key of table default_system_setting_ref
        public CrudeDefaultSystemSettingRefContract FetchByDefaultSystemSettingRcd(string defaultSystemSettingRcd)
        {
            var dataAccessLayer = new CrudeDefaultSystemSettingRefData();
            var contract        = new CrudeDefaultSystemSettingRefContract();

            dataAccessLayer.FetchByDefaultSystemSettingRcd(defaultSystemSettingRcd);
            DataToContract(dataAccessLayer, contract);

            return(contract);
        }
        // fetch by Search key into current object
        // links:
        //  crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
        //  docLink: http://sql2x.org/documentationLink/ad2dd952-e3ec-471a-9e34-f5fc965b8b37
        // parameters:
        //  DefaultSystemSettingName: key of table CrudeDefaultSystemSettingRefData
        public CrudeDefaultSystemSettingRefModel FetchByDefaultSystemSettingName(string defaultSystemSettingName)
        {
            var dataAccessLayer = new CrudeDefaultSystemSettingRefData();
            var model           = new CrudeDefaultSystemSettingRefModel();

            dataAccessLayer.FetchByDefaultSystemSettingName(defaultSystemSettingName);
            DataToModel(dataAccessLayer, model);

            return(model);
        }
Example #13
0
        // fetch by Foreign key into new List of class instances
        // links:
        //  docLink: http://sql2x.org/documentationLink/13095cd7-f136-4532-8969-c50c62cc05ef
        public static List <CrudeDefaultSystemSettingRefData> FetchByDefaultUserId(System.Guid defaultUserId)
        {
            var dataList = new List <CrudeDefaultSystemSettingRefData>();

            // create query against default_system_setting_ref
            // this will be ansi sql and parameterized
            // parameterized queries are a good way of preventing sql injection
            //   and to make sure the query plan is pre-compiled
            // links:
            // docLink: http://sql2x.org/documentationLink/86c78f05-a65f-4dfe-b048-d0cbece49f4e
            string sql = @" select default_system_setting_rcd, default_system_setting_name, default_user_id, date_time
                            from [default_system_setting_ref]
                            where default_user_id = @default_user_id
                              
                            order by default_system_setting_name";

            // open standard connection
            // the connection is found in web.config
            // the connection is closed upon completion of the reader
            // links:
            // docLink: http://sql2x.org/documentationLink/6fd25822-459f-4796-803a-071a3a270aa0
            using (var conn = new SqlConnection(Conn.ConnectionString)) {
                conn.Open();

                using (var command = new SqlCommand(sql, conn)) {
                    // add foreign key column
                    // this foreign key column will be used together with the prepared ansi sql statement
                    // links:
                    // docLink: http://sql2x.org/documentationLink/8aec2e5c-4732-4662-badb-83b89d1c34a9
                    command.Parameters.Add("@default_user_id", SqlDbType.UniqueIdentifier).Value = defaultUserId;

                    // execute query against default_system_setting_ref
                    // if the query fails in the preprocessor of sql server
                    //   an exception will be raised
                    // links:
                    // docLink: http://sql2x.org/documentationLink/bb9abe5c-d2c1-455a-b597-a2af0a35de5a
                    IDataReader reader = command.ExecuteReader(CommandBehavior.SingleResult);

                    // read all rows returned from the query of default_system_setting_ref
                    // read all columns from the datareader and
                    //   populate the List of C# objects with them
                    // links:
                    // docLink: http://sql2x.org/documentationLink/5c413c03-5ddc-472a-a63d-53aecc7a2573
                    while (reader.Read())
                    {
                        var data = new CrudeDefaultSystemSettingRefData();
                        data.Populate(reader);
                        dataList.Add(data);
                    }
                }

                return(dataList);
            }
        }
        // fetch all from table into new List of class instances, filtered by any column
        // links:
        //  docLink: http://sql2x.org/documentationLink/db27658d-4d23-46d7-9970-7bbaef8634b0
        public List <CrudeDefaultSystemSettingRefModel> FetchWithFilter(string defaultSystemSettingRcd, string defaultSystemSettingName, System.Guid defaultUserId, System.DateTime dateTime)
        {
            var list = new List <CrudeDefaultSystemSettingRefModel>();
            List <CrudeDefaultSystemSettingRefData> dataList = CrudeDefaultSystemSettingRefData.FetchWithFilter(defaultSystemSettingRcd, defaultSystemSettingName, defaultUserId, dateTime);

            foreach (CrudeDefaultSystemSettingRefData data in dataList)
            {
                var crudeDefaultSystemSettingRefBusinessModel = new CrudeDefaultSystemSettingRefModel();
                DataToModel(data, crudeDefaultSystemSettingRefBusinessModel);
                list.Add(crudeDefaultSystemSettingRefBusinessModel);
            }

            return(list);
        }
        // copy all rows from a List of serialized data objects in CrudeDefaultSystemSettingRefData to a List of SOAP Contracts
        // links:
        //  docLink: http://sql2x.org/documentationLink/9204c68e-93b8-4c77-af3c-3181985ff75f
        public List <CrudeDefaultSystemSettingRefContract> FetchAll()
        {
            var list = new List <CrudeDefaultSystemSettingRefContract>();
            List <CrudeDefaultSystemSettingRefData> dataList = CrudeDefaultSystemSettingRefData.FetchAll();

            foreach (CrudeDefaultSystemSettingRefData crudeDefaultSystemSettingRef in dataList)
            {
                var contract = new CrudeDefaultSystemSettingRefContract();
                DataToContract(crudeDefaultSystemSettingRef, contract);
                list.Add(contract);
            }

            return(list);
        }
        // copy all rows from a List of serialized data objects to a List of SOAP Contracts,
        //  with a limit on number of returned rows and order by columns, starting at a specific row
        // links:
        //  docLink: http://sql2x.org/documentationLink/3fe9f1b3-97b6-4f58-a0f2-adfcbd973bfc
        public List <CrudeDefaultSystemSettingRefContract> FetchAllWithLimitAndOffset(int limit, int offset)
        {
            var list = new List <CrudeDefaultSystemSettingRefContract>();
            List <CrudeDefaultSystemSettingRefData> dataList = CrudeDefaultSystemSettingRefData.FetchAllWithLimitAndOffset(limit, offset);

            foreach (CrudeDefaultSystemSettingRefData crudeDefaultSystemSettingRef in dataList)
            {
                var contract = new CrudeDefaultSystemSettingRefContract();
                DataToContract(crudeDefaultSystemSettingRef, contract);
                list.Add(contract);
            }

            return(list);
        }
        // copy all rows from a List of serialized data objects in CrudeDefaultSystemSettingRefData to a List of SOAP Contracts
        // links:
        //  docLink: http://sql2x.org/documentationLink/3d3e60c3-69e4-43d6-8bd5-14a67a6ecf58
        public List <CrudeDefaultSystemSettingRefModel> FetchAll()
        {
            var list = new List <CrudeDefaultSystemSettingRefModel>();
            List <CrudeDefaultSystemSettingRefData> dataList = CrudeDefaultSystemSettingRefData.FetchAll();

            foreach (CrudeDefaultSystemSettingRefData crudeDefaultSystemSettingRefBusiness in dataList)
            {
                var model = new CrudeDefaultSystemSettingRefModel();
                DataToModel(crudeDefaultSystemSettingRefBusiness, model);
                list.Add(model);
            }

            return(list);
        }
        // fetch all rows from table with an offset, and limit of rows
        // links:
        //  docLink: http://sql2x.org/documentationLink/a87e5c54-b47e-4031-bc3b-837b4cf9f692
        public List <CrudeDefaultSystemSettingRefModel> FetchAllWithLimitAndOffset(string limit, string offset)
        {
            var list = new List <CrudeDefaultSystemSettingRefModel>();
            List <CrudeDefaultSystemSettingRefData> dataList = CrudeDefaultSystemSettingRefData.FetchAllWithLimitAndOffset(int.Parse(limit), int.Parse(offset));

            foreach (CrudeDefaultSystemSettingRefData crudeDefaultSystemSettingRefBusiness in dataList)
            {
                var model = new CrudeDefaultSystemSettingRefModel();
                DataToModel(crudeDefaultSystemSettingRefBusiness, model);
                list.Add(model);
            }

            return(list);
        }
Example #19
0
        // fetch by Primary key into new class instance
        // links:
        //  crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
        //  docLink: http://sql2x.org/documentationLink/7a625d0a-3028-42ce-a543-72ea3673cef4
        // parameters:
        //  defaultSystemSettingRcd: primary key of table default_system_setting_ref
        public static CrudeDefaultSystemSettingRefData GetByDefaultSystemSettingRcd(string defaultSystemSettingRcd)
        {
            // create query against default_system_setting_ref
            // this will be ansi sql and parameterized
            // parameterized queries are a good way of preventing sql injection
            //   and to make sure the query plan is pre-compiled
            // links:
            // docLink: http://sql2x.org/documentationLink/72f5fc83-c460-40fe-bac9-73b7ee0c6b77
            string sql = @" select top 1 default_system_setting_rcd, default_system_setting_name, default_user_id, date_time
                            from [default_system_setting_ref]
                            where default_system_setting_rcd = @default_system_setting_rcd
                            order by default_system_setting_name";

            var ret = new CrudeDefaultSystemSettingRefData();

            // open standard connection
            // the connection is found in web.config
            // the connection is closed upon completion of the reader
            // links:
            // docLink: http://sql2x.org/documentationLink/1ecca728-0c07-4dd7-b095-d10777b25b70
            using (var conn = new SqlConnection(Conn.ConnectionString)) {
                conn.Open();

                using (var command = new SqlCommand(sql, conn)) {
                    // add primary key
                    // this primary key will be used together with the prepared ansi sql statement
                    // links:
                    // docLink: http://sql2x.org/documentationLink/1ecca728-0c07-4dd7-b095-d10777b25b70
                    command.Parameters.Add("@default_system_setting_rcd", SqlDbType.NVarChar).Value = defaultSystemSettingRcd;

                    // execute query against default_system_setting_ref
                    // if the query fails in the preprocessor of sql server
                    //   an exception will be raised
                    // links:
                    // docLink: http://sql2x.org/documentationLink/fd5c5faa-b400-4f29-b12b-9675c53a757f
                    IDataReader reader = command.ExecuteReader(CommandBehavior.SingleRow);

                    // populate serialized class if a row was found
                    if (reader.Read())
                    {
                        ret.Populate(reader);
                    }
                }
            }

            return(ret);
        }
Example #20
0
        // fetch all from table into new List of class instances, with a limit on number of returned rows and order by columns
        // links:
        //  docLink: http://sql2x.org/documentationLink/dfaa482b-059b-4f17-a9a9-4885138dbb46
        public static List <CrudeDefaultSystemSettingRefData> FetchAllWithLimit(int limit)
        {
            var dataList = new List <CrudeDefaultSystemSettingRefData>();

            // create query against default_system_setting_ref
            // this will be ansi sql and parameterized
            // parameterized queries are a good way of preventing sql injection
            //   and to make sure the query plan is pre-compiled
            // links:
            // docLink: http://sql2x.org/documentationLink/41f82773-6d37-4ebe-840c-c60e06337f45
            string sql = @" select top " + limit.ToString() + @" default_system_setting_rcd, default_system_setting_name, default_user_id, date_time
                            from [default_system_setting_ref]
                            order by default_system_setting_name";

            // open standard connection
            // the connection is found in web.config
            // the connection is closed upon completion of the reader
            // links:
            // docLink: http://sql2x.org/documentationLink/da228d98-b30e-4d79-89ae-98e813437753
            using (var conn = new SqlConnection(Conn.ConnectionString)) {
                conn.Open();

                using (var command = new SqlCommand(sql, conn)) {
                    // execute query against default_system_setting_ref
                    // if the query fails in the preprocessor of sql server
                    //   an exception will be raised
                    // links:
                    // docLink: http://sql2x.org/documentationLink/c32ad724-8a03-4b4c-b6fb-a5abfb1d707e
                    IDataReader reader = command.ExecuteReader(CommandBehavior.SingleResult);

                    // read all rows returned from the query of default_system_setting_ref
                    // read all columns from the datareader and
                    //   populate the List of C# objects with them
                    // links:
                    // docLink: http://sql2x.org/documentationLink/9ba4395d-d8a4-4427-b80f-7b828e34da7a
                    while (reader.Read())
                    {
                        var data = new CrudeDefaultSystemSettingRefData();
                        data.Populate(reader);
                        dataList.Add(data);
                    }
                }

                return(dataList);
            }
        }
Example #21
0
        // fetch all rows from table default_system_setting_ref into new List of class instances
        // links:
        //  docLink: http://sql2x.org/documentationLink/7ca0c014-527e-4a0a-bd1f-12f4d8ea4b43
        public static List <CrudeDefaultSystemSettingRefData> FetchAll()
        {
            var dataList = new List <CrudeDefaultSystemSettingRefData>();

            // create query against default_system_setting_ref
            // this will be ansi sql and parameterized
            // parameterized queries are a good way of preventing sql injection
            //   and to make sure the query plan is pre-compiled
            // links:
            // docLink: http://sql2x.org/documentationLink/72f9f1bc-447c-4327-9d26-4b0790a07ff8
            string sql = @" select default_system_setting_rcd, default_system_setting_name, default_user_id, date_time
                            from [default_system_setting_ref]
                            order by default_system_setting_name";

            // open standard connection
            // the connection is found in web.config
            // the connection is closed upon completion of the reader
            // links:
            // docLink: http://sql2x.org/documentationLink/952b3f82-bc00-4e82-9430-6bc26ff8bc4d
            using (var conn = new SqlConnection(Conn.ConnectionString)) {
                conn.Open();

                using (var command = new SqlCommand(sql, conn)) {
                    // execute query against default_system_setting_ref
                    // if the query fails in the preprocessor of sql server
                    //   an exception will be raised
                    // links:
                    // docLink: http://sql2x.org/documentationLink/ed55cc5b-d6be-4f5e-9385-ee726dfc2bf1
                    IDataReader reader = command.ExecuteReader(CommandBehavior.SingleResult);

                    // read all rows returned from the query of default_system_setting_ref
                    // read all columns from the datareader and
                    //   populate the List of C# objects with them
                    // links:
                    // docLink: http://sql2x.org/documentationLink/c1b8b800-b250-4822-a699-d93a35f4414d
                    while (reader.Read())
                    {
                        var data = new CrudeDefaultSystemSettingRefData();
                        data.Populate(reader);
                        dataList.Add(data);
                    }
                }

                return(dataList);
            }
        }
        // fetch all rows from table into new List of Contracts, filtered by any column
        // links:
        //  docLink: http://sql2x.org/documentationLink/ce01ef4a-5cd0-4e51-b211-9c0a15b791a0
        public List <CrudeDefaultSystemSettingRefContract> FetchWithFilter(string defaultSystemSettingRcd, string defaultSystemSettingName, System.Guid defaultUserId, System.DateTime dateTime)
        {
            var list = new List <CrudeDefaultSystemSettingRefContract>();
            List <CrudeDefaultSystemSettingRefData> dataList = CrudeDefaultSystemSettingRefData.FetchWithFilter(
                defaultSystemSettingRcd: defaultSystemSettingRcd,
                defaultSystemSettingName: defaultSystemSettingName,
                defaultUserId: defaultUserId,
                dateTime: dateTime
                );

            foreach (CrudeDefaultSystemSettingRefData data in dataList)
            {
                var crudeDefaultSystemSettingRefContract = new CrudeDefaultSystemSettingRefContract();
                DataToContract(data, crudeDefaultSystemSettingRefContract);
                list.Add(crudeDefaultSystemSettingRefContract);
            }

            return(list);
        }
 // get a count of rows in table
 // links:
 //  docLink: http://sql2x.org/documentationLink/39677f9e-daee-45c6-9527-da98a0d7958d
 public int FetchAllCount()
 {
     return(CrudeDefaultSystemSettingRefData.FetchAllCount());
 }
 // copy all columns from a SOAP Contract to a serialized data object
 // links:
 //  docLink: http://sql2x.org/documentationLink/10700d38-2227-4021-be12-2f4f206f5dd9
 public static void ContractToData(CrudeDefaultSystemSettingRefContract contract, CrudeDefaultSystemSettingRefData data)
 {
     data.DefaultSystemSettingRcd  = contract.DefaultSystemSettingRcd;
     data.DefaultSystemSettingName = contract.DefaultSystemSettingName;
     data.DefaultUserId            = contract.DefaultUserId;
     data.DateTime = contract.DateTime;
 }
 // fetch by Search key into current object
 // links:
 //  crud definition: https://en.wikipedia.org/wiki/Create,_read,_update_and_delete
 //  docLink: http://sql2x.org/documentationLink/87368fa6-b618-4f0c-acbb-1fc4e273bb2d
 // parameters:
 //  DefaultUserId: key of table CrudeDefaultSystemSettingRefData
 public List <CrudeDefaultSystemSettingRefModel> FetchByDefaultUserId(System.Guid defaultUserId)
 {
     return(DataListToModelList(CrudeDefaultSystemSettingRefData.FetchByDefaultUserId(defaultUserId)));
 }
 // delete row
 // links:
 //  docLink: http://sql2x.org/documentationLink/59823bf7-4ad8-4684-a48b-2abd49c607ee
 public void Delete(string defaultSystemSettingRcd)
 {
     CrudeDefaultSystemSettingRefData.Delete(defaultSystemSettingRcd);
 }
Example #27
0
        // fetch all from table into new List of class instances, filtered by any column
        // links:
        //  docLink: http://sql2x.org/documentationLink/a736bbfd-030d-492e-a86a-7a5e478eeb79
        public static List <CrudeDefaultSystemSettingRefData> FetchWithFilter(string defaultSystemSettingRcd, string defaultSystemSettingName, System.Guid defaultUserId, System.DateTime dateTime)
        {
            var dataList = new List <CrudeDefaultSystemSettingRefData>();

            // create query against default_system_setting_ref
            // this will be ansi sql and parameterized
            // parameterized queries are a good way of preventing sql injection
            //   and to make sure the query plan is pre-compiled
            // links:
            // docLink: http://sql2x.org/documentationLink/06da7a50-8760-48cd-b789-a41cac3edd13
            string sql = @" select default_system_setting_rcd, default_system_setting_name, default_user_id, date_time
                            from [default_system_setting_ref]
                            where 1 = 1";

            // open standard connection
            // the connection is found in web.config
            // the connection is closed upon completion of the reader
// links:
// docLink: http://sql2x.org/documentationLink/6ec2495f-3a49-4a94-ad59-0ce064fc8654
            using (var conn = new SqlConnection(Conn.ConnectionString)) {
                conn.Open();

                using (var command = new SqlCommand(sql, conn)) {
                    // add search column(s) if they are not null or empty
                    // this search column(s) will be used together with the prepared ansi sql statement
                    // links:
                    // docLink: http://sql2x.org/documentationLink/2193123a-3534-412b-8521-dac14bb3884d
                    if (!string.IsNullOrEmpty(defaultSystemSettingRcd))
                    {
                        sql += "  and default_system_setting_rcd like '%' + @default_system_setting_rcd + '%'";
                        command.Parameters.Add("@default_system_setting_rcd", SqlDbType.NVarChar).Value = defaultSystemSettingRcd.Replace("'", "''");
                    }
                    if (!string.IsNullOrEmpty(defaultSystemSettingName))
                    {
                        sql += "  and default_system_setting_name like '%' + @default_system_setting_name + '%'";
                        command.Parameters.Add("@default_system_setting_name", SqlDbType.NVarChar).Value = defaultSystemSettingName.Replace("'", "''");
                    }
                    if (defaultUserId != Guid.Empty)
                    {
                        sql += "  and default_user_id = @default_user_id";
                        command.Parameters.Add("@default_user_id", SqlDbType.UniqueIdentifier).Value = defaultUserId;
                    }
                    if (dateTime != DateTime.MinValue)
                    {
                        sql += "  and date_time = @date_time";
                        command.Parameters.Add("@date_time", SqlDbType.DateTime).Value = dateTime;
                    }
                    sql += " order by default_system_setting_name";

                    command.CommandText = sql;

                    // execute query against default_system_setting_ref
                    // if the query fails in the preprocessor of sql server
                    //   an exception will be raised
                    // links:
                    // docLink: http://sql2x.org/documentationLink/9f9fcbf4-4764-4b2e-8dc6-41d0366c95c9
                    IDataReader reader = command.ExecuteReader(CommandBehavior.SingleResult);

                    // read all rows returned from the query of default_system_setting_ref
                    // read all columns from the datareader and
                    //   populate the List of C# objects with them
                    // links:
                    // docLink: http://sql2x.org/documentationLink/60181c7c-4a5e-41a3-9599-4e7a0aaf0cc8
                    while (reader.Read())
                    {
                        var data = new CrudeDefaultSystemSettingRefData();
                        data.Populate(reader);
                        dataList.Add(data);
                    }
                }

                return(dataList);
            }
        }
 // fetch by Foreign key into new List of class instances
 // links:
 //  docLink: http://sql2x.org/documentationLink/a7599485-4f00-4ebf-974d-53f69c43654e
 public List <CrudeDefaultSystemSettingRefContract> FetchByDefaultUserId(System.Guid defaultUserId)
 {
     return(DataListToContractList(CrudeDefaultSystemSettingRefData.FetchByDefaultUserId(defaultUserId)));
 }