OracleWebEventProvider
クラスにより、ASP.NETアプリケーションは、WebイベントをOracleデータベースに格納できます。
クラスの継承
System.Object
System.Configuration.Provider.ProviderBase
System.Web.Management.WebEventProvider
System.Web.Management.BufferedWebEventProvider
Oracle.Web.Management.OracleWebEventProvider
宣言
// C# public class OracleWebEventProvider: BufferedWebEventProvider
スレッド安全性
すべてのパブリック静的メソッドはスレッドセーフですが、インスタンス・メンバーがスレッドセーフであることは保証されません。
備考
このクラスにより、ASP.NETアプリケーションは、OracleデータベースにWebイベント情報を格納できます。
例
次に、OracleWebEventProvider
クラスをデフォルト・プロバイダとして使用するASP.NETアプリケーションのweb.config
の例を示します。この構成では、machine.config
ファイルで指定された接続文字列とデフォルト属性値を使用します。
machine.config
ファイルはイベント・マッピング、バッファ・モードおよびルールに必要な構成エントリを提供しないため、アプリケーションがこれらの構成エントリをweb.config
ファイルで提供する必要があります。次のweb.config
ファイルで例を示します。
<?xml version="1.0"?> <configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0"> <system.web> <healthmonitoring enabled="true"/> <bufferModes> <add name="Notification" maxBufferSize="1000" maxFlushSize="200" urgentFlushThreshold="500" regularFlushInterval="00:00:6" urgentFlushInterval="00:00:03" maxBufferThreads="1"/> </bufferModes> <eventMappings> <add name="CustomEvent" type="CustomEventSource.CustomEvent, CustomEventSource"/> </eventMappings> <rules> <add name="CustomRule" eventName="CustomEvent" provider="OracleWebEventProvider" minInterval="00:00:00"/> </rules> </healthMonitoring> </system.web> </configuration>
次に、OracleWebEventProvider
クラスをデフォルト・プロバイダとして使用し、接続文字列名とアプリケーション名に対するカスタマイズされた設定、アプリケーション固有の接続文字列、および前の例で説明したその他の構成を使用するASP.NETアプリケーションのweb.config
の例を示します。
<?xml version="1.0"?> <configuration xmlns= "http://schemas.microsoft.com/.NetConfiguration/v2.0"> <connectionStrings> <add name="my_webevent_app_con_string" connectionString= "User Id=scott;Password=tiger;Data Source=Oracle"/> </connectionStrings> <system.web> <!-- Enable and customize OracleWebEventProvider --> <healthMonitoring enabled="true"> <providers> <add name="CustomOracleWebEventProvider" type="Oracle.Web.Management.OracleWebEventProvider, Oracle.Web, Version=2.112.2.0, Culture=neutral, PublicKeyToken=89b483f429c47342" connectionStringName="my_webevent_app_con_string" bufferMode="CustomBufferMode"> </providers> <bufferModes> <add name="CustomBufferMode" maxBufferSize="1000" maxFlushSize="200" urgentFlushThreshold="500" regularFlushInterval="00:00:06" urgentFlushInterval="00:00:03" maxBufferThreads="1"/> </bufferModes> <eventMappings> <add name="CustomEvent" type="CustomEventSource.CustomEvent, CustomEventSource"/> </eventMappings> <rules> <add name="CustomRule" eventName="CustomEvent" provider="CustomOracleWebEventProvider" minInterval="00:00:00"/> </rules> </healthMonitoring> </system.web> </configuration>
applicationName
属性は、ASP.NETアプリケーションごとに一意の値に設定する必要があります。
要件
ネームスペース: Oracle.Web.Management
アセンブリ: Oracle.Web.dll
Oracle Providers for ASP.NETのバージョン: Oracle Providers for ASP.NET 2.0およびOracle Providers for ASP.NET 4
次の表にOracleWebEventProvider
メンバーをリストします。
OracleWebEventProvider
コンストラクタを、表7-1にリストします。
OracleWebEventProvider
静的メソッドを、表7-2にリストします。
表7-2 OracleWebEventProvider静的メソッド
静的メソッド | 説明 |
---|---|
|
|
|
|
OracleWebEventProviderパブリック・プロパティ
OracleWebEventProvider
パブリック・プロパティを、表7-3にリストします。
表7-3 OracleWebEventProviderパブリック・プロパティ
パブリック・プロパティ | 説明 |
---|---|
|
|
|
コマンドが例外で実行を終了するまでに実行可能な秒数を取得します |
|
|
|
|
|
|
OracleWebEventProviderパブリック・メソッド
OracleWebEventProvider
パブリック・メソッドを、表7-4にリストします。
表7-4 OracleWebEventProviderパブリック・メソッド
パブリック・メソッド | 説明 |
---|---|
|
ASP.NETアプリケーションの構成ファイルで指定されたプロパティ値で |
|
渡されたイベントを引数として処理します |
|
引数として渡される情報をフラッシュします |
|
すべてのリソースを解放します |
|
|
|
|
|
|
|
|
|
|
このコンストラクタでは、OracleWebEventProvider
クラスのインスタンスが作成されます。
オーバーロード・リスト:
このコンストラクタでは、OracleWebEventProvider
クラスのインスタンスが作成されます。
OracleWebEventProvider
静的メソッドを、表7-5にリストします。
OracleWebEventProvider
パブリック・プロパティを、表7-6にリストします。
表7-6 OracleWebEventProviderパブリック・プロパティ
パブリック・プロパティ | 説明 |
---|---|
|
|
|
コマンドが例外で実行を終了するまでに実行可能な秒数を取得します |
|
|
|
|
|
|
OracleWebEventProvider
パブリック・メソッドを、表7-7にリストします。
表7-7 OracleWebEventProviderパブリック・メソッド
パブリック・メソッド | 説明 |
---|---|
|
ASP.NETアプリケーションの構成ファイルで指定されたプロパティ値で |
|
渡されたイベントを引数として処理します |
|
引数として渡される情報をフラッシュします |
|
すべてのリソースを解放します |
|
|
|
|
|
|
|
|
|
|
このメソッドは、OracleWebEventProvider
インスタンスを、ASP.NETアプリケーション構成ファイル(web.config
)で指定されたプロパティ値で初期化します。
宣言
// C# public override void Initialize(string name, NameValueCollection config);
パラメータ
name
初期化するOracleWebEventProvider
インスタンスの名前。
config
OracleWebEventProvider
の構成オプションの名前と値を含むSystems.Collections.Specialized.NameValueCollection
オブジェクト。
例外
InvalidOperationException
- OracleWebEventProvider
インスタンスがすでに初期化されている場合。
ProviderException
- 次のいずれかの条件が存在します。
構成ファイル内のconnectionStringName
属性がnullまたは空です。
connectionStringName
属性の値に対応する接続文字列がnullまたは空です。
構成ファイルに認識されない属性が見つかりました。
プロバイダの初期化中に別のエラーが発生します。
備考
Initialize
メソッドは、アプリケーションによって直接呼び出されることを意図していません。
このメソッドは、引数として渡されたイベントを処理します。
宣言
// C#
public override void ProcessEvent(WebBaseEvent eventRaised);
パラメータ
eventRaised
処理するWebBaseEvent
オブジェクト。
備考
このメソッドは、イベント処理を開始するためにASP.NETアプリケーションによって呼び出されます。バッファリングが有効になっている場合は、イベントがイベントのバッファに追加され、それ以外の場合はイベント情報がOracle Databaseに直接書き込まれます。
このメソッドは、引数として渡された情報をフラッシュします。
宣言
// C#
public override void ProcessEventFlush(WebEventBufferFlushInfo flushEvent);
パラメータ
flushEvent
バッファ処理されたWebイベントのコレクションを含むWebEventBufferFlushInfo
オブジェクト。
備考
このメソッドは、すべてのイベントをOracle DatabaseにフラッシュするためにASP.NETアプリケーションによって呼び出されます。