Page.Trace Property

Definition

Gets the TraceContext object for the current Web request.

public:
 property System::Web::TraceContext ^ Trace { System::Web::TraceContext ^ get(); };
[System.ComponentModel.Browsable(false)]
public System.Web.TraceContext Trace { get; }
[<System.ComponentModel.Browsable(false)>]
member this.Trace : System.Web.TraceContext
Public ReadOnly Property Trace As TraceContext

Property Value

Data from the TraceContext object for the current Web request.

Attributes

Examples

The following code example demonstrates accessing the TraceContext.IsEnabled property and the TraceContext.Write method through the Trace property. This code calls the Write method only when tracing is enabled for the Page object. If it is not enabled, this code will not run, which can help reduce overhead for your application.

if (Trace.IsEnabled)
{
  for (int i=0; i<ds.Tables["Categories"].Rows.Count; i++)
  {
    Trace.Write("ProductCategory",ds.Tables["Categories"].Rows[i][0].ToString());
  }
}
If (Trace.IsEnabled) Then

  Dim I As Integer
  For I = 0 To DS.Tables("Categories").Rows.Count - 1

    Trace.Write("ProductCategory",DS.Tables("Categories").Rows(I)(0).ToString())
  Next
End If

Remarks

Tracing tracks and presents the execution details about a Web request. For trace data to be visible in a rendered page, you must enable tracing at the page or application level.

Tracing on a page is disabled by default. To enable tracing for a page, use the @ Page directive <% @ Page trace="true" %>. To enable tracing for an entire application, you must enable it in the application's configuration file, Web.config, which resides in the root directory of the application. For more information, see ASP.NET Tracing Overview.

Applies to

See also