SPDiagnosticsService.SetItem - Méthode (IDiagnosticsLevel, TraceSeverity, EventSeverity)

Article
10/14/2015

Remarque : cette API est désormais obsolète.

Définit les seuils de déclaration pour une catégorie qui est spécifié par un objet IDiagnosticsLevel .

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

Syntaxe

'Déclaration
<ObsoleteAttribute("directly modify severities on SPDiagnosticsCategory")> _
Public Sub SetItem ( _
    item As IDiagnosticsLevel, _
    traceSeverity As TraceSeverity, _
    eventSeverity As EventSeverity _
)
'Utilisation
Dim instance As SPDiagnosticsService
Dim item As IDiagnosticsLevel
Dim traceSeverity As TraceSeverity
Dim eventSeverity As EventSeverity

instance.SetItem(item, traceSeverity, _
    eventSeverity)

[ObsoleteAttribute("directly modify severities on SPDiagnosticsCategory")]
public void SetItem(
    IDiagnosticsLevel item,
    TraceSeverity traceSeverity,
    EventSeverity eventSeverity
)

Paramètres

item
Type : Microsoft.SharePoint.Administration.IDiagnosticsLevel

Un objet IDiagnosticsLevel

traceSeverity
Type : Microsoft.SharePoint.Administration.TraceSeverity

Une valeur TraceSeverity qui représente l'événement le moins critique à signaler dans le journal des traces.

eventSeverity
Type : Microsoft.SharePoint.Administration.EventSeverity

Une valeur EventSeverity qui représente l'événement le moins critique à signaler dans le journal des événements Windows.

Remarques

Utilisez cette méthode pour contrôler le seuil pour la capture d'une seule catégorie d'événements dans les journaux de suivi et dans le journal des événements Windows. Plus le niveau de gravité diminue, le nombre d'événements journalisés augmente.

Notes

Cette méthode fournit un moyen d'accomplir ce que vous pouvez faire manuellement dans la section Limitation des événements dans la page Administration centrale d'Enregistrement des Diagnostics par programmation. Dans l'interface utilisateur, sélectionnez la catégorie, puis sélectionnez les niveaux de gravité.

Exemples

L'exemple suivant montre une application de console qui change les seuils de déclaration pour la catégorie de Service de journalisation unifiée.

Imports System
Imports Microsoft.SharePoint
Imports Microsoft.SharePoint.Administration

Module ConsoleApp

   Sub Main()

      Dim diagnostics As SPDiagnosticsService = SPDiagnosticsService.Local
      If Not diagnostics Is Nothing Then
         Dim category As IDiagnosticsLevel = diagnostics.GetItem("Unified Logging Service")
         If Not category Is Nothing Then
            diagnostics.SetItem(category, TraceSeverity.Verbose, EventSeverity.Error)
            diagnostics.Update()
         End If
      End If
   End Sub

End Module

using System;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Administration;

namespace Test
{
   class ConsoleApp
   {
      static void Main(string[] args)
      {
         SPDiagnosticsService diagnostics = SPDiagnosticsService.Local;
         if (diagnostics != null)
         {
            IDiagnosticsLevel category = diagnostics.GetItem("Unified Logging Service");
            if (category != null)
            {
               diagnostics.SetItem(category, TraceSeverity.Verbose, EventSeverity.Error);
               diagnostics.Update();
            }
         }
      }
   }
}