publish new episode

gaufung · gaufung · commit 674b4bdcb3c3 · 2023-12-30T07:58:08.000+08:00
diff --git a/README.md b/README.md
@@ -9,14 +9,13 @@
 我们打算在两个平台上发布
 
 - GitHub
-- [Web](https://dotnetweekly.azurewebsites.net/)
-  - [源码](https://github.com/DotNETWeekly-io/DotNetWeeklyWeb)
+- [Web](https://www.fungkao.net/searchByTag/.NET%20Weekly)
 
 ## 周刊
 
 ### 2023
 
-**十二月份**： [第 046 期](docs/episode-046.md) :high_brightness:
+**十二月份**： [第 046 期](docs/episode-047.md) :high_brightness: | [第 046 期](docs/episode-046.md)
 
 **十一月份**： [第 045 期](docs/episode-045.md) | [第 044 期](docs/episode-044.md)
 
diff --git a/docs/episode-019.md b/docs/episode-019.md
@@ -23,7 +23,7 @@
   - IntPtr、UIntPtr 支持数值运算
 - 模式匹配改进
   - 列表模式匹配
-  - 对 Span<char> 的模式匹配
+  - 对 `Span<char>` 的模式匹配
 - 字符串处理改进
   - 原始字符串
   - UTF-8 字符串
diff --git a/docs/episode-021.md b/docs/episode-021.md
@@ -44,7 +44,7 @@ static async Task<IEnumerable<int>> FetchItems()
 
 不幸的是出现编译错误
 
-> The body of 'Program.FetchItems()' cannot be an iterator block because 'Task<IEnumerable<int>>' is not an iterator interface type
+> The body of 'Program.FetchItems()' cannot be an iterator block because `Task<IEnumerable<int>>` is not an iterator interface type
 
 这时候需要换成 `IAsyncEnuermable` 类型
 
diff --git a/docs/episode-047.md b/docs/episode-047.md
@@ -0,0 +1,215 @@
+# .NET 每周分享第 47 期
+
+## 卷首语
+
+2023 年最后一期，感谢大家一直以来的支持，我们会在 2024 年继续为大家带来更多的内容。
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/fc3fb062-5d50-424a-a88c-d703a56b38c3)
+
+## 行业资讯
+
+1、[.NET 8 Hack 活动获奖](https://devblogs.microsoft.com/dotnet/great-dotnet-8-hack-winners/)
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/df5a9fb7-b0df-4a53-bb24-a87858806b56)
+
+前几个月 `.NET` 社区发起了 "黑客"活动，最近这个活动的获奖情况揭晓：
+
+- 最佳：NASA TechPort Headlines
+- AI 最佳：Betakads
+- 云原生最佳：AI Counselor
+
+
+2、[.NET Conf 2023 回顾](https://devblogs.microsoft.com/dotnet/dotnet-conf-2023-recap-videos-slides-demos-and-more/)
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/10b5bdf6-e3fb-4442-aa87-e683981b78cb)
+
+2023 年的 `.NET Conf` 已经结束，这个文章给出活动的回顾，主要有：
+
+- 全局视频列表
+- 幻灯片和 Demo 代码
+- eShop 应用程序
+- 客户故事
+- 本地 `.NET` 活动
+
+## 文章推荐
+
+1、[HttpClient 定制化日志](https://josef.codes/customize-the-httpclient-logging-dotnet-core/)
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/4238b0a3-431c-4cc1-a5c8-3b71bf4a77f0)
+
+`HttpClient` 默认的日志格式是这样的
+
+```csharp
+info: System.Net.Http.HttpClient.my-client.LogicalHandler[100]
+      Start processing HTTP request GET https://www.google.com
+```
+
+如果想要定制化，可以实现 `IHttpClientLogger` 接口
+
+```csharp
+public class HttpLogger : IHttpClientLogger
+{
+    private readonly ILogger<HttpLogger> _logger;
+
+    public HttpLogger(ILogger<HttpLogger> logger)
+    {
+        _logger = logger
+    }
+
+    public void LogRequestFailed(object? context, HttpRequestMessage request, HttpResponseMessage? response, Exception exception, TimeSpan elapsed)
+    {
+    }
+
+    public object? LogRequestStart(HttpRequestMessage request)
+    {
+    }
+
+    public void LogRequestStop(object? context, HttpRequestMessage request, HttpResponseMessage response, TimeSpan elapsed)
+    {
+    }
+}
+
+```
+
+这样可以将它注册到容器中
+
+```csharp
+service.AddSingleton<IHttpClientLogger, HttpLogger>();
+service.AddHttpClient("my-client", client =>
+{
+    client.BaseAddress = new Uri("https://www.google.com");
+}).RemoveAllLoggers().AddLogger<IHttpClientLogger>(true);
+```
+为了移除默认的日志格式，需要调用 `RemoveAllLoggers()` 方法。
+
+2、[All 和 TrueForAll](https://www.youtube.com/watch?v=cpL-fuiEfwU&ab_channel=NickChapsas)
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/3fe83a36-b1b0-4932-8f61-165f5f5d4b1e)
+
+在 `List` 类型中有一个 `TrueForAll` 和 `IEnumerable` 中 `All` 方法都是完成同一件事，但是它们在性能上有显著的区别。
+```csharp
+public class Benchmarks
+{
+    private List<int> _list;
+
+    [GlobalSetup]
+    public void Setup()
+    {
+        Random rnd = new Random(42);
+        _list = Enumerable.Range(0, 1000).Select(i => rnd.Next()).ToList();
+    }
+
+
+    [Benchmark(Baseline = true)]
+    public bool All()
+    {
+        return _list.All(x => x < 1000);
+    }
+
+    [Benchmark]
+    public bool TrueForAll()
+    {
+        return _list.TrueForAll(x  => x < 1000);
+    }
+}
+```
+它们在性能和内存使用上，`TrueForAll` 有着显著的优势。它们区别这在于 
+```csharp
+public static bool All<TSource>(this IEnumerable<TSource> source, Func<TSource, bool> predicate)
+{
+    foreach (TSource element in source)
+    {
+        if (!predicate(element))
+        {
+            return false;
+        }
+    }
+    return true;
+}
+
+public bool TrueForAll(Predicate<T> match)
+{
+    for (int i = 0; i < _size; i++)
+    {
+        if (!match(_items[i]))
+        {
+            return false;
+        }
+    }
+    return true;
+}
+```
+
+答案显而易见，因为 `All` 方法使用 `Foreach` 方法，因为它存在装箱和拆箱的操作。
+
+
+3、[OR 操作符](https://www.youtube.com/watch?v=wPmh_ZtFQ5k&ab_channel=MilanJovanovi%C4%87)
+
+C# 中 `or` 操作符可以简化 `||` 操作。
+
+```csharp
+if (student.Grade == Grade.Excellent ||
+(student.Grade == Grade.Good)
+{
+    Console.WriteLine("Well done");
+}
+```
+那么 `OR` 操作符可以简化成一行代码
+
+```csharp
+if (student.Grade is Grade.Excellent or Grade.Good)
+{
+    Console.WriteLine("Well done");
+}
+```
+
+4、[为什么我现在不用 Aspire](https://event-driven.io/en/nay_to_aspire/)
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/85173524-c1c9-4ca7-b466-c67faba93412)
+
+作者在使用了 `Aspire` 之后，给出了负面的评价，观点如下
+
+- 启动太复杂
+- 所有项目都在同一个解决方案下
+- 在 Linux 下，本地环境非常难管理
+
+5、[c# 中的不可变类型](https://blog.stephencleary.com/2023/12/the-joy-of-immutable-update-patterns.html)
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/72cde29b-db07-42bc-99ff-e31ae19ac050)
+
+`Immutable` 类型有很多好处，在 `C#` 中存在两种不可变类型
+
+- 基础类型，比如 int, double 等
+- 值类型，比如 struct
+
+除此之外，还有 `System.Collections.Immutable` 命名空间下类型。如果要对不可变类型做修改，通常是需要创建也给新的对象，比如在 switch 和 `with` 语句是现代 `C#` 代码创新不可变类型的方法。
+
+6、[Visual Studio Git 集成汇总](https://devblogs.microsoft.com/visualstudio/a-year-of-making-you-more-productive-using-git-in-visual-studio/)
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/4a4b4d13-69a9-4697-9563-eadfb9c96cb6)
+
+过去一年 `Visual Studio` 在 `Git` 上面的提升汇总。
+
+## 开源项目
+
+1、[GitHub Action Visual Studio 插件](https://marketplace.visualstudio.com/items?itemName=TimHeuer.GitHubActionsVS)
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/a52952b5-4147-49e0-bd06-9bee48ad6e71)
+
+Visual Studio 包含了 `GitHub Action` 的插件，它可以帮助我们浏览，管理和运行 `GitHub Action`.
+
+2、[Cocona](https://github.com/mayuki/Cocona)
+
+![image](https://github.com/DotNETWeekly-io/DotNetWeekly/assets/11272110/f73b2d4b-3561-4a9e-b5f7-9157c4a05fd4)
+
+`Cocona` 库可以帮助我们非常简单写出应用台应用程序。
+
+```csharp
+using Cocona;
+
+CoconaApp.Run((string name) =>
+{
+    Console.WriteLine($"hello {name}");
+});
+```
+这样运行 `dotnet run -- --name .netwekly` 就可以输出 `hello .netweekly` 。
