Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

Page.Trace Property

Gets the TraceContext object for the current Web request.

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

public TraceContext Trace { get; }
/** @property */
public TraceContext get_Trace ()

public function get Trace () : TraceContext

Not applicable.

Property Value

Data from the TraceContext object for the current Web request.

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.

The following code example demonstrates accessing the System.Web.TraceContext.IsEnabled property and the System.Web.TraceContext.Write(System.String) 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 (get_Trace().get_IsEnabled()) {
    for (int i=0;
        i<ds.get_Tables().get_Item("Categories").get_Rows().
        get_Count();i++) {
        get_Trace().Write("ProductCategory",
            (String)ds.get_Tables().get_Item("Categories").
            get_Rows().get_Item(i).get_Item(0));
    }
}

Windows 98, Windows Server 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

Show:
© 2014 Microsoft