healthMonitoring 提供者的 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 屬性 (Attribute)。 指定要包含在簡單電子郵件格式中電子郵件本文頂端的文字。 注意事項
這個屬性不能與 template 屬性一起使用。
|
buffer |
必要的 Boolean 屬性。 只適用於 SqlWebEventProvider 類別。 指定提供者是否使用緩衝處理或是立即將每個事件傳送至收件者。 預設值為 false。 |
bufferMode |
選擇性 String 屬性。 僅套用至 SQLWebEventProvider 屬性 (Attribute)。 指定提供者處於緩衝模式時使用之緩衝模式的名稱。 名稱必須參考存在於 BufferModesCollection 集合中的某個現有緩衝模式，否則便會擲回例外狀況。 如果緩衝啟用，則這個屬性必須存在。 |
cc |
選擇性 String 屬性。 僅套用至 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 屬性 (Attribute)。 定義分號 (;) 分隔的收件者地址清單，這些地址會放到副本 (cc:) 清單中。 |
commandTimeout |
選擇性 Int32 屬性。 僅套用至 SQLWebEventProvider 屬性 (Attribute)。 指定發送至成員資格資料來源的命令逾時前經過的秒數。 SQL 提供者在建立 SqlCommand 物件時會使用這項逾時。 根據預設，ASP.NET 組態中不會設定這項屬性 (Attribute)。 因此會使用 ADO.NET 預設的 30 秒。 如果設定這個屬性，對於所有發出至資料庫的 SQL 命令，SQL 提供者都必須使用設定的逾時值。 如果驗證失敗，則會擲回 System.Configuration.Provider.ProviderException 例外狀況。 預設為 30 (ADO.NET 預設)。 |
connectionStringName |
必要的 String 屬性。 僅套用至 SQLWebEventProvider 屬性 (Attribute)。 指定用來連接資料庫的字串。 |
detailedTemplateErrors |
選擇性 Boolean 屬性。 僅套用至 TemplatedMailWebEventProvider 屬性 (Attribute)。 指定在範本編譯或執行階段期間發生錯誤時，是否以電子郵件訊息傳送例外狀況詳細資料。 預設值為 false。 |
from |
選擇性 String 屬性。 僅套用至 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 屬性 (Attribute)。 指定寄件人的地址。 如果未指定這個屬性，則會繼承自 SMTP 郵件組態區段。 |
maxEventDetailLength |
選擇性 Int32 屬性。 僅套用至 SQLWebEventProvider 屬性 (Attribute)。 指定每個事件所允許的事件詳細資料最大長度 (字元數)，如下列所示：
注意事項
如果未限制事件詳細資料長度，則這個屬性會是潛在的弱點。
|
maxEventLengthForSimpleMessage |
選擇性 Int32 屬性。 僅套用至 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 屬性 (Attribute)。 指定每個事件所允許的事件詳細資料最大長度 (字元數)，如下列所示：
注意事項
如果未限制訊息大小，則這個屬性會是潛在的弱點。預設值為 5000 字元。
|
maxSizeForSimpleMessage |
選擇性 Int32 屬性。 僅套用至 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 屬性 (Attribute)。 指定提供者所傳送之告知訊息的最大大小 (位元組數)。 如果為 Infinite，則在簡單模式中不會執行郵件分割。 注意事項
這個屬性能導致電子郵件系統捨棄訊息，並且成為潛在的弱點。預設值為 1024 KB。
|
maxEventCountForTemplateMessage |
選擇性 Int32 屬性。 僅套用至 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 屬性 (Attribute)。 指定提供者在範本模式中傳送的每個告知訊息中事件的最大數目。 如果為 Infinite，則不會執行郵件分割。 注意事項
這個屬性能導致電子郵件系統捨棄訊息，並且成為潛在的弱點。
預設值為 100。 |
maxMessagesPerNotification |
選擇性 Int32 屬性。 僅套用至 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 屬性 (Attribute)。 指定每個告知中可以分割事件的訊息最大數目。 如果為 Infinite，則不指定限制。 注意事項
這個屬性可以導致電子郵件氾濫，並且是潛在的弱點。
預設值為 100。 |
name |
必要的 String 屬性。 指定提供者的易記名稱。 |
priority |
選擇性 String 屬性。 僅套用至 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 屬性 (Attribute)。 設定電子郵件訊息的優先權，此屬性為 MailPriority 列舉型別的成員。 預設值為 Normal。 |
separator |
選擇性 String 屬性。 僅套用至 SimpleMailWebEventProvider 屬性 (Attribute)。 指定在簡單電子郵件格式中，每個事件之間以及每個區段標頭之後要包含的文字。 注意事項
這個屬性不能與 template 屬性一起使用。
|
smtpAddresses |
必要的 String 屬性。 僅套用至 SimpleMailWebEventProvider 屬性 (Attribute)。 指定逗號分隔的電子郵件地址清單，事件告知會傳送至這些地址。 如果對於不同的設定檔事件，要使用不同組的電子郵件地址，則可以設定多個提供者的執行個體。 |
subjectPrefix |
選擇性 String 屬性。 僅套用至 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 屬性 (Attribute)。 指定字串，此字串會加到電子郵件主旨之前，讓提供者的每個執行個體具有電子郵件訊息的自訂主旨。 注意事項
這個屬性不能與 template 屬性一起使用。
|
template |
選擇性 String 屬性。 僅套用至 TemplatedMailWebEventProvider 屬性 (Attribute)。 指定使用者提供的範本頁面 (.aspx)，此頁面會用來建立每個告知的訊息本文。 注意事項
這個屬性不能與 bodyHeader、bodyFooter 和 separator 屬性一起使用。
|
to |
選擇性 String 屬性。 僅套用至 SimpleMailWebEventProvider 和 TemplatedMailWebEventProvider 屬性 (Attribute)。 定義分號分隔的收件者地址清單，這些地址會放到收件人 (to:) 清單。 |
type |
必要的 String 屬性。 指定實作 System.Configuration.Provider.ProviderBase 類別之類別的完整組件參考。 |
子項目
無。
父項目
項目 |
描述 |
|---|---|
configuration |
指定 Common Language Runtime 和 .NET Framework 應用程式所使用之每個組態檔中的根項目 (Root Element)。 |
system.web |
指定 ASP.NET 組態區段的根項目。 |
healthMonitoring |
設定健康監視的應用程式。 |
providers |
定義負責處理事件的健康監視提供者。 |
備註
如果有額外的名稱/值組，則提供者必須處理這些名稱/值組。
預設的組態
下列預設 add 項目是在 .NET Framework 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 設定結構描述)