Zen データ プロバイダーを使用すれば、.NET 対応アプリケーションやアプリケーション サーバーへのデータ アクセスが可能になります。データ プロバイダーはインターネットまたはイントラネット経由で、主要なデータ ストアへの高パフォーマンスなポイント ツー ポイント アクセスおよび n 層アクセスを提供します。データ プロバイダーは .NET 環境向けに最適化されているため、現在使用しているシステムに .NET 技術を組み込み、その機能を拡張してパフォーマンスを向上させることができます。

接続プール、ステートメント キャッシュ、セキュリティの設定、Zen Bulk Load、および診断サポートなどの高度な機能については、高度な機能を参照してください。

標準 Zen ADO.NET 環境における Zen ADO.NET データ プロバイダーの使用法については、ADO.NET データ プロバイダーを参照してください。

Zen ADO.NET Entity Framework でのデータ プロバイダーの使用法については、Zen ADO.NET Entity Framework データ プロバイダーを参照してください。

Zen データ プロバイダーはマネージ コードのみで構築されています。つまり、完全に共通言語ランタイム（CLR）の内部で、実行およびデータベースへの接続が行えます。

クライアント ライブラリや COM コンポーネントなどネイティブ オペレーティング システムで実行するコードはアンマネージ コードと言います。マネージ コードとアンマネージ コードは 1 つのアプリケーション内に混在させることができます。ただし、アンマネージ コードは共通言語ランタイムの外部にまで影響が及ぶため、現実的には複雑になり、パフォーマンスも低下します。また、セキュリティの危険にさらすことにもなりかねません。

Zen データ プロバイダーでサポートされる .NET Framework バージョンおよび Entity Framework バージョンの詳細については、サポートされる .NET Framework のバージョンを参照してください。

接続の動作は、接続文字列や PsqlConnection オブジェクトのプロパティを使って定義することができます。

しかし、接続文字列内の値の設定を接続プロパティによって変更することはできません。

接続文字列の基本形式は、セミコロンで区切られた一連の「キーワード/値」のペアを含んでいます。次に、Zen データ プロバイダー用の単純な接続文字列のキーワードと値の例を示します。

接続文字列を指定する際には、次のガイドラインを用います。

サポートされる接続文字列オプションの一覧については、接続文字列プロパティを参照してください。

Performance Wizard を使用して、Zen ADO.NET データ プロバイダーと Zen ADO.NET Entity Framework データ プロバイダーに最適な接続文字列オプションを選択することができます。

詳細については、Zen Performance Tuning Wizard の使用を参照してください。

アプリケーションでストアド プロシージャを使用できるようにするには、次の手順に従ってください。

ストアド プロシージャから戻り値を取得するには、アプリケーションで PsqlCommand オブジェクトのパラメーター コレクションにパラメーターを余分に追加する必要があります。このパラメーターの ParameterDirection プロパティを ParameterDirection.ReturnValue に設定します。戻り値の取得用のパラメーターは、パラメーター コレクションのどこにあってもかまいません。これは、このパラメーターが、PsqlCommand オブジェクトの Text プロパティにある特定のパラメーター マーカーに対応していないためです。

ストアド プロシージャからの戻り値がない場合は、ParameterDirection プロパティに ReturnValue としてバインドされているパラメーターは無視されます。

ストアド プロシージャがデータベースから ReturnValue を返しても、アプリケーションでそのパラメーターをバインドしていない場合は、データ プロバイダーによってその値が破棄されます。

Zen ADO.NET Entity Framework ユーザーへの注記：PsqlConnection オブジェクトには、拡張された統計情報機能を提供するためのプロパティおよびメソッドが含まれています。これらのメソッドおよびプロパティは、Zen ADO.NET データ プロバイダーでは標準ですが、Zen ADO.NET Entity Framework レイヤーでは利用できません。代わりに、Zen ADO.NET Entity Framework データ プロバイダーは「擬似」ストアド プロシージャを介して同様の機能を公開します。詳細については、ADO.NET Entity Framework でのストアド プロシージャの使用を参照してください。

データ プロバイダーは、IPv4 形式および IPv6 形式のインターネット プロトコル（IP）アドレスをサポートします。お使いのネットワークが名前付きサーバーをサポートしている場合は、データ ソースに指定されたサーバー名を IPv4 アドレスまたは IPv6 アドレスに解決することができます。

EnableIPV6 接続文字列オプションを True に設定すると、IPv6 プロトコルがインストールされたクライアントを、IPv4 アドレスまたは IPv6 アドレスのいずれかを使用するサーバーに接続できるようになります。IPv6 形式の詳細については、『Getting Started with Zen』の IPv6 を参照してください。

Zen データ プロバイダーは、.NET Framework 内で完全に実装されるトランザクションのサポートにはマネージ コードのみを使用します。

ローカル トランザクションは、基盤となるデータベースの内部的なトランザクション マネージャーを使用します。

アプリケーションでは、PsqlConnection オブジェクトで BeginTransaction を呼び出すことによって PsqlTransaction オブジェクトを作成します。トランザクションのコミットや中止などその後の操作は PsqlTransaction オブジェクトで実行されます。

PsqlConnection オブジェクトはスレッドセーフです。それぞれ別のスレッドでアクセスする複数の PsqlCommand オブジェクトが、同時に 1 つの接続を使用できます。

別々のスレッドでほかのパブリック オブジェクトやデータ プロバイダー固有のオブジェクトに同時にアクセスするのはスレッド セーフではありません。

データ プロバイダーは、.NET Framework SDK の規定に従って Unicode をサポートします。これは、データ プロバイダーでは Unicode UTF-16 エンコーディングで文字を表わすことを意味します。

データ プロバイダーは UTF-16 文字をデータベースで使用されている形式に変換し、.NET Framework 文字列をアプリケーションに返します。たとえば、Zen データベース コード ページが拡張 ASCII 形式である場合、データ プロバイダーは拡張 ASCII を使用してデータベースに送られた文字を表します。その後、データ プロバイダーはアプリケーションに送り戻される前に、返された拡張 ASCII 文字を変換します。

Unicode と国際的な文字の .NET Framework 実装に関する詳細については、.NET Framework SDK のドキュメントを参照してください。

Zen は ReadCommitted と Serializable 分離レベルをサポートします。レコード レベルのロックをサポートします。詳細については、ロック レベルと分離レベルを参照してください。

Zen データ プロバイダーでサポートする SQL エスケープ シーケンスの説明については、.NET の SQL エスケープ シーケンスを参照してください。

イベント ハンドラーは PsqlInfoMessageEventArgs 型の引数を受け取ります。これにはイベントに関するデータが含まれています。詳細については、PsqlInfoMessageEventArgs オブジェクトを参照してください。

このイベントは次のように定義されます。

データベース サーバーから送られる警告や情報メッセージを処理したいクライアントは、このイベントを受け取るために PsqlInfoMessageEventHandler デリゲートを作成してください。

これらのイベントを使用して、パッケージ、ストアド プロシージャ、またはストアド関数（これらはすべてコマンドを作成します）の作成時に発生するエラーを取得することができます。パッケージ、ストアド プロシージャ、またはストアド関数で作成されたコマンドをコンパイルするときに Zen でエラーが検出されると、有効ではありませんがオブジェクトが作成されます。イベントが送られ、エラー発生したことを示します。

次のコードでは、PsqlConnection オブジェクトの InfoMessage イベントを処理するメソッドを表わすデリゲートを定義しています。

ここで、sender はイベントを生成したオブジェクト、e は警告を説明する PsqlInfoMessageEventArgs オブジェクトです。イベントとデリゲートの詳細については、Microsoft .NET Framework SDK のドキュメントを参照してください。

PsqlError オブジェクトは、Zen サーバーで生成されたエラーや警告に関する情報を収集します。詳細については、PsqlError オブジェクトを参照してください。

PsqlException オブジェクトは、Zen サーバーがエラーを返したときに作成されスローされます。データ プロバイダーによって生成された例外は標準のランタイム例外として返されます。詳細については、PsqlException オブジェクトを参照してください。

データ プロバイダーでは .NET パブリック オブジェクトをサポートし、それらをシールド オブジェクト（封印されたオブジェクト）として公開します。

詳細については、サポートされる .NET オブジェクトを参照してください。

データ コンシューマー アプリケーションの開発者は、Microsoft .NET の仕様やオブジェクト指向のプログラミング技術に精通している必要があります。

Microsoft では以下のような ADO.NET に関する豊富な情報をオンラインで提供しています。