WebPageTraceListener Classe

Definizione

Fornisce un listener che indirizza i messaggi Trace agli output della pagina Web ASP.NET.Provides a listener that directs Trace messages to ASP.NET Web page outputs.

public ref class WebPageTraceListener : System::Diagnostics::TraceListener
public class WebPageTraceListener : System.Diagnostics.TraceListener
type WebPageTraceListener = class
    inherit TraceListener
Public Class WebPageTraceListener
Inherits TraceListener
Ereditarietà
WebPageTraceListener

Esempi

Nell'esempio di codice seguente viene illustrato come Trace indirizzare i messaggi all'output del Web Form.The following code example demonstrates how to route Trace messages to Web form output. Nell'esempio di codice viene illustrato un tipico Web Form BulletedList contenente AccessDataSource un controllo e.The code example shows a typical Web form containing a BulletedList and AccessDataSource control. La traccia è abilitata nel Web Form e l'output di traccia viene aggiunto al Web Form quando ne viene eseguito il rendering.Tracing is enabled on the Web form and trace output is appended to the Web form when it is rendered. È possibile esaminare i messaggi di traccia nella tabella delle informazioni di traccia dell'output di traccia.You can examine the trace messages in the Trace Information table of the trace output. Se nel file di configurazione WebPageTraceListener è stato abilitato correttamente, vengono visualizzati entrambi i messaggi di traccia con la "Trace Test"categoria.If you have enabled the WebPageTraceListener correctly in your configuration file, you see both trace messages with the category "Trace Test". Tuttavia, se non è stato abilitato WebPageTraceListener, verrà visualizzato solo il messaggio TraceContext di traccia scritto nell'oggetto.However, if you have not enabled the WebPageTraceListener, you see only the trace message that is written to the TraceContext object.

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

Commenti

Nota

L' HostProtectionAttribute attributo applicato a questa classe presenta il valore Resources della proprietà seguente Synchronization:.The HostProtectionAttribute attribute applied to this class has the following Resources property value: Synchronization. L'oggetto HostProtectionAttribute non influisce sulle applicazioni desktop, che in genere vengono avviate facendo doppio clic sull'icona, digitando un comando oppure immettendo un URL in un browser.The HostProtectionAttribute does not affect desktop applications (which are typically started by double-clicking an icon, typing a command, or entering a URL in a browser). Per ulteriori informazioni, vedere la HostProtectionAttribute classe o SQL Server la programmazione e gli attributi di protezione host.For more information, see the HostProtectionAttribute class or SQL Server Programming and Host Protection Attributes.

La WebPageTraceListener classe trasmette i messaggi di traccia scritti nel log nei Trace canali di output della pagina Web ASP.NET.The WebPageTraceListener class forwards trace messages that are written to the Trace log to ASP.NET Web page output channels. Per abilitare l'invio di tracce, è possibile WebPageTraceListener aggiungere un oggetto al file Web. config come listener nella sottosezione elemento Trace (schema delle impostazioni ASP.NET) della <sezione System. Diagnostics> .You can enable trace forwarding by adding a WebPageTraceListener object to your Web.config file as a listener in the trace Element (ASP.NET Settings Schema) subsection of the <system.diagnostics> section. È anche possibile aggiungere un WebPageTraceListener oggetto alla raccolta Listeners a livello di codice.You can also add a WebPageTraceListener to the listeners collection programmatically. In genere, questa operazione viene eseguita aggiungendo WebPageTraceListener un oggetto alla raccolta durante l'avvio dell'applicazione Application_Start , usando il metodo nel file Global. asax.Commonly, this is done by adding a WebPageTraceListener to the collection during application startup, using the Application_Start method in the Global.asax file.

Costruttori

WebPageTraceListener()

Inizializza una nuova istanza della classe WebPageTraceListener.Initializes a new instance of the WebPageTraceListener class.

Proprietà

Attributes

Ottiene gli attributi personalizzati del listener di traccia definiti nel file di configurazione dell'applicazione.Gets the custom trace listener attributes defined in the application configuration file.

(Ereditato da TraceListener)
Filter

Ottiene o imposta il filtro di traccia per il listener di traccia.Gets or sets the trace filter for the trace listener.

(Ereditato da TraceListener)
IndentLevel

Ottiene o imposta il livello di rientro.Gets or sets the indent level.

(Ereditato da TraceListener)
IndentSize

Ottiene o imposta il numero di spazi in un rientro.Gets or sets the number of spaces in an indent.

(Ereditato da TraceListener)
IsThreadSafe

Ottiene un valore che indica se il listener di traccia è thread-safe.Gets a value indicating whether the trace listener is thread safe.

(Ereditato da TraceListener)
Name

Ottiene o imposta un nome per l'oggetto TraceListener.Gets or sets a name for this TraceListener.

(Ereditato da TraceListener)
NeedIndent

Ottiene o imposta un valore che indica se impostare il rientro dell'output.Gets or sets a value indicating whether to indent the output.

(Ereditato da TraceListener)
TraceOutputOptions

Ottiene o imposta le opzioni dell'output di traccia.Gets or sets the trace output options.

(Ereditato da TraceListener)

Metodi

Close()

Quando se ne esegue l'override in una classe derivata, chiude il flusso di output in modo da bloccare la ricezione di output di tracciatura o di debug.When overridden in a derived class, closes the output stream so it no longer receives tracing or debugging output.

(Ereditato da TraceListener)
CreateObjRef(Type)

Consente di creare un oggetto che contiene tutte le informazioni rilevanti necessarie per la generazione del proxy utilizzato per effettuare la comunicazione con un oggetto remoto.Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Ereditato da MarshalByRefObject)
Dispose()

Rilascia tutte le risorse usate da TraceListener.Releases all resources used by the TraceListener.

(Ereditato da TraceListener)
Dispose(Boolean)

Rilascia le risorse non gestite usate da TraceListener e facoltativamente rilascia le risorse gestite.Releases the unmanaged resources used by the TraceListener and optionally releases the managed resources.

(Ereditato da TraceListener)
Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Fail(String)

Genera un messaggio di errore nel listener creato durante l'implementazione della classe TraceListener.Emits an error message to the listener you create when you implement the TraceListener class.

(Ereditato da TraceListener)
Fail(String, String)

Genera un messaggio di errore e un messaggio di errore dettagliato nel listener creato durante l'implementazione della classe TraceListener.Emits an error message and a detailed error message to the listener you create when you implement the TraceListener class.

(Ereditato da TraceListener)
Flush()

Quando se ne esegue l'override in una classe derivata, scarica il buffer di output.When overridden in a derived class, flushes the output buffer.

(Ereditato da TraceListener)
GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetLifetimeService()

Consente di recuperare l'oggetto servizio di durata corrente per controllare i criteri di durata per l'istanza.Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
GetSupportedAttributes()

Ottiene gli attributi personalizzati supportati dal listener di traccia.Gets the custom attributes supported by the trace listener.

(Ereditato da TraceListener)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
InitializeLifetimeService()

Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza.Obtains a lifetime service object to control the lifetime policy for this instance.

(Ereditato da MarshalByRefObject)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
MemberwiseClone(Boolean)

Crea una copia dei riferimenti dell'oggetto MarshalByRefObject corrente.Creates a shallow copy of the current MarshalByRefObject object.

(Ereditato da MarshalByRefObject)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)

Scrive le informazioni di traccia, un oggetto dati e le informazioni di evento nell'output specifico del listener.Writes trace information, a data object and event information to the listener specific output.

(Ereditato da TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])

Scrive le informazioni di traccia, una matrice di oggetti dati e le informazioni di evento nell'output specifico del listener.Writes trace information, an array of data objects and event information to the listener specific output.

(Ereditato da TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32)

Scrive le informazioni di traccia e di evento nell'output specifico del listener.Writes trace and event information to the listener specific output.

(Ereditato da TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)

Scrive un messaggio di evento in una pagina Web oppure in un visualizzatore di traccia ASP.NET utilizzando i dati di evento e di sistema specificati.Writes an event message to a Web page or to the ASP.NET trace viewer using the specified system and event data.

TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])

Scrive un messaggio di evento localizzato in una pagina Web oppure in un visualizzatore di traccia ASP.NET utilizzando i dati di evento e di sistema specificati.Writes a localized event message to a Web page or to the ASP.NET trace viewer using the specified system and event data.

TraceTransfer(TraceEventCache, String, Int32, String, Guid)

Scrive le informazioni di traccia, un messaggio, l'identità di un'attività correlata e le informazioni di evento nell'output specifico del listener.Writes trace information, a message, a related activity identity and event information to the listener specific output.

(Ereditato da TraceListener)
Write(Object)

Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Ereditato da TraceListener)
Write(Object, String)

Scrive un nome di categoria e il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class.

(Ereditato da TraceListener)
Write(String)

Scrive un messaggio in una pagina Web oppure in un visualizzatore di traccia ASP.NET.Writes a message to a Web page or to the ASP.NET trace viewer.

Write(String, String)

Scrive un nome della categoria e un messaggio in una pagina Web oppure in un visualizzatore di traccia ASP.NET.Writes a category name and a message to a Web page or to the ASP.NET trace viewer.

WriteIndent()

Inserisce il rientro nel listener creato quando si implementa questa classe e reimposta la proprietà NeedIndent su false.Writes the indent to the listener you create when you implement this class, and resets the NeedIndent property to false.

(Ereditato da TraceListener)
WriteLine(Object)

Scrive il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener, seguito da un terminatore di riga.Writes the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Ereditato da TraceListener)
WriteLine(Object, String)

Scrive un nome di categoria e il valore del metodo ToString() dell'oggetto nel listener creato durante l'implementazione della classe TraceListener, seguito da un terminatore di riga.Writes a category name and the value of the object's ToString() method to the listener you create when you implement the TraceListener class, followed by a line terminator.

(Ereditato da TraceListener)
WriteLine(String)

Scrive un messaggio in una pagina Web oppure in un visualizzatore di traccia ASP.NET.Writes a message to a Web page or to the ASP.NET trace viewer.

WriteLine(String, String)

Scrive un nome della categoria e un messaggio in una pagina Web oppure in un visualizzatore di traccia ASP.NET.Writes a category name and a message to a Web page or to the ASP.NET trace viewer.

Si applica a

Vedi anche