WebPageTraceListener Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Web

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Udostępnia odbiornik, który kieruje Trace komunikaty do ASP.NET danych wyjściowych strony sieci Web.

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

public class WebPageTraceListener : System.Diagnostics.TraceListener

type WebPageTraceListener = class
    inherit TraceListener

Public Class WebPageTraceListener
Inherits TraceListener

Dziedziczenie: Object

MarshalByRefObject

TraceListener
WebPageTraceListener

Przykłady

Poniższy przykład kodu przedstawia sposób kierowania Trace komunikatów do danych wyjściowych formularza internetowego. Przykładowy kod przedstawia typowy formularz sieci Web zawierający kontrolkę BulletedList i AccessDataSource . Śledzenie jest włączone w formularzu sieci Web, a dane wyjściowe śledzenia są dołączane do formularza sieci Web podczas renderowania. Komunikaty śledzenia można sprawdzić w tabeli Trace Information (Informacje o śladach) danych wyjściowych śledzenia. Jeśli poprawnie włączono WebPageTraceListener funkcję w pliku konfiguracji, zobaczysz oba komunikaty śledzenia z kategorią "Trace Test". Jeśli jednak nie włączono WebPageTraceListenerelementu , zobaczysz tylko komunikat śledzenia zapisany w TraceContext obiekcie.

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

Uwagi

Uwaga

Atrybut HostProtectionAttribute zastosowany do tej klasy ma następującą Resources wartość właściwości: Synchronization. Atrybut HostProtectionAttribute nie ma wpływu na aplikacje pulpitu (które typowo są uruchamiane przez dwukrotne kliknięcie ikony, wpisanie polecenia albo wprowadzenie adresu URL w przeglądarce). Aby uzyskać więcej informacji, zobacz klasę HostProtectionAttribute lub SQL Server Programowanie i atrybuty ochrony hosta.

Klasa WebPageTraceListener przekazuje komunikaty śledzenia zapisywane w dzienniku Trace do kanałów wyjściowych strony internetowej ASP.NET. Przekazywanie śledzenia można włączyć, dodając WebPageTraceListener obiekt do pliku Web.config jako odbiornik w podsekcji element śledzenia (ASP.NET Settings Schema) w sekcji <system.diagnostics> . Można również programowo dodać obiekt WebPageTraceListener do kolekcji odbiorników. Zazwyczaj odbywa się to przez dodanie WebPageTraceListener elementu do kolekcji podczas uruchamiania aplikacji przy użyciu Application_Start metody w pliku Global.asax.

Konstruktory

WebPageTraceListener()

Inicjuje nowe wystąpienie klasy WebPageTraceListener.

Właściwości

Attributes	Pobiera niestandardowe atrybuty odbiornika śledzenia zdefiniowane w pliku konfiguracji aplikacji. (Odziedziczone po TraceListener)
Filter	Pobiera lub ustawia filtr śledzenia dla odbiornika śledzenia. (Odziedziczone po TraceListener)
IndentLevel	Pobiera lub ustawia poziom wcięcia. (Odziedziczone po TraceListener)
IndentSize	Pobiera lub ustawia liczbę spacji w wcięcie. (Odziedziczone po TraceListener)
IsThreadSafe	Pobiera wartość wskazującą, czy odbiornik śledzenia jest bezpieczny wątkiem. (Odziedziczone po TraceListener)
Name	Pobiera lub ustawia nazwę dla tego elementu TraceListener. (Odziedziczone po TraceListener)
NeedIndent	Pobiera lub ustawia wartość wskazującą, czy należy wciąć dane wyjściowe. (Odziedziczone po TraceListener)
TraceOutputOptions	Pobiera lub ustawia opcje danych wyjściowych śledzenia. (Odziedziczone po TraceListener)

Metody

Close()	Gdy zastąpisz klasę pochodną, zamyka strumień wyjściowy, aby nie odbierał już danych wyjściowych śledzenia ani debugowania. (Odziedziczone po TraceListener)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
Dispose()	Zwalnia wszelkie zasoby używane przez element TraceListener. (Odziedziczone po TraceListener)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element TraceListener i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po TraceListener)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
Fail(String)	Emituje komunikat o błędzie do odbiornika utworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Fail(String, String)	Emituje komunikat o błędzie i szczegółowy komunikat o błędzie do odbiornika utworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Flush()	Po przesłonięciu w klasie pochodnej opróżni bufor wyjściowy. (Odziedziczone po TraceListener)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetSupportedAttributes()	Pobiera atrybuty niestandardowe obsługiwane przez odbiornik śledzenia. (Odziedziczone po TraceListener)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Zapisuje informacje śledzenia, obiekt danych i informacje o zdarzeniach do danych wyjściowych specyficznych dla odbiornika. (Odziedziczone po TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Zapisuje informacje śledzenia, tablicę obiektów danych i informacje o zdarzeniach do danych wyjściowych specyficznych dla odbiornika. (Odziedziczone po TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Zapisuje informacje dotyczące śledzenia i zdarzeń do danych wyjściowych specyficznych dla odbiornika. (Odziedziczone po TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Zapisuje komunikat o zdarzeniu na stronie internetowej lub w przeglądarce śledzenia ASP.NET przy użyciu określonych danych systemowych i zdarzeń.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Zapisuje zlokalizowany komunikat zdarzenia na stronie internetowej lub w przeglądarce śledzenia ASP.NET przy użyciu określonych danych systemowych i zdarzeń.
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Zapisuje informacje dotyczące śledzenia, komunikatu, powiązanej tożsamości działania i informacji o zdarzeniach do danych wyjściowych specyficznych dla odbiornika. (Odziedziczone po TraceListener)
Write(Object)	Zapisuje wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Write(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy. (Odziedziczone po TraceListener)
Write(String)	Zapisuje komunikat na stronie internetowej lub w przeglądarce śledzenia ASP.NET.
Write(String, String)	Zapisuje nazwę kategorii i komunikat na stronie sieci Web lub w przeglądarce śledzenia ASP.NET.
WriteIndent()	Zapisuje wcięcie do odbiornika utworzonego podczas implementowania tej klasy i resetuje NeedIndent właściwość do `false`. (Odziedziczone po TraceListener)
WriteLine(Object)	Zapisuje wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy, po której następuje terminator wiersza. (Odziedziczone po TraceListener)
WriteLine(Object, String)	Zapisuje nazwę kategorii i wartość metody obiektu ToString() do odbiornika tworzonego podczas implementowania TraceListener klasy, po której następuje terminator wiersza. (Odziedziczone po TraceListener)
WriteLine(String)	Zapisuje komunikat na stronie internetowej lub w przeglądarce śledzenia ASP.NET.
WriteLine(String, String)	Zapisuje nazwę kategorii i komunikat na stronie sieci Web lub w przeglądarce śledzenia ASP.NET.

Dotyczy

Zobacz też

Omówienie śledzenia ASP.NET