Create Sample Application Using Entity Objects In C#.Net

• Download EntityDemo.zip - 3.9 KB

Introduction:

I will explain the entity classes which is More superior than datasets and typed datasets.
In this article I will just explain the basics of entity Classes and how you can retrieve data using them.

DataSets:

Normally We are using Dataset for storing database values.When Compared to Entity Classes Dataset is very slow.As you all Know Dataset contains Collection of Tables its takes large memory for storing these tables.It reduces productivity. DataSets keep your data in a relational format, making them powerful and easy to use with relational databases. Unfortunately, this means you lose out on all the benefits of OOPS.

Problems With DataSets:

1.The conversion can fail because:� The value could be null� The developer might be wrong about the underlying data type (againintimate knowledge of the database schema is required). If you are using ordinal values, who knows what column is actually atposition X2. 2.ds.Tables(0) might return a null reference (if any part of the DAL method or thestored procedure failed

Entity Classes:

Entity classes provides more flexibility since they access the data using special methods defined in the class library.Take advantage of OOPS Techniques such as Inheritance and Encaptulation.

Steps For Sample:

1. Create a Customer class :

In this Customer Class is Used to get and set the Customer Details.It contains ContactTitle,ContactName,CompanyName,City Properties.

Customer Class:

  
 /// <summary>
/// Class For Setting Customer Details to Property
/// </summary>
public class Customer
{
    /// <summary>
    /// Property For Setting Customer ContactTitle
    /// </summary>
    private string contactTitle;

    public string ContactTitle
    {
        get { return contactTitle; }
        set { contactTitle = value; }
    }
    /// <summary>
    /// Property For Setting Customer ContactName
    /// </summary>
    private string contactName;

    public string ContactName
    {
        get { return contactName; }
        set { contactName = value; }
    }
    /// <summary>
    /// Property For Setting Customer CompanyName
    /// </summary>
    private string companyName;

    public string CompanyName
    {
        get { return companyName; }
        set { companyName = value; }
    }
    /// <summary>
    /// Property For Setting Customer City
    /// </summary>
    private string city;

    public string City
    {
        get { return city; }
        set { city = value; }
    }
}
 
 

2.Establish the DataBase Connection :

Establish the DataBaseConnection By Using the Below Method.Here I am Using DataReader For Reading a DataRow Values and Return the DataReader Object.For Establish a Connection I am Using Connection String.Connection String is Placed in Web.config file.Here I am Using Northwind DataBase For Getting Customer Details.

"select ContactTitle,ContactName,CompanyName,City from Customers"

3. Get Single Customers :

If you Want to Get Single Row(ie.In First Row) I am using the Following Method.Set the Datas to Datareader Object.It Returns the Method PopulateCustomer.

Please Refer attached code to GetDatasFromDataBase() method

    /// <summary>
    /// Method For Getting SingleValues Customer
    /// </summary>
    /// <returns></returns>
    public Customer GetSingleCustomer()
    {
        IDataReader dr = null;
        try
        {
            //set The Datas to Datareader
            dr=GetDatasFromDataBase();
            //Read the Single Row
            dr.Read();
        }
        catch (Exception ex)
        {
            throw ex;
        }
        return PopulateCustomer(dr);
    }
 
 

Populate Customer:

PoulateCustomer is the Method,it is used to Get the Single Values From the DataReader Object and then set into the Customer Properties likeContactTitle.ContactName,CompanyName,City.The PopulateCustomer method simply checks that if the "ContactTitle" and "ContactName" and "CompanyName" and "City" fields are not null and if its not null adds it to the Customerobject and returns the Customer object to the calling program.

For Mapping function we use IDataRecord,insted of using SqlDataReader.

    /// <summary>
    /// PopulateCustomer method which returns the Customer object.
    /// </summary>
    /// <param name="dr"></param>
    /// <returns></returns>
    public Customer PopulateCustomer(IDataRecord dr)
    {
        //Create Object For Customer Class
        Customer objCustomer = new Customer();
        //Get the single ContactTitle from DataReader
        if (dr["ContactTitle"] != DBNull.Value)
        {
            //set  the Value to Customer Property
            objCustomer.ContactTitle = (string)dr["ContactTitle"];
        }
        //Get the single ContactName from DataReader
        if (dr["ContactName"] != DBNull.Value)
        {
            //set  the Value to Customer Property
            objCustomer.ContactName = (string)dr["ContactName"];
        }
        //Get the single CompanyName from DataReader
        if (dr["CompanyName"] != DBNull.Value)
        {
            //set  the Value to Customer Property
            objCustomer.CompanyName = (string)dr["CompanyName"];
        }
        //Get the single City from DataReader
        if (dr["City"] != DBNull.Value)
        {
            //set  the Value to Customer Property
            objCustomer.City = (string)dr["City"];
        }

        return objCustomer;
    }
 
 

4. Multiple Customers :

If you Want to get Multiple Customer we need to create another one class name as CustomerCollection.Here we inherits the class CollectionBase.You can also use ArrayList or HashTables for Adding CustomerDetails.CollectionBase is the Base class for all Collections thats what we are implemented the CollectionBase Class.

Inside the CustomerCollection Class I wrote one method For getting MultipleCustomers .It returns the CustomerCollection Object.In this Method I am getting datas from DataReader
Object

CollectionBase works by storing any type of object inside private Arraylists, but exposing access to these private collections through methods that
only take a specific type

/// <summary>
/// Class For collection Of Customers
/// </summary>
public class CustomerCollection : CollectionBase
{
    /// <summary>
    /// Method For Adding Customer Values.
    /// </summary>
    /// <param name="Value"></param>
    /// <returns></returns>
    public int Add(Customer Value)
    {
        //List.Add() is from CollectionBase Class.
        return (List.Add(Value));
    }

    /// <summary>
    /// Method For Getting Multiple Values From Customer
    /// </summary>
    /// <returns></returns>
    public CustomerCollection GetMultipleCustomer()
    {
        IDataReader dr = null;
        CustomerCollection objCustomerColl;
        try
        {
            //set The Datas to Datareader
            EntityClass obj = new EntityClass();
            dr = obj.GetDatasFromDataBase();
            //Read the Multiple Rows
            objCustomerColl = new CustomerCollection();
            //Read the Values
            while (dr.Read())
            {
                //Add the values to CustomerCollection
                objCustomerColl.Add(obj.PopulateCustomer(dr));
            }
        }
        catch (Exception ex)
        {
            throw ex;
        }
        return objCustomerColl;
    }
}
 

Conclusion:

I explained the basics only. There is lot more you can do with them. Its always a good idea to use Entity Classes instead of returning datasets and data Readers from the DataAccess Layer. DataSets might work if your application is small but when your application grows in size the use of datasets will create complexity