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を示します。
-