ToB企服应用市场:ToB评测及商务社交产业平台

标题: .Net Core 你必须知道的source-generators [打印本页]
作者: 写过一篇    时间: 2024-5-14 08:10
标题: .Net Core 你必须知道的source-generators
源天生器是 C# 9 中引入的一项功能，允许在编译过程中动态天生代码。
它们直接与 C# 编译器集成(Roslyn)并在编译时运行，分析源代码并根据分析结果天生附加代码。
源天生器提供了一种简化的主动化代码天生方法，无需外部工具或单独的预编译步骤。
通过无缝集成到编译过程中，源天生器可以提高生产力、淘汰错误并实现更高效的开发工作流程。
 
如何利用
创建 .NET 控制台应用步伐。 此示例利用 .NET 6。将 Program 类替换为以下代码。 
  1. namespace ConsoleApp;
  3. partial class Program
  4. {
  5.     static void Main(string[] args)
  6.     {
  7. <ItemGroup>
  8.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  9.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  10. </ItemGroup>HelloFrom("Generated Code");
  11.     }
  13.     static partial void HelloFrom(string name);
  14. }
复制代码
接下来，我们将创建一个源天生器项目来实现 partial void HelloFrom 方法对应项。
创建一个以 netstandard2.0 目标框架名字对象为目标的 .NET 类库。 添加以下 NuGet 包
  1. <ItemGroup>
  2.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  3.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  4. </ItemGroup>
复制代码
 
然后，创建一个名为 HelloSourceGenerator.cs 的新 C# 文件，该文件指定你自己的源天生器，如下所示：
  1. using Microsoft.CodeAnalysis;namespace SourceGeneratorInCSharp{    [Generator]    public class SourceGenerator : ISourceGenerator    {<ItemGroup>
  2.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  3.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  4. </ItemGroup>public void Execute(GeneratorExecutionContext context)<ItemGroup>
  5.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  6.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  7. </ItemGroup>{<ItemGroup>
  8.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  9.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  10. </ItemGroup>    // Find the main method<ItemGroup>
  11.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  12.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  13. </ItemGroup>    var mainMethod = context.Compilation.GetEntryPoint(context.CancellationToken);<ItemGroup>
  14.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  15.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  16. </ItemGroup>    // Build up the source code<ItemGroup>
  17.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  18.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  19. </ItemGroup>    string source = $@"// using System;namespace {mainMethod.ContainingNamespace.ToDisplayString()}{{    public static partial class {mainMethod.ContainingType.Name}    {{<ItemGroup>
  20.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  21.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  22. </ItemGroup>static partial void HelloFrom(string name) =><ItemGroup>
  23.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  24.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  25. </ItemGroup>    Console.WriteLine($""Generator says: Hi from '{{name}}'"");    }}}}";<ItemGroup>
  26.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  27.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  28. </ItemGroup>    var typeName = mainMethod.ContainingType.Name;<ItemGroup>
  29.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  30.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  31. </ItemGroup>    // Add the source code to the compilation<ItemGroup>
  32.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  33.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  34. </ItemGroup>    context.AddSource($"{typeName}.g.cs", source);<ItemGroup>
  35.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  36.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  37. </ItemGroup>}<ItemGroup>
  38.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  39.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  40. </ItemGroup>public void Initialize(GeneratorInitializationContext context)<ItemGroup>
  41.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  42.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  43. </ItemGroup>{<ItemGroup>
  44.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  45.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  46. </ItemGroup>    // No initialization required for this one<ItemGroup>
  47.     <PackageReference Include="Microsoft.CodeAnalysis.CSharp" Version="4.8.0" PrivateAssets="all" />
  48.     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.3.4" PrivateAssets="all" />
  49. </ItemGroup>}    }}
复制代码
 
现在，我们有一个正常运行的天生器，但须要将其引用到控制台应用步伐。 
新引用不是传统的项目引用，必须手动编辑以包含 OutputItemType 和 ReferenceOutputAssembly 属性。
  1. <ItemGroup>
  2.     <ProjectReference Include="..\SourceGeneratorInCSharp\SourceGeneratorInCSharp.csproj"
  3.                         OutputItemType="Analyzer"
  4.                         ReferenceOutputAssembly="false" />
  5. </ItemGroup>
复制代码
 
现在，运行控制台应用步伐时，应会看到天生的代码运行并打印到屏幕。
控制台应用步伐本身不实现 HelloFrom 方法，而是在编译过程中从源天生器项目天生的源。

 
如果利用的是 Visual Studio，则可以看到源天生的文件。
在“办理方案资源管理器”窗口中，展开“依赖项”>“分析器”>“SourceGenerator”>“SourceGenerator.HelloSourceGenerator”，然后双击“Program.g.cs”文件即可看到天生的内容。

 
https://learn.microsoft.com/zh-cn/dotnet/csharp/roslyn-sdk/source-generators-overview
 

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。



欢迎光临 ToB企服应用市场:ToB评测及商务社交产业平台 (https://dis.qidao123.com/) Powered by Discuz! X3.4