WebPageTraceListener Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un listener che indirizza i Trace messaggi agli output di ASP.NET pagina Web.
public ref class WebPageTraceListener : System::Diagnostics::TraceListenerpublic class WebPageTraceListener : System.Diagnostics.TraceListenertype WebPageTraceListener = class
inherit TraceListenerPublic Class WebPageTraceListener
Inherits TraceListener- Ereditarietà
Esempio
Nell'esempio di codice seguente viene illustrato come instradare Trace i messaggi all'output del modulo Web. Nell'esempio di codice viene illustrato un tipico modulo Web contenente un BulletedList controllo e AccessDataSource . La traccia è abilitata nel Modulo Web e l'output di traccia viene aggiunto al modulo Web quando ne viene eseguito il rendering. È possibile esaminare i messaggi di traccia nella tabella Delle informazioni di traccia dell'output di traccia. Se è WebPageTraceListener stato abilitato correttamente nel file di configurazione, vengono visualizzati entrambi i messaggi di traccia con la categoria "Trace Test". Tuttavia, se non è stato abilitato , WebPageTraceListenerviene visualizzato solo il messaggio di traccia scritto nell'oggetto 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>
Commenti
Annotazioni
L'attributo HostProtectionAttribute applicato a questa classe ha il valore della proprietà seguente Resources : Synchronization. Non HostProtectionAttribute influisce sulle applicazioni desktop (che in genere vengono avviate facendo doppio clic su un'icona, digitando un comando o immettendo un URL in un browser). Per altre informazioni, vedere la HostProtectionAttribute classe o gli attributi di programmazione e protezione host di SQL Server.
La WebPageTraceListener classe inoltra i messaggi di traccia scritti nel Trace log per ASP.NET canali di output della pagina Web. È possibile abilitare l'inoltro di traccia aggiungendo un WebPageTraceListener oggetto al file Web.config come listener nella sottosezione Elemento di traccia (schema impostazioni ASP.NET) della <sezione system.diagnostics> . È anche possibile aggiungere un oggetto WebPageTraceListener alla raccolta listener a livello di codice. In genere, questa operazione viene eseguita aggiungendo un WebPageTraceListener oggetto alla raccolta durante l'avvio dell'applicazione, usando il Application_Start metodo nel file Global.asax.
Costruttori
| Nome | Descrizione |
|---|---|
| WebPageTraceListener() |
Inizializza una nuova istanza della classe WebPageTraceListener. |
Proprietà
| Nome | Descrizione |
|---|---|
| Attributes |
Ottiene gli attributi del listener di traccia personalizzati definiti nel file di configurazione dell'applicazione. (Ereditato da TraceListener) |
| Filter |
Ottiene o imposta il filtro di traccia per il listener di traccia. (Ereditato da TraceListener) |
| IndentLevel |
Ottiene o imposta il livello di rientro. (Ereditato da TraceListener) |
| IndentSize |
Ottiene o imposta il numero di spazi in un rientro. (Ereditato da TraceListener) |
| IsThreadSafe |
Ottiene un valore che indica se il listener di traccia è thread-safe. (Ereditato da TraceListener) |
| Name |
Ottiene o imposta un nome per l'oggetto TraceListener. (Ereditato da TraceListener) |
| NeedIndent |
Ottiene o imposta un valore che indica se impostare il rientro dell'output. (Ereditato da TraceListener) |
| TraceOutputOptions |
Ottiene o imposta le opzioni di output della traccia. (Ereditato da TraceListener) |
Metodi
| Nome | Descrizione |
|---|---|
| Close() |
Quando sottoposto a override in una classe derivata, chiude il flusso di output in modo che non riceva più l'output di traccia o debug. (Ereditato da TraceListener) |
| CreateObjRef(Type) |
Crea un oggetto che contiene tutte le informazioni pertinenti necessarie per generare un proxy utilizzato per comunicare con un oggetto remoto. (Ereditato da MarshalByRefObject) |
| Dispose() |
Rilascia tutte le risorse usate da TraceListener. (Ereditato da TraceListener) |
| Dispose(Boolean) |
Rilascia le risorse non gestite usate da TraceListener e, facoltativamente, rilascia le risorse gestite. (Ereditato da TraceListener) |
| Equals(Object) |
Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object) |
| Fail(String, String) |
Genera un messaggio di errore e un messaggio di errore dettagliato al listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Fail(String) |
Genera un messaggio di errore al listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Flush() |
Quando sottoposto a override in una classe derivata, scarica il buffer di output. (Ereditato da TraceListener) |
| GetHashCode() |
Funge da funzione hash predefinita. (Ereditato da Object) |
| GetLifetimeService() |
Obsoleti.
Recupera l'oggetto servizio di durata corrente che controlla i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| GetSupportedAttributes() |
Ottiene gli attributi personalizzati supportati dal listener di traccia. (Ereditato da TraceListener) |
| GetType() |
Ottiene il Type dell'istanza corrente. (Ereditato da Object) |
| InitializeLifetimeService() |
Obsoleti.
Ottiene un oggetto servizio di durata per controllare i criteri di durata per questa istanza. (Ereditato da MarshalByRefObject) |
| MemberwiseClone() |
Crea una copia superficiale del Objectcorrente. (Ereditato da Object) |
| MemberwiseClone(Boolean) |
Crea una copia superficiale dell'oggetto corrente MarshalByRefObject . (Ereditato da MarshalByRefObject) |
| ToString() |
Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object) |
Scrive informazioni di traccia, un oggetto dati e informazioni sugli eventi nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceData(TraceEventCache, String, TraceEventType, Int32, Object[]) |
Scrive informazioni di traccia, una matrice di oggetti dati e informazioni sugli eventi nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[]) |
Scrive un messaggio di evento localizzato in una pagina Web o nel visualizzatore di traccia ASP.NET utilizzando i dati di sistema e di evento specificati. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32, String) |
Scrive un messaggio di evento in una pagina Web o nel visualizzatore di traccia ASP.NET utilizzando i dati di sistema ed eventi specificati. |
| TraceEvent(TraceEventCache, String, TraceEventType, Int32) |
Scrive le informazioni di traccia e evento nell'output specifico del listener. (Ereditato da TraceListener) |
| TraceTransfer(TraceEventCache, String, Int32, String, Guid) |
Scrive informazioni di traccia, un messaggio, un'identità di attività correlata e informazioni sugli eventi nell'output specifico del listener. (Ereditato da TraceListener) |
| Write(Object, String) |
Scrive un nome di categoria e il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(Object) |
Scrive il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe . (Ereditato da TraceListener) |
| Write(String, String) |
Scrive un nome di categoria e un messaggio in una pagina Web o nel visualizzatore di traccia ASP.NET. |
| Write(String) |
Scrive un messaggio in una pagina Web o nel visualizzatore di traccia ASP.NET. |
| WriteIndent() |
Scrive il rientro nel listener creato quando si implementa questa classe e la proprietà viene reimpostata NeedIndent su |
| WriteLine(Object, String) |
Scrive un nome di categoria e il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe, seguita da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(Object) |
Scrive il valore del metodo dell'oggetto ToString() nel listener creato quando si implementa la TraceListener classe, seguita da un terminatore di riga. (Ereditato da TraceListener) |
| WriteLine(String, String) |
Scrive un nome di categoria e un messaggio in una pagina Web o nel visualizzatore di traccia ASP.NET. |
| WriteLine(String) |
Scrive un messaggio in una pagina Web o nel visualizzatore di traccia ASP.NET. |
