add-Element für providers für healthMonitoring (ASP.NET-Einstellungsschema)

Artikel
08/10/2011

Gibt den Namen des Anbieters und die Klasse an, die ihn implementiert.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute, untergeordnete Elemente und übergeordnete Elemente beschrieben.

Attribute

Attribute	Beschreibungen
bcc	Optionales String-Attribut. Gilt nur für die SimpleMailWebEventProvider-Klasse und die TemplatedMailWebEventProvider-Klasse. Definiert eine durch Komma (,) getrennte Liste von Empfängeradressen, die der Blindkopieliste (BCC:) hinzugefügt werden sollen.
bodyFooter	Optionales String-Attribut. Gilt nur für die SimpleMailWebEventProvider-Attribute. Gibt Text an, der am unteren Rand des E-Mail-Texts im einfachen E-Mail-Format eingefügt werden soll. Hinweis Dieses Attribut kann nicht zusammen mit dem template-Attribut verwendet werden.
bodyHeader	Optionales String-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut. Gibt Text an, der am oberen Rand des E-Mail-Texts im einfachen E-Mail-Format eingefügt werden soll. Hinweis Dieses Attribut kann nicht zusammen mit dem template-Attribut verwendet werden.
buffer	Erforderliches Boolean-Attribut. Gilt nur für die SqlWebEventProvider-Klasse. Gibt an, ob der Anbieter Pufferung verwendet oder jedes Ereignis sofort an den Empfänger sendet. Die Standardeinstellung ist false.
bufferMode	Optionales String-Attribut. Gilt nur für das SQLWebEventProvider-Attribut. Gibt den Namen des vom Anwender verwendeten Puffermodus an, sofern er sich im Puffermodus befindet. Der Name muss auf einen der vorhandenen Puffermodi in der BufferModesCollection-Auflistung verweisen, andernfalls wird eine Ausnahme ausgelöst. Dieses Attribut muss vorhanden sein, wenn die Pufferung aktiviert wird.
cc	Optionales String-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut und das TemplatedMailWebEventProvider-Attribut. Definiert eine durch Semikolons (;) getrennte Liste von Empfängeradressen, die der Kopieliste (CC:) hinzugefügt werden sollen.
commandTimeout	Optionales Int32-Attribut. Gilt nur für das SQLWebEventProvider-Attribut. Legt die Anzahl der Sekunden fest, nach denen ein an die Mitgliedschaftsdatenquelle ausgegebener Befehl aufgrund der angegebenen Zeitbeschränkung abgebrochen wird. Dieses Timeout wird vom SQL-Anbieter beim Erstellen von SqlCommand-Objekten verwendet. Dieses Attribut ist in der ASP.NET-Konfiguration nicht standardmäßig festgelegt. Deshalb wird der ADO.NET-Standard von 30 Sekunden verwendet. Wenn dieses Attribut festgelegt ist, muss der SQL-Anbieter den konfigurierten Timeoutwert für alle an die Datenbank ausgegebenen SQL-Befehle verwenden. Wenn die Validierung fehlschlägt, wird eine System.Configuration.Provider.ProviderException-Ausnahme ausgelöst. Die Standardeinstellung ist 30 (ADO.NET-Standardeinstellung).
connectionStringName	Erforderliches String-Attribut. Gilt nur für das SQLWebEventProvider-Attribut. Gibt die Zeichenfolge an, die zum Herstellen einer Verbindung mit der Datenbank verwendet werden soll.
detailedTemplateErrors	Optionales Boolean-Attribut. Gilt nur für das TemplatedMailWebEventProvider-Attribut. Gibt an, ob beim Auftreten eines Fehlers während der Vorlagenkompilierung oder zur Laufzeit die Einzelheiten der Ausnahme in einer E-Mail gesendet werden. Die Standardeinstellung ist false.
from	Optionales String-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut und das TemplatedMailWebEventProvider-Attribut. Gibt die Adresse des Absenders an. Dieses Attribut wird vom SMTP-Mail-Konfigurationsabschnitt geerbt, wenn es nicht angegeben ist.
maxEventDetailLength	Optionales Int32-Attribut. Gilt nur für das SQLWebEventProvider-Attribut. Gibt die maximale Länge in Zeichen der Ereignisdetails an, die für die einzelnen Ereignisse zulässig ist, wie im Folgenden veranschaulicht: Wenn die Ereignisdetails (event.ToString()) dieses Attribut überschreiten, werden die Ereignisdetails an der maxEventDetailLength-Länge abgeschnitten. Im Fall von 0 werden für die jeweiligen Ereignisse keine Details bereitgestellt. Im Fall von Infinite wird die maximale Länge nicht überprüft, und der vollständige Detailtext ist in der Mail enthalten. Hinweis Wenn die Ereignisdetaillänge nicht beschränkt ist, stellt dieses Attribut eine potenzielle Gefährdung dar.
maxEventLengthForSimpleMessage	Optionales Int32-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut und das TemplatedMailWebEventProvider-Attribut. Gibt die maximale Länge in Zeichen der Ereignisdetails an, die für die einzelnen Ereignisse zulässig ist, wie im Folgenden veranschaulicht: Wenn die Ereignisdetails (event.ToString()) dieses Attribut überschreiten, werden die Ereignisdetails an der maxEventLengthForSimpleMessage-Länge abgeschnitten. Im Fall von 0 sind in den Benachrichtigungen keine Ereignisdetails enthalten. Im Fall von Infinite wird keine Obergrenze für die Ereignisdetaillänge festgelegt. Hinweis Wenn die Nachrichtengröße nicht beschränkt ist, stellt dieses Attribut eine potenzielle Gefährdung dar.Die Standardeinstellung ist 5000 Zeichen.
maxSizeForSimpleMessage	Optionales Int32-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut und das TemplatedMailWebEventProvider-Attribut. Gibt die maximale Größe in Bytes der Benachrichtigungen an, die vom Anbieter gesendet werden. Im Fall von Infinite wird die E-Mail im einfachen Modus nicht aufgeteilt. Hinweis Dieses Attribut kann dazu führen, dass Nachrichten vom E-Mail-System verworfen werden, und stellt eine potenzielle Gefährdung dar.Der Standardwert ist 1024 KB.
maxEventCountForTemplateMessage	Optionales Int32-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut und das TemplatedMailWebEventProvider-Attribut. Gibt die maximale Anzahl von Ereignissen in den einzelnen Benachrichtigungen an, die im Vorlagenmodus vom Anbieter gesendet werden. im Fall von Infinite wird die E-Mail nicht aufgeteilt. Hinweis Dieses Attribut kann dazu führen, dass Nachrichten vom E-Mail-System verworfen werden, und stellt eine potenzielle Gefährdung dar. Der Standardwert ist 100.
maxMessagesPerNotification	Optionales Int32-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut und das TemplatedMailWebEventProvider-Attribut. Gibt die maximale Anzahl von Nachrichten an pro Benachrichtigung an, auf die die Ereignisse verteilt werden. Im Fall von Infinite wird keine Beschränkung angegeben. Hinweis Dieses Attribut kann zu einer E-Mail-Flut führen und stellt eine potenzielle Gefährdung dar. Der Standardwert ist 100.
name	Erforderliches String-Attribut. Gibt den Anzeigenamen des Anbieters an.
priority	Optionales String-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut und das TemplatedMailWebEventProvider-Attribut. Legt die Priorität der E-Mail-Nachrichten fest, und ist ein Member der MailPriority-Enumeration. Der Standardwert ist Normal.
separator	Optionales String-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut. Gibt Text an, der zwischen den Ereignissen und nach dem jeweiligen Abschnittsheader im einfachen E-Mail-Format eingefügt werden soll. Hinweis Dieses Attribut kann nicht zusammen mit dem template-Attribut verwendet werden.
smtpAddresses	Erforderliches String-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut. Gibt eine durch Trennzeichen getrennte Liste von E-Mail-Adressen an, an die Ereignisbenachrichtigungen gesendet werden. Wenn für unterschiedliche Profilereignisse verschiedene Gruppen von E-Mail-Adressen verwendet werden, können mehrere Instanzen des Anbieters konfiguriert werden.
subjectPrefix	Optionales String-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut und das TemplatedMailWebEventProvider-Attribut. Gibt die der Betreffzeile der E-Mail vorangestellte Zeichenfolge an und ermöglicht, dass die E-Mail-Nachrichten für jede Instanz des Anbieters über eine benutzerdefinierte Betreffzeile verfügen. Hinweis Dieses Attribut kann nicht zusammen mit dem template-Attribut verwendet werden.
template	Optionales String-Attribut. Gilt nur für das TemplatedMailWebEventProvider-Attribut. Gibt die vom Benutzer bereitgestellte Seitenvorlage (.aspx) an, mit der der Nachrichtentext für die jeweilige Benachrichtigung erstellt werden soll. Hinweis Dieses Attribut kann nicht zusammen mit den Attributen bodyHeader, bodyFooter und separator verwendet werden.
to	Optionales String-Attribut. Gilt nur für das SimpleMailWebEventProvider-Attribut und das TemplatedMailWebEventProvider-Attribut. Definiert eine durch Semikolons getrennte Liste von Empfängeradressen, die der Empfängerliste (An:) hinzugefügt werden.
type	Erforderliches String-Attribut. Gibt einen vollqualifizierten Assemblyverweis auf eine Klasse an, die die System.Configuration.Provider.ProviderBase-Klasse implementiert.

Untergeordnete Elemente

Keine.

Übergeordnete Elemente

Element	Beschreibungen
configuration	Gibt das Stammelement in jeder Konfigurationsdatei an, die von der Common Language Runtime und den .NET Framework-Anwendungen verwendet wird.
system.web	Gibt das Stammelement für den ASP.NET-Konfigurationsabschnitt an.
healthMonitoring	Konfiguriert eine Anwendung für die Systemüberwachung.
providers	Definiert die für die Ereignisverarbeitung zuständigen Systemüberwachungsanbieter.

Hinweise

Wenn zusätzliche Name-Wert-Paare vorhanden sind, müssen sie vom Anbieter verarbeitet werden.

Standardkonfiguration

Das folgende add-Standardelement wird in der Stammdatei Web.config von .NET Framework, Version 2.0, konfiguriert.

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

Beispiel

Das folgende Codebeispiel zeigt, wie ein Anbieter hinzugefügt wird.

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

Elementinformationen

Konfigurationsabschnittshandler	System.Web.Configuration.HealthMonitoringSection
Konfigurationsmember	HealthMonitoringSection.Providers
Konfigurierbare Speicherorte	Machine.config Web.config auf der Stammebene Web.config auf der Anwendungsebene
Anforderungen	Microsoft Internetinformationsdienste (IIS), Version 5.0, 5.1 oder 6.0 Microsoft .NET Framework 2.0 Microsoft Visual Studio 2005

Siehe auch

Freigeben über

add-Element für providers für healthMonitoring (ASP.NET-Einstellungsschema)

Attribute und Elemente

Attribute

Untergeordnete Elemente

Übergeordnete Elemente

Hinweise

Standardkonfiguration

Beispiel

Elementinformationen

Siehe auch

Aufgaben

Referenz

Konzepte

Weitere Ressourcen

Zusätzliche Ressourcen