[ |../../index.htm#lansa/lansa048_4320.htm]
Visual LANSA フレームワーク ガイド > アドバンスド・トピック > サーバープロファイルの管理と発行 > サーバー接続の復元 > プログラムによるサーバー接続チェック
プログラムによるサーバー接続チェック
#avFrameworkManager.avCheckConnectionメソッドはフィルターおよびコマンド・ハンドラー・コードで使用できます。
このメソッドは、接続を使用する操作(検索や保存など)の直前に、コマンド・ハンドラーまたはフィルター内でサーバー接続のチェックに使用します。
このメソッドを起動するとサーバー・チェック・ファンクションがサーバー上に呼び出されるので、起動する頻度がパフォーマンスに与える影響を考慮し、さらにテストで確認することをお勧めします。例えば、100データベース行を挿入するループが反復するごとに、このメソッドを起動することをお勧めします。
メソッド: avCheckConnection
パラメータ:
名前 |
使用方法 |
クラス |
説明 |
省略値 |
|---|---|---|---|---|
Server |
入力-任意 |
アルファベット-32文字以内 |
チェックするサーバー(ユーザー・オブジェクト名/サーバーのタイプ) |
現在のサーバー |
AttemptReconnect |
入力-任意 |
ブール値 |
接続に失敗したことが検出されると、再接続を試行 |
TRUE |
IssueMessages |
入力-任意 |
ブール値 |
接続の失敗をユーザーに通知するメッセージを発行 |
TRUE |
ActionOnFail |
入力-任意 |
ブール値 |
再接続の試行が失敗したときの対応。ABORTまたはNOTIFY/RETRY
|
サーバー値(サーバー・プロパティで設定) |
OfflineOK |
入力-任意 |
ブール値 |
TRUEに設定されており、ユーザーがこのサーバーに接続したことがない(例:オフラインで作業している、またはシステムがローカル・データベースを使用するように定義されている)場合は、avCheckConnectionがOKを返します。 |
TRUE |
ReturnValue |
出力 - オプション |
アルファベット- 2 文字以内 |
通常はOK(接続中)またはER(未接続)。ただし、ファンクションIIPの接続テストのコードを記述して、他の値を返すようにすることができます。 |
|
|
例
[ |../../index.htm#lansa/lansa048_4320.htm]