Compartir a través de

Elemento add aplicado a providers para healthMonitoring (Esquema de configuración de ASP.NET)

  • Artículo

Actualización: noviembre 2007

Especifica el nombre del proveedor y la clase que lo implementa.

Elemento <configuration>
  Elemento system.web (Esquema de configuración de ASP.NET)
    Elemento healthMonitoring (esquema de configuración de ASP.NET)
      Elemento providers para healthMonitoring (Esquema de configuración de ASP.NET)
        Elemento add aplicado a providers para healthMonitoring (Esquema de configuración de 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" />

Atributos y elementos

En las siguientes secciones se describen los atributos, elementos secundarios y elementos principales.

Atributos

Atributo

Descripción

bcc

Atributo String opcional.

Se aplica sólo a las clases SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Define una lista de direcciones de destinatarios separadas por punto y coma (;) que se van a incluir en la lista de copias ocultas (CCO).

bodyFooter

Atributo String opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider.

Especifica el texto que se va a incluir en la parte inferior del cuerpo del correo electrónico con formato de correo electrónico simple.

Nota

Este atributo no se puede usar con el atributo template.

bodyHeader

Atributo String opcional.

Se aplica sólo al atributo SimpleMailWebEventProvider.

Especifica el texto que se va a incluir en la parte superior del cuerpo del correo electrónico con formato de correo electrónico simple.

Nota

Este atributo no se puede usar con el atributo template.

buffer

Atributo Boolean requerido.

Se aplica sólo a la clase SqlWebEventProvider.

Especifica si el proveedor utiliza el almacenamiento en búfer o envía inmediatamente cada evento al destinatario.

El valor predeterminado es false.

bufferMode

Atributo String opcional.

Se aplica sólo al atributo SQLWebEventProvider.

Especifica el nombre del modo de almacenamiento en búfer que utiliza el proveedor si éste se encuentra en modo de búfer. El nombre debe hacer referencia a uno de los modos de almacenamiento en búfer existentes que hay en la colección BufferModesCollection; en caso contrario, se genera una excepción. Este atributo debe estar presente si está activado el almacenamiento en búfer.

cc

Atributo String opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Define una lista de direcciones de destinatarios separadas por punto y coma (;) que se van a incluir en la lista de copias (CC:).

commandTimeout

Atributo Int32 opcional.

Se aplica sólo al atributo SQLWebEventProvider.

Especifica el número de segundos que deben transcurrir antes de que se agote el tiempo de espera de un comando emitido al origen de datos de suscripción. El proveedor SQL utiliza este tiempo de espera al crear objetos SqlCommand. De manera predeterminada, este atributo no se establece en la configuración de ASP.NET. Por ello, se utiliza el valor predeterminado de ADO.NET de 30 segundos. Si se establece este atributo, el proveedor SQL tiene que utilizar el valor de tiempo de espera configurado para todos los comandos SQL emitidos a la base de datos. Si se produce un error de validación, se genera una excepción System.Configuration.Provider.ProviderException.

El valor predeterminado es 30 (valor predeterminado de ADO.NET).

connectionStringName

Atributo String necesario.

Se aplica sólo al atributo SQLWebEventProvider.

Especifica la cadena que se va a utilizar para conectarse a la base de datos.

detailedTemplateErrors

Atributo Boolean opcional.

Se aplica sólo al atributo TemplatedMailWebEventProvider.

Especifica si se envía información detallada de la excepción a través de un mensaje de correo electrónico cuando se produce un error durante la compilación de la plantilla o en tiempo de ejecución.

El valor predeterminado es false.

from

Atributo String opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Especifica la dirección del remitente.

Este atributo se hereda de la sección de configuración de correo SMTP si no se ha especificado.

maxEventDetailLength

Atributo Int32 opcional.

Se aplica sólo al atributo SQLWebEventProvider.

Especifica la longitud máxima, en caracteres, de la información detallada que se permite para cada evento:

  • Si la información detallada del evento (event.ToString()) es mayor que este atributo, se trunca en la longitud maxEventDetailLength.

  • Si su valor es 0, no se proporciona información detallada de los eventos.

  • Si su valor es Infinite, no se comprueba la longitud máxima y se incluye el texto completo de la información detallada.

Nota

Si no está limitada la longitud de la información detallada de los eventos, este atributo puede constituir un punto vulnerable.

maxEventLengthForSimpleMessage

Atributo Int32 opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Especifica la longitud máxima, en caracteres, de la información detallada que se permite para cada evento:

  • Si la información detallada del evento (event.ToString()) es mayor que este atributo, se trunca en la longitud maxEventLengthForSimpleMessage.

  • Si su valor es 0, no se incluye información detallada de los eventos en las notificaciones.

  • Si su valor es Infinite, no se establece ningún límite superior para la longitud de la información detallada de los eventos.

Nota

Si no está limitado el tamaño de los mensajes, este atributo puede constituir un punto vulnerable.

El valor predeterminado es 5000 caracteres.

maxSizeForSimpleMessage

Atributo Int32 opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Especifica el tamaño máximo, en bytes, de los mensajes de notificación que envía el proveedor. Si su valor es Infinite, no se dividen los correos en modo simple.

Nota

Este atributo puede hacer que el sistema de correo electrónico descarte mensajes y constituye un posible punto vulnerable.

El valor predeterminado es 1024 KB.

maxEventCountForTemplateMessage

Atributo Int32 opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Especifica el número máximo de eventos en cada mensaje de notificación que envía el proveedor cuando está en modo de plantilla. Si su valor es Infinite, no se dividen los correos.

Nota

Este atributo puede hacer que el sistema de correo electrónico descarte mensajes y constituye un posible punto vulnerable.

El valor predeterminado es 100.

maxMessagesPerNotification

Atributo Int32 opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Especifica el número máximo de mensajes en los que se pueden dividir los eventos por notificación. Si su valor es Infinite, no hay ningún límite especificado.

Nota

Este atributo puede originar una avalancha de correos electrónicos y constituye un posible punto vulnerable.

El valor predeterminado es 100.

name

Atributo String necesario.

Especifica el nombre descriptivo del proveedor.

priority

Atributo String opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Establece la prioridad de los mensajes de correo electrónico y es un miembro de la enumeración MailPriority.

El valor predeterminado es Normal.

separator

Atributo String opcional.

Se aplica sólo al atributo SimpleMailWebEventProvider.

Especifica el texto que se va a incluir entre cada evento y después de cada encabezado de sección en el formato de correo electrónico simple.

Nota

Este atributo no se puede usar con el atributo template.

smtpAddresses

Atributo String necesario.

Se aplica sólo al atributo SimpleMailWebEventProvider.

Especifica una lista de direcciones de correo electrónico separadas por comas a las que se envían notificaciones de eventos. Si se van a utilizar diferentes conjuntos de direcciones de correo electrónico para distintos eventos de perfil, se pueden configurar varias instancias del proveedor.

subjectPrefix

Atributo String opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Especifica la cadena que precede al asunto del correo electrónico y permite que los mensajes de correo electrónico tengan un asunto personalizado para cada instancia del proveedor.

Nota

Este atributo no se puede usar con el atributo template.

template

Atributo String opcional.

Se aplica sólo al atributo TemplatedMailWebEventProvider.

Especifica la página de plantillas (.aspx) proporcionada por el proveedor que se va a utilizar para crear el cuerpo del mensaje de cada notificación.

Nota

Este atributo no se puede usar con los atributos bodyHeader, bodyFooter y separator.

to

Atributo String opcional.

Se aplica sólo a los atributos SimpleMailWebEventProvider y TemplatedMailWebEventProvider.

Define una lista de direcciones de destinatarios separadas por punto y coma (;) que se van a incluir en la lista de destinatarios (Para:).

type

Atributo String necesario.

Especifica una referencia completa de ensamblado a una clase que implementa la clase System.Configuration.Provider.ProviderBase.

Elementos secundarios

Ninguno.

Elementos primarios

Elemento

Descripción

configuration

Especifica el elemento raíz de cada archivo de configuración utilizado por Common Language Runtime y las aplicaciones de .NET Framework.

system.web

Especifica el elemento raíz de la sección de configuración de ASP.NET.

healthMonitoring

Configura una aplicación para supervisión de estado.

providers

Define los proveedores de supervisión de estado responsables del procesamiento de los eventos.

Comentarios

Si hay más pares de nombre y valor, el proveedor deberá procesarlos.

Configuración predeterminada

En la versión 2.0 de .NET Framework, el siguiente elemento add predeterminado se configura en el archivo Web.config raíz.

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

Ejemplo

En el siguiente ejemplo de código se muestra cómo se agrega un proveedor.

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

Información de elemento

Controlador de la sección de configuración

System.Web.Configuration.HealthMonitoringSection

Miembro de configuración

HealthMonitoringSection.Providers

Ubicaciones configurables

Machine.config

Web.config del nivel raíz

Web.config del nivel de aplicaciones

Requisitos

Microsoft Internet Information Services (IIS) 5.0, 5.1 ó 6.0

Microsoft .NET Framework 2.0

Microsoft Visual Studio 2005

Vea también

Tareas

Cómo: Bloquear los valores de configuración de ASP.NET

Conceptos

Información general sobre la supervisión de estado en ASP.NET

Información general sobre la configuración de ASP.NET

Controles de servidor Web ASP.NET y funciones del explorador

Proteger la configuración de ASP.NET

Escenarios de configuración de ASP.NET

Referencia

Elemento healthMonitoring (esquema de configuración de ASP.NET)

Elemento providers para healthMonitoring (Esquema de configuración de ASP.NET)

Elemento remove que se aplica a los proveedores para la supervisión de estado (Esquema de configuración de ASP.NET)

Elemento clear que se aplica a los proveedores para la supervisión de estado (Esquema de configuración de ASP.NET)

WmiWebEventProvider

WebEventProvider

SimpleMailWebEventProvider

TemplatedMailWebEventProvider

SqlWebEventProvider

System.Configuration

System.Web.Configuration

System.Web.Management

Otros recursos

Archivos de configuración de ASP.NET

Opciones de configuración de ASP.NET

Opciones de configuración generales (ASP.NET)

API de configuración de ASP.NET