From d47eefb3ca2b787e06d77165f43f8f8d6b061dd5 Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Fri, 11 Oct 2024 15:56:44 +1000
Subject: [PATCH 1/4] Dev version bump [skip ci]

---
 src/Serilog.AspNetCore/Serilog.AspNetCore.csproj | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index ac617d0..5d29d9d 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -3,7 +3,7 @@
   <PropertyGroup>
     <Description>Serilog support for ASP.NET Core logging</Description>
     <!-- This must match the major and minor components of the referenced *.Extensions.* packages (and highest supported .NET TFM). -->
-    <VersionPrefix>8.0.3</VersionPrefix>
+    <VersionPrefix>8.0.4</VersionPrefix>
     <Authors>Microsoft;Serilog Contributors</Authors>
     <TargetFrameworks>net462;netstandard2.0;net6.0;net7.0;net8.0</TargetFrameworks>
     <GenerateDocumentationFile>true</GenerateDocumentationFile>

From 985ce641750e9eba1c6d7fd9769d1911aab06797 Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Wed, 27 Nov 2024 14:32:54 +1000
Subject: [PATCH 2/4] Update to .NET 9; Actions build

---
 .github/.DS_Store                             | Bin 0 -> 6148 bytes
 .github/workflows/ci.yml                      |  41 ++++++++
 Build.ps1                                     |  93 +++++++++++-------
 Directory.Build.props                         |  19 +++-
 Directory.Version.props                       |   6 ++
 README.md                                     |   2 +-
 Setup.ps1                                     |  11 ---
 appveyor.yml                                  |  24 -----
 global.json                                   |   2 +-
 samples/Sample/Sample.csproj                  |   5 +-
 serilog-aspnetcore.sln                        |  15 ++-
 .../AspNetCore/RequestLoggingMiddleware.cs    |   2 +-
 .../Serilog.AspNetCore.csproj                 |  25 ++---
 .../Serilog.AspNetCore.Tests.csproj           |  11 ++-
 14 files changed, 154 insertions(+), 102 deletions(-)
 create mode 100644 .github/.DS_Store
 create mode 100644 .github/workflows/ci.yml
 create mode 100644 Directory.Version.props
 delete mode 100644 Setup.ps1
 delete mode 100644 appveyor.yml

diff --git a/.github/.DS_Store b/.github/.DS_Store
new file mode 100644
index 0000000000000000000000000000000000000000..add6722590044bcc900e134099c24848a3146504
GIT binary patch
literal 6148
zcmeHKJxc>o5S-N%0YOq)zQ5o<c!s11C<xJ7(UgG{!Tu_Lmp?7DAI))E1)DH??9O|8
zJMXwDZf^nD@@sbwEC9^uj`;R4HNWpZv8&1$k<K&Lc*6_h6P_p4zbBk~iw(BCUPt^#
zJos6=<LCb4aM*jHObSQ=DIf);fD|}efoiGqo3l^S0a8E;T$%#@eQ0#YUN|Jir-LCz
z0OE}4Fs@^kAU01Bd*P7C49${COsdt0VM%AcRb4L}5|a+A;lt|5RuhWF(|LZ2a#&AP
zlmb#<tiW|{7vBHZ^grhRF-bcqAO$W;0h_J1t0iBldh6unyw^7RJKbx3=x$sGg(2E8
kG1@UV-j460DC?T9dA}D9i9u&R=tTVtxGpj&@ZSoY0BP+N4FCWD

literal 0
HcmV?d00001

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
new file mode 100644
index 0000000..acd3bc6
--- /dev/null
+++ b/.github/workflows/ci.yml
@@ -0,0 +1,41 @@
+# If this file is renamed, the incrementing run attempt number will be reset.
+
+name: CI
+
+on:
+  push:
+    branches: [ "dev", "main" ]
+  pull_request:
+    branches: [ "dev", "main" ]
+
+env:
+  CI_BUILD_NUMBER_BASE: ${{ github.run_number }}
+  CI_TARGET_BRANCH: ${{ github.head_ref || github.ref_name }}
+
+jobs:
+  build:
+
+    # The build must run on Windows so that .NET Framework targets can be built and tested.
+    runs-on: windows-latest
+
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: 9.0.x
+      - name: Compute build number
+        shell: bash
+        run: |
+          echo "CI_BUILD_NUMBER=$(($CI_BUILD_NUMBER_BASE+2300))" >> $GITHUB_ENV
+      - name: Build and Publish
+        env:
+          DOTNET_CLI_TELEMETRY_OPTOUT: true
+          NUGET_API_KEY: ${{ secrets.NUGET_API_KEY }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        shell: pwsh
+        run: |
+          ./Build.ps1
diff --git a/Build.ps1 b/Build.ps1
index a674b52..e798284 100644
--- a/Build.ps1
+++ b/Build.ps1
@@ -1,56 +1,79 @@
-echo "build: Build started"
+Write-Output "build: Tool versions follow"
+
+dotnet --version
+dotnet --list-sdks
+
+Write-Output "build: Build started"
 
 Push-Location $PSScriptRoot
+try {
+    if(Test-Path .\artifacts) {
+        Write-Output "build: Cleaning ./artifacts"
+        Remove-Item ./artifacts -Force -Recurse
+    }
 
-if(Test-Path .\artifacts) {
-	echo "build: Cleaning .\artifacts"
-	Remove-Item .\artifacts -Force -Recurse
-}
+    & dotnet restore --no-cache
 
-& dotnet restore --no-cache
+    $dbp = [Xml] (Get-Content .\Directory.Version.props)
+    $versionPrefix = $dbp.Project.PropertyGroup.VersionPrefix
 
-$branch = @{ $true = $env:APPVEYOR_REPO_BRANCH; $false = $(git symbolic-ref --short -q HEAD) }[$env:APPVEYOR_REPO_BRANCH -ne $NULL];
-$revision = @{ $true = "{0:00000}" -f [convert]::ToInt32("0" + $env:APPVEYOR_BUILD_NUMBER, 10); $false = "local" }[$env:APPVEYOR_BUILD_NUMBER -ne $NULL];
-$suffix = @{ $true = ""; $false = "$($branch.Substring(0, [math]::Min(10,$branch.Length)))-$revision"}[$branch -eq "main" -and $revision -ne "local"]
+    Write-Output "build: Package version prefix is $versionPrefix"
 
-echo "build: Version suffix is $suffix"
+    $branch = @{ $true = $env:CI_TARGET_BRANCH; $false = $(git symbolic-ref --short -q HEAD) }[$NULL -ne $env:CI_TARGET_BRANCH];
+    $revision = @{ $true = "{0:00000}" -f [convert]::ToInt32("0" + $env:CI_BUILD_NUMBER, 10); $false = "local" }[$NULL -ne $env:CI_BUILD_NUMBER];
+    $suffix = @{ $true = ""; $false = "$($branch.Substring(0, [math]::Min(10,$branch.Length)) -replace '([^a-zA-Z0-9\-]*)', '')-$revision"}[$branch -eq "main" -and $revision -ne "local"]
+    $commitHash = $(git rev-parse --short HEAD)
+    $buildSuffix = @{ $true = "$($suffix)-$($commitHash)"; $false = "$($branch)-$($commitHash)" }[$suffix -ne ""]
 
-foreach ($src in ls src/*) {
-    Push-Location $src
+    Write-Output "build: Package version suffix is $suffix"
+    Write-Output "build: Build version suffix is $buildSuffix"
 
-	echo "build: Packaging project in $src"
+    & dotnet build -c Release --version-suffix=$buildSuffix /p:ContinuousIntegrationBuild=true
+    if($LASTEXITCODE -ne 0) { throw "Build failed" }
 
-    if($suffix) {
-        & dotnet pack -c Release --include-source -o ..\..\artifacts --version-suffix=$suffix
-    } else {
-        & dotnet pack -c Release --include-source -o ..\..\artifacts
-    }
+    foreach ($src in Get-ChildItem src/*) {
+        Push-Location $src
 
-    if($LASTEXITCODE -ne 0) { exit 1 }
+        Write-Output "build: Packaging project in $src"
 
-    Pop-Location
-}
+        if ($suffix) {
+            & dotnet pack -c Release --no-build --no-restore  -o ../../artifacts --version-suffix=$suffix
+        } else {
+            & dotnet pack -c Release --no-build --no-restore  -o ../../artifacts
+        }
+        if($LASTEXITCODE -ne 0) { throw "Packaging failed" }
 
-foreach ($test in ls test/*.PerformanceTests) {
-    Push-Location $test
+        Pop-Location
+    }
 
-	echo "build: Building performance test project in $test"
+    foreach ($test in Get-ChildItem test/*.Tests) {
+        Push-Location $test
 
-    & dotnet build -c Release
-    if($LASTEXITCODE -ne 0) { exit 2 }
+        Write-Output "build: Testing project in $test"
 
-    Pop-Location
-}
+        & dotnet test -c Release --no-build --no-restore
+        if($LASTEXITCODE -ne 0) { throw "Testing failed" }
+
+        Pop-Location
+    }
 
-foreach ($test in ls test/*.Tests) {
-    Push-Location $test
+    if ($env:NUGET_API_KEY) {
+        # GitHub Actions will only supply this to branch builds and not PRs. We publish
+        # builds from any branch this action targets (i.e. main and dev).
 
-	echo "build: Testing project in $test"
+        Write-Output "build: Publishing NuGet packages"
 
-    & dotnet test -c Release
-    if($LASTEXITCODE -ne 0) { exit 3 }
+        foreach ($nupkg in Get-ChildItem artifacts/*.nupkg) {
+            & dotnet nuget push -k $env:NUGET_API_KEY -s https://api.nuget.org/v3/index.json "$nupkg"
+            if($LASTEXITCODE -ne 0) { throw "Publishing failed" }
+        }
 
+        if (!($suffix)) {
+            Write-Output "build: Creating release for version $versionPrefix"
+
+            iex "gh release create v$versionPrefix --title v$versionPrefix --generate-notes $(get-item ./artifacts/*.nupkg) $(get-item ./artifacts/*.snupkg)"
+        }
+    }
+} finally {
     Pop-Location
 }
-
-Pop-Location
diff --git a/Directory.Build.props b/Directory.Build.props
index 3dcd183..c114992 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -1,12 +1,25 @@
 <Project>
+  <!-- Properties in this file are expected to be identical for all Serilog organization projects. If
+   a property value is project-specific, please record it in the CSPROJ file instead. -->
+  <Import Project="$(MSBuildThisFileDirectory)Directory.Version.props" />
   <PropertyGroup>
     <LangVersion>latest</LangVersion>
     <TreatWarningsAsErrors>True</TreatWarningsAsErrors>
-    <SignAssembly>true</SignAssembly>
-    <AssemblyOriginatorKeyFile>../../assets/Serilog.snk</AssemblyOriginatorKeyFile>
-    <PublicSign Condition=" '$(OS)' != 'Windows_NT' ">true</PublicSign>
+    <!-- The condition is required to support BenchmarkDotNet -->
+    <SignAssembly Condition="Exists('$(MSBuildThisFileDirectory)assets/Serilog.snk')">true</SignAssembly>
+    <AssemblyOriginatorKeyFile>$(MSBuildThisFileDirectory)assets/Serilog.snk</AssemblyOriginatorKeyFile>
     <CheckEolTargetFramework>false</CheckEolTargetFramework>
     <Nullable>enable</Nullable>
     <ImplicitUsings>enable</ImplicitUsings>
+    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <PublishRepositoryUrl>true</PublishRepositoryUrl>
+    <EmbedUntrackedSources>true</EmbedUntrackedSources>
+    <IncludeSymbols>true</IncludeSymbols>
+    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
   </PropertyGroup>
+  <ItemGroup Condition="'$(TargetFrameworkIdentifier)' == '.NETFramework'">
+    <Reference Include="System" />
+    <Reference Include="System.Core" />
+    <Reference Include="Microsoft.CSharp" />
+  </ItemGroup>
 </Project>
diff --git a/Directory.Version.props b/Directory.Version.props
new file mode 100644
index 0000000..f350992
--- /dev/null
+++ b/Directory.Version.props
@@ -0,0 +1,6 @@
+<Project>
+  <PropertyGroup>
+    <!-- This must match the major and minor components of the referenced *.Extensions.* packages (and highest supported .NET TFM). -->
+    <VersionPrefix>9.0.0</VersionPrefix>
+  </PropertyGroup>
+</Project>
diff --git a/README.md b/README.md
index 4b5ae29..9d09bf1 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Serilog.AspNetCore [![Build status](https://ci.appveyor.com/api/projects/status/4rscdto23ik6vm2r/branch/dev?svg=true)](https://ci.appveyor.com/project/serilog/serilog-aspnetcore/branch/dev) [![NuGet Version](http://img.shields.io/nuget/v/Serilog.AspNetCore.svg?style=flat)](https://www.nuget.org/packages/Serilog.AspNetCore/) [![NuGet Prerelease Version](http://img.shields.io/nuget/vpre/Serilog.AspNetCore.svg?style=flat)](https://www.nuget.org/packages/Serilog.AspNetCore/)
+# Serilog.AspNetCore&nbsp;[![Build status](https://github.com/serilog/serilog-aspnetcore/actions/workflows/ci.yml/badge.svg?branch=dev)](https://github.com/serilog/serilog-aspnetcore/actions)&nbsp;[![NuGet Version](http://img.shields.io/nuget/v/Serilog.AspNetCore.svg?style=flat)](https://www.nuget.org/packages/Serilog.AspNetCore/)
 
 Serilog logging for ASP.NET Core. This package routes ASP.NET Core log messages through Serilog, so you can get information about ASP.NET's internal operations written to the same Serilog sinks as your application events.
 
diff --git a/Setup.ps1 b/Setup.ps1
deleted file mode 100644
index 880a07a..0000000
--- a/Setup.ps1
+++ /dev/null
@@ -1,11 +0,0 @@
-$ErrorActionPreference = "Stop"
-
-$RequiredDotnetVersion =  $(cat ./global.json | convertfrom-json).sdk.version
-
-mkdir "./build"
-
-Invoke-WebRequest "https://dot.net/v1/dotnet-install.ps1" -OutFile "./build/installcli.ps1"
-& ./build/installcli.ps1 -InstallDir "$pwd/.dotnetcli" -NoPath -Version $RequiredDotnetVersion
-if ($LASTEXITCODE) { exit 1 }
-
-$env:Path = "$pwd/.dotnetcli;$env:Path"
diff --git a/appveyor.yml b/appveyor.yml
deleted file mode 100644
index 5eadb66..0000000
--- a/appveyor.yml
+++ /dev/null
@@ -1,24 +0,0 @@
-version: '{build}'
-skip_tags: true
-image: Visual Studio 2022
-install:
-- ps: ./Setup.ps1
-build_script:
-- ps: ./Build.ps1
-test: off
-artifacts:
-- path: artifacts/Serilog.*.nupkg
-deploy:
-- provider: NuGet
-  skip_symbols: true
-  api_key:
-    secure: cyyTkHHOJHO3tPWDeocu+EjnHERcPncSaEi/l2gjYPDsNP3I4zh/KPtbqt7kWVc0
-  on:
-    branch: /^(main|dev)$/
-- provider: GitHub
-  auth_token:
-    secure: p4LpVhBKxGS5WqucHxFQ5c7C8cP74kbNB0Z8k9Oxx/PMaDQ1+ibmoexNqVU5ZlmX
-  artifact: /Serilog.*\.nupkg/
-  tag: v$(appveyor_build_version)
-  on:
-    branch: main
diff --git a/global.json b/global.json
index d079f83..db8627a 100644
--- a/global.json
+++ b/global.json
@@ -1,7 +1,7 @@
 {
   "sdk": {
+    "version": "9.0.100",
     "allowPrerelease": false,
-    "version": "8.0.100",
     "rollForward": "latestFeature"
   }
 }
diff --git a/samples/Sample/Sample.csproj b/samples/Sample/Sample.csproj
index b5a6d67..446c9b8 100644
--- a/samples/Sample/Sample.csproj
+++ b/samples/Sample/Sample.csproj
@@ -1,7 +1,8 @@
 <Project Sdk="Microsoft.NET.Sdk.Web">
 
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net9.0</TargetFramework>
+    <GenerateDocumentationFile>false</GenerateDocumentationFile>
   </PropertyGroup>
 
   <ItemGroup>
@@ -9,7 +10,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Serilog.Expressions" Version="4.0.0" />
+    <PackageReference Include="Serilog.Expressions" Version="5.0.0" />
   </ItemGroup>
 
 </Project>
diff --git a/serilog-aspnetcore.sln b/serilog-aspnetcore.sln
index a9b5e42..73c077d 100644
--- a/serilog-aspnetcore.sln
+++ b/serilog-aspnetcore.sln
@@ -11,12 +11,11 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "samples", "samples", "{F240
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "assets", "assets", "{9C21B9DF-AEDD-4AA6-BEA4-912DEF3E5B8E}"
 	ProjectSection(SolutionItems) = preProject
-		appveyor.yml = appveyor.yml
-		Build.ps1 = Build.ps1
-		global.json = global.json
 		README.md = README.md
 		assets\Serilog.snk = assets\Serilog.snk
-		Setup.ps1 = Setup.ps1
+		Build.ps1 = Build.ps1
+		global.json = global.json
+		Directory.Version.props = Directory.Version.props
 		Directory.Build.props = Directory.Build.props
 	EndProjectSection
 EndProject
@@ -26,6 +25,13 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Serilog.AspNetCore.Tests",
 EndProject
 Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Sample", "samples\Sample\Sample.csproj", "{4FA0FE41-973E-4555-AB4A-0F400DBA9DD3}"
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = ".github", ".github", "{B867CAF4-D737-4230-AD2F-8093223A949A}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "workflows", "workflows", "{5944D1E2-BC3C-4A95-B4E2-9DDE5B0684AC}"
+	ProjectSection(SolutionItems) = preProject
+		.github\workflows\ci.yml = .github\workflows\ci.yml
+	EndProjectSection
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -52,6 +58,7 @@ Global
 		{0549D23F-986B-4FB2-BACE-16FD7A7BC9EF} = {A1893BD1-333D-4DFE-A0F0-DDBB2FE526E0}
 		{AD51759B-CD58-473F-9620-0B0E56A123A1} = {E30F638E-BBBE-4AD1-93CE-48CC69CFEFE1}
 		{4FA0FE41-973E-4555-AB4A-0F400DBA9DD3} = {F2407211-6043-439C-8E06-3641634332E7}
+		{5944D1E2-BC3C-4A95-B4E2-9DDE5B0684AC} = {B867CAF4-D737-4230-AD2F-8093223A949A}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {811E61C5-3871-4633-AFAE-B35B619C8A10}
diff --git a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
index e4f50a8..a8ec777 100644
--- a/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
+++ b/src/Serilog.AspNetCore/AspNetCore/RequestLoggingMiddleware.cs
@@ -88,7 +88,7 @@ bool LogCompletion(HttpContext httpContext, DiagnosticContextCollector collector
             collectedProperties = NoProperties;
 
         // Last-in (correctly) wins...
-        var properties = collectedProperties.Concat(_getMessageTemplateProperties(httpContext, GetPath(httpContext, _includeQueryInRequestPath), elapsedMs, statusCode));
+        var properties = (collectedProperties ?? []).Concat(_getMessageTemplateProperties(httpContext, GetPath(httpContext, _includeQueryInRequestPath), elapsedMs, statusCode));
 
         var (traceId, spanId) = Activity.Current is { } activity ?
             (activity.TraceId, activity.SpanId) :
diff --git a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
index 5d29d9d..a244735 100644
--- a/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
+++ b/src/Serilog.AspNetCore/Serilog.AspNetCore.csproj
@@ -2,17 +2,13 @@
 
   <PropertyGroup>
     <Description>Serilog support for ASP.NET Core logging</Description>
-    <!-- This must match the major and minor components of the referenced *.Extensions.* packages (and highest supported .NET TFM). -->
-    <VersionPrefix>8.0.4</VersionPrefix>
     <Authors>Microsoft;Serilog Contributors</Authors>
-    <TargetFrameworks>net462;netstandard2.0;net6.0;net7.0;net8.0</TargetFrameworks>
-    <GenerateDocumentationFile>true</GenerateDocumentationFile>
+    <TargetFrameworks>net462;netstandard2.0;netstandard2.1;net8.0;net9.0</TargetFrameworks>
     <PackageTags>serilog;aspnet;aspnetcore</PackageTags>
     <PackageIcon>icon.png</PackageIcon>
     <PackageProjectUrl>https://github.com/serilog/serilog-aspnetcore</PackageProjectUrl>
     <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
     <RepositoryUrl>https://github.com/serilog/serilog-aspnetcore</RepositoryUrl>
-    <RepositoryType>git</RepositoryType>
     <RootNamespace>Serilog</RootNamespace>
     <PackageReadmeFile>README.md</PackageReadmeFile>
   </PropertyGroup>
@@ -24,26 +20,25 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Serilog" Version="3.1.1" />
-    <PackageReference Include="Serilog.Sinks.Console" Version="5.0.0" />
-    <PackageReference Include="Serilog.Sinks.File" Version="5.0.0" />
-    <PackageReference Include="Serilog.Sinks.Debug" Version="2.0.0" />
-    <PackageReference Include="Serilog.Formatting.Compact" Version="2.0.0" />
+    <PackageReference Include="Serilog" Version="4.2.0-*" />
+    <PackageReference Include="Serilog.Sinks.Console" Version="6.0.0" />
+    <PackageReference Include="Serilog.Sinks.File" Version="6.0.0" />
+    <PackageReference Include="Serilog.Sinks.Debug" Version="3.0.0" />
+    <PackageReference Include="Serilog.Formatting.Compact" Version="3.0.0" />
   </ItemGroup>
 
   <ItemGroup>
     <!-- The versions of all references in this group must match the major and minor components of the package version prefix. -->
-    <PackageReference Include="Serilog.Extensions.Hosting" Version="8.0.0" />
-    <PackageReference Include="Serilog.Settings.Configuration" Version="8.0.4" />
-    <PackageReference Include="Microsoft.Extensions.Logging" Version="8.0.0" />
+    <PackageReference Include="Serilog.Extensions.Hosting" Version="9.0.0-*" />
+    <PackageReference Include="Serilog.Settings.Configuration" Version="9.0.0-*" />
   </ItemGroup>
 
-  <ItemGroup Condition=" '$(TargetFramework)' != 'net462' and '$(TargetFramework)' != 'netstandard2.0' ">
+  <ItemGroup Condition=" '$(TargetFramework)' != 'net462' and '$(TargetFramework)' != 'netstandard2.0' and '$(TargetFramework)' != 'netstandard2.1' ">
     <!-- I.e. all modern/supported non-Framework .NET SKUs -->
     <FrameworkReference Include="Microsoft.AspNetCore.App" />
   </ItemGroup>
 
-  <ItemGroup Condition=" '$(TargetFramework)' == 'net462' or '$(TargetFramework)' == 'netstandard2.0' ">
+  <ItemGroup Condition=" '$(TargetFramework)' == 'net462' or '$(TargetFramework)' == 'netstandard2.0' or '$(TargetFramework)' == 'netstandard2.1' ">
     <PackageReference Include="Microsoft.AspNetCore.Hosting.Abstractions" Version="2.2.0" />
     <PackageReference Include="Microsoft.AspNetCore.Http.Abstractions" Version="2.2.0" />
   </ItemGroup>
diff --git a/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj b/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj
index 446fc77..a0a29df 100644
--- a/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj
+++ b/test/Serilog.AspNetCore.Tests/Serilog.AspNetCore.Tests.csproj
@@ -1,7 +1,8 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
   <PropertyGroup>
-    <TargetFramework>net8.0</TargetFramework>
+    <TargetFramework>net9.0</TargetFramework>
+    <GenerateDocumentationFile>false</GenerateDocumentationFile>
   </PropertyGroup>
 
   <ItemGroup>
@@ -9,10 +10,10 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.8.0" />
-    <PackageReference Include="xunit.runner.visualstudio" Version="2.5.3" PrivateAssets="all" />
-    <PackageReference Include="xunit" Version="2.6.1" />
-    <PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="8.0.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.12.0" />
+    <PackageReference Include="xunit.runner.visualstudio" Version="2.8.2" PrivateAssets="all" />
+    <PackageReference Include="xunit" Version="2.9.2" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc.Testing" Version="9.0.0" />
   </ItemGroup>
 
 </Project>

From ba531334efd4a2c6e8f86241dbf949603e07099f Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Wed, 27 Nov 2024 14:34:52 +1000
Subject: [PATCH 3/4] Remove .DS_Store

---
 .github/.DS_Store | Bin 6148 -> 0 bytes
 .gitignore        |   2 ++
 2 files changed, 2 insertions(+)
 delete mode 100644 .github/.DS_Store

diff --git a/.github/.DS_Store b/.github/.DS_Store
deleted file mode 100644
index add6722590044bcc900e134099c24848a3146504..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 6148
zcmeHKJxc>o5S-N%0YOq)zQ5o<c!s11C<xJ7(UgG{!Tu_Lmp?7DAI))E1)DH??9O|8
zJMXwDZf^nD@@sbwEC9^uj`;R4HNWpZv8&1$k<K&Lc*6_h6P_p4zbBk~iw(BCUPt^#
zJos6=<LCb4aM*jHObSQ=DIf);fD|}efoiGqo3l^S0a8E;T$%#@eQ0#YUN|Jir-LCz
z0OE}4Fs@^kAU01Bd*P7C49${COsdt0VM%AcRb4L}5|a+A;lt|5RuhWF(|LZ2a#&AP
zlmb#<tiW|{7vBHZ^grhRF-bcqAO$W;0h_J1t0iBldh6unyw^7RJKbx3=x$sGg(2E8
kG1@UV-j460DC?T9dA}D9i9u&R=tTVtxGpj&@ZSoY0BP+N4FCWD

diff --git a/.gitignore b/.gitignore
index a85b957..3ce8c4c 100644
--- a/.gitignore
+++ b/.gitignore
@@ -289,3 +289,5 @@ __pycache__/
 
 samples/Sample/logs/
 
+.DS_Store
+

From 613941a7304a857a0e30c19a4f84d3b336f00c9f Mon Sep 17 00:00:00 2001
From: Nicholas Blumhardt <nblumhardt@nblumhardt.com>
Date: Wed, 27 Nov 2024 14:36:22 +1000
Subject: [PATCH 4/4] Remove vestigial images folder

---
 .../images/serilog-extension-nuget.png          | Bin 22378 -> 0 bytes
 1 file changed, 0 insertions(+), 0 deletions(-)
 delete mode 100644 src/Serilog.AspNetCore/images/serilog-extension-nuget.png

diff --git a/src/Serilog.AspNetCore/images/serilog-extension-nuget.png b/src/Serilog.AspNetCore/images/serilog-extension-nuget.png
deleted file mode 100644
index 1dfe4308b664e684217d436367a25bf91308f436..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 22378
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