Caché Direct の使用法

VisM コントロールの 使 用 に 関 する 基 本• 新 しい CDConnect を 作 成 し、これに 接 続 するには、 接 続 文 字 列 を 1 つ 目 の 引 数 として 使 用 して、Connect() メソッドを 呼 び 出 します。• 最 後 に 開 かれた CDConnect に 接 続 するには、 空 の 文 字 列 を 1 つ 目 の 引 数 として 使 用 して、Connect() メソッドを 呼び 出 します。• 既 存 の CDConnect に 接 続 するには、 次 のいずれかを 実 行 します。– Server プロパティに 接 続 タグと 等 しい 値 を 設 定 します (Caché 2007.1 以 降 で 可 能 )。– 1 つ 目 の 引 数 として 接 続 タグを 使 用 し、SetServer() メソッドを 呼 び 出 します (Caché 2007.1 以 降 で 可 能 )。– 最 初 の 引 数 として、 接 続 タグを 使 用 して、Connect() メソッドを 呼 び 出 します。次 に 例 を 示 します。VisM1.Server="tagA"このような 操 作 の 結 果 、 元 の CDConnect が 破 棄 されることはありません。また、サーバ・チャネルが 存 在 する 場 合 、これが 影 響 を 受 けることもありません。"CDConnect の 破 棄 " で 説 明 されているとおり、CDConnect は、アクセスが 不 可 能 になるまで ( 自 動 的 に 破 棄 されたとき)、または 明 示 的 に 破 棄 されるまで 存 在 します。2.2.3 CDConnect のチャネルの 変 更既 存 の CDConnect のチャネルを 変 更 するには、 次 の 方 法 のいずれかを 使 用 します。• Server プロパティに、 接 続 文 字 列 と 同 じ 値 を 設 定 します。• 最 初 の 引 数 として、 接 続 文 字 列 を 使 用 して、SetServer() メソッドを 呼 び 出 します。どちらの 場 合 も、CDConnect により、 現 在 接 続 中 のサーバ・プロセスが 停 止 、 切 断 され、その 後 、 新 しいサーバ・プロセスが 開 始 、 接 続 されます。2.2.4 Caché からの 切 断Caché サーバから 切 断 するには、 次 の 方 法 のいずれかを 使 用 します。• Server プロパティに、 空 の 文 字 列 と 同 じ 値 を 設 定 します。• 最 初 の 引 数 として、 空 の 文 字 列 を 使 用 して、SetServer() メソッドを 呼 び 出 します。このような 操 作 の 結 果 、CDConnect が 破 棄 されることはありません。また、サーバ・チャネルが 存 在 する 場 合 、これが 影響 を 受 けることもありません。 次 のセクションで 説 明 するとおり、CDConnect は、アクセスが 不 可 能 になるまで ( 自 動 的 に破 棄 されたとき)、または 明 示 的 に 破 棄 されるまで 存 在 します。2.2.5 CDConnect の 破 棄CDConnect とそのチャネルを 破 棄 するには、DeleteConnection() メソッドを 呼 び 出 します。もちろん、このメソッドによりサーバ・プロセスも 停 止 します。 次 に 例 を 示 します。VisM1.DeleteConnection()2.2.6 方 法 の 概 要以 下 のテーブルは、Caché との 接 続 および 切 断 方 法 をまとめたものです。どんな 場 合 でも、Server プロパティを 設 定 することには、SetServer() メソッドの 呼 び 出 しと 同 じ 効 果 があります。10 Caché Direct の 使 用 法