Поделиться через

Элемент add для элемента providers для элемента healthMonitoring (схема параметров 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.

Определяет список адресов получателей, разделяемый запятой (,), которые нужно включить в список скрытой копии (СК).

bodyFooter

Необязательный атрибут элемента String.

Применяется только к атрибутам SimpleMailWebEventProvider.

Задает текст, который нужно включить в конец текста сообщения электронного письма в простом формате электронной почты.

ПримечаниеПримечание
Этот атрибут не может использоваться с атрибутом template.

bodyHeader

Необязательный атрибут элемента String.

Применяется только к атрибуту SimpleMailWebEventProvider.

Задает текст, который нужно включить в заголовок текста сообщения электронного письма в простом формате электронной почты.

ПримечаниеПримечание
Этот атрибут не может использоваться с атрибутом template.

buffer

Обязательный атрибут элемента Boolean.

Применяется только к классу SqlWebEventProvider.

Указывает, использует ли поставщик буферизацию или немедленно посылает каждое событие получателю.

Значение по умолчанию — false.

bufferMode

Необязательный атрибут элемента String.

Применяется только к атрибуту SQLWebEventProvider.

Задает имя режима буферизации, используемого поставщиком, если поставщик находится в режиме буферизации. Имя должно ссылаться на один из существующих режимов буферизации, присутствующих в коллекции BufferModesCollection. В противном случае вызывается исключение. Этот атрибут должен присутствовать, если буферизация включена.

cc

Необязательный атрибут элемента String.

Применяется только к атрибутам SimpleMailWebEventProvider и TemplatedMailWebEventProvider.

Определяет список адресов получателей, разделяемый точкой с запятой (;), которые должны входить в список копии (СС).

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.

Задает максимальную длину сведений о событии (в символах), разрешенную для каждого события, следующим образом.

  • Если длина сведений о событии (event.ToString()) больше этого атрибута, сведения о событии усекаются до длины maxEventDetailLength.

  • При значении 0 для всех событий сведения не поставляются.

  • При значении Infinite проверка на максимальную длину не производится, и включается весь текст сведений.

ПримечаниеПримечание
Если длина сведений о событии не ограничена, этот атрибут может быть причиной уязвимости.

maxEventLengthForSimpleMessage

Необязательный атрибут элемента Int32.

Применяется только к атрибутам SimpleMailWebEventProvider и TemplatedMailWebEventProvider.

Задает максимальную длину сведений о событии (в символах), разрешенную для каждого события, следующим образом.

  • Если длина сведений о событии (event.ToString()) больше этого атрибута, сведения о событии усекаются до длины maxEventLengthForSimpleMessage.

  • При значении 0 сведения о событии в уведомления не включаются.

  • При значении Infinite верхняя граница для длины сведений о событии не устанавливается.

ПримечаниеПримечание
Если размер сообщения неограничен, этот атрибут может быть причиной уязвимости.По умолчанию задается 5000 символов.

maxSizeForSimpleMessage

Необязательный атрибут элемента Int32.

Применяется только к атрибутам SimpleMailWebEventProvider и TemplatedMailWebEventProvider.

Задает максимальный размер сообщений уведомления (в байтах), посылаемых поставщику. При значении Infinite в простом режиме разбиения почты не производится.

ПримечаниеПримечание
Этот атрибут может вызывать отклонение сообщений системой электронной почты, и является причиной возможной уязвимости.По умолчанию используется значение 1024 КБ.

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.

Определяет список адресов получателей, разделяемый точкой с запятой (;), которые должны входить в список получателей (Кому).

type

Обязательный атрибут элемента String.

Задает полную ссылку сборки на класс, реализующий класс System.Configuration.Provider.ProviderBase.

Дочерние элементы

Отсутствует.

Родительские элементы

Элемент

Описание

configuration

Задает корневой элемент любого файла конфигурации, используемого средой CLR и приложениями платформы .NET Framework.

system.web

Задает корневой элемент для раздела конфигурации ASP.NET.

healthMonitoring

Настраивает приложение для наблюдения за состоянием системы.

providers

Определяет поставщики мониторинга работоспособности, ответственные за обработку событий.

Заметки

Если имеются дополнительные пары "имя-значение", поставщик обязан их обрабатывать.

Параметры по умолчанию

В .NET Framework версии 2.0 в корневом файле Web.config по умолчанию задан следующий элемент add.

<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>

Сведения об элементе

Обработчик раздела конфигурации

System.Web.Configuration.HealthMonitoringSection

Элемент конфигурации

HealthMonitoringSection.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

См. также

Задачи

Пошаговое руководство. Отключение параметров конфигурации ASP.NET

Ссылки

Элемент healthMonitoring (схема параметров ASP.NET)

Элемент providers для элемента healthMonitoring (схема параметров ASP.NET)

Элемент remove для элемента providers для элемента healthMonitoring (схема параметров ASP.NET)

Элемент clear для элемента providers для элемента healthMonitoring (схема параметров ASP.NET)

WmiWebEventProvider

WebEventProvider

SimpleMailWebEventProvider

TemplatedMailWebEventProvider

SqlWebEventProvider

System.Configuration

System.Web.Configuration

System.Web.Management

Основные понятия

Общие сведения о мониторинге работоспособности системы ASP.NET

Общие сведения о конфигурационном ASP.NET

Серверные веб-элементы управления ASP.NET и возможности обозревателей

Настройка обеспечения безопасности ASP.NET

Сценарии конфигурации ASP.NET

Другие ресурсы

Файлы конфигурации ASP.NET

Параметры конфигурации ASP.NET

Общие параметры конфигурации (ASP.NET)

Конфигурационный API-интерфейс настройки ASP.NET