SPDiagnosticsServiceBase.WriteTrace method

Artigo
05/12/2015

Grava um rastreamento para o log de rastreamento de Microsoft SharePoint Foundation .

Namespace: Microsoft.SharePoint.Administration
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)

Syntax

'Declaração
Public Sub WriteTrace ( _
    id As UInteger, _
    category As SPDiagnosticsCategory, _
    severity As TraceSeverity, _
    output As String, _
    ParamArray data As Object() _
)
'Uso
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
)

Parâmetros

id
Type: System.UInt32

O identificador definido pelo aplicativo para o rastreamento.

category
Type: Microsoft.SharePoint.Administration.SPDiagnosticsCategory

A categoria do rastreamento.

severity
Type: Microsoft.SharePoint.Administration.TraceSeverity

A gravidade do rastreamento.

output
Type: System.String

A mensagem. Opcionalmente, a mensagem pode conter espaços reservados de formato para que a seqüência de caracteres pode ser passada para System.String.Format(string, Object[]) de formatação.

data
Type: []

Os itens opcionais a ser substituído na seqüência de formato de message .

Comentários

Você deve usar uma categoria que é reconhecida pelo serviço. Para obter um exemplo mostrando como consultar um serviços de diagnóstico para áreas e categorias, consulte a propriedade Areas .

Tenha em mente que, se você passar um valor no parâmetro de gravidade é menor que o valor configurado no momento para a propriedade de TraceSeverity da categoria, o rastreamento não será gravado no log.

Examples

O exemplo a seguir é um aplicativo de console que grava uma mensagem de teste no log de rastreamento.

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();
        }
    }
}

Ver também

Referência

SPDiagnosticsServiceBase class

SPDiagnosticsServiceBase members

Microsoft.SharePoint.Administration namespace

Areas

Compartilhar via