WebPageTraceListener Třída

Reference

Definice

Obor názvů:: System.Web

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje naslouchací proces, který směruje Trace zprávy na výstupy ASP.NET webové stránky.

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

public class WebPageTraceListener : System.Diagnostics.TraceListener

type WebPageTraceListener = class
    inherit TraceListener

Public Class WebPageTraceListener
Inherits TraceListener

Dědičnost: Object

MarshalByRefObject

TraceListener
WebPageTraceListener

Příklady

Následující příklad kódu ukazuje, jak směrovat Trace zprávy do výstupu webového formuláře. Příklad kódu ukazuje typický webový formulář obsahující ovládací prvek BulletedList a AccessDataSource . Ve webovém formuláři je povoleno trasování a výstup trasování se připojí k webovému formuláři při jeho vykreslení. Zprávy trasování můžete prozkoumat v tabulce Trasovací informace výstupu trasování. Pokud jste v konfiguračním WebPageTraceListener souboru povolili správně, zobrazí se obě zprávy trasování s kategorií "Trace Test". Pokud jste však nepovolili WebPageTraceListener, zobrazí se pouze zpráva trasování, která je zapsána do objektu TraceContext .

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

Poznámky

Poznámka

Atribut HostProtectionAttribute použitý pro tuto třídu má následující Resources hodnotu vlastnosti: Synchronization. Atribut HostProtectionAttribute nemá vliv na běžné aplikace (které jsou obvykle spouštěny dvojitým kliknutím na ikonu, zadáním příkazu nebo zadáním adresy URL v prohlížeči). Další informace najdete v HostProtectionAttribute tématu o třídě nebo o atributech programování a ochrany hostitele SQL Serveru.

Třída WebPageTraceListener předává trasovací zprávy, které jsou zapsány do Trace protokolu ASP.NET výstupní kanály webové stránky. Přesměrování trasování můžete povolit přidáním objektu WebPageTraceListener do souboru Web.config jako naslouchací proces v pododdíle trace Element (ASP.NET Settings Schema) v části system.diagnostics>.< Do kolekce naslouchacích procesů můžete také přidat WebPageTraceListener programově. Obvykle se to provádí přidáním WebPageTraceListener objektu do kolekce během spuštění aplikace pomocí Application_Start metody v souboru Global.asax.

Konstruktory

WebPageTraceListener()

Inicializuje novou instanci WebPageTraceListener třídy.

Vlastnosti

Attributes	Získá vlastní atributy trasovacího naslouchacího procesu definované v konfiguračním souboru aplikace. (Zděděno od TraceListener)
Filter	Získá nebo nastaví filtr trasování pro trasovací naslouchací proces. (Zděděno od TraceListener)
IndentLevel	Získá nebo nastaví úroveň odsazení. (Zděděno od TraceListener)
IndentSize	Získá nebo nastaví počet mezer v odsazení. (Zděděno od TraceListener)
IsThreadSafe	Získá hodnotu označující, zda trasovací naslouchací proces je bezpečný z více vláken. (Zděděno od TraceListener)
Name	Získá nebo nastaví název pro tento TraceListener. (Zděděno od TraceListener)
NeedIndent	Získá nebo nastaví hodnotu označující, zda odsadit výstup. (Zděděno od TraceListener)
TraceOutputOptions	Získá nebo nastaví možnosti výstupu trasování. (Zděděno od TraceListener)

Metody

Close()	Při přepsání v odvozené třídě zavře výstupní datový proud, aby již nepřijíma výstup trasování nebo ladění. (Zděděno od TraceListener)
CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy používaného ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem TraceListener. (Zděděno od TraceListener)
Dispose(Boolean)	Uvolní nespravované prostředky používané TraceListener nástrojem a volitelně uvolní spravované prostředky. (Zděděno od TraceListener)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Fail(String)	Vygeneruje chybovou zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Fail(String, String)	Vygeneruje chybovou zprávu a podrobnou chybovou zprávu do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Flush()	Při přepsání v odvozené třídě vyprázdní výstupní vyrovnávací paměť. (Zděděno od TraceListener)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Zastaralé. Načte objekt služby aktuální životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetSupportedAttributes()	Získá vlastní atributy podporované trasovacím naslouchacím procesem. (Zděděno od TraceListener)
GetType()	Získá aktuální Type instanci. (Zděděno od Object)
InitializeLifetimeService()	Zastaralé. Získá objekt služby životnosti, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapíše trasovací informace, datový objekt a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapíše trasovací informace, pole datových objektů a informací o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapíše trasování a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapíše zprávu události na webovou stránku nebo do prohlížeče trasování ASP.NET pomocí zadaných systémových dat a dat událostí.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapíše zprávu lokalizované události na webovou stránku nebo do prohlížeče trasování ASP.NET pomocí zadaných systémových dat a dat událostí.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Zapíše trasovací informace, zprávu, související identitu aktivity a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener)
Write(Object)	Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Write(Object, String)	Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener)
Write(String)	Zapíše zprávu na webovou stránku nebo do prohlížeče trasování ASP.NET.
Write(String, String)	Zapíše název kategorie a zprávu na webovou stránku nebo do prohlížeče trasování ASP.NET.
WriteIndent()	Zapíše odsazení do naslouchacího procesu, který vytvoříte při implementaci této třídy, a resetuje NeedIndent vlastnost na `false`. (Zděděno od TraceListener)
WriteLine(Object)	Zapíše hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener)
WriteLine(Object, String)	Zapíše název kategorie a hodnotu metody objektu ToString() do naslouchacího procesu, který vytvoříte při implementaci TraceListener třídy, následovaný ukončovacím znakem řádku. (Zděděno od TraceListener)
WriteLine(String)	Zapíše zprávu na webovou stránku nebo do prohlížeče trasování ASP.NET.
WriteLine(String, String)	Zapíše název kategorie a zprávu na webovou stránku nebo do prohlížeče trasování ASP.NET.

Platí pro

Viz také

Přehled trasování ASP.NET

Sdílet prostřednictvím