add posts

wangb · wangb · commit b886c993b4d6 · 2021-09-28T17:33:27.000+08:00
diff --git a/source/_posts/case-insensitive-containstring.md b/source/_posts/case-insensitive-containstring.md
@@ -0,0 +1,60 @@
+---
+title: "C# 如何在字符串中查找大小写不敏感子字符串"
+date: 2021-09-22T13:24:20+08:00
+description: "在 C# 中如何查找大小写不敏感的子字符串"
+tags: ["C#"]
+categories: ["C# 语言"]
+---
+
+在 C# 中如何查找大小写不敏感的子字符串, 比如我们想要下面的例子返回 `true`:
+
+```c#
+string title = "ASTRINGTOTEST";
+title.Contains("string") == true;
+```
+<!-- more -->
+
+## 对于英语
+
+一种解决方案是将两个字符串都转换成大写或小写, 然后再进行比较:
+
+```c#
+title.ToUpper().Contains("string".ToUpper()) == true;
+```
+
+另一种方案是使用 [`IndexOf` 方法](https://msdn.microsoft.com/en-us/library/ms224425(v=vs.110).aspx), 该方法有一个重载方法可以忽略字符串的大小写, 即 [`StringComparison.OrdinalIgnoreCase`](https://msdn.microsoft.com/en-us/library/system.stringcomparer.ordinalignorecase(v=vs.110).aspx) 作为第二个参数:
+
+```c#
+string title = "STRING";
+bool contains = title.IndexOf("string", StringComparison.OrdinalIgnoreCase) >= 0;
+```
+
+我们还可以为 `String` 定义一个扩展方法, 重载 `Contains`
+
+```c#
+public static class StringExtensions
+{
+    public static bool Contains(this string source, string toCheck, StringComparison comp)
+    {
+        return source?.IndexOf(toCheck, comp) >= 0;
+    }
+}
+```
+
+使用方法:
+
+```c#
+string title = "STRING";
+bool contains = title.Contains("string", StringComparison.OrdinalIgnoreCase);
+```
+
+## 非英语语言解决方案
+不同语言对于大小写的定义是不一样的, 比如在英语中 `I` 和 `i` 是第九个字符的大小写形式, 然而在土耳其语中, 这两个字符分别是[第 19 和 20 个字符](http://en.wikipedia.org/wiki/Dotted_and_dotless_I), 土耳其语中 `i` 的大写形式为 `İ`. 因此 `tin` 和 `TIN` 在英语中是同一个单词, 在土耳其语中前一个词表示 `精神`, 第二个是一个拟声词.
+
+因此上面提供的方法只适用于英语语言, 为了兼容各种不同语言, C# 中提供了 [`CultureInfo`](http://msdn.microsoft.com/en-gb/library/system.globalization.cultureinfo(v=vs.110).aspx) API, 我们可以通过下面方法进行判断:
+
+```c#
+culture.CompareInfo.IndexOf(paragraph, word, CompareOptions.IgnoreCase) >= 0
+```
+
+其中 `culture` 是一个 `CultureInfo` 对象.
diff --git a/source/_posts/csharp-runtime-memory-usage.md b/source/_posts/csharp-runtime-memory-usage.md
@@ -0,0 +1,25 @@
+---
+title: "C# 获取运行时内存占用"
+date: 2021-09-28T14:22:18+08:00
+description: "C# 获取运行时内存占用"
+tags: ["C#", "内存占用"]
+categories: ["C#"]
+---
+
+## 获取 GC 分配的内存
+
+这里输出的是 `GC` 管理的堆上内存.
+
+```c#
+Console.WriteLine("Total Memory: {0}", GC.GetTotalMemory(false));
+```
+<!-- more -->
+
+## 获取进程分配的所有内存
+
+这里输出的是进程从操作系统申请的所有内存, 包括堆, 栈, 静态变量, 本地库申请的内存等, .
+
+```c#
+Process proc = Process.GetCurrentProcess();
+System.Console.WriteLine($"Current Memory Usage: {proc.PrivateMemorySize64}");
+```
diff --git a/source/_posts/csharp-string-difference.md b/source/_posts/csharp-string-difference.md
@@ -0,0 +1,23 @@
+---
+title: "C# 语言 String 和 string 的区别"
+date: 2021-09-22T13:24:20+08:00
+description: "C# 中 String 和 string 类型的区别和适合的使用方式"
+tags: ["C#"]
+categories: ["C# 语言"]
+---
+
+
+在 C# 语言中 `string` 是 `System.String` 的别名. 因此从技术上来说, 这两者没有任何区别, 就像 `int` 和 `System.Int32`.
+<!-- more -->
+
+通常我们推荐使用 `string` 类型声明一个对象.
+
+```c#
+string place = "world";
+```
+
+同时, 推荐使用 `String` 来引用字符串类型中的方法, 属性等, 比如:
+
+```c#
+string greet = String.Format("Hello {0}!", place);
+```
diff --git a/source/_posts/how-to-enumerate-enum-in-csharp.md b/source/_posts/how-to-enumerate-enum-in-csharp.md
@@ -0,0 +1,41 @@
+---
+title: "C# 中如何遍历 Enum 枚举值"
+date: 2021-09-22T15:47:20+08:00
+description: "在 C# 中遍历 Enum 枚举值"
+tags: ["C#"]
+categories: ["C# 语言"]
+---
+
+假如我们有如下 `Shape` 枚举类型, 我们要遍历其中所有的枚举值
+```c#
+public enum Shape
+{
+    Circle,
+    Triangle,
+    Rect
+}
+```
+
+可以通过 [`GetValues`](https://docs.microsoft.com/en-us/dotnet/api/system.enum.getvalues) 方法实现:
+<!-- more -->
+
+```c#
+var shapes = Enum.GetValues(typeof(Shape));
+
+foreach (var shape in shapes)
+{
+    DoSomething(shape);
+}
+```
+
+另外我们还可以做一点封装
+
+```c#
+public static class EnumUtil {
+    public static IEnumerable<T> GetValues<T>() {
+        return Enum.GetValues(typeof(T)).Cast<T>();
+    }
+}
+
+var shapes = EnumUtil.GetValues<Shape>();
+```
diff --git a/source/_posts/mapcontrollerroute-vs-mapdefaultcontrollerroute-mapcontrollers.md b/source/_posts/mapcontrollerroute-vs-mapdefaultcontrollerroute-mapcontrollers.md
@@ -0,0 +1,20 @@
+---
+title: "ASP.NET 中 MapControllerRoute, MapDefaultControllerRoute 和 MapControllers 的区别"
+date: 2021-09-24T12:52:02+08:00
+description: "ASP.NET 中 MapControllerRoute, MapDefaultControllerRoute 和 MapControllers 的区别"
+tags: ["ASP.NET", "路由"]
+categories: ["ASP.NET"]
+---
+
+`MapControllerRoute` 定义了默认的 `Controller` 的路由映射关系, 就像我们在大部分的教程中看到的:
+
+```c#
+app.MapControllerRoute(
+    name: "default",
+    pattern: "{controller=Home}/{action=Index}/{id?}");
+```
+
+`MapDefaultControllerRoute` 是上面代码的缩写形式, 也就是 `pattern` 等于 `{controller=Home}/{action=Index}/{id?}`.
+
+`MapControllers` 没有定义默认的 `Controller` 的路由, 我们需要在 `Controller` 或 `Action` 上使用 `[Route]` 来定义对应的路由, 大部分时候在 `ApiController` 中使用.
+<!-- more -->
diff --git a/source/_posts/net-background-task.md b/source/_posts/net-background-task.md
@@ -0,0 +1,209 @@
+---
+title: "在 .NET 中运行后台任务"
+date: 2021-09-24T09:36:50+08:00
+description: "在 .NET 中运行后台任务"
+tags: [".NET", "后台任务", "定时任务", "队列任务", "Generic Host"]
+categories: [".NET", "ASP.NET"]
+---
+
+在一个 `ASP.NET` 程序中我们常常需要进行比较耗时间的任务, 通常我们不会在一个请求中等待这些任务完成后再返回响应, 比如发邮件, 短信等. 这时候就需要我们将任务放到后台运行, 然后直接返回响应, 告诉用户任务已经再进行了. 本文将教会大家如何在 `.NET` 中运行后台任务, 示例代码请点击[链接](https://github.com/wangbinyq/net-background-task-example)
+<!-- more -->
+
+## 创建 `Worker` 程序
+
+`.NET` 自带了一个后台任务模板, 我们执行 `dotnet new worker -o BackgroundTask` 就可以创建一个通用的 `console` 后台任务程序. 该模板中包含一个 `Worker` 类型, 继承了 `BackgroundService`, 然后在 `HostBuilder` 中通过 `AddHostedService` 注册. 最后调用 `host.RunAsync()` 执行该后台任务. 该示例程序每隔一秒钟打印当前时间.
+
+```c#
+namespace BackgroundTask;
+
+public class Worker : BackgroundService
+{
+    private readonly ILogger<Worker> _logger;
+
+    public Worker(ILogger<Worker> logger)
+    {
+        _logger = logger;
+    }
+
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        while (!stoppingToken.IsCancellationRequested)
+        {
+            _logger.LogInformation("Worker running at: {time}", DateTimeOffset.Now);
+            await Task.Delay(1000, stoppingToken);
+        }
+    }
+}
+```
+
+```c#
+using BackgroundTask;
+
+IHost host = Host.CreateDefaultBuilder(args)
+    .ConfigureServices(services =>
+    {
+        services.AddHostedService<Worker>();
+    })
+    .Build();
+
+await host.RunAsync();
+```
+
+`AddHostedService` 接受一个 `IHostedService` 的泛型参数, 其有两个方法 `StartAsync` 和 `StopAsync`. 一个 `IHostedService` 跟一个单例 `Service` 相似, 只是启动时会调用 `StartAsync` 方法, 结束时调用 `StopAsync` 方法.
+`BackgroundService` 实际上是一个 `IHostedService` 长时间运行的实现. 
+
+现在我们添加一个 `SimpleWorker` 类:
+
+```c#
+namespace BackgroundTask;
+
+public class SimpleWorker : IHostedService
+{
+    private ILogger<SimpleWorker> _logger;
+
+    public SimpleWorker(ILogger<SimpleWorker> logger)
+    {
+        _logger = logger;
+    }
+
+    public Task StartAsync(CancellationToken cancellationToken)
+    {
+        _logger.LogInformation("Simple Worker Start");
+        return Task.CompletedTask;
+    }
+
+    public Task StopAsync(CancellationToken cancellationToken)
+    {
+        _logger.LogInformation("Simple Worker Stop");
+        return Task.CompletedTask;
+    }
+}
+```
+我们还需要在 `Program.cs` 中添加注册.
+
+```c#
+    services.AddHostedService<SimpleWorker>();
+```
+
+现在在启动和结束时会分别打印信息.
+
+![打印信息](/images/background-task/task-1.png)
+
+
+## 使用 `Timer` 进行定时任务
+
+默认的 `Worker` 实现定时每秒钟打印执行的效果, 我们也可以使用 `Timer` 可以获得同样的效果.
+
+```c#
+namespace BackgroundTask;
+
+public class TimerWorker : IHostedService
+{
+    private int _count = 0;
+    private ILogger<TimerWorker> _logger;
+    private Timer? _timer;
+
+    public TimerWorker(ILogger<TimerWorker> logger)
+    {
+        _logger = logger;
+    }
+
+    public Task StartAsync(CancellationToken cancellationToken)
+    {
+        _logger.LogInformation("Timer Worker Start");
+        _timer = new Timer(DoWork, null, TimeSpan.Zero, TimeSpan.FromSeconds(5));
+
+        return Task.CompletedTask;
+    }
+
+    public Task StopAsync(CancellationToken cancellationToken)
+    {
+        _logger.LogInformation("Timer Worker Stop");
+
+        return Task.CompletedTask;
+    }
+
+    private void DoWork(object? state)
+    {
+        var count = Interlocked.Increment(ref _count);
+
+        _logger.LogInformation($"count = {count}, time: {DateTimeOffset.Now}");
+    }
+}
+```
+
+同时别忘了注册该 `Service`.
+
+![定时任务](/images/background-task/task-2.png)
+
+## 使用 `Channel` 创建任务队列
+
+更常见的使用后台任务的方式是使用队列, `.NET` 为我们提供了 `System.Threading.Channel` 类. 这里我们需要两个 `Worker`: 一个作为生产者, 一个作为消费者:
+
+```c#
+namespace BackgroundTask;
+
+using System.Threading.Channels;
+
+public class ProducerWorker : BackgroundService
+{
+    private int _count = 0;
+    private Channel<int> _queue;
+
+    public ProducerWorker(Channel<int> queue)
+    {
+        _queue = queue;
+    }
+
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        while (!stoppingToken.IsCancellationRequested)
+        {
+            var count = Interlocked.Increment(ref _count);
+            await _queue.Writer.WriteAsync(count, stoppingToken);
+            await Task.Delay(1000, stoppingToken);
+        }
+    }
+}
+```
+
+```c#
+namespace BackgroundTask;
+
+using System.Threading;
+using System.Threading.Channels;
+using System.Threading.Tasks;
+
+public class ConsumerWorker : BackgroundService
+{
+    private Channel<int> _queue;
+    private ILogger<ConsumerWorker> _logger;
+
+    public ConsumerWorker(Channel<int> queue, ILogger<ConsumerWorker> logger)
+    {
+        _queue = queue;
+        _logger = logger;
+    }
+
+    protected override async Task ExecuteAsync(CancellationToken stoppingToken)
+    {
+        while (!stoppingToken.IsCancellationRequested)
+        {
+            var count = await _queue.Reader.ReadAsync(stoppingToken);
+
+            _logger.LogInformation($"do work for: {count}");
+        }
+    }
+}
+```
+
+同时我们需要通过依赖注入注入一个 `Channel<int>` 的单例:
+
+```c#
+var queue = Channel.CreateBounded<int>(10);
+services.AddSingleton(queue);
+services.AddHostedService<ProducerWorker>();
+services.AddHostedService<ConsumerWorker>();
+```
+
+![队列任务](/images/background-task/task-3.png)
diff --git a/source/_posts/openapi-codegen-aspnet.md b/source/_posts/openapi-codegen-aspnet.md
diff --git a/source/_posts/vscode-justmycode.md b/source/_posts/vscode-justmycode.md
