|
页输出的跟踪记录
页级跟踪使您能够在启用跟踪后将调试语句直接写入页的输出并有条件地运行调试代码。若要为页启用跟踪，请在页代码的顶部包括以下指令：
<%@ Page Trace="true"%>
跟踪语句也可以按类别组织，使用 Page ??á?μ? TraceMode 属性。如果没有定义 TraceMode 属性，默认值为
SortByTime。
<%@ Page Trace="true" TraceMode="SortByCategory"
%>
以下示例显示启用页级跟踪时的默认输出。注意，ASP.NET 将重要位置的执行时间信息插入页的执行生命周期：
| |
VB BrowsCaps.aspx
[运行示例] | [查看源代码] |
页公开 Trace 属性（TraceContext 类型），该属性可用来将调试语句输出到页输出（如果启用了跟踪）。使用
TraceContext 后，可以用 Trace.Write 和 Trace.Warn
方法写调试语句，而每个方法都采用消息字符串或类别和消息字符串。Trace.Warn 语句与 Trace.Write
语句相同，只是它们以红色输出。
|
' Trace(Message)
Trace.Write("Begging User Code...")
...
Trace.Warn("Array count is Nothing!")
' Trace(Category, Message)
Trace.Write("Custom Trace","Beginning User
Code...")
...
Trace.Warn("Custom Trace","Array count is null!")
|
禁用跟踪时（即 Page 指令上的 Trace="false" 或不存在），这些语句不运行且客户端浏览器中不显示跟踪输出。这样，就可以在生产代码中保留调试语句，并在以后有条件地启用它们。
可能经常需要运行额外的代码来构造传递到 Trace.Write 或 Trace.Warn 方法的语句；在这些方法中，仅当为页启用了跟踪时此代码才应运行。为此，Page
公开一个 Boolean 属性 Trace.IsEnabled，该属性仅在为页启用了跟踪时才返回真。应首先检查该属性，以保证调试代码只有在跟踪打开时才能运行。
|
If Trace.IsEnabled Then
For i=0 To ds.Tables("Categories").Rows.Count-1
Trace.Write("ProductCategory",ds.Tables("Categories").Rows(i)(0).ToString())
Next
End if
|
下面的示例显示如何使用 Trace.Write 和 Trace.Warn 输出调试语句。此外，还显示如何使用
Trace.IsEnabled 属性有条件地运行额外的调试代码。在此示例中，跟踪信息已经按类别排序。
| |
VB BrowsCaps.aspx
[运行示例] | [查看源代码] |
ASP.NET 还提供了为整个应用程序而不是单页启用跟踪的方法。有关应用程序级跟踪的更多信息，请单击此处。
本节小结
页级跟踪通过顶级 Page 指令上的 Trace="true" 属性启用。
页级跟踪使您能够将调试语句写为页的客户端输出的一部分。跟踪语句通过 Trace.Write 和 Trace.Warn
方法输出，并为每个语句传递类别和消息。
调试代码可以根据是否为页启用了跟踪来有条件地运行。使用页的 Trace.IsEnabled 属性确定是否启用了跟踪。
感谢2001 Microsoft Corporation教材提供 |
|
