Code tracing

Sample description

You can use the method :Trace() in your CXP code to output tracing information to a debug console. The trace messages can then be viewed using utilities such as DbgView. DbgView is published by Microsoft Technet. The CXP infrastructure also features a built-in tracing mechanism which prints state information to the debug console while processing your CXP page. This trace output contains vital information for debugging.

Directive #page directive

Run in new tab

Live editor

<html lang="en">
<head>
 <title>Code tracing | Xbase++ | Alaska Software</title>
</head>
<body>
<h3>Trace <CXP/> code execution</h3>

Code tracing is turned off by default. For this page, however,
 code tracing has been turned on by setting the page trace directive to "yes".
 Note, a page directive needs to be placed at the beginning of your
 <CXP/> file!

<code>
 <%#Page trace="yes"%>
</code>

 To view the trace output, start DebugView on your workstation. In the
 event that you have not installed DebugView yet, you can download
 the utility from here:
 <a href="http://download.sysinternals.com/files/DebugView.zip">
 http://download.sysinternals.com/files/DebugView.zip
 </a>


 Alternatively, you can execute DebugView directly from live.sysinternals.com. 
 <a href="http://live.sysinternals.com/Dbgview.exe">
 Click here to run DebugView now!
 </a>


 Note that security settings may require you to be logged in as an Administrator.
 If errors occur when running DebugView or when enabling tracing, use the "Run as
 Administrator" option to run DebugView, or if you are using Windows Vista or above,
 disable User Account Control (UAC).


 More details about what DebugView is all about can be found
 <a href="http://technet.microsoft.com/en-us/sysinternals/bb896647">here</a>.


 Once the DbgView utility has been started, start capturing of trace events
 by enabling Capture -> Global Win32 Events in the menubar.

 Afterwards, any trace output made during page execution will become visible
 in the log. Just reload/refresh the <CXP/> page and you will see the trace
 data. In fact, tracing is a great tool for monitoring page execution and for
 outputting debug information.

<%
 // Parameters of arbitrary type can be passed to
 // the :Trace() method. The corresponding values
 // will be inserted into the trace log as text.
 ::Trace( "TRACING.CXP " )
 ::Trace( {Date(), Time()} )
%>

</body>
</html>

                    Result
                    built with V2 2156
                

Code tracing

Related articles: