add, élément de providers pour healthMonitoring (Schéma des paramètres ASP.NET)

Article
09/04/2008

Mise à jour : novembre 2007

Spécifie le nom du fournisseur et la classe qui implémente le fournisseur.

<configuration>, élément
  system.web, élément (Schéma des paramètres ASP.NET)
    healthMonitoring, élément (Schéma des paramètres ASP.NET)
      providers, élément de healthMonitoring (Schéma des paramètres ASP.NET)
        add, élément de providers pour healthMonitoring (Schéma des paramètres 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" />

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

bcc

Attribut String facultatif.

S'applique uniquement aux classes SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Définit une liste d'adresses, délimitée par des points-virgules (;), des destinataires à inclure dans la liste de copie carbone invisible (Cci).

bodyFooter

Attribut String facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider.

Spécifie le texte à inclure en bas du corps du message électronique pour le format de message simple.

Remarque :
Cet attribut ne peut pas être utilisé avec l'attribut template.

bodyHeader

Attribut String facultatif.

S'applique uniquement à l'attribut SimpleMailWebEventProvider.

Spécifie le texte à inclure en haut du corps du message électronique pour le format de message simple.

Remarque :
Cet attribut ne peut pas être utilisé avec l'attribut template.

buffer

Attribut Boolean requis.

S'applique uniquement à la classe SqlWebEventProvider.

Spécifie si le fournisseur utilise la mise en mémoire tampon ou envoie immédiatement chaque événement au destinataire.

La valeur par défaut est false.

bufferMode

Attribut String facultatif.

S'applique uniquement à l'attribut SQLWebEventProvider.

Spécifie le nom du mode de mise en mémoire tampon utilisé par le fournisseur, si le fournisseur est en mode de mise en mémoire tampon. Le nom doit référencer l'un des modes de mise en mémoire tampon existants présents dans la collection BufferModesCollection ; sinon, une exception est levée. Cet attribut doit être présent, si la mise en mémoire tampon est activée.

Attribut String facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Définit une liste d'adresses, délimitée par des points-virgules (;), des destinataires dans la liste de copie (Cc:).

commandTimeout

Attribut Int32 facultatif.

S'applique uniquement à l'attribut SQLWebEventProvider.

Spécifie le nombre de secondes avant l'expiration du délai imparti à une commande envoyée à la source de données d'appartenance. Ce délai est utilisé par le fournisseur SQL lors de la création d'objets SqlCommand. Par défaut, cet attribut n'est pas défini dans la configuration ASP.NET. Par conséquent, la valeur par défaut ADO.NET de 30 secondes est utilisée. Si cet attribut est défini, le fournisseur SQL doit utiliser la valeur du délai d'expiration configurée pour toutes les commandes SQL envoyées à la base de données. Une exception System.Configuration.Provider.ProviderException est levée, si la validation échoue.

La valeur par défaut est 30 (valeur par défaut ADO.NET).

connectionStringName

Attribut String requis.

S'applique uniquement à l'attribut SQLWebEventProvider.

Spécifie la chaîne à utiliser pour se connecter à la base de données.

detailedTemplateErrors

Attribut Boolean facultatif.

S'applique uniquement à l'attribut TemplatedMailWebEventProvider.

Spécifie si les détails de l'exception sont envoyés dans un message électronique lorsqu'une erreur se produit pendant la compilation du modèle ou au moment de l'exécution.

La valeur par défaut est false.

from

Attribut String facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Spécifie l'adresse de l'expéditeur.

Cet attribut est hérité de la section de configuration de messagerie SMTP, s'il n'est pas spécifié.

maxEventDetailLength

Attribut Int32 facultatif.

S'applique uniquement à l'attribut SQLWebEventProvider.

Spécifie la longueur maximale, en caractères, autorisée pour les détails de chaque événement, comme suit :

Si les détails de l'événement (event.ToString()) sont plus longs que la valeur de cet attribut, ils sont tronqués lorsque la longueur maxEventDetailLength est atteinte.
Si la valeur est 0, aucun détail n'est fourni pour chaque événement.
Si la valeur est Infinite, aucun contrôle de longueur maximale n'est exécuté et le texte détaillé complet est inclus.

Remarque :
Si la longueur des détails de l'événement n'est pas limitée, cet attribut constitue une vulnérabilité potentielle.

maxEventLengthForSimpleMessage

Attribut Int32 facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Spécifie la longueur maximale autorisée, en caractères, des détails de chaque événement, comme suit :

Si les détails de l'événement (event.ToString()) sont plus longs que la valeur de cet attribut, ils sont tronqués lorsque la longueur maxEventLengthForSimpleMessage est atteinte.
Si la valeur est 0, aucun détail d'événement n'est inclus dans les notifications.
Si la valeur est Infinite, aucune limite supérieure n'est définie pour la longueur des détails d'événement.

Si la taille du message n'est pas limitée, cet attribut constitue une vulnérabilité potentielle.

La valeur par défaut est 5000 caractères.

maxSizeForSimpleMessage

Attribut Int32 facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Spécifie la taille maximale, en octets, des messages de notification envoyés par le fournisseur. Si la valeur est Infinite, aucun fractionnement de message n'est exécuté en mode simple.

Cet attribut peut provoquer le rejet des messages par le système de messagerie électronique et constitue une vulnérabilité potentielle.

La valeur par défaut est 1024 Ko.

maxEventCountForTemplateMessage

Attribut Int32 facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Spécifie le nombre maximal d'événements dans chaque message de notification envoyé par le fournisseur en mode modèles. Si la valeur est Infinite, aucun fractionnement de message n'est exécuté.

Remarque :
Cet attribut peut provoquer le rejet des messages par le système de messagerie électronique et constitue une vulnérabilité potentielle.

La valeur par défaut est 100.

maxMessagesPerNotification

Attribut Int32 facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Spécifie le nombre maximal des messages entre lesquels il est possible de répartir les événements par notification. Si la valeur est Infinite, aucune limite n'est spécifiée.

Remarque :
Cet attribut peut provoquer une inondation de messages électroniques et constitue une vulnérabilité potentielle.

La valeur par défaut est 100.

name

Attribut String requis.

Spécifie le nom convivial du fournisseur.

priority

Attribut String facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Définit la priorité des messages électroniques et représente un membre de l'énumération MailPriority.

La valeur par défaut est Normal.

separator

Attribut String facultatif.

S'applique uniquement à l'attribut SimpleMailWebEventProvider.

Spécifie le texte à inclure entre chaque événement et après chaque en-tête de section pour le format de message simple.

Remarque :
Cet attribut ne peut pas être utilisé avec l'attribut template.

smtpAddresses

Attribut String requis.

S'applique uniquement à l'attribut SimpleMailWebEventProvider.

Spécifie une liste, délimitée par des virgules, des adresses de messagerie auxquelles les notifications d'événement sont envoyées. Si différents ensembles d'adresses de messagerie sont utilisés pour les événements de différents profils, il est possible de configurer plusieurs instances de fournisseur.

subjectPrefix

Attribut String facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Spécifie la chaîne qui est ajoutée à l'objet de message et permet aux messages électroniques d'avoir un objet personnalisé pour chaque instance du fournisseur.

Remarque :
Cet attribut ne peut pas être utilisé avec l'attribut template.

template

Attribut String facultatif.

S'applique uniquement à l'attribut TemplatedMailWebEventProvider.

Spécifie la page modèle fournie par l'utilisateur (.aspx) qui sert à créer le corps du message de chaque notification.

Remarque :
Cet attribut ne peut pas être utilisé avec les attributs bodyHeader, bodyFooter et separator.

Attribut String facultatif.

S'applique uniquement aux attributs SimpleMailWebEventProvider et TemplatedMailWebEventProvider.

Définit une liste, délimitée par des points-virgules, des adresses de destinataire à insérer dans la liste À.

type

Attribut String requis.

Spécifie une référence d'assembly qualifiée complète à une classe qui implémente la classe System.Configuration.Provider.ProviderBase.

Éléments enfants

Aucun

Éléments parents

Élément	Description
configuration	Spécifie l'élément racine dans chaque fichier de configuration utilisé par le Common Language Runtime et les applications .NET Framework.
system.web	Spécifie l'élément racine de la section de configuration ASP.NET.
healthMonitoring	Configure une application pour le contrôle d'état.
providers	Définit les fournisseurs de contrôle d'état chargés du traitement d'événements.

Notes

S'il existe des paires nom/valeur supplémentaires, le fournisseur doit traiter les paires nom/valeur.

Configuration par défaut

L'élément add par défaut suivant est configuré dans le fichier Web.config racine dans le .NET Framework version 2.0.

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

Exemple

L'exemple de code suivant montre comment ajouter un fournisseur.

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

Informations sur les éléments

Gestionnaire de section de configuration	System.Web.Configuration.HealthMonitoringSection
Membre de configuration	HealthMonitoringSection.Providers
Emplacements configurables	Machine.config Web.config racine Web.config au niveau de l'application
Configuration requise	Microsoft Internet Information Services (IIS) version 5.0, 5.1 ou 6.0 Microsoft .NET Framework 2.0 Microsoft Visual Studio 2005

Voir aussi

Partager via

add, élément de providers pour healthMonitoring (Schéma des paramètres ASP.NET)

Attributs et éléments

Attributs

Éléments enfants

Éléments parents

Notes

Configuration par défaut

Exemple

Informations sur les éléments

Voir aussi

Tâches

Concepts

Référence

Autres ressources

Ressources supplémentaires