WebPageTraceListener Класс

Определение

Пространство имен:: System.Web

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет прослушиватель, который направляет Trace сообщения на ASP.NET выходные данные веб-страницы.

public ref class WebPageTraceListener : System::Diagnostics::TraceListener

public class WebPageTraceListener : System.Diagnostics.TraceListener

type WebPageTraceListener = class
    inherit TraceListener

Public Class WebPageTraceListener
Inherits TraceListener

Наследование: Object

MarshalByRefObject

TraceListener
WebPageTraceListener

Примеры

В следующем примере кода показано, как направлять Trace сообщения в выходные данные веб-формы. В примере кода показана типичная веб-форма, BulletedList содержащая элемент управления и AccessDataSource элемент управления. Трассировка включена в веб-форме и выходные данные трассировки добавляются в веб-форму при отрисовке. Вы можете проверить сообщения трассировки в таблице сведений о трассировке выходных данных трассировки. Если вы включили правильное WebPageTraceListener использование файла конфигурации, вы увидите оба сообщения трассировки с категорией "Trace Test". Однако если вы не включили WebPageTraceListenerэтот параметр, отображается только сообщение трассировки, записанное в TraceContext объект.

<%@ Page language="C#" trace="true" %>

<script runat="server">
private void page_load(object sender, EventArgs e) {
    
    Trace.Write("Trace Test","This message is written with the TraceContext object.");

    System.Diagnostics.Trace.WriteLine("This message is forwarded to the TraceContext from System.Diagnostics using the WebPageTraceListener.");
}
</script>
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
    <title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">

<asp:GridView 
  id="GridView1"
  runat="server"
  datasourceid="AccessDataSource1"/>

<asp:AccessDataSource 
  id="AccessDataSource1"
  runat="server"
  datafile="Northwind.mdb"
  selectcommand="SELECT * FROM employees"/>

</form>
</body>
</html>

<%@ Page language="VB" trace="true" %>

<script runat="server">
Private Sub Page_Load(sender As Object, e As EventArgs)
    
    Trace.Write("Trace Test","This message is written with the System.Web.TraceContext object.")

    System.Diagnostics.Trace.Write("Trace Test", "This message is forwarded to the TraceContext from System.Diagnostics using the WebPageTraceListener.")

End Sub ' Page_Load
</script>

<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>ASP.NET Example</title>
</head>
<body>
<form id="Form1" runat="server">

<asp:GridView 
  id="GridView1"
  runat="server"
  datasourceid="AccessDataSource1"/>

<asp:AccessDataSource 
  id="AccessDataSource1"
  runat="server"
  datafile="Northwind.mdb"
  selectcommand="SELECT * FROM employees"/>
</form>
</body>
</html>

Атрибут, применяемый к этому классу, имеет следующее HostProtectionAttribute Resources значение свойства: Synchronization Это HostProtectionAttribute не влияет на классические приложения (которые обычно запускаются путем двойного щелчка значка, ввода команды или ввода URL-адреса в браузере). Дополнительные сведения см. в HostProtectionAttribute разделе "Класс" или "Атрибуты защиты узлов SQL Server".

Класс WebPageTraceListener перенаправит сообщения трассировки, записанные в Trace журнал, в ASP.NET каналы вывода веб-страниц. Вы можете включить перенаправление трассировки, добавив WebPageTraceListener объект в файл Web.config в качестве прослушивателя в подразделе trace Element (ASP.NET Settings Schema) раздела <system.diagnostics> . Вы также можете добавить WebPageTraceListener коллекцию прослушивателей программным способом. Обычно это делается путем добавления WebPageTraceListener коллекции во время запуска приложения с помощью Application_Start метода в файле Global.asax.

Конструкторы

Имя	Описание
WebPageTraceListener()	Инициализирует новый экземпляр класса WebPageTraceListener.

Свойства

Имя	Описание
Attributes	Возвращает атрибуты пользовательского прослушивателя трассировки, определенные в файле конфигурации приложения. (Унаследовано от TraceListener)
Filter	Возвращает или задает фильтр трассировки для прослушивателя трассировки. (Унаследовано от TraceListener)
IndentLevel	Возвращает или задает уровень отступа. (Унаследовано от TraceListener)
IndentSize	Возвращает или задает количество пробелов в отступе. (Унаследовано от TraceListener)
IsThreadSafe	Возвращает значение, указывающее, является ли прослушиватель трассировки потокобезопасной. (Унаследовано от TraceListener)
Name	Возвращает или задает имя для этого TraceListener. (Унаследовано от TraceListener)
NeedIndent	Возвращает или задает значение, указывающее, следует ли отступить выходные данные. (Унаследовано от TraceListener)
TraceOutputOptions	Возвращает или задает параметры выходных данных трассировки. (Унаследовано от TraceListener)

Методы

Имя	Описание
Close()	При переопределении в производном классе закрывает выходной поток, чтобы он больше не получал трассировку или отладку выходных данных. (Унаследовано от TraceListener)
CreateObjRef(Type)	Создает объект, содержащий все соответствующие сведения, необходимые для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject)
Dispose()	Освобождает все ресурсы, используемые параметром TraceListener. (Унаследовано от TraceListener)
Dispose(Boolean)	Освобождает неуправляемые ресурсы, используемые TraceListener и при необходимости освобождает управляемые ресурсы. (Унаследовано от TraceListener)
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
Fail(String, String)	Выдает сообщение об ошибке и подробное сообщение об ошибке прослушивателю, создаваемому TraceListener при реализации класса. (Унаследовано от TraceListener)
Fail(String)	Выдает сообщение об ошибке прослушивателю, создаваемому при реализации TraceListener класса. (Унаследовано от TraceListener)
Flush()	При переопределении в производном классе очищает выходной буфер. (Унаследовано от TraceListener)
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetLifetimeService()	Устаревшие.. Извлекает текущий объект службы времени существования, который управляет политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
GetSupportedAttributes()	Возвращает настраиваемые атрибуты, поддерживаемые прослушивателем трассировки. (Унаследовано от TraceListener)
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
InitializeLifetimeService()	Устаревшие.. Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject)
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
MemberwiseClone(Boolean)	Создает неглубокую копию текущего MarshalByRefObject объекта. (Унаследовано от MarshalByRefObject)
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object)	Записывает сведения трассировки, объект данных и сведения о событии в конкретный выход прослушивателя. (Унаследовано от TraceListener)
TraceData(TraceEventCache, String, TraceEventType, Int32, Object[])	Записывает сведения трассировки, массив объектов данных и сведений о событиях в конкретный выходной объект прослушивателя. (Унаследовано от TraceListener)
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String, Object[])	Записывает локализованное сообщение о событии на веб-страницу или в средство просмотра трассировки ASP.NET с помощью указанных системных и данных событий.
TraceEvent(TraceEventCache, String, TraceEventType, Int32, String)	Записывает сообщение о событии на веб-страницу или в средство просмотра трассировки ASP.NET с помощью указанных системных и данных событий.
TraceEvent(TraceEventCache, String, TraceEventType, Int32)	Записывает данные трассировки и события в конкретный выход прослушивателя. (Унаследовано от TraceListener)
TraceTransfer(TraceEventCache, String, Int32, String, Guid)	Записывает сведения трассировки, сообщение, связанное удостоверение действия и сведения о событиях прослушивателя в определенные выходные данные прослушивателя. (Унаследовано от TraceListener)
Write(Object, String)	Записывает имя категории и значение метода объекта ToString() в прослушиватель, который вы создаете при реализации TraceListener класса. (Унаследовано от TraceListener)
Write(Object)	Записывает значение метода объекта ToString() в прослушиватель, который вы создаете при реализации TraceListener класса. (Унаследовано от TraceListener)
Write(String, String)	Записывает имя категории и сообщение на веб-страницу или в средство просмотра трассировки ASP.NET.
Write(String)	Записывает сообщение на веб-страницу или в средство просмотра трассировки ASP.NET.
WriteIndent()	Записывает отступ в прослушиватель, который вы создаете при реализации этого класса, и сбрасывает свойство NeedIndentв `false` . (Унаследовано от TraceListener)
WriteLine(Object, String)	Записывает имя категории и значение метода объекта ToString() в прослушиватель, который вы создаете при реализации TraceListener класса, за которым следует терминатор строки. (Унаследовано от TraceListener)
WriteLine(Object)	Записывает значение метода объекта ToString() в прослушиватель, который создается при реализации TraceListener класса, за которым следует терминатор строки. (Унаследовано от TraceListener)
WriteLine(String, String)	Записывает имя категории и сообщение на веб-страницу или в средство просмотра трассировки ASP.NET.
WriteLine(String)	Записывает сообщение на веб-страницу или в средство просмотра трассировки ASP.NET.

Применяется к

См. также раздел

Обзор трассировки ASP.NET

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через