किसी मौजूदा प्रोजेक्ट को ASP.NET MVC से ASP.NET कोर में कैसे अपग्रेड किया जाए। प्रैक्टिकल गाइड

यह पोस्ट ASP.NET MVC से ASP.NET कोर में एक मौजूदा प्रोजेक्ट को माइग्रेट करने के हमारे अनुभव से पैदा हुई थी। हमने पूरी माइग्रेशन प्रक्रिया को एक संरचित रूप में एक साथ रखने और विभिन्न बाधाओं का वर्णन करने की कोशिश की ताकि डेवलपर्स इस सामग्री पर भरोसा करते रहें और ऐसी समस्याओं को हल करने में रोडमैप का पालन कर सकें।

हमारे प्रोजेक्ट के बारे में कुछ शब्द। हम ASP.NET पर एक ओपन-सोर्स ईकामर्स प्लेटफॉर्म हैं, जो ट्रांसफर के समय तक 9 वर्षों से सफलतापूर्वक चल रहा था। हमने 2 साल पहले प्रवास किया था - लेकिन हमारे हाथ केवल इसके बारे में लिखने के लिए आया था। उस समय, हम पहली बड़ी परियोजनाओं में से एक थे जिन्होंने इस तरह के कदम पर फैसला किया।

ASP.NET कोर पर स्विच क्यों करें?

ASP.NET MVC से ASP.NET Core में माइग्रेट करने के चरणों के साथ आगे बढ़ने से पहले, इस प्लेटफ़ॉर्म के लाभों के बारे में कुछ शब्द।




अब बात करते हैं कि एक नए प्लेटफ़ॉर्म पर अपने एप्लिकेशन को पोर्ट करते समय आपको क्या विचार करना चाहिए।

प्रवास

विषय पर अधिक विस्तृत जानकारी प्राप्त करने में मदद करने के लिए पाठ में बड़ी संख्या में आधिकारिक ASP.NET कोर दस्तावेज होंगे। पहली बार समान कार्य के साथ सामना करने वाले डेवलपर्स के लिए विशेष रूप से प्रासंगिक।

चरण 1. उपकरणों की तैयारी

पहली चीज जो आपको करने की ज़रूरत है वह दृश्य स्टूडियो 2017 को 15.3 या उच्चतर संस्करण में अपग्रेड करना है। और .NET कोर एसडीके के नवीनतम संस्करण को स्थापित करें।

माइग्रेशन शुरू करने से पहले, हम अनुशंसा करते हैं कि आप .NET .Net पोर्टेबिलिटी एनालाइज़र पोर्टेबिलिटी एनालिसिस टूल का उपयोग करें। यह समझने के लिए एक अच्छा प्रारंभिक बिंदु है कि एक मंच से दूसरे में संक्रमण कितना श्रमसाध्य होगा। लेकिन, निश्चित रूप से, यह उपकरण सभी समस्याओं का समाधान नहीं करता है, और इस प्रक्रिया में कई नुकसान होंगे। अगला, जिन मुख्य चरणों को पारित करने की आवश्यकता होगी, उनका वर्णन किया जाएगा, और हमारी परियोजना में उपयोग किए गए समाधान दिखाए जाएंगे।

सबसे पहली चीज जो आपको चाहिए वह है प्रोजेक्ट में प्रयुक्त पुस्तकालयों के लिंक को अद्यतन करना जो .NET मानक का समर्थन करेंगे।

चरण 2. समर्थन करने के लिए NuGet संकुल का संगतता विश्लेषण .Net मानक

यदि आप अपने प्रोजेक्ट में NuGet पैकेज का उपयोग करते हैं, तो आपको यह जांचने की आवश्यकता है कि क्या वे .NET कोर के साथ संगत हैं। ऐसा करने का एक तरीका NuGetPackageExplorer टूल का उपयोग करना है।

चरण 3. .NET कोर नए csproj फ़ाइल स्वरूप का उपयोग करता है

.NET कोर में पेश किए गए तृतीय-पक्ष लिंक को जोड़ने के लिए नए दृष्टिकोण का उपयोग करना महत्वपूर्ण है: जब समाधान में एक नया वर्ग पुस्तकालय जोड़ा जाता है, तो आपको मुख्य परियोजना फ़ाइल को खोलना चाहिए और इसकी सामग्री को निम्नलिखित के साथ बदलना चाहिए:

<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>netcoreapp2.2</TargetFramework> </PropertyGroup> <ItemGroup> <PackageReference Include="Microsoft.AspNetCore.App" Version="2.2.6" /> ... </ItemGroup> ... </Project> 

कनेक्टेड लाइब्रेरी के लिंक अपने आप डाउनलोड हो जाएंगे। Project.json और CSPROJ संपत्तियों के बीच मानचित्रण के बारे में अधिक जानकारी आधिकारिक दस्तावेज में यहां और यहां पाई जा सकती है ।

चरण 4. नामस्थान को अद्यतन करना

आपको System.Web के सभी उपयोगों को हटाना होगा और उन्हें Microsoft.AspNetCore से बदलना होगा।

चरण 5. आपको Startup.cs फ़ाइल को कॉन्फ़िगर करना होगा। वैश्विक उपयोग के बजाय

ASP.NET Core में एप्लिकेशन लोड करने के लिए एक नया तंत्र है। आवेदन के लिए प्रवेश बिंदु Startup बन जाता है, और Global.asax फ़ाइल पर निर्भरता गायब हो जाती है। Startup आवेदन में मिडलवेयर सुइट का पंजीकरण करता है। Startup में Configure विधि शामिल होनी चाहिए। Configure आवश्यक मिडलवेयर को पाइपलाइन में जोड़ें।

Startup.cs समस्याएं

1. MVC और WebAPI अनुरोधों के लिए मिडिलवेयर कॉन्फ़िगर करना
2. इसके लिए कॉन्फ़िगरेशन सेटिंग्स:

• अपवाद संभालना
  

  चूंकि संक्रमण की प्रक्रिया में, आपको अनिवार्य रूप से विभिन्न प्रकार के टकरावों से निपटना होगा, आपको तुरंत तैयार करना होगा और विकास के माहौल में अपवाद हैंडलिंग स्थापित करना होगा। UseDeveloperExceptionPage का उपयोग करके अपवादों को पकड़ने के लिए मिडलवेयर जोड़ा जाता है।

• रूटिंग एम.वी.सी.
  

  नए मार्गों के पंजीकरण में भी बदलाव किया गया है। IRouteBuilder का उपयोग अब रूटकॉलेक्शन के बजाय, बाधाओं को दर्ज करने का एक नया तरीका है (IActionConstraint)

• MVC / WebAPI फ़िल्टर
  

  ASP.NET कोर के नए कार्यान्वयन के अनुसार फ़िल्टर को फिर से लिखना आवश्यक है।

• MVC / WebAPI प्रारूपकार
• बाइंडिंग मॉडल

 //add basic MVC feature var mvcBuilder = services.AddMvc(); //add custom model binder provider (to the top of the provider list) mvcBuilder.AddMvcOptions(options => options.ModelBinderProviders.Insert(0, new NopModelBinderProvider())); /// <summary> /// Represents model binder provider for the creating NopModelBinder /// </summary> public class NopModelBinderProvider : IModelBinderProvider { /// <summary> /// Creates a nop model binder based on passed context /// </summary> /// <param name="context">Model binder provider context</param> /// <returns>Model binder</returns> public IModelBinder GetBinder(ModelBinderProviderContext context) { if (context == null) throw new ArgumentNullException(nameof(context)); var modelType = context.Metadata.ModelType; if (!typeof(BaseNopModel).IsAssignableFrom(modelType)) return null; //use NopModelBinder as a ComplexTypeModelBinder for BaseNopModel if (context.Metadata.IsComplexType && !context.Metadata.IsCollectionType) { //create binders for all model properties var propertyBinders = context.Metadata.Properties .ToDictionary(modelProperty => modelProperty, modelProperty => context.CreateBinder(modelProperty)); return new NopModelBinder(propertyBinders, EngineContext.Current.Resolve<ILoggerFactory>()); } //or return null to further search for a suitable binder return null; } } 

• क्षेत्रों

 app.UseMvc(routes => { routes.MapRoute("areaRoute", "{area:exists}/{controller=Admin}/{action=Index}/{id?}"); routes.MapRoute( name: "default", template: "{controller=Home}/{action=Index}/{id?}"); }); 

उसी समय, नाम क्षेत्र वाला फ़ोल्डर, जिसके अंदर व्यवस्थापक फ़ोल्डर स्थित है, को आवेदन की जड़ में रखा जाना चाहिए। अब, इस क्षेत्र के साथ नियंत्रक को जोड़ने के लिए [Area("Admin")] [Route("admin")] विशेषता का उपयोग किया जाएगा।
यह केवल नियंत्रक में वर्णित सभी कार्यों के लिए दृश्य बनाने के लिए बनी हुई है।

 [Area("Admin")] [Route("admin")] public class AdminController : Controller { public IActionResult Index() { return View(); } } 

मान्यता

अब आपको नियंत्रकों को IFormCollection पास करने की आवश्यकता नहीं है, क्योंकि इस मामले में asp.net सर्वर सत्यापन अक्षम है - यदि IFormCollection शून्य नहीं पाया जाता है तो MVC आगे की मान्यता को दबा रहा है। समस्या का समाधान इस संपत्ति को मॉडल में जोड़ सकता है, यह हमें नियंत्रक विधि से सीधे गुजरने से रोकेगा। यह नियम केवल तभी मान्य है जब कोई मॉडल मौजूद है, लेकिन यदि कोई मॉडल नहीं है, तो कोई सत्यापन नहीं होगा।

बाल संपत्तियों को अब स्वचालित रूप से मान्य नहीं किया जाता है। इसे मैन्युअल रूप से निर्दिष्ट किया जाना चाहिए।

चरण 6. HTTP हैंडलर और HTTP मॉड्यूल को मिडलवेयर में स्थानांतरित करना

HTTP हैंडलर्स और HTTP मॉड्यूल अनिवार्य रूप से ASP.NET Core में मिडलवेयर कॉन्सेप्ट के समान हैं, लेकिन मॉड्यूल के विपरीत, मिडिलवेयर ऑर्डर उस ऑर्डर पर आधारित होता है, जिसमें वे रिक्वेस्ट पाइपलाइन में डाले जाते हैं। अधिकांश भाग के लिए मॉड्यूल का क्रम अनुप्रयोग जीवन चक्र की घटनाओं पर आधारित है। उत्तरों के लिए मिडिलवेयर का क्रम अनुरोधों के क्रम के विपरीत है, और अनुरोधों और उत्तरों के लिए मॉड्यूल का क्रम समान है। इसके आधार पर, आप अपग्रेड के साथ आगे बढ़ सकते हैं।

इसलिए, जो अपडेट होना बाकी है:

• Middleware (AuthenticationMiddleware, CultureMiddleware, आदि) के लिए मॉड्यूल का प्रवासन
• मिडलवेयर को हैंडलर
• न्यू मिडलवेयर का उपयोग करना

हमारी परियोजना में प्रमाणीकरण बिल्ट-इन क्रेडेंशियल सिस्टम का उपयोग नहीं करता है, इन उद्देश्यों के लिए, मिडिलवेयर ऑथेंटिकेशनमेडिलवेयर का उपयोग किया जाता है, जिसे नए ASP.NET कोर संरचना के अनुसार विकसित किया गया है।

 public class AuthenticationMiddleware { private readonly RequestDelegate _next; public AuthenticationMiddleware(IAuthenticationSchemeProvider schemes, RequestDelegate next) { Schemes = schemes ?? throw new ArgumentNullException(nameof(schemes)); _next = next ?? throw new ArgumentNullException(nameof(next)); } public IAuthenticationSchemeProvider Schemes { get; set; } public async Task Invoke(HttpContext context) { context.Features.Set<IAuthenticationFeature>(new AuthenticationFeature { OriginalPath = context.Request.Path, OriginalPathBase = context.Request.PathBase }); var handlers = context.RequestServices.GetRequiredService<IAuthenticationHandlerProvider>(); foreach (var scheme in await Schemes.GetRequestHandlerSchemesAsync()) { try { if (await handlers.GetHandlerAsync(context, scheme.Name) is IAuthenticationRequestHandler handler && await handler.HandleRequestAsync()) return; } catch { // ignored } } var defaultAuthenticate = await Schemes.GetDefaultAuthenticateSchemeAsync(); if (defaultAuthenticate != null) { var result = await context.AuthenticateAsync(defaultAuthenticate.Name); if (result?.Principal != null) { context.User = result.Principal; } } await _next(context); } } 

ASP.NET बहुत सारे एम्बेडेड मिडिलवेयर प्रदान करता है जिन्हें आप अपने एप्लिकेशन में उपयोग कर सकते हैं, लेकिन ध्यान दें कि डेवलपर के पास अपना मिडलवेयर बनाने और HTTP अनुरोध पाइपलाइन में जोड़ने की क्षमता है । इस तंत्र को सरल बनाने के लिए, हमने एक विशेष इंटरफ़ेस जोड़ा, और अब यह केवल एक वर्ग बनाने के लिए पर्याप्त है जो इसे लागू करता है।

 public interface INopStartup { /// <summary> /// Add and configure any of the middleware /// </summary> /// <param name="services">Collection of service descriptors</param> /// <param name="configuration">Configuration of the application</param> void ConfigureServices(IServiceCollection services, IConfiguration configuration); /// <summary> /// Configure the using of added middleware /// </summary> /// <param name="application">Builder for configuring an application's request pipeline</param> void Configure(IApplicationBuilder application); /// <summary> /// Gets order of this startup configuration implementation /// </summary> int Order { get; } } 

यहां आप अपने मिडलवेयर को जोड़ और कॉन्फ़िगर कर सकते हैं:

 /// <summary> /// Represents object for the configuring authentication middleware on application startup /// </summary> public class AuthenticationStartup : INopStartup { /// <summary> /// Add and configure any of the middleware /// </summary> /// <param name="services">Collection of service descriptors</param> /// <param name="configuration">Configuration of the application</param> public void ConfigureServices(IServiceCollection services, IConfiguration configuration) { //add data protection services.AddNopDataProtection(); //add authentication services.AddNopAuthentication(); } /// <summary> /// Configure the using of added middleware /// </summary> /// <param name="application">Builder for configuring an application's request pipeline</param> public void Configure(IApplicationBuilder application) { //configure authentication application.UseNopAuthentication(); } /// <summary> /// Gets order of this startup configuration implementation /// </summary> public int Order => 500; //authentication should be loaded before MVC } 

चरण 7. एकीकृत डि का उपयोग करना

निर्भरता इंजेक्शन ASP.NET कोर में एप्लिकेशन डिजाइन प्रक्रिया की प्रमुख विशेषताओं में से एक है। यह आपको शिथिल युग्मित एप्लिकेशन बनाने की अनुमति देता है जो अधिक परीक्षण योग्य, मॉड्यूलर और, परिणामस्वरूप, बनाए रखने योग्य हैं। यह निर्भरता उलटा के सिद्धांत का पालन करके संभव बनाया गया था। निर्भरता स्थापित करने के लिए, IoC कंटेनर (नियंत्रण के व्युत्क्रम) का उपयोग किया जाता है। ASP.NET Core में, इस तरह के कंटेनर को IServiceProvider इंटरफ़ेस द्वारा दर्शाया जाता है। अनुप्रयोग Startup.ConfigureServices() पद्धति में एप्लिकेशन इंस्टॉल किए जाते हैं।

किसी भी पंजीकृत सेवा को तीन स्कोप के साथ कॉन्फ़िगर किया जा सकता है:

• क्षणिक
• दायरे वाला
• एकाकी वस्तु

 services.AddDbContext<ApplicationDbContext>(options => options.UseSqlServer(Configuration.GetConnectionString("DefaultConnection"))); services.AddSingleton<Isingleton,MySingleton>(); 

चरण 8. वेबएपीआई परियोजना संगतता गोले (शिम) का उपयोग करना

मौजूदा वेब एपीआई कार्यान्वयन के प्रवास को सरल बनाने के लिए, Microsoft.AspNetCore.Mvc.WebApiCompatShim NuGet पैकेज का उपयोग करने की अनुशंसा की जाती है। निम्नलिखित संगत कार्य समर्थित हैं:

• ApiController प्रकार जोड़ता है
• वेब एपीआई स्टाइल मॉडल बाइंडिंग को सक्षम करता है
• मॉडल बाइंडिंग का विस्तार करता है ताकि नियंत्रक क्रियाएं HttpRequestMessage के मापदंडों को स्वीकार कर सकें।
• संदेश फ़ॉर्मेटर्स जोड़ता है जो क्रियाओं को टाइप HttpResponseMessage के परिणाम वापस करने की अनुमति देता है

 services.AddMvc().AddWebApiConventions(); routes.MapWebApiRoute(name: "DefaultApi", template: "api/{controller}/{id?}" ); 

चरण 9. स्थानांतरण अनुप्रयोग कॉन्फ़िगरेशन

पहले, कुछ सेटिंग्स web.config फ़ाइल में सहेजी गई थीं। अब हम कॉन्फ़िगरेशन प्रदाताओं द्वारा स्थापित की-वैल्यू पेयर के आधार पर एक नया दृष्टिकोण ले रहे हैं। यह ASP.NET कोर में अनुशंसित तंत्र है, और हम appsettings.json फ़ाइल का उपयोग करते हैं।

यदि आप किसी कारण से * का उपयोग जारी रखना चाहते हैं, तो आप NuGet संकुल System.Configuration.ConfigurationManager का भी उपयोग कर सकते हैं। इस स्थिति में, आपको एप्लिकेशन को यूनिक्स प्लेटफार्मों पर चलाने और इसे केवल IIS के तहत चलाने की क्षमता को छोड़ना होगा।

यदि आप Azure Key Vault कॉन्फ़िगरेशन प्रदाता का उपयोग करना चाहते हैं, तो आपको Azure Key Valut सामग्री के लिए सामग्री माइग्रेशन का उल्लेख करना चाहिए। हमारे प्रोजेक्ट में, यह कार्य नहीं था।

चरण 10. स्थैतिक सामग्री को wwwroot पर स्थानांतरित करना

स्थिर सामग्री परोसने के लिए, आपको वेब को वर्तमान निर्देशिका की सामग्री की जड़ को बताना होगा। डिफ़ॉल्ट wwwroot है। आप मिडिलवेयर सेट करके स्थिर फ़ाइलों को संग्रहीत करने के लिए अपनी निर्देशिका को अनुकूलित कर सकते हैं।

चरण 11. पोर्टिंग EntityFramework ईएफ कोर के लिए

यदि परियोजना एंटिटी फ्रेमवर्क 6 की कुछ विशिष्ट विशेषताओं का उपयोग करती है जो EF Core में समर्थित नहीं हैं, तो यह NET Framework पर एप्लिकेशन को चलाने के लिए समझ में आता है। इस मामले में, हालांकि, आपको मल्टीप्लेट रिकॉर्डर का त्याग करना होगा। आवेदन केवल विंडोज पर और आईआईएस के तहत काम करेगा।

आइए मुख्य बदलावों को ध्यान में रखते हैं:

• System.Data.Entity नाम स्थान Microsoft.EntityFrameworkCore द्वारा प्रतिस्थापित
• DbContext कंस्ट्रक्टर के हस्ताक्षर को बदल दिया गया है। अब आपको DbContextOptions को इंजेक्ट करने की आवश्यकता है
• HasDatabaseGeneratedOption (DatabaseGeneratedOption.None) ValueGeneratedNever द्वारा प्रतिस्थापित विधि)
• OnCelete (DeleteBehavior.Restrict) द्वारा प्रतिस्थापित WillCascadeOnDelete (झूठा) तरीका
• OnModelCreating (DBModelBuilder मॉडलबाली) विधि OnModelCreating (ModelBuilder मॉडलबाली) द्वारा प्रतिस्थापित
• HasOptional विधि अब उपलब्ध नहीं है
• ऑब्जेक्ट का कॉन्फ़िगरेशन बदल दिया गया है, अब आपको OnModelCreating का उपयोग करने की आवश्यकता है, क्योंकि EntityTypeConfiguration अब उपलब्ध नहीं है
• ComplexType विशेषता अब उपलब्ध नहीं है
• DbSet के साथ IDbSet इंटरफ़ेस प्रतिस्थापन
• ComplexType - जटिल प्रकार का समर्थन EF Core 2 में Owned Entity प्रकार ( https://docs.microsoft.com/en-us/ef/core/modeling/ प्रसिद्ध-entities) के साथ दिखाई दिया, और EF Core में QueryType के साथ प्राथमिक कुंजी के बिना तालिकाएँ 2.1 ( https://docs.microsoft.com/en-us/ef/core/modeling/query-types )
• EF Core में विदेशी कुंजियाँ EF6 के विपरीत [Entity] Id पैटर्न का उपयोग करके छाया गुण उत्पन्न करती हैं, जो [Entity] _Id पैटर्न का उपयोग करती है। इसलिए, पहले इकाई के लिए एक नियमित संपत्ति के रूप में विदेशी कुंजी जोड़ें।
• DbContext के लिए DI का समर्थन करने के लिए, कॉन्फिगरसर्विसेस में अपने DbContex को ConfigureServices

 /// <summary> /// Register base object context /// </summary> /// <param name="services">Collection of service descriptors</param> public static void AddNopObjectContext(this IServiceCollection services) { services.AddDbContextPool<NopObjectContext>(optionsBuilder => { optionsBuilder.UseSqlServerWithLazyLoading(services); }); } /// <summary> /// SQL Server specific extension method for Microsoft.EntityFrameworkCore.DbContextOptionsBuilder /// </summary> /// <param name="optionsBuilder">Database context options builder</param> /// <param name="services">Collection of service descriptors</param> public static void UseSqlServerWithLazyLoading(this DbContextOptionsBuilder optionsBuilder, IServiceCollection services) { var nopConfig = services.BuildServiceProvider().GetRequiredService<NopConfig>(); var dataSettings = DataSettingsManager.LoadSettings(); if (!dataSettings?.IsValid ?? true) return; var dbContextOptionsBuilder = optionsBuilder.UseLazyLoadingProxies(); if (nopConfig.UseRowNumberForPaging) dbContextOptionsBuilder.UseSqlServer(dataSettings.DataConnectionString, option => option.UseRowNumberForPaging()); else dbContextOptionsBuilder.UseSqlServer(dataSettings.DataConnectionString); } 

यह सत्यापित करने के लिए SQL तुलना टूल का उपयोग करें कि EF Core माइग्रेशन के दौरान Entity Framework के समान डेटाबेस स्कीमा बनाता है।

चरण 12. सभी HttpContext संदर्भों को हटाना, अप्रचलित कक्षाओं को बदलना और नाम स्थान को बदलना

अपनी परियोजना के प्रवास के दौरान, आप पाएंगे कि पर्याप्त रूप से बड़ी संख्या में कक्षाओं का नाम बदल दिया गया है या स्थानांतरित कर दिया गया है, और अब आपको नई आवश्यकताओं के अनुरूप सब कुछ लाने की आवश्यकता है। यहां उन मुख्य बदलावों की सूची दी गई है जिनका आप सामना कर सकते हैं:

• HttpPostedFileBase -> IFormFile
• HttpContext को एक्सेस करने की पहुंच अब IHttpContextAccessor के माध्यम से है
• HtmlHelper -> IHtmlHelper
• ActionResult -> IActionResult
• HttpUtility -> वेबयुटिलिटी
• HttpSessionStateBase के बजाय - ISession, HttpContext.Session से सुलभ है। Microsoft.AspNetCore.Http से
• Request.Cookies ने IRequestCookieCollection: IEnumerable <KeyValuePair <string, string >>, इसलिए HttpCookie के बजाय, KeyValuePair <string, string> Microsoft.AspNetCore.Http के बजाय

नाम बदलने की जगह:

• SelectList -> Microsoft.AspNetCore.Mvc.Rendering
• UrlHelper -> WebUtitlity
• MimeMapping -> FileExtensionContentTypeProvider
• MvcHtmlString -> IHtmlString और HtmlString
• ModelState, ModelStateDictionary, ModelError -> Microsoft.AspNetCore.Mvc.ModelBinding
• FormCollection -> IFormCollection
• Request.Url.Scheme -> this.Url.ActionContext.HttpContext.Request.Sheme

अन्य:

• MvcHtmlString.IsNullOrEmpty (IHtmlString) -> String.IsNullOrEmpty (variable.ToHtmlString) ()
• [वैधव्य (झूठी)] - यह आम तौर पर नहीं है और इसकी आवश्यकता नहीं है
• HttpUnauthorizedResult -> अनधिकृत
• [AllowHtml] - निर्देश अधिक नहीं है और इसकी आवश्यकता नहीं है
• TagBuilder.SetInnerText विधि को बदल दिया गया - अब यह इनरएचटीएमएल है। एपेंडहट एमएल
• JsonRequestBehavior.AllowGet जब Json को वापस लाने की आवश्यकता नहीं है
• HttpUtility.JavaScriptStringEncode। -> JavaScriptEncoder.Default.Encode
• Request.RawUrl। यह अलग से Request.Path + Request.QueryString कनेक्ट करने के लिए आवश्यक है
• AllowHtmlAttribute - अधिक वर्ग नहीं
• XmlDownloadResult - अब आप केवल रिटर्न फाइल (Encoding.UTF8.GetBytes (xml), "एप्लीकेशन / xml", "filename.xml") का उपयोग कर सकते हैं;
• [वैधव्य (झूठी)] - कोई अधिक निर्देश नहीं है और इसकी आवश्यकता नहीं है

चरण 13. प्रमाणीकरण और प्राधिकरण को अद्यतन करना

मैंने पहले ही ऊपर लिखा है कि हमारी परियोजना में प्रमाणीकरण अंतर्निहित पहचान प्रणाली का उपयोग करके लागू नहीं किया गया है, लेकिन एक अलग मिडलवेयर परत में निकाला गया है। हालाँकि, ASP.NET Core के पास क्रेडेंशियल्स प्रदान करने का अपना तंत्र है। अधिक विवरण यहां प्रलेखन में पाया जा सकता है ।

डेटा सुरक्षा के लिए - हम अब MachineKey का उपयोग नहीं करते हैं। इसके बजाय, हम अंतर्निहित डेटा सुरक्षा सुविधा का उपयोग करते हैं। डिफ़ॉल्ट रूप से, जब एप्लिकेशन शुरू होता है, तो चाबियाँ उत्पन्न होती हैं। डेटा वेयरहाउस हो सकता है:

• फाइल सिस्टम - फाइल सिस्टम-आधारित कीस्टोर
• Azure Storage - Azure Blob Storage में डेटा सुरक्षा कुंजी
• रेडिस - रेडिस कैश में डेटा सुरक्षा कुंजी
• रजिस्ट्री - का उपयोग किया जाना चाहिए यदि एप्लिकेशन में फ़ाइल सिस्टम तक पहुंच नहीं है
• EF Core - कुंजियों को डेटाबेस में संग्रहीत किया जाता है

यदि अंतर्निहित तंत्र उपयुक्त नहीं हैं, तो आप कस्टम IXmlRepository प्रदान करके अपने स्वयं के कुंजी संग्रहण तंत्र को निर्दिष्ट कर सकते हैं।

चरण 14. अद्यतन जेएस / सीएसएस

स्थैतिक संसाधनों के साथ काम करने का तरीका बदल गया है: अब उन सभी को wwwroot प्रोजेक्ट के रूट फ़ोल्डर में संग्रहीत किया जाना चाहिए, जब तक कि निश्चित रूप से, अन्य सेटिंग्स निर्दिष्ट न हों।

जावास्क्रिप्ट इनलाइन ब्लॉकों का उपयोग करते समय, यह अनुशंसा की जाती है कि आप उन्हें पृष्ठ के अंत में स्थानांतरित करें। बस अपने टैग के लिए एस्प-लोकेशन = "पाद" विशेषता का उपयोग करें। यही नियम js फाइलों पर भी लागू होता है।

System.Web.Optimization के प्रतिस्थापन के रूप में BundlerMinifier एक्सटेंशन का उपयोग करें - यह आपको प्रोजेक्ट बनाते समय जावास्क्रिप्ट और सीएसएस को बांधने और कम करने की अनुमति देगा। प्रलेखन के लिए लिंक ।

चरण 15. माइग्रेटिंग दृश्य

बाल क्रियाओं का अब उपयोग नहीं किया जाता है। इसके बजाय, ASP.NET Core एक नया शक्तिशाली उपकरण प्रदान करता है - ViewCompords , जिसे एसिंक्रोनसली कहा जाता है।

ViewComponent से एक स्ट्रिंग कैसे प्राप्त करें:

 /// <summary> /// Render component to string /// </summary> /// <param name="componentName">Component name</param> /// <param name="arguments">Arguments</param> /// <returns>Result</returns> protected virtual string RenderViewComponentToString(string componentName, object arguments = null) { if (string.IsNullOrEmpty(componentName)) throw new ArgumentNullException(nameof(componentName)); var actionContextAccessor = HttpContext.RequestServices.GetService(typeof(IActionContextAccessor)) as IActionContextAccessor; if (actionContextAccessor == null) throw new Exception("IActionContextAccessor cannot be resolved"); var context = actionContextAccessor.ActionContext; var viewComponentResult = ViewComponent(componentName, arguments); var viewData = ViewData; if (viewData == null) { throw new NotImplementedException(); } var tempData = TempData; if (tempData == null) { throw new NotImplementedException(); } using (var writer = new StringWriter()) { var viewContext = new ViewContext( context, NullView.Instance, viewData, tempData, writer, new HtmlHelperOptions()); // IViewComponentHelper is stateful, we want to make sure to retrieve it every time we need it. var viewComponentHelper = context.HttpContext.RequestServices.GetRequiredService<IViewComponentHelper>(); (viewComponentHelper as IViewContextAware)?.Contextualize(viewContext); var result = viewComponentResult.ViewComponentType == null ? viewComponentHelper.InvokeAsync(viewComponentResult.ViewComponentName, viewComponentResult.Arguments): viewComponentHelper.InvokeAsync(viewComponentResult.ViewComponentType, viewComponentResult.Arguments); result.Result.WriteTo(writer, HtmlEncoder.Default); return writer.ToString(); } } 

अब HtmlHelper का उपयोग करने की कोई आवश्यकता नहीं है - ASP.NET Core में बड़ी संख्या में सहायक टैग फ़ंक्शंस ( टैग हेल्पर्स ) बनाए गए हैं। जब एप्लिकेशन चल रहा होता है, तो वे रेजर इंजन द्वारा सर्वर साइड पर संसाधित होते हैं और अंततः मानक HTML तत्वों में बदल जाते हैं। यह अनुप्रयोग विकास को बहुत सरल करता है। और, ज़ाहिर है, आप अपने स्वयं के टैग-सहायकों को लागू कर सकते हैं।

हमने EngineContext का उपयोग करके सेटिंग्स और सेवाओं की अनुमति देने के बजाय विचारों में निर्भरता इंजेक्शन का उपयोग करना शुरू कर दिया।

तो, विचारों के प्रवास पर मुख्य बिंदु:

• परिवर्तित Views/web.config Views/_ViewImports.cshtml - नामस्थान आयात करने और निर्भरता Views/web.config Views/_ViewImports.cshtml करने के लिए उपयोग किया जाता है। यह फ़ाइल अन्य Razor कार्यों का समर्थन नहीं करती है, जैसे कि फ़ंक्शन और अनुभाग परिभाषाएं।
• namespaces.add बदलें
• किसी भी सेटिंग्स को मुख्य एप्लिकेशन कॉन्फ़िगरेशन में स्थानांतरित करें
• Scripts.Render और Styles.Render । Styles.Render मौजूद नहीं है। उत्पादन के लिंक के BundlerMinifier libman या BundlerMinifier बदलें

निष्कर्ष में

हमने अपने अनुभव से देखा है कि एक बड़े वेब एप्लिकेशन को माइग्रेट करने की प्रक्रिया एक बहुत ही समय लेने वाला कार्य है जिसे शायद ही कभी नुकसान के साथ किया जा सकता है। जैसे ही इसका पहला स्थिर संस्करण जारी हुआ, हमने एक नए ढांचे में जाने की योजना बनाई, लेकिन हम इसे तुरंत खत्म नहीं कर पाए: कुछ महत्वपूर्ण कार्य थे जो उस समय तक अभी तक .NET कोर में स्थानांतरित नहीं हुए थे, विशेष रूप से, EntityFramework से संबंधित। इसलिए, हमें पहले रिलीज़ को मिश्रित दृष्टिकोण का उपयोग करके जारी करना था - .NET कोर आर्किटेक्चर .NET फ्रेमवर्क निर्भरता के साथ।

हम .NET कोर 2.1 की रिलीज़ के बाद परियोजना को पूरी तरह से अनुकूलित करने में सक्षम थे, उस समय पहले से ही नई वास्तुकला पर काम कर रहे एक स्थिर समाधान - जो कुछ बचा था उसे कुछ पैकेजों को बदलने और ईएफ कोर के साथ काम को फिर से लिखना था। इस प्रकार, नए ढांचे में पूर्ण प्रवास में कई महीनों का समय लगा।

आप GitHub पर हमारे भंडार से हमारी परियोजना के बारे में अधिक जान सकते हैं।