FireDAC.Comp.Client.TFDEventAlerter.OnAlert

提供:RAD Studio API Documentation

Delphi

property OnAlert: TFDEventAlerterEvent read FOnAlert write FOnAlert;

C++

__property OnAlert;

プロパティ

種類 可視性 ソース ユニット
event published
FireDAC.Comp.Client.pas
FireDAC.Comp.Client.hpp
FireDAC.Comp.Client TFDEventAlerter

説明

このイベントは、DBMS イベントが発生した際に、発生します。 {{#multireplace:FireDAC.Comp.Client.TFDEventAlerter.OnAlert|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} は {{#multireplace:FireDAC.Comp.Client.TFDCustomEventAlerter.OnAlert|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を継承しています。以下の内容はすべて {{#multireplace:FireDAC.Comp.Client.TFDCustomEventAlerter.OnAlert|H21=!|H25=%|H28=(|H29=)|H2A=*|H2B=+|H2F=/|H3C=<|H3D==|H3E=>|H5B=[|H5D=]|H5E=^|H7C=|}} を参照しています。

このイベントは、DBMS イベントが発生した際に、発生します。

OnAlert イベント ハンドラを使用すると、FireDAC.Comp.Client.TFDCustomEventAlerter.Names プロパティで指定されている DBMS イベントの 1 つが発生した際に発生する、イベント ハンドラを指定することができます。イベント通知を受信し始めるには、Register メソッドや Active プロパティを使用して、イベントが登録されていなければなりません。イベント ハンドラは、独自のイベント アラータ スレッド内で発生(False)、もしくは、メインのアプリケーション スレッドで発生し(True)、それは、Options.Synchronize オプションによって変わります。

イベント ハンドラは、3 つの引数を受け取ります:

  • ASender--イベント アラータの参照。
  • AEventName--イベント名を指定。
  • AArgument--イベントに対する追加引数を指定。これら引数は、DBMS やアプリケーションによって変わります。引数が指定されていない場合、Null または Unassigned 値が渡されます。引数が 1 つだけ指定されている場合、それはスカラー バリアント値で、そうでなければ、それは値のバリアント配列となります。

 
 procedure TForm1.FDEventAlerter1Alert(ASender: TFDCustomEventAlerter;
   const AEventName: String; const AArgument: Variant);
 begin
   if CompareText(AEventName, 'Customers') = 0 then
     qryCustomers.Refresh
   else if CompareText(AEventName, 'Orders') = 0 then
     qryOrders.Refresh;
 end;

関連項目