在 .NET 中可以使用三条斜杠 /// 启用 XML注释，XML注释具有很强大的表现力，但貌似很多人都只是使用最简单的样式，今天就记录和分享一下个人项目中经常使用，且很有帮助的一些花式XML注释

[FromRoute] 和 [FromBody] 默认情况下是不能同时使用的，会接收不到路由参数，但也不是完全没有办法。起码有两种办法可以使他们同时生效：一种是通过自定义 ModelBinder； 另一种则需要禁用掉框架默认的 “自动推断参数绑定来源”。

using (var scope = new TransactionScope())
{
	// ...
	scope.Complete();
}

TransactionScope 提供分布式事务的相关功能，但在单纯的数据库事务且不涉及到分布式的情况下，要想用好他可不容易。但是 TransactionScope 的代码写法又很美，有没有什么办法自己实现一个呢？

接入ES之后，json格式的日志在查找效率方面将会更加高效

将非 UTF-8 字符写入 Azure Storage Table 时会发生异常，Microsoft.WindowsAzure.Storage.StorageException: Unable to translate Unicode character xxx at index xxx to specified code page. 所以需要先从字符串中过滤掉非 UTF-8 的字符。

如果使用默认配置选项， AutoMapper 会自作主张的将值为 null 的集合类型的字段转换为空集合。

在向 HttpClient 添加 Header 时，默认会进行合法性检查，但有的时候，服务的提供者要求的 Header 并不总是合乎规范的。

如果在路由的最后一节中包含英文句号(.), 则会被识别为 “文件名.扩展名” 的形式，从而导致使用 StaticFileHandler，以静态文件的方式来处理请求，所以就会404。

搭建并使用私有的 nuget server 是很常见的，但是在进行包还原的时候，我们也需要指定 --configfile 参数才行。