WebPageTraceListener Klass

Definition

Namnområde:: System.Web

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Tillhandahåller en lyssnare som dirigerar Trace meddelanden till ASP.NET webbsidautdata.

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

public class WebPageTraceListener : System.Diagnostics.TraceListener

type WebPageTraceListener = class
    inherit TraceListener

Public Class WebPageTraceListener
Inherits TraceListener

Arv: Object

MarshalByRefObject

TraceListener
WebPageTraceListener

Exempel

I följande kodexempel visas hur du dirigerar Trace meddelanden till webbformulärutdata. Kodexemplet visar ett typiskt webbformulär som innehåller en BulletedList och AccessDataSource -kontroll. Spårning är aktiverat i webbformuläret och spårningsutdata läggs till i webbformuläret när det återges. Du kan undersöka spårningsmeddelandena i tabellen Spårningsinformation för spårningsutdata. Om du har aktiverat WebPageTraceListener rätt i konfigurationsfilen visas båda spårningsmeddelandena med kategorin "Trace Test". Men om du inte har aktiverat WebPageTraceListenerser du bara spårningsmeddelandet som skrivs TraceContext till objektet.

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

Kommentarer

Note

Attributet HostProtectionAttribute som tillämpas på den här klassen har följande Resources egenskapsvärde: Synchronization. Påverkar HostProtectionAttribute inte skrivbordsprogram (som vanligtvis startas genom att dubbelklicka på en ikon, skriva ett kommando eller ange en URL i en webbläsare). Mer information finns i klassen HostProtectionAttribute eller SQL Server Programming and Host Protection Attributes.

Klassen WebPageTraceListener vidarebefordrar spårningsmeddelanden som skrivs till loggen Trace till ASP.NET utdatakanaler för webbsida. Du kan aktivera spårningsvidarebefordring genom att lägga till ett -objekt i Web.config-filen som lyssnare i trace-elementet (ASP.NET inställningsschema)et system.diagnostics. Du kan också lägga till en WebPageTraceListener i lyssnarsamlingen programmatiskt. Detta görs vanligtvis genom att lägga till en WebPageTraceListener i samlingen under programstarten Application_Start med hjälp av metoden i filen Global.asax.

Konstruktorer

Name	Description
WebPageTraceListener()	Initierar en ny instans av WebPageTraceListener klassen.

Egenskaper

Name	Description
Attributes	Hämtar attributen för anpassad spårningslyssnare som definierats i programkonfigurationsfilen. (Ärvd från TraceListener)
Filter	Hämtar eller anger spårningsfiltret för spårningslyssnaren. (Ärvd från TraceListener)
IndentLevel	Hämtar eller anger indragsnivån. (Ärvd från TraceListener)
IndentSize	Hämtar eller anger antalet blanksteg i ett indrag. (Ärvd från TraceListener)
IsThreadSafe	Hämtar ett värde som anger om spårningslyssnaren är trådsäker. (Ärvd från TraceListener)
Name	Hämtar eller anger ett namn för den här TraceListener. (Ärvd från TraceListener)
NeedIndent	Hämtar eller anger ett värde som anger om utdata ska dras in. (Ärvd från TraceListener)
TraceOutputOptions	Hämtar eller anger alternativen för spårningsutdata. (Ärvd från TraceListener)

Metoder

Name	Description
Close()	När den åsidosätts i en härledd klass stänger utdataströmmen så att den inte längre tar emot spårning eller felsökning av utdata. (Ärvd från TraceListener)
CreateObjRef(Type)	Skapar ett objekt som innehåller all relevant information som krävs för att generera en proxy som används för att kommunicera med ett fjärrobjekt. (Ärvd från MarshalByRefObject)
Dispose()	Släpper alla resurser som används av TraceListener. (Ärvd från TraceListener)
Dispose(Boolean)	Släpper de ohanterade resurser som används av TraceListener och släpper eventuellt de hanterade resurserna. (Ärvd från TraceListener)
Equals(Object)	Avgör om det angivna objektet är lika med det aktuella objektet. (Ärvd från Object)
Fail(String, String)	Genererar ett felmeddelande och ett detaljerat felmeddelande till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener)
Fail(String)	Genererar ett felmeddelande till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener)
Flush()	När den åsidosättas i en härledd klass töms utdatabufferten. (Ärvd från TraceListener)
GetHashCode()	Fungerar som standard-hash-funktion. (Ärvd från Object)
GetLifetimeService()	Föråldrad. Hämtar det aktuella livslängdstjänstobjektet som styr livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
GetSupportedAttributes()	Hämtar anpassade attribut som stöds av spårningslyssnaren. (Ärvd från TraceListener)
GetType()	Hämtar den aktuella instansen Type . (Ärvd från Object)
InitializeLifetimeService()	Föråldrad. Hämtar ett tjänstobjekt för livslängd för att styra livslängdsprincipen för den här instansen. (Ärvd från MarshalByRefObject)
MemberwiseClone()	Skapar en ytlig kopia av den aktuella Object. (Ärvd från Object)
MemberwiseClone(Boolean)	Skapar en ytlig kopia av det aktuella MarshalByRefObject objektet. (Ärvd från MarshalByRefObject)
ToString()	Returnerar en sträng som representerar det aktuella objektet. (Ärvd från Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Skriver spårningsinformation, ett dataobjekt och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Skriver spårningsinformation, en matris med dataobjekt och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Skriver ett lokaliserat händelsemeddelande till en webbsida eller till ASP.NET spårningsvisare med hjälp av angivna system- och händelsedata.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Skriver ett händelsemeddelande till en webbsida eller till ASP.NET spårningsvisningsprogram med hjälp av angivna system- och händelsedata.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Skriver spårnings- och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Skriver spårningsinformation, ett meddelande, en relaterad aktivitetsidentitet och händelseinformation till lyssnarens specifika utdata. (Ärvd från TraceListener)
Write(Object, String)	Skriver ett kategorinamn och värdet för objektets ToString() metod till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener)
Write(Object)	Skriver värdet för objektets ToString() -metod till lyssnaren som du skapar när du implementerar TraceListener klassen. (Ärvd från TraceListener)
Write(String, String)	Skriver ett kategorinamn och ett meddelande till en webbsida eller till ASP.NET spårningsvisaren.
Write(String)	Skriver ett meddelande till en webbsida eller till ASP.NET spårningsvisaren.
WriteIndent()	Skriver indraget till lyssnaren som du skapar när du implementerar den här klassen och återställer NeedIndent egenskapen till `false`. (Ärvd från TraceListener)
WriteLine(Object, String)	Skriver ett kategorinamn och värdet för objektets ToString() metod till lyssnaren som du skapar när du implementerar TraceListener klassen, följt av en radavgränsare. (Ärvd från TraceListener)
WriteLine(Object)	Skriver värdet för objektets ToString() -metod till lyssnaren du skapar när du implementerar TraceListener klassen, följt av en radavslutare. (Ärvd från TraceListener)
WriteLine(String, String)	Skriver ett kategorinamn och ett meddelande till en webbsida eller till ASP.NET spårningsvisaren.
WriteLine(String)	Skriver ett meddelande till en webbsida eller till ASP.NET spårningsvisaren.

Gäller för

Se även

översikt över ASP.NET spårning

Feedback

Var den här sidan till hjälp?