DB2Connection Class

In This Topic

Represents an open connection to DB2.

Syntax

Visual Basic
C#

'Declaration
 
Public Class DB2Connection 
   Inherits Devart.Common.DbConnectionBase
   Implements System.ComponentModel.IComponent, System.Data.IDbConnection, System.ICloneable, System.IDisposable

public class DB2Connection : Devart.Common.DbConnectionBase, System.ComponentModel.IComponent, System.Data.IDbConnection, System.ICloneable, System.IDisposable

Remarks

A DB2Connection object represents a unique connection to DB2. Use it in conjunction with DB2Command, DB2DataReader, DB2DataAdapter or other components for convenient interoperation with DB2.

When you create an instance of DB2Connection, all properties are set to their initial values. For a list of these values, see ConnectionString.

If the DB2Connection goes out of scope, it is not closed. Therefore, you must explicitly close the connection by calling Close.

Note that DB2Connection instance is not guaranteed to be thread safe. You should avoid using the same DB2Connection in several threads at the same time. It is recommended to open a new connection per thread and to close it when the work is done. Actually, connections will not be created/disposed every time with the Pooling=true; connection string option - connections will be stored at connection pool. This boosts performance greatly.

A single DB2Connection can be used by many DB2Command objects on the assumption that all operations will be done consecutively. In other words, you can not execute a SQL statement while an asynchronous operation is in progress.

This class supports cross-form data binding with the InterForm Technology.

Example

The following example creates a DB2Command and a DB2Connection. The DB2Connection is opened and set as the Connection property. The example then calls ExecuteNonQuery method, and closes the connection. To accomplish this, the ExecuteNonQuery is passed a connection string and a query string that is SQL INSERT statement.

csharp

public void InsertRow(string db2ConnectionString)
{
  // If the connection string is empty, use default.
  if(db2ConnectionString == "")
  {
    db2ConnectionString = 
        "user id=db2admin;server=db2;database=SAMPLE;";
  }
  DB2Connection myConn = new DB2Connection(db2ConnectionString);
  string myInsertQuery = "INSERT INTO DEPT VALUES (50,'Development','Philadelphia')";
  DB2Command db2Command = new DB2Command(myInsertQuery);
  db2Command.Connection = myConn;
  myConn.Open();
  try
  {
    db2Command.ExecuteNonQuery();
  }
  finally
  {
    myConn.Close();
  }
}

Visual Basic

Public Sub InsertRow(db2ConnectionString As String)
  ' If the connection string is empty, use default.
  If db2ConnectionString = "" Then
    db2ConnectionString = _
        "user id=db2admin;server=db2;database=SAMPLE;"
  End If
  Dim myConn As New DB2Connection(db2ConnectionString)
  Dim myInsertQuery As String = "INSERT INTO DEPT VALUES (50,'Development','Philadelphia')"
  Dim db2Command As New DB2Command(myInsertQuery)
  db2Command.Connection = myConn
  myConn.Open()
  Try
    db2Command.ExecuteNonQuery()
  Finally
    myConn.Close()
  End Try
End Sub

Inheritance Hierarchy

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Data.Common.DbConnection
            Devart.Common.DbConnectionBase
               Devart.Data.DB2.DB2Connection

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

DB2Connection Members
Devart.Data.DB2 Namespace
DB2DataAdapter Class
DB2Command Class

Send Feedback