Skip to content

Latest commit

 

History

History
332 lines (233 loc) · 10.2 KB

episode-039.md

File metadata and controls

332 lines (233 loc) · 10.2 KB

.NET 每周分享第 39 期

卷首语

C# 12 的新功能预览

  1. nameof 可以访问成员变量，包括初始化，静态变量和注解
  2. 内联数组： 可以标记 [System.Runtime.CompilerServices.InlineArray(10)] 方式在内存中创建 10 个元素
  3. Interceptors: 这是一项实验功能，可以让特定的方法调用路由到不同的代码。

行业资讯

1、Azure AD 改名 Microsoft Entra

image

微软改名部继续工作，将 Azure AD 改名为 Microsoft Entra。这个改名对于 .NET 开发者而言，没有任何影响。

文章推荐

1、最小的 Hello world 程序

image

Hello World 是每个编程语言的第一个 demo， 那么对于 C# 而言，一个简单的 Hello world 应用程序会暂用多大的磁盘空间呢？

using System;
namespace ConsoleApp1;
internal static class Program
{
    public static void Main(string[] args)
    {
        Console.WriteLine("Hello, World!");
    }
}

这段代码在 .NET Framework 4.7.2 版本下， 生成可执行文件的大小为 5kb，那么作者是如何一步步将它减少体积的呢？

  • 移除 Nullable 属性
  • 手动创建 .NET Module
  • 移除引入和基础重定位
  • 删除名称 metadata
  • 删除更多的 metadata
  • 不适用 System.Console.WriteLine

最终的 Hello World 文件大小定格在 476 字节。

2、分析器认为有错误写法

image

在 .NET 8 中， Code Analysis 为 C# 代码更多的检查，比如下面 6 种例子

  1. ConstantExpected
public static void ProcessValue([ConstantExpected (Min = 20)]int value)
{
}

如果方法的参数增加了 ConstantExpected 的注解，那么要求方法的调用必须传入常量

  1. Linq 中的 Any
public static bool HasElement(string[] strings)
{
      return strings.Any();
}

通常 Linq 中的 Any() 方法可以判断是否存在元素，但是如果是具体的类型，比如 Array, List 等，则分析器提示使用 strings.Length !=0 的方式。

  1. Split
public static string[] SplitText(string text)
{
    return text.Split(new char[] { ' ', ',' });
}

在这个方法中，每次调用 SplitText 方法，都会创建一个 char[] 对象，这样增加了内存压力，所以分析器建议将 array 对象设置为一个只读对象，并且只初始化一次。

  1. Cast
var test = new int[] { 1 }.Cast<string>();

这个代码在运行的时候会抛出 InvalidCastExpection ，现在分析器会检测到这个错误并且在编译的时候给出这样提示。

在 Runtime repo 中的 issue，它列出可以增加的分析功能。

3、你应该学习 Blazor 吗？

image

Blazor 的未来是怎样的？我们需要学习吗？这个视频给了一些介绍。

4、高效连接字符串和字符

image

C# 中字符串的 + 操作符是转换为 string.Concat 方法调用。如果是一个字符串连接一个字符呢？有没有什么其他方法，并且能够使用更高的性能呢？ string.Concat 有另一个方法签名，接受的参数类型是 ReadOnlySpan<Char>, 所以只需要将 char 类型转化为 ReadOnlySpan<char> 即可

[MemoryDiagnoser]
public class StringConcatBenchmark
{
    private string Part1 = "abc";
    private char Part2_Char = 'd';
    private string Part2_String = "d";
    private string Part3 = "efg";

    [Benchmark(Baseline = true)]
    public string Operator_String_Char_String() => Part1 + Part2_Char + Part3;

    [Benchmark]
    public string Operator_String_String_String() => Part1 + Part2_String + Part3;

    [Benchmark]
    public string String_Concat() => string.Concat(Part1, new ReadOnlySpan<char>(in Part2_Char), Part3);
}

benchmark 结果如下 image

5、Powershell 定制自动任务

image

如果我们想要在 Widnows 中注册一个定时任务，使用 PowerShell 那么该怎么做呢？

  1. 注册一个Action
$Action = New-ScheduledTaskAction -Execute 'pwsh.exe' -Argument '-NonInteractive -NoLogo -NoProfile -File "C:\MyScript.ps1"'

首先通过 New-ScheduledTaskAction 注册一个 Action，它知名了执行的命令和相关的参数

  1. 定制一个 Trigger
$Trigger = New-ScheduledTaskTrigger -Once -At 3am

定义一个 Trigger 用来什么时候启动这个任务，比如每次早上 3 点运行

  1. 配置
$Settings = New-ScheduledTaskSettingsSet

通过从 Setting 配置任务的额外信息，比如执行超时，是否 retry 等等。

  1. 创建 Task
$Task = New-ScheduledTask -Action $Action -Trigger $Trigger -Settings $Settings

根据 Action, Trigger 和 Setting 创建要给 Task

  1. 注册任务
Register-ScheduledTask -TaskName 'My PowerShell Script' -InputObject $Task

目前任务是保存在内存中，通过 Register-ScheduleTask 将这个对象注册到操作系统中。

6、写出 Clean Code 的 8 个技巧

如果有这样一段 C# 代码，该如何优化呢？

public void Process(Order? order)
{
    if (order != null)
    {
        if (order.IsVerified)
        {
            if (order.Items.Count > 0)
            {
                if (order.Items.Count > 15)
                {
                    throw new Exception(
                        "The order " + order.Id + " has too many items");
                }

                if (order.Status != "ReadyToProcess")
                {
                    throw new Exception(
                        "The order " + order.Id + " isn't ready to process");
                }

                order.IsProcessed = true;
            }
        }
    }
}

那么 8 个建议重构更好的代码

  • 尽早返回
  • 合并更多的 If 判断条件
  • 使用 Linq 让代码更加简洁
  • 使用特定的方法来重构 If 判断条件
  • 抛出自定义异常
  • 将魔数转换为常量
  • 将字符串转化为枚举类型
  • 使用返回结果类型，而不是直接修改输入

7、如何正确的使用 HttpClient 类

image

HttpClient 类是 C# 代码中广泛使用的类型，那么该怎么最好的使用这个类型呢？

  1. 普通方式
 var client = new HttpClient();
//...
  1. 使用 IHttpClientFactory
var client = _factory.CreateClient();
//....

Microsoft.Extensions.Http 推荐的使用方式

  1. Name Client
{
    var settings = serviceProvider
        .GetRequiredService<IOptions<GitHubSettings>>().Value;
    client.BaseAddress = new Uri("https://api.github.com");
});

 var client = _factory.CreateClient("github");
  1. Type client
services.AddHttpClient<GitHubService>((serviceProvider, client) =>
{
    var settings = serviceProvider
        .GetRequiredService<IOptions<GitHubSettings>>().Value;
    client.BaseAddress = new Uri("https://api.github.com");
});

public class GitHubService
{
    private readonly HttpClient client;

    public GitHubService(HttpClient client)
    {
        _client = client;
    }

    public async Task<GitHubUser?> GetUserAsync(string username)
    {
        GitHubUser? user = await client
            .GetFromJsonAsync<GitHubUser>($"users/{username}");

        return user;
    }
}

这样在应用程序中，只需要在依赖注入框架中获取 GithubSerivce 对象即可，注意这是一个 transient 注入方式。

开源项目

1、MSBuilder 编辑器

image

MSBuild Editor 插件是用来管理 C# 的 MSBuild 文件，主要有下面几个功能

  • 智能提示
  • 导航
  • 快速查询
  • 验证和分析
  • 重构和代码修复
  • schemas 修改
  • 导入

2、TextUtility

image

Microsoft.Powershell.TextUtility 是 Powershell 中的文本处理库，只要包含一下三个函数

  1. Compare-Text

它实现了 diff-match-path

image

  1. ConvertFrom-Base64/ConvertTo-Base64

它主要是将字符串转换成 Base64 或者将 Base64 转成成字符串。

> ConvertTo-Base64 "dotnetweekly"
# ZG90bmV0d2Vla2x5
> ConvertFrom-Base64 "ZG90bmV0d2Vla2x5"
# dotnetweekly
  1. ConvertFrom-TextTable

这个主要是将文本的表格转换成一个实体对象

> $string = $("a".."z";"A".."Z";0..9) -join ""
> 1..10 | %{$string}|convertfrom-texttable -noheader -columnoffset 0,15,23,40,55 | ft

image