SPDiagnosticsServiceBase.WriteTrace - Méthode

Écrit une trace dans le journal de suivi Microsoft SharePoint Foundation .

Espace de noms :  Microsoft.SharePoint.Administration
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

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

Paramètres

• id
  Type : System.UInt32

  L'identificateur défini par l'application pour la trace.

• category
  Type : Microsoft.SharePoint.Administration.SPDiagnosticsCategory

  La catégorie de la trace.

• severity
  Type : Microsoft.SharePoint.Administration.TraceSeverity

  La gravité de la trace.

• output
  Type : System.String

  Le message. Le cas échéant, le message peut contenir des espaces réservés du format, afin que la chaîne peut être transmise à System.String.Format(string, Object[]) de mise en forme.

• data
  Type : []

  Les éléments facultatifs à remplacer dans la chaîne de format message .

Remarques

Vous devez utiliser une catégorie qui est reconnue par le service. Pour obtenir un exemple montrant comment interroger un service de diagnostic pour les zones et les catégories, consultez la propriété Areas .

Gardez à l'esprit que si vous transmettez une valeur dans le paramètre de gravité est inférieur à la valeur actuellement configurée pour la propriété TraceSeverity de la catégorie, la trace n'est pas écrit dans le journal.

Exemples

L'exemple suivant est une application de console qui écrit un message de test dans le journal de suivi.

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

Voir aussi

Référence

SPDiagnosticsServiceBase classe

SPDiagnosticsServiceBase - Membres

Microsoft.SharePoint.Administration - Espace de noms

Areas