林德熙

dotnet 已知问题使用 Directory.EnumerateXXX 方法枚举 C 盘根路径可能错误的问题

在 dotnet 里面，可以使用 Directory.EnumerateXXX 系列方法进行枚举文件或文件夹。在准备枚举驱动器根路径的文件或文件夹时，可能获取到错误的路径。错误的步骤在于传入的是如 C: 不带斜杠的路径，且存在同驱动器磁盘下的非根路径工作路径

dotnet 警惕 Task 的 ContinueWith 带上 OnlyOnFaulted 参数抛出取消异常

本文记录 dotnet 的一个令人迷惑的设计，在 Task 里，有一个叫 ContinueWith 的方法，此方法可以在 Task 完成时执行传入的委托。在 ContinueWith 方法里面，还有一个可选的 TaskContinuationOptions 参数，在此参数里面传入 OnlyOnFaulted 即可在 Task 出错时才执行传入的委托，然而此行为迷惑的是在 Task 正在执行完成却抛出取消异常

dotnet6 C# 一个国内还能用的 NTP 时间校准客户端的实现

本文来记录一个我自己在使用的 NTP 时间校准客户端的实现

dotnet 记 TaskCompletionSource 的 SetException 可能将异常记录到 UnobservedTaskException 的问题

本文将记录 dotnet 的一个已知问题，且是设计如此的问题。假定有一个 TaskCompletionSource 对象，此对象的 Task 没有被任何地方引用等待。在 TaskCompletionSource 被调用 SetException 或 TrySetException 方法时，将会记录一个存在异常且未捕获的 Task 对象。此 Task 对象将会在被 GC 回收时，进入 TaskScheduler.UnobservedTaskException 事件里面，尽管没有明确副作用，但是会吓到不明真相的开发者

dotnet 将控制台 Console.WriteLine 内容输出到文件

很多伙伴喜欢使用 Console.WriteLine 打日志，也许是打起来顺手。打完了之后，又想着，要是能够输出到本机文件那就更好了。既然很多伙伴都有这个想法，那 dotnet 自然就是有方便的方法让咱来实现此需求。只需要调用 Console.SetOut 方法，即可将控制台的输出重定向到一个 TextWriter 里面，只要此 TextWriter 最终输出到本地文件里，即可实现将控制台的内容输出到文件。本文将来告诉大家这个实现方法

dotnet 理解 IConfigurationProvider 的 GetChildKeys 方法用途

我最近遇到了一个有趣的 Bug 让我调试了半天，这个 Bug 的现象是我的好多个模块都因为读取不到配置信息而炸掉，开始我没有定位到具体的问题，以为是我的配置服务器挂掉了。经过了半天的调试，才找到了是我新加入的使用 COIN 配置库的 ReadonlyCoinConfiguration 类型导致的，此 ReadonlyCoinConfiguration 类型继承 IConfigurationProvider 接口，但是我对 IConfigurationProvider 的 GetChildKeys 方法的理解不对，实现错了 GetChildKeys 方法，导致在枚举应用内的所有配置时，配置都会 ReadonlyCoinConfiguration 过滤掉，导致模块读取不到配置。本文将告诉大家 IConfigurationProvider 的 GetChildKeys 方法用途和如何正确实现他

dotnet 警惕使用 StackTrace 加获取方法标记 Attribute 特性在 Release 下被内联

大家都知道，在 dotnet 里的 Debug 下和 Release 下的一个最大的不同是在 Release 下开启了代码优化。启用代码优化，将会对生成的 IL 代码进行优化，同时优化后的 IL 也会有一些运行时的更多优化。内联是一个非常常用的优化手段，内联将会让 StackTrace 获取的调用堆栈存在 Debug 下和 Release 下的差异，从而导致获取方法标记的 Attribute 特性不能符合预期工作

dotnet 将任意时区的 DateTimeOffset 转换为中国时区时间文本

本文告诉大家在拿到任意时区的 DateTimeOffset 对象，将 DateTimeOffset 转换为使用中国的 +8 时区表示的时间

dotnet 警惕判断文件是否存在因为检查网络资源造成超长等待

在使用 System.IO.File.Exists 方法时，绝大部分的情况下都是一个非常快捷且没有成本的，但是如果判断的文件是否存在，是从非自己完全控制的逻辑下进入的，那就需要警惕是否判断的文件路径属于一个网络资源。判断一个网络资源是否存在，是一个耗时不可确定行为，很有可能造成主线程卡顿

dotnet 使用 IndentedTextWriter 辅助生成代码时生成带缩进的内容

随着源代码生成的越来越多的应用，自然也遇到了越来越多开发上的坑，例如源代码的缩进是一个绕不过去的问题。如果源代码生成是人类可见的代码，我期望生成的代码最好是比较符合人类编写代码的规范。为了能让人类在阅读机器生成的代码的时候，不会想着拿刀砍那个编写代码生成代码的开发者，最好，或者说至少代码也应该有个缩进和换行吧。本文将安利大家通过 IndentedTextWriter 这个辅助类，用来辅助生成带缩进的内容

dotnet 使用 TaskTupleAwaiter 同时等待多个任务简化代码写法

在某些业务逻辑下，需要同时等待多个任务执行完成，才能继续往下执行后续逻辑。等待任务执行的逻辑，大部分情况下需要使用到 Task.WhenAll 方法，代码行数不少。另外，在需要获取多个异步任务的返回值的逻辑上，整体的逻辑代码量看起来也不少。本文将和大家介绍 TaskTupleAwaiter 库，通过 TaskTupleAwaiter 库可以方便等待多个任务执行完成，且方便获取各个异步任务的返回值

dotnet 开启 Fiddler 抓包将会让请求 HOST 头被更改

我在写域名备份功能，想要修改请求的 IP 地址，同时又将原有的请求域名带上。实现方法是修改请求的地址，在 HttpRequestMessage 的 Header 上添加 HOST 记录，记录的值就是原有的域名。然而在开启 Fiddler 之后，将会发现实际发出的请求的 HOST 是实际请求的地址

dotnet 解析 TTF 字体文件格式

在 Windows 下，可以使用 DX 提供的强大能力，调用 DX 读取 TTF 字体文件，获取字体文件的信息以及额外的渲染信息。特别是基于 DX 的 WPF 更是加了一层封装，使用 FontFamily 类型提供的友好方法获取到字体的信息。出于学习的目的，本文将不使用任何平台封装好的方法，自己读取二进制的 TTF 文件，解析 TTF 的内容，获取到字体文件里面的字体名

dotnet 读 WPF 源代码笔记为什么自定义的 UserControl 用户控件不能跨程序集继承

从设计上，用户控件 UserControl 就不是一个合适用来多次继承的类型，更不要说进行跨程序集继承自定义的 UserControl 用户控件。对于大部分的用户控件来说，都是采用组合现有的控件来实现的功能，本身应该被当成一个模块来进行使用。在 WPF 框架里面，从框架层阻止了开发者对自定义的 UserControl 用户控件跨程序集继承的逻辑，一旦尝试进行跨程序集继承，将在运行时抛出异常。本文将从源代码的角度告诉大家 WPF 框架是如何阻止跨程序集继承

dotnet 读 WPF 源代码笔记 WPF 是如何做到一套代码兼容多个 .NET Framework 版本

在 .NET Framework 时代里面，有一组有趣的概念，那就是 SDK 和 Runtime 这两个概念。开发模式十分有趣，在开发者设备上，可以指定 .NET Framework 的 SDK 版本，例如指定 .NET Framework 4.5 版本。开发完成之后，分发给到用户，用户的电脑上所安装的 .NET Framework 基本都是 Runtime 版本。应用程序要求运行的 Runtime 版本一定要大于等于 SDK 的指定版本号这就有一个非常有趣的问题了，我开发环境使用的 SDK 是低版本，例如 .NET Framework 4.5 版本。但用户的电脑上所安装的 .NET Framework 的 Runtime 版本是高版本，例如是 .NET Framework 4.7 版本，中间距离过了几年的版本。那行为如何保证相同？如果行为不能保证相同，那将会出现行为差异，在我的开发设备上跑得好好的，在一些用户电脑上，将会因为运行时基础库的版本差异从而变更行为，应用程序就不能符合预期跑起来了。事实上，咱没有碰到过这个问题，这是因为在 .NET Framework 层做了很多兼容处理逻辑，其中就包括本文要和大家聊的 WPF 框架的兼容行为

dotnet 修复在 Linux 上使用 SkiaSharp 提示找不到 libSkiaSharp 库

本文告诉大家如何简单修复在 Linux 上使用 SkiaSharp 提示找不到 libSkiaSharp 库

dotnet 谨慎在静态构造函数里使用锁

在 dotnet 的最佳实践里面，不推荐在静态构造函数里面包含复杂的逻辑，其中也就包含了本文聊的和多线程相关的锁的使用。最佳做法是尽量不要在静态构造函数里面碰到任何和锁以及多线程安全相关的逻辑。本文来告诉大家，在静态构造函数里面使用锁将带来的问题以及原因

dotnet 使用 ConfigureAwait.Fody 库设置默认的 await 同步上下文切换配置

在 dotnet 里面，使用 await 进行异步逻辑，默认是会尝试切换回调用 await 的线程同步上下文。这个机制对于大多数的上层应用来说都是符合逻辑且方便的逻辑，例如对于带 UI 线程的 WPF 或 WinForms 等应用，基础开发的执行逻辑基本都是在 UI 线程上，此时进入一次 await 再出来，期望如果是进入 await 之前是在 UI 线程，那么执行 await 完成之后，退出的代码也能在 UI 线程执行，正好这就是 dotnet 的默认行为。但是对于库开发者来说，情况就反过来的，库的开发者大部分时候更期望默认不要切换回调用方的线程，采用 Fody 的 ConfigureAwait.Fody 库，可以控制此默认的行为。本文将告诉大家如何使用 ConfigureAwait.Fody 库

dotnet 使用 NamedPipeClientStream 连接一个不存在管道服务名将不断空跑 CPU 资源

本文记录一个开发和代码审查过程中，需要关注的细节。在 dotnet 里，在 .NET 6 和以下版本，包括 .NET Framework 版本，使用 NamedPipeClientStream 进行连接管道服务，如果此时的管道服务没有存在，或者还没有启动，调用 ConnectAsync 或 Connect 方法，将会进入一个循环，不断进行空跑，等待超时或者是连接上。默认的 ConnectAsync 或 Connect 方法，传入的超时时间都是无穷，也就是将会无限重试，不断消耗 CPU 资源

dotnet 启动进程传入不存在的文件夹作为工作目录行为变更

本文记录在 dotnet 下，启动进程，传入不存在的文件夹作为进程的工作目录，分别在 .NET Framework 和 .NET Core 的行为

dotnet format 忽略生成代码的格式化

我给团队引入了自动格式化代码机器人，这个机器人有点傻，会将生成的代码也进行格式化，每次都会我的代码生成工具打架。为了让这两个机器人和好，我探索了让 dotnet format 忽略对生成代码进行自动格式化的方法

dotnet 通过 DockerfileContext 解决项目放在里层文件夹导致 VisualStudio 构建失败

本文告诉大家，如何解决 csproj 项目文件放入到里层的文件夹，不放在 sln 所在文件夹的第一层子文件夹，导致 VisualStudio 2022 在构建 docker 映像提示找不到文件的问题

dotnet 根据基线包版本实现库版本兼容

本文来告诉大家如何根据基线包版本的功能来实现自动在构建过程中，告诉开发者，当前版本是否存在不兼容旧版本的变更。其不兼容变更包括二进制中断变更和 API 不兼容变更和源代码中断变更。可以让库开发者花更少的精力在测试兼容性上

dotnet 使用 Newtonsoft.Json 输出枚举首字符小写

本文告诉大家如何使用 Newtonsoft.Json 输出枚举首字符小写

dotnet 写一个支持层层继承属性的对象

我最近在造一个比 Excel 差得多的表格控件，其中一个需求是属性的继承。大家都知道，表格里面有单元格，单元格里面允许放文本，文本可以放多段文本。本文的主角就是文本段落的样式属性，包括文本字体字号颜色等等属性。文本段落的属性，如果没有特别设置，将使用单元格里面的文本样式属性。而如果单元格里面，没有特别指定此单元格使用特殊的文本样式，将会继承使用当前所在的行的文本样式。如果当前行没有特殊指定文本样式属性，那么将会使用文档的默认样式。文档默认样式将会根据是否有特殊指定而采用主题样式如此复杂的层层继承逻辑，如果每个属性都需要自己一层层去寻找，那代码量将会特别多。维护起来就想吃桌子

lindexi

林德熙