SPDiagnosticsServiceBase.WriteTrace-Methode

Schreibt eine Ablaufverfolgung für das Ablaufverfolgungsprotokoll Microsoft SharePoint Foundation .

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

Syntax

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

Parameter

• id
  Typ: System.UInt32

  Der anwendungsdefinierte Bezeichner für die Ablaufverfolgung.

• category
  Typ: Microsoft.SharePoint.Administration.SPDiagnosticsCategory

  Die Kategorie der Ablaufverfolgung.

• severity
  Typ: Microsoft.SharePoint.Administration.TraceSeverity

  Der Schweregrad der Ablaufverfolgung.

• output
  Typ: System.String

  Die Nachricht. Die Meldung kann optional Formatplatzhalter enthalten, damit die Zeichenfolge für die Formatierung an System.String.Format(string, Object[]) übergeben werden kann.

• data
  Typ: []

  Die optionalen Elemente in die Formatzeichenfolge message ersetzt werden.

Hinweise

Sie müssen eine Kategorie verwenden, die vom Dienst erkannt wird. Ein Beispiel, das zeigt, wie Sie eine Diagnosedienste für Bereiche und Kategorien Abfragen finden Sie unter der Areas -Eigenschaft.

Berücksichtigen Sie, wenn Sie einen Wert in der Schweregrad -Parameter, die kleiner als die aktuell konfigurierte Wert für die Kategorie TraceSeverity -Eigenschaft ist übergeben, wird die Ablaufverfolgung nicht in das Protokoll geschrieben.

Beispiele

Das folgende Beispiel ist eine Konsolenanwendung, die eine Testnachricht in das Ablaufprotokoll geschrieben.

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

Siehe auch

Referenz

SPDiagnosticsServiceBase Klasse

SPDiagnosticsServiceBase-Member

Microsoft.SharePoint.Administration-Namespace

Areas