Page.Trace Property (System.Web.UI)

Trace Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 11/.NET Framework 4.5

Other versions are also available for the following:

.NET Framework Class Library

Page..::.Trace Property

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Gets the TraceContext object for the current Web request.

Namespace: System.Web.UI
Assembly: System.Web (in System.Web.dll)

Syntax

Visual Basic

<BrowsableAttribute(False)> _
Public ReadOnly Property Trace As TraceContext

[BrowsableAttribute(false)]
public TraceContext Trace { get; }

Visual C++

[BrowsableAttribute(false)]
public:
property TraceContext^ Trace {
	TraceContext^ get ();
}

[<BrowsableAttribute(false)>]
member Trace : TraceContext

Property Value

Type: System.Web..::.TraceContext
Data from the TraceContext object for the current Web request.

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.

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.

Visual Basic

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

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

Version Information

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

Platforms

Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Reference

Page Class

System.Web.UI Namespace

TraceContext

Other Resources

@ Page

ASP.NET Tracing Overview