Метод SPDiagnosticsServiceBase.WriteTrace

Статья
05/13/2015

Записывает данные трассировки в журнал трассировки Microsoft SharePoint Foundation .

Пространство имен: Microsoft.SharePoint.Administration
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Sub WriteTrace ( _
    id As UInteger, _
    category As SPDiagnosticsCategory, _
    severity As TraceSeverity, _
    output As String, _
    ParamArray data As Object() _
)
'Применение
Dim instance As SPDiagnosticsServiceBase
Dim id As UInteger
Dim category As SPDiagnosticsCategory
Dim severity As TraceSeverity
Dim output As String
Dim data As Object()

instance.WriteTrace(id, category, severity, _
    output, data)

public void WriteTrace(
    uint id,
    SPDiagnosticsCategory category,
    TraceSeverity severity,
    string output,
    params Object[] data
)

Параметры

id
Тип: System.UInt32

Определенная приложением идентификатор трассировки.

category
Тип: Microsoft.SharePoint.Administration.SPDiagnosticsCategory

Категория трассировки.

severity
Тип: Microsoft.SharePoint.Administration.TraceSeverity

Уровень серьезности трассировки.

output
Тип: System.String

Сообщение. Кроме того сообщение может содержать заполнители формата, чтобы строка может быть передан System.String.Format(string, Object[]) для форматирования.

data
Тип: []

Дополнительные элементы для замены в строку формата message .

Замечания

Необходимо использовать категории, распознаваемых службу. Пример, в котором показано, как выполнить запрос службы диагностики для областей и категорий Areas см.

Имейте в виду, что если передать значение с помощью параметра уровень серьезности , который меньше, чем значение для свойства TraceSeverity категории трассировки не записываются в журнал.

Примеры

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

using System;
using Microsoft.SharePoint.Administration;

namespace ConsoleApp
{
    class Program
    {
        static void Main(string[] args)
        {
            SPDiagnosticsService diagnosticsService = SPDiagnosticsService.Local;
            SPDiagnosticsCategory cat = diagnosticsService.Areas["SharePoint Foundation"].Categories["Unknown"];

            string format = "Test trace logging for category {0} in area {1}";
            diagnosticsService.WriteTrace(1, cat, TraceSeverity.Medium, format, cat.Name, cat.Area.Name);

            Console.WriteLine(format, cat.Name, cat.Area.Name);
            Console.ReadLine();
        }
    }
}

См. также

Справочные материалы

SPDiagnosticsServiceBase класс

Элементы SPDiagnosticsServiceBase

Пространство имен Microsoft.SharePoint.Administration

Areas

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