healthMonitoring の providers の add 要素 (ASP.NET 設定スキーマ)
プロバイダーの名前と、プロバイダーを実装するクラスを指定します。
<!-- Default, WMIWebEventProvider and WebEventProvider syntax -->
<add
name="provider name"
type="type reference" />
<!-- SQL Implementation Provider syntax -->
<add name="SqlEventProvider"
type="System.Web.Management.SqlWebEventProvider, System.Web,
Version=1.2.3300.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a"
connectionName="string"
maxEventDetailLength="int"
commandTimeout="interval"
buffer="true|false"
bufferMode="string" />
<!-- Simple Mail Event and Templated Mail Web Event Providers syntax -->
<add name="MailEventProvider"
type="System.Web.Management.MailWebEventProvider,System.Web,
Version=%ASSEMBLY_VERSION%,Culture=neutral,PublicKeyToken=%MICROSOFT_PUBLICKEY%"
from="string"
to="string, string"
cc="string, string"
bcc="string, string"
priority="High|Normal|Low"
subjectPrefix="email subject prefix"
bodyHeader="email body header"
bodyFooter="email body footer"
separator="string"
template="string" (cannot be specified with the header/footer/separator)
maxSizeForSimpleMessage="number"
maxEventLengthForSimpleMessage="number"
maxEventCountForTemplateMessage="number"
maxMessagesPerNotification="number"
buffer="true|false"
bufferMode="string" />
属性および要素
以降のセクションでは、属性、子要素、および親要素について説明します。
属性
属性 |
説明 |
|---|---|
bcc |
省略可能な String 型の属性です。 SimpleMailWebEventProvider クラスと TemplatedMailWebEventProvider クラスにだけ適用されます。 ブラインド コピー (Bcc) リストに追加する受信者アドレスのコンマ (,) 区切りのリストを定義します。 |
bodyFooter |
省略可能な String 型の属性です。 SimpleMailWebEventProvider 属性にだけ適用されます。 単純な電子メール形式の電子メール本文の一番下に追加するテキストを指定します。 .gif "メモ") メモ
この属性は、template 属性とは併用できません。
|
bodyHeader |
省略可能な String 型の属性です。 SimpleMailWebEventProvider 属性にだけ適用されます。 単純な電子メール形式の電子メール本文の一番上に追加するテキストを指定します。 メモ
この属性は、template 属性とは併用できません。
|
buffer |
必須の Boolean 属性です。 SqlWebEventProvider クラスにだけ適用されます。 プロバイダーがバッファリングを使用するか、イベントごとにすぐに受信者に送信するかを指定します。 既定値は、false です。 |
bufferMode |
省略可能な String 型の属性です。 SQLWebEventProvider 属性にだけ適用されます。 プロバイダーがバッファー モードの場合に、プロバイダーにより使用されるバッファー モードの名前を指定します。 名前は、BufferModesCollection コレクションに存在する既存のバッファー モードのいずれかを参照している必要があります。参照していない場合は、例外がスローされます。 バッファリングが有効な場合は、この属性が存在している必要があります。 |
cc |
省略可能な String 型の属性です。 SimpleMailWebEventProvider 属性と TemplatedMailWebEventProvider 属性にだけ適用されます。 コピー (Cc:) リストに追加する受信者アドレスのセミコロン (;) 区切りのリストを定義します。 |
commandTimeout |
省略可能な Int32 型の属性です。 SQLWebEventProvider 属性にだけ適用されます。 メンバーシップ データ ソースに対して実行されたコマンドがタイムアウトするまでの時間を秒単位で指定します。 このタイムアウト値は、SQL プロバイダーが SqlCommand オブジェクトを作成するときに使用します。 既定では、この属性は ASP.NET 構成では設定されていません。 そのため、ADO.NET の既定値である 30 秒が使用されます。 この属性が設定されると、SQL プロバイダーは、データベースに対して実行されるすべての SQL コマンドについて、構成されたタイムアウト値を使用する必要があります。 検証に失敗した場合、System.Configuration.Provider.ProviderException 例外がスローされます。 既定値は 30 です (ADO.NET の既定値)。 |
connectionStringName |
必須の String 属性です。 SQLWebEventProvider 属性にだけ適用されます。 データベースへの接続に使用する文字列を指定します。 |
detailedTemplateErrors |
省略可能な Boolean 型の属性です。 TemplatedMailWebEventProvider 属性にだけ適用されます。 テンプレートのコンパイル時または実行時にエラーが発生した場合、例外の詳細を電子メール メッセージで送信するかどうかを指定します。 既定値は、false です。 |
from |
省略可能な String 型の属性です。 SimpleMailWebEventProvider 属性と TemplatedMailWebEventProvider 属性にだけ適用されます。 送信者のアドレスを指定します。 指定されない場合、この属性は SMTP メール構成セクションから継承されます。 |
maxEventDetailLength |
省略可能な Int32 型の属性です。 SQLWebEventProvider 属性にだけ適用されます。 次のようにして、各イベントに許容されるイベント詳細の長さの最大文字数を指定します。
メモ
イベント詳細の長さが制限されない場合、この属性が脆弱性となる可能性があります。
|
maxEventLengthForSimpleMessage |
省略可能な Int32 型の属性です。 SimpleMailWebEventProvider 属性と TemplatedMailWebEventProvider 属性にだけ適用されます。 次のようにして、各イベントに許容されるイベント詳細の長さの最大文字数を指定します。
メモ
メッセージ サイズが制限されない場合、この属性が脆弱性となる可能性があります。既定値は 5000 文字です。
|
maxSizeForSimpleMessage |
省略可能な Int32 型の属性です。 SimpleMailWebEventProvider 属性と TemplatedMailWebEventProvider 属性にだけ適用されます。 プロバイダーにより送信される通知メッセージの最大サイズをバイト単位で指定します。 Infinite の場合、簡易モードでのメール分割は実行されません。 メモ
この属性が原因で、電子メール システムによりメッセージが破棄される可能性があり、この属性は脆弱性となる可能性があります。既定値は、1024 KB です。
|
maxEventCountForTemplateMessage |
省略可能な Int32 型の属性です。 SimpleMailWebEventProvider 属性と TemplatedMailWebEventProvider 属性にだけ適用されます。 テンプレート モードの場合に、プロバイダーにより送信される各通知メッセージ内のイベントの最大数を指定します。 Infinite の場合、メール分割は実行されません。 メモ
この属性が原因で、電子メール システムによりメッセージが破棄される可能性があり、この属性は脆弱性となる可能性があります。
既定値は、100 です。 |
maxMessagesPerNotification |
省略可能な Int32 型の属性です。 SimpleMailWebEventProvider 属性と TemplatedMailWebEventProvider 属性にだけ適用されます。 通知ごとに分割可能なイベント間のメッセージの最大数を指定します。 Infinite の場合、制限は指定されません。 メモ
この属性が原因で電子メール フラッドが発生する可能性があり、この属性が脆弱性となる可能性があります。
既定値は、100 です。 |
name |
必須の String 属性です。 プロバイダーの表示名を指定します。 |
priority |
省略可能な String 型の属性です。 SimpleMailWebEventProvider 属性と TemplatedMailWebEventProvider 属性にだけ適用されます。 電子メール メッセージの優先順位を設定します。また、MailPriority 列挙のメンバーです。 既定値は、Normal です。 |
separator |
省略可能な String 型の属性です。 SimpleMailWebEventProvider 属性にだけ適用されます。 各イベント間と、単純な電子メール形式の各セクション ヘッダーの後に含めるテキストを指定します。 メモ
この属性は、template 属性とは併用できません。
|
smtpAddresses |
必須の String 属性です。 SimpleMailWebEventProvider 属性にだけ適用されます。 イベント通知が送信される電子メール アドレスのコンマ区切りのリストを指定します。 異なるプロファイル イベントには電子メール アドレスの異なるセットを使用する場合、プロバイダーの複数のインスタンスを構成できます。 |
subjectPrefix |
省略可能な String 型の属性です。 SimpleMailWebEventProvider 属性と TemplatedMailWebEventProvider 属性にだけ適用されます。 電子メールの件名に付加する文字列を指定し、電子メール メッセージでプロバイダーのインスタンスごとにカスタム件名を使用できるようにします。 メモ
この属性は、template 属性とは併用できません。
|
template |
省略可能な String 型の属性です。 TemplatedMailWebEventProvider 属性にだけ適用されます。 使用するユーザー指定のテンプレート ページ (.aspx) を指定し、各通知のメッセージ本文を作成します。 メモ
この属性は、bodyHeader、bodyFooter、および separator 属性とは併用できません。
|
to |
省略可能な String 型の属性です。 SimpleMailWebEventProvider 属性と TemplatedMailWebEventProvider 属性にだけ適用されます。 宛先 (To:) リストに追加する受信者アドレスのセミコロン区切りのリストを定義します。 |
type |
必須の String 属性です。 System.Configuration.Provider.ProviderBase クラスを実装するクラスへの完全修飾アセンブリ参照を指定します。 |
子要素
なし。
親要素
要素 |
説明 |
|---|---|
configuration |
共通言語ランタイムおよび .NET Framework アプリケーションで使用されるすべての構成ファイルのルート要素を指定します。 |
system.web |
ASP.NET 構成セクションのルート要素を指定します。 |
healthMonitoring |
状態の監視に対応したアプリケーションを構成します。 |
providers |
イベント処理を行う状態監視プロバイダーを定義します。 |
解説
名前と値の他のペアが存在する場合、プロバイダーはその名前と値のペアを処理する必要があります。
既定の構成
次の既定の add 要素は、.NET Framework Version 2.0 においてルートの Web.config ファイルで構成されています。
<add name="EventLogProvider" type="System.Web.Management.EventLogWebEventProvider,
System.Web,Version=2.0.0.0,Culture=neutral,
PublicKeyToken=b03f5f7f11d50a3a" />
<add ConnectionStringName="LocalSqlServer" maxEventDetailsLength="1073741823"
buffer="false" bufferMode="Notification" name="SqlWebEventProvider"
type="System.Web.Management.SqlWebEventProvider,
System.Web,Version=2.0.0.0,
Culture=neutral,PublicKeyToken=b03f5f7f11d50a3a" />
<add name="WmiWebEventProvider" type="System.Web.Management.WmiWebEventProvider,
System.Web,Version=2.0.0.0,Culture=neutral,
PublicKeyToken=b03f5f7f11d50a3a" />
使用例
プロバイダーを追加する方法のコード例を次に示します。
<providers>
<add name="WmiEventProvider"
type="System.Web.Management.WmiWebEventProvider,
System.Web,Version=1.2.3400.0,Culture=neutral,
PublicKeyToken=b03f5f7f11d50a3a"/>
<add name="SampleEventProvider"
type="Samples.AspNet.SampleEventProvider,SampleEventProvider,
Version=0.0.0.0,Culture=neutral,PublicKeyToken=92029af6cf75bd7c,
ProcessorArchitecture=Neutral"/>
</providers>
要素情報
構成セクション ハンドラー |
|
構成メンバー |
|
構成できる場所 |
Machine.config ルート レベルの Web.config アプリケーション レベルの Web.config |
要件 |
Microsoft Internet Information Services (IIS) バージョン 5.0、5.1、または 6.0 Microsoft .NET Framework 2.0 Microsoft Visual Studio 2005 |
参照
処理手順
参照
healthMonitoring 要素 (ASP.NET 設定スキーマ)
healthMonitoring の providers 要素 (ASP.NET 設定スキーマ)
healthMonitoring の providers の remove 要素 (ASP.NET 設定スキーマ)
healthMonitoring の providers の clear 要素 (ASP.NET 設定スキーマ)
概念
ASP.NET Web サーバー コントロールとブラウザーの機能