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

Artículo
05/27/2012

[Esta documentación se proporciona solo para fines preliminares y está sujeta a cambios en versiones posteriores. Se incluye temas en blanco como marcadores].

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

<!-- 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 próximas secciones se describen los atributos, los elementos secundarios y los elementos primarios.

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 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. Note 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. Note Este atributo no se puede usar con el atributo template.
buffer	El atributo Boolean es obligatorio. 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 en el origen de datos de pertenencia. 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	El atributo String es obligatorio. 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. Note 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. Note 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. Note 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. Note 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. Note Este atributo puede originar una avalancha de correos electrónicos y constituye un posible punto vulnerable. El valor predeterminado es 100.
name	El atributo String es obligatorio. 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. Note Este atributo no se puede usar con el atributo template.
smtpAddresses	El atributo String es obligatorio. 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. Note 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. Note 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	El atributo String es obligatorio. Especifica una referencia calificada con el nombre 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 que utilizan las aplicaciones basadas en Common Language Runtime y .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 eventos.

Comentarios

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

Configuración predeterminada

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

<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) versión 5.0, 5.1 ó 6.0 Microsoft .NET Framework 2.0 Microsoft Visual Studio 2005

Vea también

Share via

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

Atributos y elementos

Atributos

Elementos secundarios

Elementos primarios

Comentarios

Configuración predeterminada

Ejemplo

Información de elemento

Vea también

Tareas

Referencia

Conceptos

Otros recursos

Recursos adicionales