SPDiagnosticsService.SetItem-Methode (IDiagnosticsLevel, TraceSeverity, EventSeverity)

Artikel
05/06/2015

HINWEIS: Diese API ist veraltet.

Legt die Berichterstellung Schwellenwerte für eine Kategorie, die durch ein IDiagnosticsLevel -Objekt angegeben ist.

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

Syntax

'Declaration
<ObsoleteAttribute("directly modify severities on SPDiagnosticsCategory")> _
Public Sub SetItem ( _
    item As IDiagnosticsLevel, _
    traceSeverity As TraceSeverity, _
    eventSeverity As EventSeverity _
)
'Usage
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
)

Parameter

item
Typ: Microsoft.SharePoint.Administration.IDiagnosticsLevel

Ein IDiagnosticsLevel -Objekt

traceSeverity
Typ: Microsoft.SharePoint.Administration.TraceSeverity

Ein TraceSeverity -Wert, der Bericht in das Ablaufverfolgungsprotokoll aufzuzeichnendes Ereignis darstellt.

eventSeverity
Typ: Microsoft.SharePoint.Administration.EventSeverity

Ein EventSeverity -Wert, der Bericht im Windows-Ereignisprotokoll aufzuzeichnendes Ereignis darstellt.

Hinweise

Verwenden Sie diese Methode, um den Schwellenwert für das Aufzeichnen von Ereignissen in Ablaufverfolgungsprotokollen und im Windows-Ereignisprotokoll einer einzelnen Kategorie steuern. Der Schweregrad verringert, erhöht die Anzahl der Ereignisse protokolliert.

Hinweis

Diese Methode bietet die programmgesteuerte erledigen, was Sie manuell im Abschnitt Ereignissteuerung auf der Seite Zentraladministration Diagnoseprotokoll möglich ist. Klicken Sie auf der Benutzeroberfläche wählen Sie die Kategorie, und wählen Sie dann Schweregrade.

Beispiele

Das folgende Beispiel zeigt eine Konsolenanwendung, die die Berichterstellung Schwellenwerte für die Kategorie Unified Logging Service ändert.

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