跳至頁尾內容
.NET 幫助

C# LINQ 連線查詢語法(開發人員的工作原理)

在 C# 程式設計的多樣性中,LINQ(語言整合查詢)脫穎而出,成為查詢和操作物件集合的強大工具。 在 LINQ 提供的眾多運算元中,Join 運算元在合併來自多個來源的資料時扮演關鍵角色。

在這篇文章中,我們將深入探討 C# LINQ Join 運算符號的複雜性,揭開其功能、語法和實際應用的面貌。

瞭解 Join Clause 的基本原理

LINQ Join 運算子的核心是根據指定的條件,將兩個或更多集合中的元素合併。 此操作員可讓開發人員在記憶體集合上執行類似 SQL 的連線,輕鬆合併來自不同來源的資料。

LINQ Join 運算子的語法

LINQ Join 運算符號的語法具有很強的表達力,並遵循類似 SQL 連結的模式。 基本語法如下:

var queryResult = 
    from element1 in collection1
    join element2 in collection2 on element1.Key equals element2.Key
    select new { element1, element2 };
var queryResult = 
    from element1 in collection1
    join element2 in collection2 on element1.Key equals element2.Key
    select new { element1, element2 };
$vbLabelText   $csharpLabel

在此語法中

  • element1element2 是變數,代表 collection1collection2 中的元素。
  • element1.Keyelement2.Key 是用作連接操作基礎的屬性。
  • equals 關鍵字指定連接的條件。
  • select 子句會建立一個結合兩個集合中元素的新物件。

LINQ Joins 的類型

LINQ 支援幾種類型的連接,包括

1.Inner Join: 只會回傳兩個集合中具有匹配關鍵的元素。

```csharp
var innerJoin = from customer in customers
                join order in orders on customer.CustomerID equals order.CustomerID // join orders to customers based on the customer ID key
                select new { customer.CustomerID, customer.CustomerName, order.OrderID }; // create a new anonymous object based on the objects obtained from the join
```

2.Left Outer Join (預設):回傳來自左集合的所有元素,以及來自右集合的符合元素。 如果未找到匹配,結果將包含右側元素的預設值。

```csharp
var leftOuterJoin = from customer in customers
                    join order in orders on customer.CustomerID equals order.CustomerID into customerOrders
                    from co in customerOrders.DefaultIfEmpty()
                    select new { customer.CustomerID, customer.CustomerName, OrderID = co?.OrderID ?? -1 };
```

3.Group Join: 將左側集合中的元素與右側集合中的匹配元素組合。

```csharp
var groupJoin = from customer in customers
                join order in orders on customer.CustomerID equals order.CustomerID into customerOrders
                select new { customer.CustomerID, customer.CustomerName, Orders = customerOrders };
```

實際應用:結合客戶和訂單資料

讓我們考慮一個實際的例子,我們有兩個集合:客戶訂單。 我們想要建立一個結果集,使用 LINQ Join 運算子將客戶資訊與其相對應的訂單結合。

var customerOrderInfo = 
    from customer in customers
    join order in orders on customer.CustomerID equals order.CustomerID
    select new { customer.CustomerID, customer.CustomerName, order.OrderID, order.OrderDate };
var customerOrderInfo = 
    from customer in customers
    join order in orders on customer.CustomerID equals order.CustomerID
    select new { customer.CustomerID, customer.CustomerName, order.OrderID, order.OrderDate };
$vbLabelText   $csharpLabel

在本範例中,結果集將包含客戶資訊及其相關訂單的項目。 join 延伸方法語法可協助 C# 開發人員執行類似 SQL 的 join 作業。

介紹 IronPDF。

C# LINQ Join Query Syntax (How It Works For Developers):圖 1 - IronPdf 網頁

Develop PDF Solutions with IronPDF 是一個全面的 C# 函式庫,專門用於建立、處理和編輯 PDF 文件。 它賦予開發人員從各種資料來源動態產生 PDF 的能力,使其成為需要產生 PDF 文件的應用程式的多功能解決方案。

安裝 IronPdf:快速入門

要開始在您的 C# 專案中利用 IronPDF 函式庫,您可以輕鬆安裝 IronPDF NuGet 套件。 在套件管理員控制台中使用下列指令:

Install-Package IronPdf 

另外,您也可以在 NuGet 套件管理員中搜尋"IronPDF",並從中安裝。

C# LINQ Join Query Syntax (How It Works For Developers):圖 2 - 從 NuGet 套件管理員安裝 IronPDF 函式庫

LINQ Join 與 IronPDF:動態雙人組?

LINQ Join 運算符號以其合併來自不同來源的資料的能力而聞名,在資料整合是關鍵的情況下,LINQ Join 運算符號可成為一項寶貴的資產。 當談到利用 IronPDF 的 LINQ Join 時,首要考慮的是您打算整合到 PDF 文件中的資料性質。

IronPdf 的亮點在於其HTML 至 PDF 轉換功能,可保持您的版面設計和樣式不變。 此功能可從網頁內容產生 PDF,非常適合報告、發票和文件。 HTML 檔案、URL 和 HTML 字串可無縫轉換為 PDF。

using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        var renderer = new ChromePdfRenderer();

        // 1. Convert HTML String to PDF
        var htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a PDF from an HTML string.</p>";
        var pdfFromHtmlString = renderer.RenderHtmlAsPdf(htmlContent);
        pdfFromHtmlString.SaveAs("HTMLStringToPDF.pdf");

        // 2. Convert HTML File to PDF
        var htmlFilePath = "path_to_your_html_file.html"; // Specify the path to your HTML file
        var pdfFromHtmlFile = renderer.RenderHtmlFileAsPdf(htmlFilePath);
        pdfFromHtmlFile.SaveAs("HTMLFileToPDF.pdf");

        // 3. Convert URL to PDF
        var url = "http://ironpdf.com"; // Specify the URL
        var pdfFromUrl = renderer.RenderUrlAsPdf(url);
        pdfFromUrl.SaveAs("URLToPDF.pdf");
    }
}
$vbLabelText   $csharpLabel

情境 1:在生成 PDF 之前組合資料

如果您的目標是在啟動 PDF 生成程序之前,將來自不同資料來源的資料結合起來,則可以獨立運用 LINQ Join。 一旦有了統一的資料集,您就可以利用 IronPDF 來根據整合的資料動態產生 PDF 文件。

以下是一個簡化的範例:

// Assume 'customerOrderInfo' is a result set obtained using LINQ Join
var pdfDocument = new IronPdf.ChromePdfRenderer();
foreach (var entry in customerOrderInfo)
{
    // Use IronPDF to add content to the PDF based on integrated data
    pdfDocument.AddHTML($"<p>Customer ID: {entry.CustomerID}, Order ID: {entry.OrderID}</p>");
}
// Save or render the PDF document as needed
pdfDocument.SaveAs("IntegratedDataDocument.pdf");
// Assume 'customerOrderInfo' is a result set obtained using LINQ Join
var pdfDocument = new IronPdf.ChromePdfRenderer();
foreach (var entry in customerOrderInfo)
{
    // Use IronPDF to add content to the PDF based on integrated data
    pdfDocument.AddHTML($"<p>Customer ID: {entry.CustomerID}, Order ID: {entry.OrderID}</p>");
}
// Save or render the PDF document as needed
pdfDocument.SaveAs("IntegratedDataDocument.pdf");
$vbLabelText   $csharpLabel

請造訪 IronPDF 文件,探索 PDF 文件產生的更多方式,以及如何使用 IronPDF 的 LINQ Join。

情境 2:PDF 生成过程中的动态数据集成

IronPDF 允許在 PDF 文件中加入動態內容,使得在 PDF 生成過程中使用 LINQ Join 整合資料成為可能。 在此,我們將建立並訂定客戶類別,以代表真實世界的應用程式。 資料來源可以是 SQL 資料庫或某些結構化格式,在本例中,是包含一組資料屬性的物件清單,就像資料庫中的表格一樣。 以下範例顯示 LINQ Join 方法與 IronPDF 的詳細整合,我們使用 HTML Strings for PDF Generation 來建立文件:

using System;
using System.Collections.Generic;
using System.Linq;
using IronPdf;

class Order
{
    public int OrderID { get; set; }
    public int CustomerID { get; set; }
    // Other order-related properties...
}

class Customer
{
    public int CustomerID { get; set; }
    // Other customer-related properties...
}

class Program
{
    static void Main()
    {
        // Sample orders collection
        var orders = new List<Order>
        {
            new Order { OrderID = 1, CustomerID = 1 },
            new Order { OrderID = 2, CustomerID = 1 },
            new Order { OrderID = 3, CustomerID = 2 },
        };

        // Sample customers collection
        var customers = new List<Customer>
        {
            new Customer { CustomerID = 1 },
            new Customer { CustomerID = 2 },
        };

        var pdfDocument = new ChromePdfRenderer();
        string htmlContent = "<h1>Details generated using LINQ JOIN</h1>";

        // Use join to find customer orders
        var query = from customer in customers
                    join order in orders on customer.CustomerID equals order.CustomerID
                    select new { CustomerID = customer.CustomerID, OrderID = order.OrderID };

        foreach (var result in query)
        {
            // Use IronPDF to dynamically add content to the PDF based on integrated data
            htmlContent += $"<p>Customer ID: {result.CustomerID}, Order ID: {result.OrderID}</p>";
        }

        // Save or render the PDF document as needed
        pdfDocument.RenderHtmlAsPdf(htmlContent)
                   .SaveAs("DynamicIntegratedDataDocument.pdf");
    }
}
using System;
using System.Collections.Generic;
using System.Linq;
using IronPdf;

class Order
{
    public int OrderID { get; set; }
    public int CustomerID { get; set; }
    // Other order-related properties...
}

class Customer
{
    public int CustomerID { get; set; }
    // Other customer-related properties...
}

class Program
{
    static void Main()
    {
        // Sample orders collection
        var orders = new List<Order>
        {
            new Order { OrderID = 1, CustomerID = 1 },
            new Order { OrderID = 2, CustomerID = 1 },
            new Order { OrderID = 3, CustomerID = 2 },
        };

        // Sample customers collection
        var customers = new List<Customer>
        {
            new Customer { CustomerID = 1 },
            new Customer { CustomerID = 2 },
        };

        var pdfDocument = new ChromePdfRenderer();
        string htmlContent = "<h1>Details generated using LINQ JOIN</h1>";

        // Use join to find customer orders
        var query = from customer in customers
                    join order in orders on customer.CustomerID equals order.CustomerID
                    select new { CustomerID = customer.CustomerID, OrderID = order.OrderID };

        foreach (var result in query)
        {
            // Use IronPDF to dynamically add content to the PDF based on integrated data
            htmlContent += $"<p>Customer ID: {result.CustomerID}, Order ID: {result.OrderID}</p>";
        }

        // Save or render the PDF document as needed
        pdfDocument.RenderHtmlAsPdf(htmlContent)
                   .SaveAs("DynamicIntegratedDataDocument.pdf");
    }
}
$vbLabelText   $csharpLabel

此代碼使用 join 關鍵字,可協助找到每位客戶的匹配訂單,使查詢更簡潔且更具表達力。

C# LINQ Join Query Syntax (How It Works For Developers):圖 3 - 上一個程式碼範例輸出的 PDF

結論

總而言之,IronPDF 是在 C# 應用程式中產生 PDF 的強大解決方案。 當與功能強大的 LINQ Join 運算符結合時,開發人員可以在 PDF 生成過程之前或過程中實現無縫的資料整合。 無論您是需要將客戶資訊與訂單合併,或是合併來自不同來源的資料,LINQ Join 與 IronPDF 的動態二重奏都能提供靈活有效的方法,增強您在 C# 應用程式中產生 PDF 的能力。

總而言之,C# LINQ Join 運算符號是一種強大的工具,可以無縫整合來自多個來源的資料。 無論您處理的是資料庫、API 回應或記憶體集合,LINQ Join 運算子都能簡化根據指定條件組合資料的過程。 當您在 C# 應用程式中瀏覽資料連線的多樣性時,請考慮 LINQ Join 運算子為您的資料整合工具包所帶來的強大功能與彈性。 掌握此操作符可為有效處理和操作資料開啟新的可能性,增強 C# 應用程式的功能。

IronPdf 提供免費試用版以進行評估,以測試其完整功能。 不過,一旦試用期過後,就需要適當的授權

常見問題解答

C# LINQ Join 運算子的用途是什麼?

C# LINQ Join 運算子旨在根據指定條件合併來自多個集合的資料。它允許開發人員執行類似於 SQL 連接的複雜資料集成,使其在記憶體資料操作方面具有不可估量的價值。

如何在C#中將HTML轉換為PDF?

您可以使用 IronPDF 的RenderHtmlAsPdf方法將 HTML 字串轉換為 PDF。您也可以使用RenderHtmlFileAsPdf將 HTML 檔案轉換為 PDF。

LINQ 支援哪些類型的連線?

LINQ 支援多種連接類型,包括內連接、左外連接和分組連接。這些連接類型允許不同層級的資料集成,例如僅返回匹配的元素或包含來自相同來源集合的所有元素。

LINQ Join 在實際場景中如何應用?

LINQ Join 可用於實際場景中,合併來自不同來源的數據,例如將客戶資訊與其訂單數據結合。這種整合有助於進行全面的數據分析和報告。

如何在我的專案中安裝用於生成 PDF 的 C# 庫?

您可以透過 NuGet 套件管理器在 C# 專案中安裝 IronPDF,方法是在套件管理器控制台中使用指令Install-Package IronPdf ,或在 NuGet 套件管理器中搜尋「IronPDF」。

在 C# 中使用 PDF 生成庫有哪些好處?

使用 IronPDF 等庫可以從各種資料來源動態產生 PDF 文件,並保持內容的佈局和樣式。它尤其適用於將 HTML 內容轉換為 PDF,以便建立報告、發票和其他文件。

LINQ Join 和 PDF 生成庫如何協同運作?

您可以使用 LINQ Join 整合來自各種資料來源的數據,然後使用 IronPDF 產生 PDF。這種組合方式可以建立基於全面整合資料集的動態 PDF 文件。

我可以在 PDF 產生過程中使用 LINQ Join 嗎?

是的,您可以使用 LINQ Join 在 IronPDF 中產生 PDF 時整合資料。這使得創建能夠反映即時資料整合的動態文件成為可能,從而提高文件創建的效率和靈活性。

HTML 轉換 PDF 功能提供哪些功能?

IronPDF 的 HTML 轉 PDF 功能可以將 HTML 檔案、URL 和 HTML 字串轉換為 PDF,同時保留佈局和樣式。這對於從網頁內容產生視覺上一致的 PDF 文件尤其有用。

PDF生成庫是否有評估選項?

是的,IronPDF 提供免費試用版供評估使用。試用期結束後,若要繼續使用該庫的全部功能,則需要購買正式許可證。

Jacob Mellor,Team Iron 首席技術官
首席技術長

Jacob Mellor 是 Iron Software 的首席技術官,也是一位富有遠見的工程師,率先開發了 C# PDF 技術。作為 Iron Software 核心程式碼庫的最初開發者,他自公司成立之初便參與塑造了其產品架構,並與執行長 Cameron Rimington 一起將其發展成為一家擁有 50 多名員工、服務於 NASA、特斯拉和全球政府機構的公司。

Jacob 於 1998 年至 2001 年在曼徹斯特大學獲得土木工程一級榮譽學士學位。 1999 年,他在倫敦創辦了自己的第一家軟體公司;2005 年,他創建了自己的第一個 .NET 元件。此後,他專注於解決微軟生態系統中的複雜問題。

他的旗艦產品 IronPDF 和 IronSuite .NET 庫在全球 NuGet 上的安裝量已超過 3000 萬次,其基礎程式碼持續為全球開發者工具提供支援。憑藉 25 年的商業經驗和 41 年的程式設計專長,Jacob 始終致力於推動企業級 C#、Java 和 Python PDF 技術的創新,同時指導下一代技術領導者。