WebPageTraceListener Klasse

Referenz

Definition

Namespace:: System.Web

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt einen Listener bereit, der Trace-Meldungen an ASP.NET-Webseitenausgaben weiterleitet.

public ref class WebPageTraceListener : System::Diagnostics::TraceListener

public class WebPageTraceListener : System.Diagnostics.TraceListener

type WebPageTraceListener = class
    inherit TraceListener

Public Class WebPageTraceListener
Inherits TraceListener

Vererbung: Object

MarshalByRefObject

TraceListener
WebPageTraceListener

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Nachrichten an die Webformularausgabe weitergeleitet Trace werden. Das Codebeispiel zeigt ein typisches Webformular, das ein BulletedList - und AccessDataSource -Steuerelement enthält. Die Ablaufverfolgung ist im Webformular aktiviert, und die Ablaufverfolgungsausgabe wird an das Webformular angefügt, wenn es gerendert wird. Sie können die Ablaufverfolgungsmeldungen in der Tabelle Ablaufverfolgungsinformationen der Ablaufverfolgungsausgabe untersuchen. Wenn Sie die WebPageTraceListener ordnungsgemäß in Ihrer Konfigurationsdatei aktiviert haben, werden beide Ablaufverfolgungsmeldungen mit der Kategorie "Trace Test"angezeigt. Wenn Sie jedoch nicht aktiviert haben, wird nur die WebPageTraceListenerAblaufverfolgungsmeldung angezeigt, die in das TraceContext Objekt geschrieben wird.

<%@ Page language="C#" trace="true" %>

<script runat="server">
private void page_load(object sender, EventArgs e) {
    
    Trace.Write("Trace Test","This message is written with the TraceContext object.");

    System.Diagnostics.Trace.WriteLine("This message is forwarded to the TraceContext from System.Diagnostics using the WebPageTraceListener.");
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">

<asp:GridView 
  id="GridView1"
  runat="server"
  datasourceid="AccessDataSource1"/>

<asp:AccessDataSource 
  id="AccessDataSource1"
  runat="server"
  datafile="Northwind.mdb"
  selectcommand="SELECT * FROM employees"/>

</form>
</body>
</html>

<%@ Page language="VB" trace="true" %>

<script runat="server">
Private Sub Page_Load(sender As Object, e As EventArgs)
    
    Trace.Write("Trace Test","This message is written with the System.Web.TraceContext object.")

    System.Diagnostics.Trace.Write("Trace Test", "This message is forwarded to the TraceContext from System.Diagnostics using the WebPageTraceListener.")

End Sub ' Page_Load
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">

<asp:GridView 
  id="GridView1"
  runat="server"
  datasourceid="AccessDataSource1"/>

<asp:AccessDataSource 
  id="AccessDataSource1"
  runat="server"
  datafile="Northwind.mdb"
  selectcommand="SELECT * FROM employees"/>
</form>
</body>
</html>

Hinweise

Hinweis

Das HostProtectionAttribute Attribut, das auf diese Klasse angewendet wird, weist den folgenden Resources Eigenschaftswert auf: Synchronization. Das HostProtectionAttribute hat keine Auswirkungen auf Desktopanwendungen (die normalerweise durch Doppelklicken auf ein Symbol, Eingeben eines Befehls oder einer URL in einem Browser gestartet werden). Weitere Informationen finden Sie in der HostProtectionAttribute Klasse oder SQL Server Programming and Host Protection Attribute.

Die WebPageTraceListener -Klasse leitet Ablaufverfolgungsmeldungen, die in das Trace Protokoll geschrieben werden, an ASP.NET Ausgabekanäle der Webseite weiter. Sie können die Ablaufverfolgungsweiterleitung aktivieren, indem Sie ihrer WebPageTraceListener Web.config-Datei im Unterabschnitt ablaufverfolgungselement (ASP.NET Einstellungsschema) des <Abschnitts system.diagnostics> ein Objekt als Listener hinzufügen. Sie können der Listenersammlung auch programmgesteuert einen WebPageTraceListener hinzufügen. Dies geschieht in der Regel durch Hinzufügen einer WebPageTraceListener zur Auflistung während des Anwendungsstarts mithilfe der Application_Start -Methode in der Datei Global.asax.

Konstruktoren

WebPageTraceListener()

Initialisiert eine neue Instanz der WebPageTraceListener-Klasse.

Eigenschaften

Attributes	Ruft die benutzerdefinierten Attribute für Ablaufverfolgungslistener ab, die in der Anwendungskonfigurationsdatei definiert sind. (Geerbt von TraceListener)
Filter	Ruft den Ablaufverfolgungsfilter für den Ablaufverfolgungslistener ab oder legt diesen fest. (Geerbt von TraceListener)
IndentLevel	Ruft die Einzugsebene ab oder legt diese fest. (Geerbt von TraceListener)
IndentSize	Ruft die Anzahl der Leerzeichen in einem Einzug ab oder legt diese fest. (Geerbt von TraceListener)
IsThreadSafe	Ruft einen Wert ab, der angibt, ob der Ablaufverfolgungslistener threadsicher ist. (Geerbt von TraceListener)
Name	Ruft einen Namen für diesen TraceListener ab oder legt diesen fest. (Geerbt von TraceListener)
NeedIndent	Ruft einen Wert ab, der einen Einzug für die Ausgabe angibt, oder legt diesen fest. (Geerbt von TraceListener)
TraceOutputOptions	Ruft die Optionen für die Ablaufverfolgungsausgabe ab oder legt diese fest. (Geerbt von TraceListener)

Methoden

Close()	Schließt beim Überschreiben in einer abgeleiteten Klasse den Ausgabestream, sodass dieser keine Ablaufverfolgungs- oder Debugausgaben mehr empfängt. (Geerbt von TraceListener)
CreateObjRef(Type)	Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. (Geerbt von MarshalByRefObject)
Dispose()	Gibt alle vom TraceListener verwendeten Ressourcen frei. (Geerbt von TraceListener)
Dispose(Boolean)	Gibt die von TraceListener verwendeten nicht verwalteten Ressourcen und optional die verwalteten Ressourcen frei. (Geerbt von TraceListener)
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
Fail(String)	Gibt eine Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
Fail(String, String)	Gibt eine Fehlermeldung sowie eine detaillierte Fehlermeldung an den Listener aus, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
Flush()	Entleert beim Überschreiben in einer abgeleiteten Klasse den Ausgabepuffer. (Geerbt von TraceListener)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetLifetimeService()	Veraltet. Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. (Geerbt von MarshalByRefObject)
GetSupportedAttributes()	Ruft die vom Ablaufverfolgungslistener unterstützten benutzerdefinierten Attribute ab. (Geerbt von TraceListener)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
InitializeLifetimeService()	Veraltet. Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. (Geerbt von MarshalByRefObject)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
MemberwiseClone(Boolean)	Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. (Geerbt von MarshalByRefObject)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Schreibt Ablaufverfolgungsinformationen, ein Datenobjekt und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Schreibt Ablaufverfolgungsinformationen, ein Array von Datenobjekten und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Schreibt Ablaufverfolgungs- und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Schreibt mithilfe der angegebenen System- und Ereignisdaten eine Ereignismeldung in eine Webseite oder in den ASP.NET-Ablaufverfolgungs-Viewer.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Schreibt mithilfe der angegebenen System- und Ereignisdaten eine lokalisierte Ereignismeldung in eine Webseite oder in den ASP.NET-Ablaufverfolgungs-Viewer.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Schreibt Ablaufverfolgungsinformationen, eine Meldung, eine verwandte Aktivitätsidentität und Ereignisinformationen in die spezifische Ausgabe des Listeners. (Geerbt von TraceListener)
Write(Object)	Schreibt den Wert der ToString()-Methode des Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
Write(Object, String)	Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
Write(String)	Schreibt eine Meldung in eine Webseite oder in den ASP.NET-Ablaufverfolgungs-Viewer.
Write(String, String)	Schreibt einen Kategorienamen und eine Meldung in eine Webseite oder in den ASP.NET-Ablaufverfolgungs-Viewer.
WriteIndent()	Schreibt den Einzug in den Listener, den sie bei der Implementierung dieser Klasse erstellen, und setzt die NeedIndent-Eigenschaft auf `false` zurück. (Geerbt von TraceListener)
WriteLine(Object)	Schreibt den Wert der ToString()-Methode des Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
WriteLine(Object, String)	Schreibt einen Kategorienamen und den Wert der ToString()-Methode eines Objekts gefolgt von einem Zeilenabschluss in den Listener, den Sie beim Implementieren der TraceListener-Klasse erstellen. (Geerbt von TraceListener)
WriteLine(String)	Schreibt eine Meldung in eine Webseite oder in den ASP.NET-Ablaufverfolgungs-Viewer.
WriteLine(String, String)	Schreibt einen Kategorienamen und eine Meldung in eine Webseite oder in den ASP.NET-Ablaufverfolgungs-Viewer.

Gilt für:

Weitere Informationen

Übersicht über die ASP.NET-Ablaufverfolgung