Serilog Extensions Logging 项目教程

Serilog Extensions Logging 项目教程

serilog-extensions-loggingSerilog provider for Microsoft.Extensions.Logging项目地址:https://gitcode.com/gh_mirrors/se/serilog-extensions-logging

1. 项目的目录结构及介绍

Serilog Extensions Logging 项目的目录结构如下：

serilog-extensions-logging/
├── src/
│   └── Serilog.Extensions.Logging/
│       ├── Properties/
│       ├── Serilog.Extensions.Logging.csproj
│       ├── AddSerilog.cs
│       ├── LoggerProviderCollection.cs
│       ├── LoggerProvider.cs
│       └── README.md
├── test/
│   └── Serilog.Extensions.Logging.Tests/
│       ├── Properties/
│       ├── Serilog.Extensions.Logging.Tests.csproj
│       ├── AddSerilogTests.cs
│       ├── LoggerProviderCollectionTests.cs
│       └── LoggerProviderTests.cs
├── .gitignore
├── .editorconfig
├── .gitattributes
├── LICENSE
├── README.md
└── Serilog.sln

目录结构介绍

• src/Serilog.Extensions.Logging/：包含项目的主要源代码文件。

  • AddSerilog.cs：实现了 AddSerilog 方法，用于将 Serilog 集成到 Microsoft.Extensions.Logging 中。
  • LoggerProvider.cs：定义了 Serilog 的日志提供程序。
  • LoggerProviderCollection.cs：处理多个日志提供程序的集合。
  • Serilog.Extensions.Logging.csproj：项目文件。

• test/Serilog.Extensions.Logging.Tests/：包含项目的单元测试文件。

  • AddSerilogTests.cs：测试 AddSerilog 方法的功能。
  • LoggerProviderCollectionTests.cs：测试日志提供程序集合的功能。
  • LoggerProviderTests.cs：测试日志提供程序的功能。
  • Serilog.Extensions.Logging.Tests.csproj：测试项目文件。

• 根目录下的文件：

  • .gitignore：Git 忽略文件配置。
  • .editorconfig：编辑器配置文件。
  • .gitattributes：Git 属性配置文件。
  • LICENSE：项目许可证。
  • README.md：项目说明文档。
  • Serilog.sln：Visual Studio 解决方案文件。

2. 项目的启动文件介绍

项目的启动文件主要涉及 AddSerilog.cs 文件，该文件实现了将 Serilog 集成到 Microsoft.Extensions.Logging 中的关键方法 AddSerilog。

AddSerilog.cs 文件介绍

using Microsoft.Extensions.Logging;
using Serilog;

namespace Serilog.Extensions.Logging
{
    public static class SerilogLoggingBuilderExtensions
    {
        public static ILoggingBuilder AddSerilog(this ILoggingBuilder builder, ILogger logger = null, bool dispose = false)
        {
            builder.AddProvider(new SerilogLoggerProvider(logger, dispose));
            return builder;
        }
    }
}

• AddSerilog 方法：将 Serilog 日志提供程序添加到 Microsoft.Extensions.Logging 中。
  • builder：ILoggingBuilder 实例。
  • logger：可选的 Serilog 日志记录器实例。
  • dispose：是否在应用程序关闭时释放 Serilog 日志记录器。

3. 项目的配置文件介绍

项目的配置文件主要涉及 Serilog.Extensions.Logging.csproj 文件，该文件定义了项目的构建和依赖项。

Serilog.Extensions.Logging.csproj 文件介绍

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <RootNamespace>Serilog.Extensions.Logging</RootNamespace>
    <AssemblyName>Serilog.Extensions.Logging</AssemblyName>
    <PackageId>Serilog.Extensions.Logging</PackageId>
    <Version>3.0.1</Version>
    <Authors>Serilog Contributors</Authors>
    <Description>Serilog provider for Microsoft.Extensions.Logging</Description>
    <PackageTags>serilog;logging;microsoft.extensions.logging</PackageTags>
    <PackageProjectUrl>https://github.com/serilog/serilog-extensions-logging</PackageProjectUrl>
    <RepositoryUrl>https://github.com/ser

serilog-extensions-loggingSerilog provider for Microsoft.Extensions.Logging项目地址:https://gitcode.com/gh_mirrors/se/serilog-extensions-logging