Click here to Skip to main content
Click here to Skip to main content

DbHelper for DotNet 2.0 using DbProviderFactory

, 27 Feb 2008
Rate this:
Please Sign up or sign in to vote.
DbHelper comes with methods to manipulate data using the features of DbProviderFactory.

Introduction

This document covers

         
       1. Overview of DbProviderFactory [in the Background section]
       2. DBHelper class to implement DbProviderFactory concepts 
       3. Pre-requisites for DBHelper class
       4. Overview of DBHelper class

In addition, this include source codes for


       1. DBHelper class
       2. EmployeeDL [DataLayer class] with the implementation

Background

Since DotNet evolved, ADO.Net have been getting improvized by trying different approaches. To communicate with different databases ADO.Net have been providing a set of numerous data providers which can be readily accessed under the “System.Data” namespace.

For example

       SQL Server      	- System.Data.SqlClient
       Oracle		- System.Data.OracleClient
       OleDb		- System.Data. OleDb
       Odbc		- System.Data. Odbc
       etc…

In the real world scenario, there are chances of changing databases. As per the current situation, developers use to write code based on a specific data provider, say SQL. But if the database has to be changed to Oracle, the code must be rewritten to support the Oracle data provider, which is really tedious. To overcome this situation ADO.Net has come up with a generic solution by providing a new namespace under “System.Data” which is “System.Data.Common”.

Generalized versions of all data providers are available under this namespace, namely

       •	DbCommand 
       •	DbCommandBuilder 
       •	DbConnection 
       •	DbDataAdapter 
       •	DbDataReader 
       •	DbException 
       •	DbParameter 
       •	DbTransaction

Using the code

DBHelper Class

DBHelper class is created with the intension to reduce the coding effort by using the DbProvider Factory concepts. This class provides a set of methods for

	
       •	ExecuteNonQuery 
       •	ExecuteScalar
       •	ExecuteReader
       •	DataAdapter

Pre-requisites

Dot Net 2.0

Settings

The Web.config file should be having the following keys in the appSettings section.

       // Include the lines in the Web.config file with the required details with opening and closing tags
       add key="DATA.PROVIDER" value="System.Data.SqlClient"
       add key="DATA.CONNECTIONSTRING" value="data source=ServerName;initial catalog =DatabaseName; user id =UserId; pwd =Password;"

       DATA.PROVIDER		- To define the Provider.
       DATA.CONNECTIONSTRING	- To define the Connection string.

Overview of DBHelper class

Below mentioned are some of the methods available in the DBHelper class. This helps to get an overview of the working of DBHelper class and its methods.

Constructor


DBHelper()

When an DBHelper object is created, a DbProviderFactory object is created based on the data provider specified on the Web.config file.

       // Creating DbProviderFactory object based on the provider given in Web.config 
       DbProviderFactory oFactory = DbProviderFactories.GetFactory(PROVIDER);

Destructor


~DBHelper()

The DbProviderFactory object is disposed.

       // Disposing DbProviderFactory object
       oFactory = null;

Connection Related Methods


EstablishFactoryConnection()

DbConnection object is created based on the connection string specified in the Web.config file with DbProviderFactory object.

       // Creating DbConnection object based on the connection string given in Web.config 
       DbConnection oConnection = oFactory.CreateConnection();

CloseFactoryConnection()

Connection is closed and the DbConnection object gets disposed.

       // Closing the connection and disposing the DbConnection object
       oConnection.Close();
       oConnection.Dispose();

Parameter Related Methods

A structure has been created to define the parameter details like

       •	ParamName
       •	ParamValue
       •	ParamDirection

The structure provides two constructors

       // Constructors for the structure
       public Parameters(string Name, object Value, ParameterDirection Direction)
       public Parameters(string Name, object Value)

Transaction Related Methods

An enumerator has been created to define TransactionType which could be either

       •	Open	- Begin Transaction 
       •	Commit	- Commit Transaction
       •	Rollback - Rollback Transaction

TransactionHandler method handles the transaction based on the defined Transaction type.

       // Method to handle Transaction
       public void TransactionHandler(TransactionType veTransactionType)

Execute Methods

Provides a set of overloaded methods for

       // Overloaded methods avaliable for
       •	ExecuteScalar
       •	ExecuteReader
       •	ExecuteNonQuery
       •	DataAdapter

There are many overloaded methods for the above mentioned methods which are currently not mentioned here. You can get a better overview of these methods and their implementation in the example class [EmployeeDL] attached along with this document.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Shyam SS
Web Developer Infosys Technologies Limited
India India
Have 3.5 years of experience in IT industry, mostly into ASP.Net, C#, SQL Server.

Comments and Discussions

 
QuestionSqlserverCe PinmemberMember 798400229-May-12 0:54 
AnswerRe: SqlserverCe PinmemberShyam SS10-Jul-12 12:33 
QuestionGood work Pinmemberrohit kakria27-Apr-12 21:50 
GeneralMy vote of 5 Pinmemberlaopei26-May-11 22:02 
GeneralMy vote of 5 Pinmembersridharceg29-Nov-10 6:22 
GeneralHi Siam Pinmembersognant18-Feb-10 10:05 
GeneralBulk copy PinmemberSumit Thapar7-Jan-10 18:17 
GeneralParameters (SQLServer and MYSQL) Pinmemberchicodrummer22-Mar-08 20:22 
GeneralRe: Parameters (SQLServer and MYSQL) PinmemberKang Chian Gim18-Mar-11 17:07 
GeneralShyam PinmemberFabio Galante Mans9-Mar-08 14:14 
GeneralWonderful article Pinmembersujeeth.maroli25-Feb-08 14:58 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web03 | 2.8.140902.1 | Last Updated 27 Feb 2008
Article Copyright 2008 by Shyam SS
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid