SPDiagnosticsService.GetItem-Methode (String)

Artikel
05/06/2015

HINWEIS: Diese API ist veraltet.

Gibt ein IDiagnosticsLevel -Objekt, das eine Berichterstellung Kategorie mit einem angegebenen Namen darstellt.

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

Syntax

'Declaration
<ObsoleteAttribute("Use SPDiagnosticsServiceBase.Categories")> _
Public Function GetItem ( _
    name As String _
) As IDiagnosticsLevel
'Usage
Dim instance As SPDiagnosticsService
Dim name As String
Dim returnValue As IDiagnosticsLevel

returnValue = instance.GetItem(name)

[ObsoleteAttribute("Use SPDiagnosticsServiceBase.Categories")]
public IDiagnosticsLevel GetItem(
    string name
)

Parameter

name
Typ: System.String

Ein String -Objekt, das den Namen einer reporting Kategorie enthält.

Rückgabewert

Typ: Microsoft.SharePoint.Administration.IDiagnosticsLevel
Ein IDiagnosticsLevel -Objekt, das eine Berichterstellung Kategorie darstellt. Wenn Sie eine Kategorie mit dem angegebenen Namen nicht in der Farm registriert ist, gibt die Methode ein Nullverweis (Nothing in Visual Basic)zurück.

Implementiert

IDiagnosticsManager.GetItem(String)

Hinweise

Die als Argument übergebene Zeichenfolge kann es sich um einen lokalisierten Kategorienamen (der Wert der Eigenschaft IDiagnosticsLevel.Name ) oder eine nicht lokalisierte Kategoriename (der Wert der Eigenschaft IDiagnosticsLevel.Id ) sein. Mit dem nicht lokalisierten Namen ist Ihr Code in Gebietsschemas portierbar.

Beispiele

Das folgende Beispiel zeigt eine Konsolenanwendung, die Informationen zur Laufzeit Kategorie in der Konsole gedruckt.

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

Module ConsoleApp

   Sub Main()

      Dim diagnostics As SPDiagnosticsService = SPDiagnosticsService.Local
      If diagnostics Is Nothing Then
         Console.WriteLine("You are not connected to a front-end server.")
      Else
         Dim level As IDiagnosticsLevel = diagnostics.GetItem("Runtime")
         If Not level Is Nothing Then
            Console.WriteLine("Category name (localized): {0}", level.Name)
            Console.WriteLine("Category name (not localized): {0}", level.Id)
            Console.WriteLine("Least critical event to report to the event log: {0}", _
                              level.EventSeverity.ToString())
            Console.WriteLine("Least critical event to report to the trace log: {0}", _
                               level.TraceSeverity.ToString())
         End If
      End If

      Console.Write(vbCrLf + "Press ENTER to continue...")
      Console.ReadLine()
   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)
         {
            Console.WriteLine("You are not connected to a front-end server.");
         }
         else
         {
            IDiagnosticsLevel level = diagnostics.GetItem("Runtime");
            if (level != null)
            {
               Console.WriteLine("Category name (localized): {0}", level.Name);
               Console.WriteLine("Category name (not localized): {0}", level.Id);
               Console.WriteLine("Least critical event to report to the event log: {0}", 
                                 level.EventSeverity.ToString());
               Console.WriteLine("Least critical event to report to the trace log: {0}", 
                                 level.TraceSeverity.ToString());
            }
         }
         Console.Write("\nPress ENTER to continue...");
         Console.ReadLine();
      }
   }
}