15.11.1　データベースへの接続

HiRDBに接続し，そのまま切断する例を次に示します。

Visual C# .NETで記述した例

using System;
using Hitachi.HiRDB;
 
namespace test_C
{
    class Sample
    {
        [STAThread]
        static void Main(string[] args)
        {
            try
            {
                // Connectionオブジェクトを作成する
                HiRDBConnection cn = new HiRDBConnection("dsn=pc;");  ...1
 
                // DBに接続する
                cn.Open();  .............................................2
 
                // DBから切断する
                cn.Close();  ............................................3
                cn.Dispose();
            }
            catch ( HiRDBException ex)
            {
                Console.WriteLine(ex);
            }
            catch ( System.Exception ex)
            {
                Console.WriteLine(ex);
            }  ..........................................................4
        }
    }
}

Visual Basic.NETで記述した例

Imports System
Imports System.Data
Imports Hitachi.HiRDB
 
Module Module1
 
    Sub Main()
 
        Dim cn As HiRDBConnection
        Dim cm As HiRDBCommand
        Try
            ' Connectionオブジェクトを作成する
            cn = New HiRDBConnection("dsn=pc;")  ........................1
 
            ' DBに接続する
            cn.Open()  ..................................................2
 
            ' DBから切断する
            cn.Close()  .................................................3
            cn.Dispoxe()
        Catch ex As HiRDBException
            Console.WriteLine(ex)
 
        Catch ex As System.Exception
 
            Console.WriteLine(ex)
 
        End Try  ........................................................4
 
    End Sub
 
End Module

[説明]

最初にHiRDBConnectionのオブジェクトを作成します。このオブジェクトがHiRDBとの通信をすべて管理することになります。

このメソッドには一つのstring型引数を指定する必要があります。指定する文字列は接続文字列と呼ばれるもので，これはADOやADO.NETのConnectionで使用する接続文字列と同種のものです。指定できる文字列については，「ConnectionString」を参照してください。
DBへ接続するにはOpenメソッドを使用します。
切断する場合にはCloseメソッドを使用します。接続していない状態でCloseメソッドを使用しても例外は発生しません。
サーバが起動していなかったり，通信ができなかったり，SQL文が不正だったりした場合など，例外が発生します。基本的には，HiRDBデータプロバイダ for .NET Frameworkを使用するブロックは，try〜catchで例外を検出して例外メッセージを表示させるようにします。

HiRDB全般のエラーではSystem.Exceptionが，HiRDBデータプロバイダ for .NET Framework固有のエラーではHiRDBExceptionが発生します。なお，System.ExceptionはExceptionと省略しないでください。

HiRDBデータプロバイダ for .NET Frameworkが生成する例外オブジェクトのプロパティ「ErrorCode」には，HiRDB Client Library又はHiRDBデータプロバイダ for .NET Framework固有のエラーコードが格納されます。

エラーコードが3けた(-XXX)又は4けた(-XXXX)の場合はKFPA1XXXXを示し，5けた(-24XXX)の場合はKFPZ24XXXを示します。

ページの先頭へ

15.11.1 データベースへの接続

15.11.1　データベースへの接続