.NET 幫助

CSLA .NET (如何運作給開發人員)

發佈 2024年8月13日

介紹

在當前的企業應用開發情況下，實現業務邏輯、數據訪問和用戶界面設計之間的平衡至關重要。基於組件的可擴展邏輯架構（CSLA）是一個備受歡迎的軟件開發框架，提供穩定、可擴展的架構，用於創建可管理的業務應用，旨在簡化此過程。通過使用這種方法，代碼庫可以變得更易管理和測試。 CSLA .NET 以幫助開發人員清晰地將業務邏輯與數據訪問分離。

開發人員可以利用 IronPDF 結合CSLA .NET和IronPDF以創建高質量的PDF文件和CSLA結構化的方法來管理業務邏輯。需要廣泛數據展示、自動文件準備和動態報告生成的應用程序特別能夠從這種結合中受益。企業可以直接從他們的.NET生成精美的文件。應用程式, 保證資料一致性，並透過此介面簡化操作。

我們將在本教程中探討 CSLA 與 IronPDF 的成功整合，重點介紹有用的功能，並提供在 C# 應用程式中實施此整合的詳細過程。無論您是創建簡單的商業應用程式還是複雜的企業解決方案，此整合都可以大大增加您的應用程式的可能性，使其更加高效和多功能。

什麼是 CSLA .NET？

Rocky Lhotka 創建了開源 CSLA .NET (基於元件的可擴展邏輯架構) 一個框架幫助程式員為 .NET 平台構建可靠、可擴展且可管理的商業應用程式。它通過強調使用包含所有業務邏輯、驗證標準和授權檢查的業務對象來促進責任的明確分工。由於 CSLA 支持 n 層設計和抽象數據訪問邏輯的能力，從而將業務邏輯部署在多個層中，維護性和可擴展性得到了改善。

CSLA .NET（對開發人員的運作方式）：圖 1

除了支援行動物件，它還可以與各種 UI 技術一起使用，包括 Windows Forms、WPF、ASP.NET MVC 和 Blazor，以實現豐富的客戶端和高效的伺服器端 Web 表單處理。這種靈活性使得開發響應迅速、有效且一致的企業級應用程式變得更加容易，並確保業務邏輯可以在多個展示層之間可靠地重複使用。

業務物件模型

確保通過將業務邏輯封裝在業務物件內，授權規則引擎、業務規則和驗證規則在整個應用程式中一律應用。

資料存取抽象化

使資料存取邏輯與業務邏輯可以用靈活的方法分離，從而增強可維護性，並使在資料存取層和業務層技術之間的切換和測試變得更加簡單。

驗證和授權

由於內建功能可建立和執行業務物件的授權檢查和驗證規則，因此業務規則得以實現並不斷強制執行，確保不會有規則違反。

N-Tier 架構

支援 N-Tier 設計，提升擴充性，並可透過將業務邏輯分散到多個層級或級別來建立分散式應用程式。 (如客戶端、伺服器和數據庫).

行動物件支援

使創建可在客戶端和伺服器之間傳輸的行動物件變得更容易，支援需要在兩端使用業務物件的情況，例如豐富的客戶端應用程式和需要有效伺服器端處理的情況。

UI 獨立性

可以使用多種UI技術處理業務對象，促進代碼重用並在多個展示層中保持一致性。這些技術包括Windows Forms、WPF、ASP.NET MVC和Blazor。

非同步程式設計

允許建構響應式應用程式，透過支援非同步程式設計模型，在不干擾使用者介面的情況下執行耗時的任務。

宣告式業務規則

使得透過宣告式的方法定義自動應用的規則，從而更容易管理複雜的業務邏輯。

物件關聯對應 (ORM) 整合

無縫地允許業務物件和資料存取層與像是 Entity Framework 等 ORM 連接。

序列化與行動能力

為行動情境啟用商業物件序列化，簡化需要跨越網絡障礙進行數據傳輸的應用程式開發。

交易管理

支持交易處理，特別是在分佈式系統中維持應用程式，以保證資料的一致性和完整性。

事件處理和資料繫結

提供強大的事件處理和資料繫結支援；這對於需要實時通知和更新的UI應用程式特別有幫助。

基於角色的安全性

包含基於角色的安全功能，以限制對屬性和業務對象的訪問，僅允許授權用戶執行特定任務。

本地化和全球化

支援本地化和全球化，允許開發可在多種語言和文化環境中使用的應用程式。

擴展性

極其靈活且可重複使用，使開發人員能夠修改和擴展框架以滿足特定的業務需求。

創建和配置 CSLA .NET

建立專案、安裝所需套件以及配置框架是創建和配置 CSLA .NET 應用程式的一些步驟。這是一個幫助您開始使用 CSLA .NET 的全面指南：

建立一個新的 Visual Studio 專案

使用 Visual Studio，創建控制台專案非常簡單。使用以下簡單步驟在 Visual Studio 環境中啟動控制台應用程式：

請確保在使用前已在您的電腦上安裝了 Visual Studio。

開始一個新項目

選擇檔案、項目，然後點擊新建選單。

CSLA .NET（對開發者的運作方式）：圖2

從以下的專案範本參考清單中，選擇「Console App」或「Console App」。 (.NET Core)"模板。

請填寫「名稱」部分以給你的專案命名。

CSLA .NET（它如何為開發人員工作）：圖 3

決定你想存放專案的位置。

點擊「建立」將開啟控制台應用程式專案。

CSLA .NET（對開發人員的運作方式）：圖 4

安裝 CSLA .NET 套件

接下來安裝 CSLA .NET NuGet 套件。在 NuGet 套件管理器控制台中執行以下命令： (工具 -> NuGet 套件管理器 -> 套件管理器控制台):

Install-Package CSLA
Install-Package CSLA-Server

Install-Package CSLA
Install-Package CSLA-Server

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

這些套件包含伺服器端元件以及基本的 CSLA 功能。

在項目中配置 CSLA.NET

對於控制台應用程序，請在您的 Program.cs 文件中初始化 CSLA.NET 配置。在 ASP.NET Core 應用程序的 Startup.cs 文件中，會完成這個操作。

using System;
using Csla.Configuration;
namespace CslaDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize CSLA .NET
            var applicationContext = new ApplicationContext();
            // Use dependency injection if needed (for ASP.NET Core or other frameworks)
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            applicationContext = provider.GetService<ApplicationContext>();
            Console.WriteLine("CSLA .NET is configured and ready to use!");
        }
    }
}

using System;
using Csla.Configuration;
namespace CslaDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize CSLA .NET
            var applicationContext = new ApplicationContext();
            // Use dependency injection if needed (for ASP.NET Core or other frameworks)
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            applicationContext = provider.GetService<ApplicationContext>();
            Console.WriteLine("CSLA .NET is configured and ready to use!");
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

建立一個業務物件

為了捕捉您的業務邏輯，請建立一個基本的業務物件。在此範例中，我們將建立一個Person類別。

using Csla;
namespace CslaDemo
{
    [Serializable]
    public class Person : BusinessBase<Person>
    {
        public static readonly PropertyInfo<int> IdProperty = RegisterProperty<int>(c => c.Id);
        public int Id
        {
            get => GetProperty(IdProperty);
            set => SetProperty(IdProperty, value);
        }
        public static readonly PropertyInfo<string> NameProperty = RegisterProperty<string>(c => c.Name);
        public string Name
        {
            get => GetProperty(NameProperty);
            set => SetProperty(NameProperty, value);
        }
        protected override void AddBusinessRules()
        {
            // Add validation rules
            BusinessRules.AddRule(new Csla.Rules.CommonRules.Required(NameProperty));
        }
        // Data access methods
    [Fetch]
        private void DataPortal_Fetch(int id)
        {
            // Simulate data fetch
            Id = id;
            Name = "John Doe";
        }
    [Create]
        private void DataPortal_Create()
        {
            // Initialize default values
            Id = -1;
            Name = "New Person";
        }
    }
}

using Csla;
namespace CslaDemo
{
    [Serializable]
    public class Person : BusinessBase<Person>
    {
        public static readonly PropertyInfo<int> IdProperty = RegisterProperty<int>(c => c.Id);
        public int Id
        {
            get => GetProperty(IdProperty);
            set => SetProperty(IdProperty, value);
        }
        public static readonly PropertyInfo<string> NameProperty = RegisterProperty<string>(c => c.Name);
        public string Name
        {
            get => GetProperty(NameProperty);
            set => SetProperty(NameProperty, value);
        }
        protected override void AddBusinessRules()
        {
            // Add validation rules
            BusinessRules.AddRule(new Csla.Rules.CommonRules.Required(NameProperty));
        }
        // Data access methods
    [Fetch]
        private void DataPortal_Fetch(int id)
        {
            // Simulate data fetch
            Id = id;
            Name = "John Doe";
        }
    [Create]
        private void DataPortal_Create()
        {
            // Initialize default values
            Id = -1;
            Name = "New Person";
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

使用業務對象

現在我們來使用 Program.cs 文件中的Person業務對象。

using System;
using Csla;
using Microsoft.Extensions.DependencyInjection;
namespace CslaDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize CSLA .NET
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            var applicationContext = provider.GetService<ApplicationContext>();
        var db = provider.GetRequiredService<IDataPortal<Person>>();
            // Create a new person
            var newPerson =  db.Create();
            Console.WriteLine($"New Person: {newPerson.Name}");
            // Fetch an existing person
            var existingPerson = db.Fetch(1);
            Console.WriteLine($"Fetched Person: {existingPerson.Name}");
        }
    }
}

using System;
using Csla;
using Microsoft.Extensions.DependencyInjection;
namespace CslaDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Initialize CSLA .NET
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            var applicationContext = provider.GetService<ApplicationContext>();
        var db = provider.GetRequiredService<IDataPortal<Person>>();
            // Create a new person
            var newPerson =  db.Create();
            Console.WriteLine($"New Person: {newPerson.Name}");
            // Fetch an existing person
            var existingPerson = db.Fetch(1);
            Console.WriteLine($"Fetched Person: {existingPerson.Name}");
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

展示如何在 Main 方法中使用 DataPortal 創建新的 Person 並獲取現有的 Person。在 IDataPortal 中建立。

CSLA .NET (對開發者的運作原理)：圖5

這個配置為在 .NET 應用程式中使用 CSLA .NET 提供了基本基礎。如果需要更複雜的商業邏輯、數據訪問和驗證標準，您可以在此策略上進一步擴展。

入門

您必須首先設置您的項目，使用 CSLA 構建業務對象，並使用 IronPDF 創建 PDF，才能開始在 C# 項目中使用 CSLA 和 IronPDF。以下是一個詳細的操作指南。

IronPDF 是什麼？

C# 程式可以使用 IronPDF，功能豐富的 .NET 庫，用於生成、讀取和編輯 PDF 文檔。開發人員可以快速使用此應用程序從 HTML、CSS 和 JavaScript 內容創建高質量、可打印的 PDF。關鍵功能包括創建頁眉和頁腳、拆分和合併 PDF、在文檔上加水印以及將 HTML 轉換為 PDF。IronPDF 支援 .NET Framework 和 .NET Core，對各種應用程式都很有幫助。

由於具有豐富的文檔並且易於集成，開發人員在其應用程式中使用 PDF 非常簡單。IronPDF 輕鬆處理複雜的佈局和格式，確保輸出的 PDF 與原始 HTML 文本高度相似。

CSLA .NET（對開發者如何運作）：圖6

IronPDF 的功能

從 HTML 生成 PDF

將 HTML、CSS 和 JavaScript 轉換為 PDF。支持兩種現代 Web 標準：媒體查詢和響應式設計。便於使用 HTML 和 CSS 動態裝飾 PDF 文件、發票和報告。

PDF 編輯

可以在已有的 PDF 中添加文本、圖像和其他材料。從 PDF 文件中提取文本和圖像。將多個 PDF 合併成一個文件。將 PDF 文件拆分為多個不同的文件。添加頁眉、頁腳、註釋和水印。

PDF 轉換

將 Word、Excel 和圖像文件等其他文件類型轉換為 PDF 格式。將 PDF 轉換為圖像。 (PNG，JPEG 等。).

效能和可靠性

在工業環境中，高效能和可靠性是理想的設計屬性。成功處理大型文件集。

安裝 IronPDF

安裝 IronPDF 套件以獲取在 .NET 項目中處理 PDF 所需的工具。

Install-Package IronPDF

Install-Package IronPDF

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronPDF

VB C#

初始化 CSLA .NET 並使用 IronPDF 生成 PDF

使用我們先前建立的 Person 業務物件，並在您的 Program.cs 文件中初始化 CSLA .NET 框架。接著，使用 IronPDF 生成 PDF。

using Csla;
using IronPdf;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Text;
namespace CslaIronPdfDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Setup dependency injection
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            var applicationContext = provider.GetRequiredService<ApplicationContext>();
        var db = provider.GetRequiredService<IDataPortal<Person>>();
            // Create a new person
            var newPerson = db.Create();
            // Display the new person
            Console.WriteLine($"New Person: {newPerson.Name}");
            // Fetch an existing person
            var existingPerson = db.Fetch(1);;
            // Display the fetched person
            Console.WriteLine($"Fetched Person: {existingPerson.Name}");
            // Generate PDF
            var htmlContent = new StringBuilder();
            htmlContent.Append("<h1>Person Details</h1>");
            htmlContent.Append($"<p><strong>New Person:</strong> {newPerson.Name}</p>");
            htmlContent.Append($"<p><strong>Fetched Person:</strong> {existingPerson.Name}</p>");
            // Create PDF
            var Renderer = new HtmlToPdf();
            var pdfDocument = Renderer.RenderHtmlAsPdf(htmlContent.ToString());
            // Save PDF
            var outputPath = "PersonDetails.pdf";
            pdfDocument.SaveAs(outputPath);
            Console.WriteLine($"PDF generated and saved to {outputPath}");
        }
    }
}

using Csla;
using IronPdf;
using Microsoft.Extensions.DependencyInjection;
using System;
using System.Text;
namespace CslaIronPdfDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Setup dependency injection
            var services = new ServiceCollection();
            services.AddCsla();
            var provider = services.BuildServiceProvider();
            var applicationContext = provider.GetRequiredService<ApplicationContext>();
        var db = provider.GetRequiredService<IDataPortal<Person>>();
            // Create a new person
            var newPerson = db.Create();
            // Display the new person
            Console.WriteLine($"New Person: {newPerson.Name}");
            // Fetch an existing person
            var existingPerson = db.Fetch(1);;
            // Display the fetched person
            Console.WriteLine($"Fetched Person: {existingPerson.Name}");
            // Generate PDF
            var htmlContent = new StringBuilder();
            htmlContent.Append("<h1>Person Details</h1>");
            htmlContent.Append($"<p><strong>New Person:</strong> {newPerson.Name}</p>");
            htmlContent.Append($"<p><strong>Fetched Person:</strong> {existingPerson.Name}</p>");
            // Create PDF
            var Renderer = new HtmlToPdf();
            var pdfDocument = Renderer.RenderHtmlAsPdf(htmlContent.ToString());
            // Save PDF
            var outputPath = "PersonDetails.pdf";
            pdfDocument.SaveAs(outputPath);
            Console.WriteLine($"PDF generated and saved to {outputPath}");
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

提供的範例展示了如何使用結合了 CSLA.NET 與 IronPDF 的 .NET 6 主控台應用程式從企業物件創建、驗證和生成 PDF。安裝所需的 IronPDF 和 CSLA.NET 套件是設定專案的第一步。CSLA 的 BusinessBase 被用來描述您的業務物件（Person）的主要容器。

它封裝了例如姓名和 ID 這樣的特徵，並包含業務規則來驗證這些屬性。工廠方法和資料存取方法的執行負責物件生成和資料檢索。在 Program.cs 文件中使用相依性注入來初始化 CSLA 應用程式上下文。代碼然後展示了如何使用 CSLA 的 DataPortal 功能創建新的 Person 物件並檢索現有的物件。

CSLA .NET（對開發者的運作方式）：圖7