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

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

  • Статья

Обновлен: Ноябрь 2007

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

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

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

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Этот атрибут не может использоваться с атрибутом template.

bodyHeader

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

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

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

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Этот атрибут не может использоваться с атрибутом 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 проверка на максимальную длину не производится, и включается весь текст сведений.

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Если длина сведений о событии не ограничена, этот атрибут может быть причиной уязвимости.

maxEventLengthForSimpleMessage

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

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

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

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

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

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

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Если размер сообщения неограничен, этот атрибут может быть причиной уязвимости. По умолчанию задается 5000 символов.

maxSizeForSimpleMessage

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

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

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

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Этот атрибут может вызывать отклонение сообщений системой электронной почты, и является причиной возможной уязвимости. По умолчанию используется значение 1024 КБ.

maxEventCountForTemplateMessage

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

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

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

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Этот атрибут может вызывать отклонение сообщений системой электронной почты, и является причиной возможной уязвимости.

По умолчанию используется значение 100.

maxMessagesPerNotification

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

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

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

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Этот атрибут может вызвать поток электронных сообщений, поэтому может быть причиной уязвимости.

По умолчанию используется значение 100.

name

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

Задает понятное имя поставщика.

priority

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

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

Устанавливает приоритет сообщений электронной почты, и является элементом перечисления MailPriority.

По умолчанию используется значение Normal.

separator

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

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

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

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Этот атрибут не может использоваться с атрибутом template.

smtpAddresses

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

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

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

subjectPrefix

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

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

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

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Этот атрибут не может использоваться с атрибутом template.

template

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

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

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

y6d9ss59.alert_note(ru-ru,VS.90).gifПримечание.
Этот атрибут не может использоваться с атрибутами 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 IIS версии 5.0, 5.1 или 6.0

Платформа Microsoft .NET Framework 2.0.

Microsoft Visual Studio 2005

См. также

Задачи

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

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

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

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

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

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

Сценарии конфигурации 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)

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