Page.Trace Property (System.Web.UI)

Trace Property

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

Page..::.Trace Property

Gets the TraceContext object for the current Web request.

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

Syntax

Visual Basic (Declaration)

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

Visual Basic (Usage)

Dim instance As Page
Dim value As TraceContext

value = instance.Trace

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

Visual C++

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

JScript

public function get 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());
  }
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

Version Information

.NET Framework

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

Reference

Page Class

Page Members

System.Web.UI Namespace

TraceContext

Other Resources

@ Page

ASP.NET Tracing Overview