Introduction
CMS version 1 was created based on ASP.NET Standard; in a short time, CMS migrated to ASP.NET Core; therefore, CMS version 2 is based on ASP.NET Core. This CMS uses the CodeBehind framework; this framework is an infrastructure whose executable files are aspx that run on ASP.NET Core.
The migration of this CMS from .NET Standard version 4.5 to .NET Core version 7.0 took only two weeks.
Note. Web development in the CodeBehind framework is based on a modern MVC structure and has nothing to do with Microsoft's Web Form.
An example of .NET Standard code changes to .NET Core
View in ASP.NET Standard
<%@ Page Language="C#" CodeBehind="Default.aspx.cs" Inherits="elanat.SiteEmail" %>
View in ASP.NET Core
<%@ Page Controller="Elanat.SiteEmailController" Model="Elanat.SiteEmailModel" %>
As you can see, only the first line of the aspx page information has changed, and the rest of the data has remained unchanged.
Model in ASP.NET Standard
public class SiteEmailModel
Model in ASP.NET Core
public partial class SiteEmailModel : CodeBehindModel
CodeBehind namespace has been added in the model section class; also, the word partial has been added before the class name. The parent class name of CodeBehindModel is also added in front of the model class name.
Controller in ASP.NET Standard
using System;
using System.Collections.Generic;
using System.Data.SqlClient;
using System.Linq;
using System.Web;
using System.Web.UI;
using System.Web.UI.WebControls;
namespace elanat
{
public partial class SiteEmail : System.Web.UI.Page
{
public SiteEmailModel model = new SiteEmailModel();
protected void Page_Load(object sender, EventArgs e)
{
if (!string.IsNullOrEmpty(Request.Form["btn_SendEmail"]))
btn_SendEmail_Click(sender, e);
if (string.IsNullOrEmpty(Request.Form["hdn_ContentId"]))
{
if (string.IsNullOrEmpty(Request.QueryString["content_id"]))
return;
if (!Request.QueryString["content_id"].IsNumber())
return;
model.ContentIdValue = Request.QueryString["content_id"].ToString(); ;
}
model.SetValue();
// Set Required Field Validation
model.SetImportantField();
}
protected void btn_SendEmail_Click(object sender, EventArgs e)
{
model.ContentIdValue = Request.Form["hdn_ContentId"];
model.YourEmailValue = Request.Form["txt_YourEmail"];
model.RecipientsEmailValue = Request.Form["txt_RecipientsEmail"];
model.CaptchaTextValue = Request.Form["txt_Captcha"];
// Evaluate Field Check
model.EvaluateField(Request.Form);
if (model.FindEvaluateError)
{
ResponseForm rf = new ResponseForm(StaticObject.GetCurrentSiteGlobalLanguage());
foreach (string EvaluateError in model.EvaluateErrorList)
rf.AddLocalMessage(EvaluateError, "problem");
rf.RedirectToResponseFormPage();
}
if (!model.CaptchaTextValue.MatchByCaptcha())
{
model.CaptchaIncorrectErrorView();
return;
}
model.SendEmail();
model.SuccessView();
}
}
}
Controller in ASP.NET Core
using CodeBehind;
namespace Elanat
{
public partial class SiteEmailController : CodeBehindController
{
public SiteEmailModel model = new SiteEmailModel();
public void PageLoad(HttpContext context)
{
if (!string.IsNullOrEmpty(context.Request.Form["btn_SendEmail"]))
{
btn_SendEmail_Click(context);
return;
}
if (string.IsNullOrEmpty(context.Request.Form["hdn_ContentId"]))
{
if (string.IsNullOrEmpty(context.Request.Query["content_id"]))
{
IgnoreViewAndModel = true;
return;
}
if (!context.Request.Query["content_id"].ToString().IsNumber())
{
IgnoreViewAndModel = true;
return;
}
model.ContentIdValue = context.Request.Query["content_id"].ToString(); ;
}
model.SetValue();
// Set Required Field Validation
model.SetImportantField();
View(model);
}
protected void btn_SendEmail_Click(HttpContext context)
{
model.ContentIdValue = context.Request.Form["hdn_ContentId"];
model.YourEmailValue = context.Request.Form["txt_YourEmail"];
model.RecipientsEmailValue = context.Request.Form["txt_RecipientsEmail"];
model.CaptchaTextValue = context.Request.Form["txt_Captcha"];
// Evaluate Field Check
model.EvaluateField(context.Request.Form);
if (model.FindEvaluateError)
{
ResponseForm rf = new ResponseForm(StaticObject.GetCurrentSiteGlobalLanguage());
foreach (string EvaluateError in model.EvaluateErrorList)
rf.AddLocalMessage(EvaluateError, "problem");
rf.AddReturnFunction("el_SetWarningField('" + model.WarningFieldClassList.SplitText("$") + "', '" + model.WarningFieldClassList.SplitValue("$") + "')");
rf.RedirectToResponseFormPage();
IgnoreViewAndModel = true;
return;
}
if (!model.CaptchaTextValue.MatchByCaptcha())
{
model.CaptchaIncorrectErrorView();
View(model);
return;
}
model.SendEmail(context);
model.SuccessView();
View(model);
}
}
}
Controller section changes have also been done simply.
The following are the controller changes:
Added CodeBehind namespace.
System.Web.UI.Page has been removed, and CodeBehindController has been added instead.
The underline of the main method has been remove(Page_Load to PageLoad).
The main method has been changed from private to public.
The following input arguments were omitted.
object sender, EventArgs e
The following new argument is added.
HttpContext context
View(model) method; Added before the end of the main method
To access the current HttpContext, the HttpContext context argument has been added inside the btn_SendEmail_Click method.
Added context prefix to Request
Please note that the capitalization of the first letter of the project name and the addition of Controller to the name of the MemberChangeEmail class is for arranging the naming and is not required!
We created some methods that were in standard .NET but not in .NET using Extension methods, and the codes remained intact.
Example of SaveAs method on IFormFile.
public static void SaveAs(this IFormFile PostedFile, string FilePath)
{
using (Stream TmpFileStream = new FileStream(FilePath, FileMode.Create, FileAccess.ReadWrite))
{
PostedFile.CopyTo(TmpFileStream);
}
}
Fortunately, all the data remained unchanged, and the source code of the server side also had minor changes; For example, the App_Data directory remains as a relic of the ASP.NET standard.
The CMS repository based on ASP.NET Core can be seen in the link below
https://github.com/elanatframework/Elanat
CMS external add-on repository
https://github.com/elanatframework/Elanat_add-ons
Code-Behind library is a backend framework
https://github.com/elanatframework/Code_behind
CMS old
We created a new repository and copied all the information from the ASP.NET Standard-based CMS repository into the new repository. This repository's README.md file provides information on how to migrate CMS from ASP.NET Standard to ASP.NET Core.
You can see the CMS repository based on ASP.NET Standard in the link below.