TraceSection-Klasse
Konfiguriert den ASP.NET Codeablaufverfolgungsdienst.
Syntax
class TraceSection : ConfigurationSection
Methoden
In der folgenden Tabelle werden die Methoden aufgelistet, die von der TraceSection-Klasse verfügbar gemacht werden.
| Name | Beschreibung |
|---|---|
| GetAllowDefinition | (Geerbt von ConfigurationSection.) |
| GetAllowLocation | (Geerbt von ConfigurationSection.) |
| RevertToParent | (Geerbt von ConfigurationSection.) |
| SetAllowDefinition | (Geerbt von ConfigurationSection.) |
| SetAllowLocation | (Geerbt von ConfigurationSection.) |
Eigenschaften
In der folgenden Tabelle sind die Eigenschaften aufgeführt, die von der TraceSection-Klasse verfügbar gemacht werden.
| Name | Beschreibung |
|---|---|
Enabled |
Optionaler boolean Lese-/Schreibwert. true wenn die Ablaufverfolgung für eine ASP.NET Anwendung aktiviert ist; andernfalls false. Der Standardwert ist false.Wenn die Ablaufverfolgung aktiviert ist, können Sie die protokollierten Fehler mit dem Trace.axd-Viewer unter der URL http://<servername>/<applicationroot>/trace.axd anzeigen. Sie müssen die Enabled Eigenschaft auf true setzen, um den Viewer zu verwenden. Hinweis: Trace.axd wird standardmäßig dem <httpHandlers> Abschnitt in der Datei Applicationhost.config hinzugefügt. |
LocalOnly |
Optionaler boolean Lese-/Schreibwert. true wenn der Ablaufverfolgungs-Viewer (Trace.axd) nur auf dem Hostwebserver verfügbar ist; false wenn der Ablaufverfolgungs-Viewer von einem beliebigen Computer aus verfügbar ist. Der Standardwert ist true. |
Location |
(Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft. |
MostRecent |
Optionaler boolean Lese-/Schreibwert. true wenn der Ablaufverfolgungsspeicher weiterhin die neuesten Ablaufverfolgungsmeldungen sammelt und beginnt, ältere Ablaufverfolgungsmeldungen zu verwerfen, wenn der in RequestLimit angegebene Grenzwert erreicht ist. false wenn der Ablaufverfolgungsspeicher die Erfassung von Ablaufverfolgungsmeldungen beendet, wenn die in RequestLimit angegebene Zahl erreicht ist. Der Standardwert ist false. Hinweis: Diese Eigenschaft ist neu in .NET Framework 2.0. |
PageOutput |
Optionaler boolean Lese-/Schreibwert. true wenn Ablaufverfolgungsinformationen am Ende jeder Webseite hinzugefügt werden; false wenn auf die Ablaufverfolgungsausgabe nur über das Ablaufverfolgungshilfsprogramm zugegriffen werden kann. Der Standardwert ist false. Hinweis: Weitere Informationen zum Hilfsprogramm ASP.NET Ablaufverfolgungsanzeige finden Sie unter Gewusst wie: ASP.NET Ablaufverfolgungsinformation mit dem Trace Viewer ansehen. |
Path |
(Geerbt von ConfigurationSection.) Eine Schlüsseleigenschaft. |
RequestLimit |
Ein optionaler sint32 Lese-/Schreibwert, der die Anzahl der Ablaufverfolgungsanforderungen zwischen 0 und 10000 angibt, um auf dem Server zu speichern. Der Standardwert ist 10. Wenn der Grenzwert erreicht ist und die MostRecent Eigenschaft false lautet, wird die Ablaufverfolgung beendet. Hinweis: Obwohl ganzzahlige Werte im Bereich 0 bis 2147483647 für die RequestLimit Eigenschaft akzeptiert werden, wenn Sie einen Wert größer als 10000 angeben, rundet ASP.NET sie im Hintergrund auf 10000 ab. |
SectionInformation |
(Geerbt von ConfigurationSection.) |
TraceMode |
Ein optionaler sint32 Lese-/Schreibwert, der die Reihenfolge angibt, in der Ablaufverfolgungsinformationen angezeigt werden. Die möglichen Werte werden weiter unten im Abschnitt Hinweise aufgeführt. |
WriteToDiagnosticsTrace |
Optionaler boolean Lese-/Schreibwert. true wenn ASP.NET Ablaufverfolgungsmeldungen an die System.Diagnostics-Ablaufverfolgungsinfrastruktur für Listener weitergeleitet werden, die zum Anzeigen von Ablaufverfolgungsmeldungen registriert sind; andernfalls false. Der Standardwert ist false. Hinweis: Diese Eigenschaft ist neu in .NET Framework 2.0. |
Unterklassen
Diese Klasse enthält keine Unterklassen.
Hinweise
In der folgenden Tabelle werden die verschiedenen möglichen Werte für die TraceMode Eigenschaft angezeigt. Der Standardwert ist 1 (SortByTime).
| Wert | Schlüsselwort | BESCHREIBUNG |
|---|---|---|
| 1 | SortByTime |
Gibt an, dass Ablaufverfolgungsinformationen in der Reihenfolge angezeigt werden, in der sie verarbeitet wird. |
| 2 | SortByCategory |
Gibt an, dass Ablaufverfolgungsinformationen alphabetisch nach benutzerdefinierten Kategorien angezeigt werden, die im System.Web.TraceContext.Warn- und System.Web.TraceContext.Write-Methodenaufruf in Seiten- oder Serversteuerungscode angegeben sind. |
Vererbungshierarchie
TraceSection
Anforderungen
| type | Beschreibung |
|---|---|
| Client | - IIS 7.0 unter Windows Vista. - IIS 7.5 unter Windows 7 - IIS 8.0 unter Windows 8 - IIS 10.0 unter Windows 10 |
| Server | - IIS 7.0 unter Windows Server 2008 - IIS 7.5 unter Windows Server 2008 R2 - IIS 8.0 auf Windows Server 2012 - IIS 8.5 unter Windows Server 2012 R2 - IIS 10.0 auf Windows Server 2016 |
| Produkt | - IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 |
| MOF-Datei | WebAdministration.mof |
Weitere Informationen
System.Web.TraceContextConfigurationSection Class
trace-Element (ASP.NET-Einstellungsschema)
Gewusst wie: Aktivieren der Ablaufverfolgung für eine ASP.NET-Seite
System.Web.TraceContext Methods