Elemento add per providers per healthMonitoring (schema delle impostazioni ASP.NET)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Specifica il nome del provider e la classe che lo implementa.

Elemento <Configuration>
  Elemento system.web (schema delle impostazioni ASP.NET)
    Elemento healthMonitoring (schema delle impostazioni ASP.NET)
      Elemento providers per healthMonitoring (schema delle impostazioni ASP.NET)
        Elemento add per providers per healthMonitoring (schema delle impostazioni 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" />

Attributi ed elementi

Nelle sezioni riportate di seguito vengono illustrati attributi, elementi figlio ed elementi padre.

Attributi

Attributo	Descrizione
bcc	Attributo String facoltativo. È applicabile solo alle classi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Definisce un elenco di indirizzi di destinatari, separati dal segno di punto e virgola (;), da includere nell'elenco dei destinatari in copia nascosta (Ccn).
bodyFooter	Attributo String facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider. Specifica il testo da includere nella parte inferiore del corpo del messaggio di posta elettronica di formato semplice. Nota Non è possibile utilizzare questo attributo in combinazione con l'attributo template.
bodyHeader	Attributo String facoltativo. È applicabile solo all'attributo SimpleMailWebEventProvider. Specifica il testo da includere nella parte superiore del corpo del messaggio di posta elettronica di formato semplice. Nota Non è possibile utilizzare questo attributo in combinazione con l'attributo template.
buffer	Attributo Boolean obbligatorio. È applicabile solo alla classe SqlWebEventProvider. Specifica se il provider utilizza la funzione di memorizzazione nel buffer o invia immediatamente ciascun evento al destinatario. Il valore predefinito è false.
bufferMode	Attributo String facoltativo. È applicabile solo all'attributo SQLWebEventProvider. Specifica il nome della modalità di memorizzazione nel buffer utilizzata dal provider, se il provider si trova nella modalità di inserimento nel buffer. Il nome deve fare riferimento a una delle modalità di memorizzazione nel buffer esistenti nell'insieme BufferModesCollection. In caso contrario, viene generata un'eccezione. Questo attributo deve essere presente, se il buffer è attivato.
cc	Attributo String facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Definisce un elenco di indirizzi di destinatari, separati dal segno di punto e virgola (;), da includere nell'elenco dei destinatari in copia (Cc).
commandTimeout	Attributo Int32 facoltativo. È applicabile solo all'attributo SQLWebEventProvider. Specifica il numero di secondi che trascorrono prima del timeout di un comando rilasciato all'origine dati relativi all'appartenenza. Questo valore di timeout viene utilizzato dal provider SQL durante la creazione di oggetti SqlCommand. Per impostazione predefinita, l'attributo non viene impostato nella configurazione ASP.NET. Viene, pertanto, utilizzato il valore ADO.NET predefinito di 30 secondi. Se questo attributo è impostato, il provider SQL dovrà utilizzare il valore di timeout configurato per tutti i comandi SQL inviati al database. Se la convalida non riesce, viene generata un'eccezione System.Configuration.Provider.ProviderException. Il valore predefinito è 30 (il valore ADO.NET predefinito).
connectionStringName	Attributo String obbligatorio. È applicabile solo all'attributo SQLWebEventProvider. Specifica la stringa da utilizzare per la connessione al database.
detailedTemplateErrors	Attributo Boolean facoltativo. È applicabile solo all'attributo TemplatedMailWebEventProvider. Specifica se vengono inviati dettagli relativi all'eccezione in un messaggio di posta elettronica quando si verifica un errore durante la compilazione di modelli o in fase di esecuzione. Il valore predefinito è false.
from	Attributo String facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Specifica l'indirizzo del mittente. Se non viene specificato, questo attributo viene ereditato dalla sezione di configurazione della posta elettronica SMTP.
maxEventDetailLength	Attributo Int32 facoltativo. È applicabile solo all'attributo SQLWebEventProvider. Specifica la lunghezza massima, in caratteri, dei dettagli evento consentita per ciascun evento, come descritto di seguito. Se la lunghezza dei dettagli evento (event.ToString()) è maggiore rispetto a questo attributo, i dettagli evento vengono troncati in corrispondenza della lunghezza maxEventDetailLength. Se l'impostazione è 0, non vengono forniti dettagli per ciascun evento. Se l'impostazione è Infinite, non verrà eseguito alcun controllo di lunghezza e verrà inserito il testo completo dei dettagli. Nota Se la lunghezza dei dettagli evento non è limitata, questo attributo costituisce un elemento di potenziale vulnerabilità.
maxEventLengthForSimpleMessage	Attributo Int32 facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Specifica la lunghezza massima, in caratteri, dei dettagli evento consentita per ciascun evento, come descritto di seguito. Se la lunghezza dei dettagli evento (event.ToString()) è maggiore rispetto a questo attributo, i dettagli evento vengono troncati in corrispondenza della lunghezza maxEventLengthForSimpleMessage. Se l'impostazione è 0, nelle notifiche non verranno inclusi dettagli evento. Se l'impostazione è Infinite, non verrà impostato un limite superiore per la lunghezza dei dettagli evento. Nota Se la dimensione del messaggio non è limitata, questo attributo costituisce un elemento di potenziale vulnerabilità. Il valore predefinito è 5000 caratteri.
maxSizeForSimpleMessage	Attributo Int32 facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Specifica la dimensione massima, espressa in byte, dei messaggi di notifica inviati dal provider. Se l'impostazione è Infinite, non verrà eseguita la suddivisione nella posta in modalità semplice. Nota Questo attributo può determinare l'eliminazione dei messaggi dal sistema di posta elettronica e costituisce un elemento di potenziale vulnerabilità. Il valore predefinito è 1024 KB.
maxEventCountForTemplateMessage	Attributo Int32 facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Specifica il numero massimo di eventi in ciascun messaggio di notifica inviato dal provider in modalità basata su modelli. Se l'impostazione è Infinite, non verrà eseguita alcuna suddivisione nella posta. Nota Questo attributo può determinare l'eliminazione dei messaggi dal sistema di posta elettronica e costituisce un elemento di potenziale vulnerabilità. Il valore predefinito è 100.
maxMessagesPerNotification	Attributo Int32 facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Specifica il numero massimo di messaggi tra cui è possibile che gli eventi vengano suddivisi per notifica. Se l'impostazione è Infinite, non viene specificato alcun limite. Nota Questo attributo può determinare un sovraccarico nella posta elettronica e costituisce un elemento di potenziale vulnerabilità. Il valore predefinito è 100.
name	Attributo String obbligatorio. Specifica il nome descrittivo del provider.
priority	Attributo String facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Imposta la priorità dei messaggi di posta elettronica ed è membro dell'enumerazione MailPriority. L'impostazione predefinita è Normal.
separator	Attributo String facoltativo. È applicabile solo all'attributo SimpleMailWebEventProvider. Specifica il testo da includere tra ciascun evento e dopo ogni intestazione di sezione nel formato di posta elettronica semplice. Nota Non è possibile utilizzare questo attributo in combinazione con l'attributo template.
smtpAddresses	Attributo String obbligatorio. È applicabile solo all'attributo SimpleMailWebEventProvider. Specifica un elenco di indirizzi di posta elettronica separati da virgole a cui vengono inviate le notifiche di eventi. Se vengono utilizzati gruppi differenti di indirizzi di posta elettronica per eventi di profili diversi, è possibile configurare più istanze del provider.
subjectPrefix	Attributo String facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Specifica la stringa che viene anteposta all'oggetto dei messaggi di posta e consente la presenza di un oggetto personalizzato nei messaggi per ciascuna istanza del provider. Nota Non è possibile utilizzare questo attributo in combinazione con l'attributo template.
template	Attributo String facoltativo. È applicabile solo all'attributo TemplatedMailWebEventProvider. Specifica la pagina modello fornita dall'utente (aspx) da utilizzare per la creazione del corpo del messaggio per ciascuna notifica. Nota Non è possibile utilizzare questo attributo in combinazione con gli attributi bodyHeader, bodyFooter e separator.
to	Attributo String facoltativo. È applicabile solo agli attributi SimpleMailWebEventProvider e TemplatedMailWebEventProvider. Definisce un elenco di indirizzi di destinatari, separati da virgole, che verranno inseriti nell'elenco A:.
type	Attributo String obbligatorio. Specifica un riferimento a un assembly completo per una classe che implementa la classe System.Configuration.Provider.ProviderBase.

Elementi figlio

Nessuno.

Elementi padre

Elemento	Descrizione
configuration	Specifica l'elemento di primo livello in ciascun file di configurazione utilizzato in Common Language Runtime e nelle applicazioni .NET Framework.
system.web	Specifica l'elemento di primo livello per la sezione di configurazione ASP.NET.
healthMonitoring	Configura un'applicazione per il monitoraggio dello stato.
providers	Definisce i provider di monitoraggio dello stato responsabili dell'elaborazione degli eventi.

Note

Se sono presenti altre coppie di nome e valore, tali coppie devono essere elaborate dal provider.

Configurazione predefinita

L'elemento add predefinito riportato di seguito è configurato nel file Web.config a livello di radice in .NET Framework versione 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" />

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come aggiungere un provider.

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

Informazioni sull'elemento

Gestore della sezione di configurazione	System.Web.Configuration.HealthMonitoringSection
Membro di configurazione	HealthMonitoringSection.Providers
Percorsi configurabili	Machine.config Web.config a livello di radice Web.config a livello di applicazione
Requisiti	Microsoft Internet Information Services (IIS) versione 5.0, 5.1 o 6.0 Microsoft .NET Framework 2.0 Microsoft Visual Studio 2005

Vedere anche

Condividi tramite

Elemento add per providers per healthMonitoring (schema delle impostazioni ASP.NET)

Attributi ed elementi

Attributi

Elementi figlio

Elementi padre

Note

Configurazione predefinita

Esempio

Informazioni sull'elemento

Vedere anche

Attività

Concetti

Riferimenti

Altre risorse

Risorse aggiuntive