Benutzerdefiniertes Logging in C# verwenden

How to use Custom Logging in C#

This article was translated from English: Does it need improvement?
Translated
View the article in English

Benutzerdefiniertes Logging bezieht sich auf die Praxis, ein Loggingsystem zu implementieren, das speziell auf die Bedürfnisse und Anforderungen einer Anwendung oder eines Systems zugeschnitten ist. Es beinhaltet das Erstellen und Verwenden von Logdateien, um Informationen, Ereignisse und Nachrichten aufzuzeichnen, die von der Software während ihres Betriebs generiert werden.

als-Überschrift:2(Schnellstart: Implementieren von benutzerdefiniertem Logging mit IronPDF)

Beginnen Sie schnell mit benutzerdefiniertem Logging in C# mit IronPDF. Dieser Leitfaden zeigt Ihnen, wie Sie den LoggingMode auf Custom setzen und ihn mit Ihrer maßgeschneiderten Logger-Klasse verknüpfen. Überwachen und verwalten Sie Ihre Anwendungsprotokolle effektiv, indem Sie IronPDF-Nachrichten an Ihren benutzerdefinierten Logger weiterleiten. Es ist einfach einzurichten und ermöglicht es Ihnen, die Protokollierungsfähigkeiten Ihrer Anwendung an Ihre einzigartigen Bedürfnisse anzupassen.

Nuget IconGet started making PDFs with NuGet now:

  1. Install IronPDF with NuGet Package Manager

    PM > Install-Package IronPdf

  2. Copy and run this code snippet.

    IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.Custom;
    IronSoftware.Logger.CustomLogger = new MyCustomLogger();
  3. Deploy to test on your live environment

    Start using IronPDF in your project today with a free trial
    arrow pointer
class="hsg-featured-snippet">

Minimaler Arbeitsablauf (5 Schritte)

  1. Laden Sie IronPDF von NuGet herunter
  2. Setzen Sie die LoggingMode-Eigenschaft auf LoggingModes.Custom
  3. Weisen Sie die CustomLogger-Eigenschaft Ihrem benutzerdefinierten Logger-Objekt zu
  4. Alle Lognachrichten werden an den benutzerdefinierten Logger weitergeleitet
  5. Geben Sie die Lognachrichten aus, um die Protokolle anzuzeigen


Beispiel für benutzerdefiniertes Logging

Um die Funktion des benutzerdefinierten Loggings zu nutzen, ändern Sie die LoggingMode-Eigenschaft auf LoggingModes.Custom. Weisen Sie anschließend die CustomLogger-Eigenschaft der von Ihnen erstellten benutzerdefinierten Logger-Klasse zu.

:path=/static-assets/pdf/content-code-examples/how-to/custom-logging-custom-logging.cs
IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.Custom;
IronSoftware.Logger.CustomLogger = new CustomLoggerClass("logging");
IronSoftware.Logger.LoggingMode = IronSoftware.Logger.LoggingModes.Custom
IronSoftware.Logger.CustomLogger = New CustomLoggerClass("logging")
$vbLabelText   $csharpLabel

IronPdf-Protokolle werden an das benutzerdefinierte Logger-Objekt weitergeleitet. Die Nachrichten bleiben identisch mit denen im IronPdf-Logger; sie werden einfach an den benutzerdefinierten Logger weitergeleitet. Wie der benutzerdefinierte Logger die Nachrichten verwaltet, wird vom Designer des benutzerdefinierten Loggers bestimmt. Lassen Sie uns die folgende benutzerdefinierte Logger-Klasse als Beispiel verwenden.

:path=/static-assets/pdf/content-code-examples/how-to/custom-logging-custom-logging-class.cs
public class CustomLoggerClass : ILogger
{
    private readonly string categoryName;

    public CustomLoggerClass(string categoryName)
    {
        this.categoryName = categoryName;
    }

    public IDisposable BeginScope<TState>(TState state)
    {
        return null;
    }

    public bool IsEnabled(LogLevel logLevel)
    {
        return true;
    }

    public void Log<TState>(LogLevel logLevel, EventId eventId, TState state, Exception exception, Func<TState, Exception, string> formatter)
    {
        if (!IsEnabled(logLevel))
        {
            return;
        }

        // Implement your custom logging logic here.
        string logMessage = formatter(state, exception);

        // You can use 'logLevel', 'eventId', 'categoryName', and 'logMessage' to log the message as needed.
        // For example, you can write it to a file, console, or another destination.

        // Example: Writing to the console
        Console.WriteLine($"[{logLevel}] [{categoryName}] - {logMessage}");
    }
}
Public Class CustomLoggerClass
	Implements ILogger

	Private ReadOnly categoryName As String

	Public Sub New(ByVal categoryName As String)
		Me.categoryName = categoryName
	End Sub

	Public Function BeginScope(Of TState)(ByVal state As TState) As IDisposable
		Return Nothing
	End Function

	Public Function IsEnabled(ByVal logLevel As LogLevel) As Boolean
		Return True
	End Function

	Public Sub Log(Of TState)(ByVal logLevel As LogLevel, ByVal eventId As EventId, ByVal state As TState, ByVal exception As Exception, ByVal formatter As Func(Of TState, Exception, String))
		If Not IsEnabled(logLevel) Then
			Return
		End If

		' Implement your custom logging logic here.
		Dim logMessage As String = formatter(state, exception)

		' You can use 'logLevel', 'eventId', 'categoryName', and 'logMessage' to log the message as needed.
		' For example, you can write it to a file, console, or another destination.

		' Example: Writing to the console
		Console.WriteLine($"[{logLevel}] [{categoryName}] - {logMessage}")
	End Sub
End Class
$vbLabelText   $csharpLabel

In diesem Fall habe ich den Lognachrichten zusätzliche Informationen vorangestellt.

class="content-img-align-center">
class="center-image-wrapper"> Konsolenfenster

Bereit zu sehen, was Sie sonst noch tun können? Schauen Sie sich unsere Tutorial-Seite hier an: Zusätzliche Funktionen

Häufig gestellte Fragen

Wie implementiere ich benutzerdefiniertes Logging in C#?

Sie können benutzerdefiniertes Logging in C# mit IronPDF implementieren. Laden Sie zuerst IronPDF von NuGet herunter, setzen Sie dann die LoggingMode-Eigenschaft auf LoggingModes.Custom und weisen Sie Ihr benutzerdefiniertes Logger-Objekt der CustomLogger-Eigenschaft zu. Diese Einrichtung stellt sicher, dass alle Logmeldungen an Ihren benutzerdefinierten Logger geleitet werden.

Welche Schritte sind nötig, um mit benutzerdefiniertem Logging in IronPDF zu starten?

Um mit benutzerdefiniertem Logging in IronPDF zu beginnen, laden Sie die Bibliothek von NuGet herunter, setzen Sie die LoggingMode-Eigenschaft auf LoggingModes.Custom, weisen Sie einen benutzerdefinierten Logger der CustomLogger-Eigenschaft zu, und stellen Sie sicher, dass alle Logmeldungen an Ihren Logger zur Ausgabe weitergeleitet werden.

Welche Rolle spielt die CustomLogger-Eigenschaft in IronPDF?

Die CustomLogger-Eigenschaft in IronPDF ermöglicht es Ihnen, ein benutzerdefiniertes Logger-Objekt zuzuweisen. Diese Funktion leitet alle Logmeldungen an den benutzerdefinierten Logger weiter, wodurch Sie verwalten können, wie Protokolle gemäß den Anforderungen Ihrer Anwendung aufgezeichnet und angezeigt werden.

Können Sie ein detailliertes Beispiel für die Einrichtung eines benutzerdefinierten Protokollierers in C# bereitstellen?

Natürlich! Um einen benutzerdefinierten Logger in C# einzurichten, müssen Sie das ILogger-Interface von IronPDF implementieren. Definieren Sie Methoden wie LogInformation, LogWarning und LogError, um verschiedene Logmeldungen zu verarbeiten, und weisen Sie dann Ihren benutzerdefinierten Logger der CustomLogger-Eigenschaft zu.

Warum sollte ich benutzerdefiniertes Logging in meiner C#-Anwendung verwenden?

Benutzerdefiniertes Logging ist in einer C#-Anwendung vorteilhaft, da es Ihnen ermöglicht, ein Protokollierungssystem zu erstellen, das Ihren spezifischen Anforderungen entspricht. Diese Anpassung verbessert die Überwachung, das Debuggen und die Wartung, indem sie detaillierte und relevante Loginformationen bereitstellt.

Was sind die Vorteile der Verwendung von benutzerdefiniertem Logging mit IronPDF?

Die Verwendung von benutzerdefiniertem Logging mit IronPDF bietet Flexibilität bei der Verwaltung von Logmeldungen. Es ermöglicht Ihnen, das Logging an die Anforderungen Ihrer Anwendung anzupassen und sicherzustellen, dass Sie Logmeldungen auf die effektivste Weise für Ihre Prozesse erfassen und verarbeiten.

Wie unterstützt das ILogger-Interface benutzerdefiniertes Logging?

Das ILogger-Interface unterstützt benutzerdefiniertes Logging, indem es eine Struktur bereitstellt, die Sie in Ihrem benutzerdefinierten Logger implementieren müssen. Es enthält Methoden zur Verarbeitung verschiedener Lognachrichtentypen und stellt sicher, dass umfassende Protokollierungsfunktionen zur Verfügung stehen.

Welche Arten von Nachrichten können mit einem benutzerdefinierten Logger in IronPDF protokolliert werden?

Ein benutzerdefinierter Logger in IronPDF kann eine Vielzahl von Logmeldungen verarbeiten, darunter Informations-, Warn- und Fehlermeldungen. Diese umfassende Protokollierungskapazität stellt sicher, dass Sie detaillierte Aufzeichnungen über die Vorgänge Ihrer Anwendung haben.

Wird die benutzerdefinierte Protokollierung von IronPDF in .NET 10 vollständig unterstützt?

Ja. IronPDF ist vollständig mit .NET 10 kompatibel, einschließlich dessen Funktionen für die benutzerdefinierte Protokollierung. Sie können LoggingModes.Custom verwenden und in einem .NET 10-Projekt ohne zusätzliche Anpassungen einen benutzerdefinierten Logger über CustomLogger zuweisen.

Chaknith Bin
Software Ingenieur
Chaknith arbeitet an IronXL und IronBarcode. Er hat umfassende Expertise in C# und .NET und hilft, die Software zu verbessern und Kunden zu unterstützen. Seine Einblicke aus Benutzerinteraktionen tragen zu besseren Produkten, Dokumentationen und einem insgesamt besseren Erlebnis bei.
Bereit anzufangen?
Nuget Downloads 16,154,058 | Version: 2025.11 gerade veröffentlicht