跳至頁尾內容
  1. IronPDF
  2. IronPDF博客
  3. .NET 幫助
  4. csharp-imap
.NET 幫助

C# IMAP（開發者如何理解其工作原理）

Jacob Mellor，Team Iron 首席技術官
雅各·梅勒
更新:

在電子郵件伺服器通訊領域中，網際網路訊息存取通訊協定 (IMAP) 物件扮演著關鍵的角色，可協助無縫存取儲存於郵件伺服器上的電子郵件訊息。 將 .NET Framework 對新 IMAP 伺服器功能的支援整合至 C# 應用程式，可讓開發人員建立強大的電子郵件用戶端，自動化電子郵件處理工作，並提高生產力。 本綜合指南探討 C# 中 IMAP 通訊協定整合的基本原理，涵蓋主要概念、IMAP 實作技術、閒置延伸以及實用程式碼範例，協助開發人員在其應用程式中利用 IMAP 用戶端的功能。 本指南還探討了如何使用 IronPDF - 用於 PDF 生成和操作的強大 C# 函式庫，以及 Rebex 的 C# IMAP 功能資料來建立 PDF 檔案。

1.瞭解 IMAP 用戶端。

IMAP 是一種廣泛使用的通訊協定，用於存取和管理儲存在遠端郵件伺服器上的電子郵件訊息。 IMAP 伺服器與較舊的 POP3 通訊協定不同，POP3 通訊協定是將電子郵件下載到本機電子郵件用戶端，之後再從電子郵件伺服器移除，而 IMAP 伺服器則允許使用者直接在伺服器上檢視、整理和處理電子郵件。 這可讓電子郵件在多種裝置上同步處理，並提供更靈活的電子郵件管理方式。

2.IMAP 的主要功能

1.訊息同步化： IMAP 可讓用戶端與伺服器同步化電子郵件訊息、資料夾和郵箱狀態，確保從任何裝置都能一致存取最新的電子郵件資料。 2.資料夾管理： IMAP 支援在伺服器上建立、重新命名、刪除和組織電子郵件資料夾，讓使用者可以將電子郵件組織成符合邏輯的類別。 3.訊息擷取與操作：使用 IMAP，用戶端可以直接從伺服器擷取、搜尋、閱讀、移動、複製和刪除個別電子郵件或整個線程。 4.電子郵件標記與狀態更新： IMAP 允許用戶端標記郵件，將其標記為已讀或未讀，並管理郵件標記，例如"已閱讀"、"已回答"或"已標記"，提供對電子郵件狀態的增強控制。

3.在 C# 中實作 IMAP 伺服器；

若要在 C# 應用程式中整合 IMAP 功能，開發人員可以利用第三方函式庫，例如 MailKit 或 OpenPop.NET，這些函式庫提供 IMAP 作業的全面支援。 讓我們探討一個簡單的範例，說明如何使用 MailKit 將使用者連接到 IMAP 伺服器、擷取電子郵件訊息並執行基本操作。

在我們進入程式碼範例之前，有幾個步驟可以讓您取得使用 IMAP 伺服器存取電子郵件所需的應用程式密碼。

1.進入您的 Gmail 帳戶，點選設定。 2.在設定中，前往 IMAP 區段並啟用下列核取方塊。

![C# Imap (How It Works For Developers)：圖 1 - IMAP 設定](/static-assets/pdf/blog/csharp-imap/csharp-imap-1.webp)

3.接下來，進入您的 Google 帳戶，找到兩步驗證。

![C# Imap (How It Works For Developers)：圖 2 - 兩步驗證](/static-assets/pdf/blog/csharp-imap/csharp-imap-2.webp)

4.在兩步驗證頁面中，向下捲動到最後，找到 App Password。

![C# Imap (How It Works For Developers)：圖 3 - 應用程式密碼](/static-assets/pdf/blog/csharp-imap/csharp-imap-3.webp)

5.接下來，寫下您的應用程式名稱，然後按一下建立按鈕。

![C# Imap (How It Works For Developers)：圖 4 - 建立應用程式密碼](/static-assets/pdf/blog/csharp-imap/csharp-imap-4.webp)

6.應用程式密碼已成功產生。

![C# Imap (How It Works For Developers)：圖 5 - 生成的應用程式密碼](/static-assets/pdf/blog/csharp-imap/csharp-imap-5.webp)

配置完成並建立應用程式密碼後，讓我們深入研究程式碼。

// This example demonstrates how to connect to an IMAP server using MailKit and retrieve unread email messages.
// Install the MailKit package using the following command:
// dotnet add package MailKit

using System;
using MailKit.Net.Imap;
using MailKit.Search;
using MimeKit;

class Program
{
    static void Main(string[] args)
    {
        // IMAP server settings
        string imapServer = "imap.gmail.com";
        int imapPort = 993;
        bool useSsl = true;

        // IMAP credentials
        string username = "your-email@gmail.com"; // Replace with your email address
        string password = "your-app-password"; // Replace with the generated app password

        try
        {
            using (var client = new ImapClient())
            {
                // Connect to the IMAP server
                client.Connect(imapServer, imapPort, useSsl);

                // Authenticate with the server
                client.Authenticate(username, password);

                // Select the INBOX folder or any special folder
                client.Inbox.Open(FolderAccess.ReadOnly);

                // Search for unread messages
                var searchQuery = SearchQuery.NotSeen;
                var uids = client.Inbox.Search(searchQuery);

                foreach (var uid in uids)
                {
                    // Retrieve the message by UID
                    var message = client.Inbox.GetMessage(uid);

                    // Display message details
                    Console.WriteLine($"From: {message.From}");
                    Console.WriteLine($"Subject: {message.Subject}");
                    Console.WriteLine($"Date: {message.Date}");
                    Console.WriteLine($"Body: {message.TextBody}");
                    Console.WriteLine();
                }

                // Disconnect from the server
                client.Disconnect(true);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}
// This example demonstrates how to connect to an IMAP server using MailKit and retrieve unread email messages.
// Install the MailKit package using the following command:
// dotnet add package MailKit

using System;
using MailKit.Net.Imap;
using MailKit.Search;
using MimeKit;

class Program
{
    static void Main(string[] args)
    {
        // IMAP server settings
        string imapServer = "imap.gmail.com";
        int imapPort = 993;
        bool useSsl = true;

        // IMAP credentials
        string username = "your-email@gmail.com"; // Replace with your email address
        string password = "your-app-password"; // Replace with the generated app password

        try
        {
            using (var client = new ImapClient())
            {
                // Connect to the IMAP server
                client.Connect(imapServer, imapPort, useSsl);

                // Authenticate with the server
                client.Authenticate(username, password);

                // Select the INBOX folder or any special folder
                client.Inbox.Open(FolderAccess.ReadOnly);

                // Search for unread messages
                var searchQuery = SearchQuery.NotSeen;
                var uids = client.Inbox.Search(searchQuery);

                foreach (var uid in uids)
                {
                    // Retrieve the message by UID
                    var message = client.Inbox.GetMessage(uid);

                    // Display message details
                    Console.WriteLine($"From: {message.From}");
                    Console.WriteLine($"Subject: {message.Subject}");
                    Console.WriteLine($"Date: {message.Date}");
                    Console.WriteLine($"Body: {message.TextBody}");
                    Console.WriteLine();
                }

                // Disconnect from the server
                client.Disconnect(true);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}
$vbLabelText   $csharpLabel

在這個程式碼範例中，我們使用 MailKit 連線到 IMAP 伺服器，使用所提供的憑證認證我們與伺服器的連線，並從 INBOX 資料夾中擷取未讀的電子郵件。 然後，我們遍歷未讀訊息的 UID 清單，依 UID 擷取每則訊息，並顯示其詳細資訊，包括寄件者、主題、日期和正文。

輸出

C# Imap (How It Works For Developers)：圖 6 - 控制台輸出

4.IronPDF。

IronPDF for .NET 是一個功能強大的 C# 函式庫，設計用來簡化 .NET 應用程式中 PDF 文件的建立、操作和渲染。 IronPDF 具有直觀的 API 和廣泛的功能集，使開發人員能夠以程式化的方式無縫生成、編輯和處理 PDF 檔案，增強應用程式的通用性和功能性。 無論您需要生成動態報告、將 HTML 內容轉換為 PDF、從現有 PDF 中提取文字和圖像，還是對文件進行數位簽名，IronPDF 都能提供全面的工具包，滿足您的 PDF 處理需求。 利用 IronPDF，開發人員可以簡化 PDF 相關工作，輕鬆提供高品質的文件解決方案。

IronPDF 擅長於 HTML 至 PDF 的轉換，可確保精確保留原始版面與樣式。 它非常適合從網頁內容（如報告、發票和文件）建立 PDF。 IronPDF 支援 HTML 檔案、URL 和原始 HTML 字串，可輕鬆製作高品質的 PDF 文件。

// This example demonstrates how to convert HTML content to a PDF using IronPDF.
// Install the IronPdf package using the following command:
// dotnet add package IronPdf

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");
    }
}
// This example demonstrates how to convert HTML content to a PDF using IronPDF.
// Install the IronPdf package using the following command:
// dotnet add package IronPdf

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

4.1.安裝 IronPdf

IronPDF 可使用 NuGet 套件管理程式安裝，執行下列指令即可。

Install-Package IronPdf

4.2.使用 IMAP 伺服器的電子郵件建立 PDF

// This example demonstrates how to connect to an IMAP server, retrieve unread email messages, and generate a PDF report using IronPDF.

using System;
using System.Collections.Generic;
using MailKit.Net.Imap;
using MailKit.Search;
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        // IMAP server settings
        string imapServer = "imap.gmail.com";
        int imapPort = 993;
        bool useSsl = true;

        // IMAP credentials
        string username = "your-email@gmail.com"; // Replace with your email address
        string password = "your-app-password"; // Replace with the generated app password

        try
        {
            using (var client = new ImapClient())
            {
                // Connect to the IMAP server
                client.Connect(imapServer, imapPort, useSsl);

                // Authenticate with the server
                client.Authenticate(username, password);

                // Select the INBOX folder
                client.Inbox.Open(FolderAccess.ReadOnly);

                // Search for unread messages
                var searchQuery = SearchQuery.NotSeen;
                var uids = client.Inbox.Search(searchQuery);

                // Create a list to store message details
                var messages = new List<string>();

                // Retrieve details for the first 100 unread messages
                for (int i = 0; i < Math.Min(uids.Count, 100); i++)
                {
                    var uid = uids[i];
                    var message = client.Inbox.GetMessage(uid);

                    // Add message details to the list
                    messages.Add($"From: {message.From}");
                    messages.Add($"Subject: {message.Subject}");
                    messages.Add($"Date: {message.Date}");
                    messages.Add($"Body: {message.TextBody}");
                    messages.Add(""); // Add an empty line for separation
                }

                // Generate PDF report
                GeneratePdfReport(messages);

                // Disconnect from the server
                client.Disconnect(true);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }

    static void GeneratePdfReport(List<string> messages)
    {
        try
        {
            var pdf = new ChromePdfRenderer();

            // Convert message details to HTML format
            string htmlContent = "<h1>Not Seen Emails</h1><hr/>";
            foreach (var message in messages)
            {
                htmlContent += $"<p style='padding-top:30px;'>{message}</p>";
            }

            // Render HTML content to PDF
            var pdfOutput = pdf.RenderHtmlAsPdf(htmlContent);

            // Save PDF to file
            var outputPath = "Email_Report.pdf";
            pdfOutput.SaveAs(outputPath);

            Console.WriteLine($"PDF report generated successfully: {outputPath}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF report: {ex.Message}");
        }
    }
}
// This example demonstrates how to connect to an IMAP server, retrieve unread email messages, and generate a PDF report using IronPDF.

using System;
using System.Collections.Generic;
using MailKit.Net.Imap;
using MailKit.Search;
using IronPdf;

class Program
{
    static void Main(string[] args)
    {
        // IMAP server settings
        string imapServer = "imap.gmail.com";
        int imapPort = 993;
        bool useSsl = true;

        // IMAP credentials
        string username = "your-email@gmail.com"; // Replace with your email address
        string password = "your-app-password"; // Replace with the generated app password

        try
        {
            using (var client = new ImapClient())
            {
                // Connect to the IMAP server
                client.Connect(imapServer, imapPort, useSsl);

                // Authenticate with the server
                client.Authenticate(username, password);

                // Select the INBOX folder
                client.Inbox.Open(FolderAccess.ReadOnly);

                // Search for unread messages
                var searchQuery = SearchQuery.NotSeen;
                var uids = client.Inbox.Search(searchQuery);

                // Create a list to store message details
                var messages = new List<string>();

                // Retrieve details for the first 100 unread messages
                for (int i = 0; i < Math.Min(uids.Count, 100); i++)
                {
                    var uid = uids[i];
                    var message = client.Inbox.GetMessage(uid);

                    // Add message details to the list
                    messages.Add($"From: {message.From}");
                    messages.Add($"Subject: {message.Subject}");
                    messages.Add($"Date: {message.Date}");
                    messages.Add($"Body: {message.TextBody}");
                    messages.Add(""); // Add an empty line for separation
                }

                // Generate PDF report
                GeneratePdfReport(messages);

                // Disconnect from the server
                client.Disconnect(true);
            }
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }

    static void GeneratePdfReport(List<string> messages)
    {
        try
        {
            var pdf = new ChromePdfRenderer();

            // Convert message details to HTML format
            string htmlContent = "<h1>Not Seen Emails</h1><hr/>";
            foreach (var message in messages)
            {
                htmlContent += $"<p style='padding-top:30px;'>{message}</p>";
            }

            // Render HTML content to PDF
            var pdfOutput = pdf.RenderHtmlAsPdf(htmlContent);

            // Save PDF to file
            var outputPath = "Email_Report.pdf";
            pdfOutput.SaveAs(outputPath);

            Console.WriteLine($"PDF report generated successfully: {outputPath}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error generating PDF report: {ex.Message}");
        }
    }
}
$vbLabelText   $csharpLabel

1.我們建立一個 messages 清單，儲存前 100 封未讀電子郵件的詳細資料。 2.在擷取電子郵件詳細資訊的迴圈中，我們會將每封郵件的詳細資訊加入 messages 清單中。 3.在擷取所有未讀電子郵件或前 100 封電子郵件的詳細資訊後，我們呼叫 GeneratePdfReport 方法來建立包含這些詳細資訊的 PDF 報告。 4.在 GeneratePdfReport 方法中，我們將訊息詳細內容轉換為 HTML 格式，並使用 IronPDF 將此 HTML 內容渲染為 PDF 檔案。 5.PDF 報告會儲存在名為"Email_Report.pdf"的檔案中。

您可以用實際的伺服器資訊取代 IMAP 伺服器預設設定與憑證，並執行程式，以測試此程式碼。 它將連線至 IMAP 伺服器，擷取前 100 封未讀電子郵件的詳細資料，產生包含這些詳細資料的 PDF 報告，並將其儲存至檔案中。

C# Imap (How It Works For Developers)：圖 7 - 電子郵件報告輸出

5.結論

將 IMAP 功能整合至 C# 應用程式，可為電子郵件通訊、自動化和生產力提昇開啟無限可能。 透過瞭解 IMAP 的基本原理，並利用 MailKit .NET 等功能強大的函式庫，開發人員可以輕鬆建立功能豐富的電子郵件用戶端、自動化電子郵件處理工作，以及簡化通訊工作流程。

有了本指南所提供的實用知識與程式碼範例，開發人員就有能力在他們的 C# 應用程式中運用 IMAP 整合的力量，並開啟電子郵件通訊創新與效率的新契機。 借助 IronPDF 這個 PDF 處理的多功能函式庫，您可以將附件儲存為 PDF、將電子郵件匯入為 PDF 檔案，或將電子郵件儲存為 PDF 文件。

要瞭解 IronPdf 及其功能的更多資訊，請造訪官方 IronPDF 文件頁面。

常見問題解答

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

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

網路訊息存取協定（IMAP）是用來做什麼的？

IMAP 用於存取和管理遠端郵件伺服器上的電子郵件。它允許跨多個裝置進行郵件同步、資料夾管理、郵件檢索和狀態更新。

如何在C#應用程式中實作IMAP功能？

要在 C# 應用程式中實現 IMAP 功能，可以使用 MailKit 或 OpenPop.NET 等程式庫，它們提供對 IMAP 操作的支持，可讓您建立電子郵件用戶端並自動執行電子郵件處理任務。

我能否使用 C# 從透過 IMAP 協定檢索的電子郵件中產生 PDF 文件？

是的，您可以使用 IMAP 庫檢索電子郵件，然後使用 IronPDF 將電子郵件內容轉換為 PDF 文檔，從而從電子郵件訊息產生 PDF。

在 C# 中連接到 IMAP 伺服器需要哪些步驟？

連接到 IMAP 伺服器包括設定伺服器設定、使用憑證進行身份驗證，以及使用 IMAP 庫來建立連線並與伺服器互動。

如何在C#中實現跨多個裝置的電子郵件同步？

使用 IMAP 協定可以實現跨多個裝置的電子郵件同步，該協定允許直接在伺服器上管理和同步電子郵件。像 MailKit 這樣的程式庫可以為 C# 應用程式提供便利。

在 C# 中，我可以使用哪些函式庫來處理 PDF 檔案？

IronPDF 是一個 C# 庫，可用於建立、操作和渲染 PDF 文檔，簡化產生報告和將 HTML 內容轉換為 PDF 等任務。

如何透過程式設計方式將HTML內容轉換為PDF檔案？

使用 IronPDF，您可以透過渲染 HTML 內容並使用RenderHtmlAsPdf等方法將其儲存為 PDF，從而以程式設計方式將 HTML 內容轉換為 PDF 檔案。

在使用 C# 處理 IMAP 時，常見問題有哪些？

常見問題包括身份驗證錯誤、連線逾時和伺服器設定設定錯誤。確保伺服器設定正確並使用像 MailKit 這樣可靠的庫可以幫助緩解這些問題。

如何為我的電子郵件用戶端應用程式新增PDF產生功能？

透過整合 IronPDF 來增強您的電子郵件用戶端，從而從使用 IMAP 檢索的電子郵件資料產生 PDF 報告，實現高效的文件記錄和保存。

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 技術的創新，同時指導下一代技術領導者。

相關文章

30天試用期 → 完整產品。無限制。無需信用卡。 開始免費試用