हम आपको स्रोत कोड जनरेटर का पूर्वावलोकन प्रस्तुत करने की कृपा कर रहे हैं। यह एक नई सुविधा है जो सी # डेवलपर्स को कस्टम कोड का विश्लेषण करने और नई सी # फाइलें बनाने की अनुमति देता है, जो बदले में संकलन प्रक्रिया में जोड़ा जा सकता है। यह एक नए घटक - स्रोत जनरेटर की मदद से होता है।

जनरेटर के साथ आरंभ करने के लिए, आपको नवीनतम .NET 5 पूर्वावलोकन और Visual Studio पूर्वावलोकन की आवश्यकता है । नोट: सोर्स कोड जनरेटर के निर्माण के लिए विजुअल स्टूडियो की आवश्यकता होती है। इसे .NET 5 के अगले पूर्वावलोकन में बदला जाएगा।

एक स्रोत कोड जनरेटर क्या है?

एक स्रोत कोड जनरेटर कोड का एक टुकड़ा है जिसे संकलन समय पर निष्पादित किया जाता है, कार्यक्रम की जांच करता है और अतिरिक्त फाइलें बनाता है, जो तब बाकी कोड के साथ संकलित की जाती हैं।

यहां दो मुख्य विशेषताएं हैं जो आपको इसे लागू करने की अनुमति देती हैं:

• एक संकलन ऑब्जेक्ट प्राप्त करें जो सभी संकलित उपयोगकर्ता कोड का प्रतिनिधित्व करता है। इस ऑब्जेक्ट का विश्लेषण किया जा सकता है, और आप कोड लिख सकते हैं जो संकलित कोड के सिंटैक्टिक और सिमेंटिक मॉडल के साथ काम करता है, जैसा कि आधुनिक विश्लेषक के मामले में है।
• C# , . , .

. , , C# . Roslyn, , C#.

:

.NET Standard 2.0, , .NET Standard.

, .

, .

— , , , .

: , IL (IL weaving) MSBuild. .

— .NET. . .

, ASP.NET Core - , , razor . , : - , , , , . , .

— . .

, . MSBuild C# ( CSC) . , . MSBuild, , .

, — "-" (“stringly-typed”) API. , , ASP.NET Core razor. . , , .

API . -, .

Ahead-of-Time (AOT)

linker-based AOT-. , System.Text.Json, System.Text.RegularExpressions; ASP.NET Core WPF, / .

NuGet . .NET, "" ( “linkability”) AOT . OSS , .NET.

Hello World-

, .

, “Hello World” , . :

public class SomeClassInMyCode
{
    public void SomeMethodIHave()
    {
        HelloWorldGenerated.HelloWorld.SayHello(); 
        //  Console.WriteLine("Hello World!")     
    }
}

, :

1. .NET.

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>netstandard2.0</TargetFramework>
    <LangVersion>preview</LangVersion>
  </PropertyGroup>

  <PropertyGroup>
    <RestoreAdditionalProjectSources>https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet5/nuget/v3/index.json ;$(RestoreAdditionalProjectSources)</RestoreAdditionalProjectSources>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="3.6.0-3.20207.2" PrivateAssets="all" />
    <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.0.0-beta2.final" PrivateAssets="all" />
  </ItemGroup>

</Project>

2. C#, .

using Microsoft.CodeAnalysis;
using Microsoft.CodeAnalysis.Text;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Text;
using System.Xml;

namespace MyGenerator
{
    [Generator]
    public class MySourceGenerator : ISourceGenerator
    {
        public void Execute(SourceGeneratorContext context)
        {
            // TODO -     
        }

        public void Initialize(InitializationContext context)
        {
             //     
        }
    }
}

Microsoft.CodeAnalysis.Generator Microsoft.CodeAnalysis.ISourceGenerator.

3. .

using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.CodeAnalysis;
using Microsoft.CodeAnalysis.Text;

namespace SourceGeneratorSamples
{
    [Generator]
    public class HelloWorldGenerator : ISourceGenerator
    {
        public void Execute(SourceGeneratorContext context)
        {

            // ,       
            var sourceBuilder = new StringBuilder(@"

using System;
namespace HelloWorldGenerated
{
    public static class HelloWorld
    {
        public static void SayHello() 
        {
            Console.WriteLine(""   !"");
            Console.WriteLine(""       "");
");

           //  ,       
            var syntaxTrees = context.Compilation.SyntaxTrees;
            //        ,   
            foreach (SyntaxTree tree in syntaxTrees)
            {
                sourceBuilder.AppendLine($@"Console.WriteLine(@"" - {tree.FilePath}"");");
            }
            //   
            sourceBuilder.Append(@"
        }
    }
}");
            //      
            context.AddSource("helloWorldGenerator", SourceText.From(sourceBuilder.ToString(), Encoding.UTF8));
        }

        public void Initialize(InitializationContext context)
        {
              //     
        }
    }
}

4. LangVersion .

<!--        -->
<PropertyGroup>
  <LangVersion>preview</LangVersion>
</PropertyGroup>

<!--   ItemGroup,       -->
<ItemGroup>
<!--   ,    "" ProjectReference. 
   'OutputItemType'  'ReferenceOutputAssmbly'. -->
    <ProjectReference Include="path-to-sourcegenerator-project.csproj" 
                      OutputItemType="Analyzer"
                      ReferenceOutputAssembly="false" />
</ItemGroup>

Roslyn, .

Visual Studio , . , :

public class SomeClassInMyCode
{
    public void SomeMethodIHave()
    {
        HelloWorldGenerated.HelloWorld.SayHello(); 
        //  Console.WriteLine("Hello World!")     
    }
}

: Visual Studio, IntelliSense

:

• , , INotifyPropertyChanged,
• , SourceGeneratorContext,
• JSON- . .

Source Generators Cookbook.
GitHub.

, — , IntelliSense , Visual Studio.

. — . API . C# 9, API , .

C# : ! .NET , C# – . , - .

:

• API ,
• source Generators cookbook .

, .

Visual Studio , “ 1.0”. , . .NET 5 . , API, - OSS.

. , . .

FAQ

, . .

— , ?

— , , , . , . , , . , - , .

F#?

F#. . , F# , . — , C#, , C# .

?

. — . “”, . .

?

, . , , . C#, . -.

/ ?

. , / . , C#.

?

C# 9. , .

TFM ?

. .NET Standard 2.0 TFM . .NET Standard 2.0.

Visual Basic F#?

#. , . VB . F# — .

?

, . VB F# , , . . . , , .

Intellisense ? Visual Studio , ?

Visual Studio. . Visual Studio .

Visual Studio?

Visual Studio.

?

NuGet, , . .

Microsoft ?

. . , Microsoft .

LangVersion ?

यद्यपि स्रोत कोड जनरेटर तकनीकी रूप से C # भाषा विशेषता नहीं है, लेकिन वे पूर्वावलोकन में हैं। केवल उनके लिए एक नई सेटिंग शुरू करने के बजाय, हमने फैसला किया कि मौजूदा स्विच का उपयोग करना आसान होगा, जो आपको C # संकलक की भाषा विशेषताओं को देखने की अनुमति देता है।