WebPageTraceListener Třída
Definice
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 webové stránky ASP.NET.
public ref class WebPageTraceListener : System::Diagnostics::TraceListenerpublic class WebPageTraceListener : System.Diagnostics.TraceListenertype WebPageTraceListener = class
inherit TraceListenerPublic Class WebPageTraceListener
Inherits TraceListener- Dědičnost
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í BulletedList a AccessDataSource ovládací prvek. Trasování je povolené ve webovém formuláři a výstup trasování se při vykreslení připojí k webovému formuláři. Trasovací zprávy můžete prozkoumat v tabulce Informace o trasování 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 WebPageTraceListenermožnost , 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
Note
Atribut HostProtectionAttribute použitý pro tuto třídu má následující Resources hodnotu vlastnosti: Synchronization. Nemá HostProtectionAttribute vliv na desktopové aplikace (které se obvykle spouští poklikáním na ikonu, zadáním příkazu nebo zadáním adresy URL v prohlížeči). Další informace naleznete v HostProtectionAttribute tématu třídy nebo programování SYSTÉMU SQL Server a atributy ochrany hostitele.
Třída WebPageTraceListener předává trasovací zprávy, které jsou zapsány do Trace protokolu do ASP.NET výstupní kanály webové stránky. Předávání trasování můžete povolit takWebPageTraceListener, že do souboru Web.config přidáte objekt jako naslouchací proces v pododdílu < Do kolekce naslouchacích procesů můžete také přidat WebPageTraceListener programově. Obvykle se to provádí přidáním WebPageTraceListener kolekce během spuštění aplikace pomocí Application_Start metody v souboru Global.asax.
Konstruktory
| Name | Description |
|---|---|
| WebPageTraceListener() |
Inicializuje novou instanci WebPageTraceListener třídy. |
Vlastnosti
| Name | Description |
|---|---|
| Attributes |
Získá vlastní atributy naslouchacího procesu trasování definované v konfiguračním souboru aplikace. (Zděděno od TraceListener) |
| Filter |
Získá nebo nastaví filtr trasování pro naslouchací proces trasování. (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 je naslouchací proces trasování bezpečný podproces. (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 se má výstup odsadit. (Zděděno od TraceListener) |
| TraceOutputOptions |
Získá nebo nastaví možnosti výstupu trasování. (Zděděno od TraceListener) |
Metody
| Name | Description |
|---|---|
| Close() |
Při přepsání v odvozené třídě zavře výstupní datový proud, takže již nepřijímá trasování nebo ladění výstup. (Zděděno od TraceListener) |
| CreateObjRef(Type) |
Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy serveru sloužící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 a volitelně uvolní spravované prostředky. (Zděděno od TraceListener) |
| Equals(Object) |
Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object) |
| Fail(String, String) |
Vygeneruje chybovou zprávu a podrobnou chybovou zprávu naslouchacímu procesu, který vytvoříte při implementaci TraceListener třídy. (Zděděno od TraceListener) |
| Fail(String) |
Vygeneruje chybovou zprávu naslouchacímu 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í funkce hash. (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é naslouchacím procesem trasování. (Zděděno od TraceListener) |
| GetType() |
Získá Type aktuální instance. (Zděděno od Object) |
| InitializeLifetimeService() |
Zastaralé.
Získá objekt služby životnosti pro řízení zásad životnosti pro tuto instanci. (Zděděno od MarshalByRefObject) |
| MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Object. (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) |
Zapisuje informace o trasování, 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[]) |
Zapisuje informace o trasování, pole datových objektů a informace o událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Zapíše lokalizovanou zprávu události na webovou stránku nebo do prohlížeče trasování ASP.NET pomocí zadaného systému a dat událostí. |
| 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ého systému a dat událostí. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Zapíše informace o trasování a událostech do výstupu specifického pro naslouchací proces. (Zděděno od TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Zapisuje informace o trasování, 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, 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(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(String, String) |
Zapíše název kategorie a zprávu na webovou stránku nebo do prohlížeče trasování ASP.NET. |
| Write(String) |
Zapíše 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 |
| 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(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 řádkem. (Zděděno od TraceListener) |
| WriteLine(String, String) |
Zapíše název kategorie a zprávu na webovou stránku nebo do prohlížeče trasování ASP.NET. |
| WriteLine(String) |
Zapíše zprávu na webovou stránku nebo do prohlížeče trasování ASP.NET. |
