跳至頁尾內容
  1. IronPDF
  2. IronPDF博客
  3. .NET 幫助
  4. C# IList
.NET 幫助

C# iList（開發者使用方法）

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

IList簡介

IList 是 .NET Framework 的 Collections 命名空間的一部分。 它是一個非一般的集合介面，提供了一個物件集合的藍圖，這些物件可以透過其索引來個別存取。 與陣列不同，IList 允許動態的物件值元素數量，這表示您可以根據需要從集合中新增或移除元素。 它是 .NET Framework 中所有非一般清單的基本介面，提供一種比陣列更靈活的方式來管理物件集合。 在本教程中，我們將學習 IList 介面和 IronPDF C# PDF Library。

瞭解 IList 介面。

public interface IList 聲明是在 C# 中建立自訂集合的基本部分，這些集合遵守 .NET Framework 的 Collections 命名空間指定的 IList 契約。 IList 包含可存取集合中元素、計數元素，以及透過新增、插入或移除元素來修改集合的屬性和方法。 以下是 IList 介面中定義的一些關鍵屬性和方法：

  • IsFixedSize 和 IsReadOnly 等屬性分別告知集合是固定大小還是唯讀。
  • Add, Insert, Remove, 和 RemoveAt 等方法用於修改集合中的元素。 您可以新增、插入或移除元素。
  • IndexOf 方法用於定位元素，而 Item 屬性 (或 C# 中的 indexer) 則允許根據元素的索引來取得和設定元素。

IList介面的實用用法

為了展示 IList 如何運作，讓我們建立一個簡單的範例。 本範例將示範如何宣告 IList 、新增項目，以及迭代其內容。

建立和修改 IList

首先，讓我們看看如何宣告 IList 並將項目加入其中：

using System;
using System.Collections;

class Program
{
    static void Main(string[] args)
    {
        // Creating an IList instance
        IList myIList = new ArrayList();

        // Adding elements to the IList
        myIList.Add("Hello");
        myIList.Add(10);
        myIList.Add(new object());

        // Displaying the number of values in the IList using the Count property
        Console.WriteLine($"Number of elements: {myIList.Count}");

        // Accessing elements using a loop
        foreach (var element in myIList)
        {
            Console.WriteLine(element);
        }
    }
}
using System;
using System.Collections;

class Program
{
    static void Main(string[] args)
    {
        // Creating an IList instance
        IList myIList = new ArrayList();

        // Adding elements to the IList
        myIList.Add("Hello");
        myIList.Add(10);
        myIList.Add(new object());

        // Displaying the number of values in the IList using the Count property
        Console.WriteLine($"Number of elements: {myIList.Count}");

        // Accessing elements using a loop
        foreach (var element in myIList)
        {
            Console.WriteLine(element);
        }
    }
}
$vbLabelText   $csharpLabel

在上面的示例中，我們使用實作 IList 的類別 ArrayList 建立了一個 IList 實例。 我們混合加入了不同類型的物件，以展示 IList 可以容納任何物件。 最後，我們反覆檢視這個集合，列印出每個元素。

基於索引的存取與修改

透過索引存取和修改元素是 IList 的主要功能。 以下範例說明您如何做到這一點：

using System;
using System.Collections;

class Program
{
    static void Main(string[] args)
    {
        IList myIList = new ArrayList { "Hello", 10, new object() };

        // Accessing an element by index
        object value = myIList[1];
        Console.WriteLine($"Element at index 1: {value}");

        // Modifying an element by index
        myIList[1] = 20;
        Console.WriteLine($"Modified element at index 1: {myIList[1]}");
    }
}
using System;
using System.Collections;

class Program
{
    static void Main(string[] args)
    {
        IList myIList = new ArrayList { "Hello", 10, new object() };

        // Accessing an element by index
        object value = myIList[1];
        Console.WriteLine($"Element at index 1: {value}");

        // Modifying an element by index
        myIList[1] = 20;
        Console.WriteLine($"Modified element at index 1: {myIList[1]}");
    }
}
$vbLabelText   $csharpLabel

實作自訂 IList

有時候，您可能需要繼承 IList 的量身打造的集合。 這可讓您對元素的儲存、存取和修改方式有更多的控制。 以下是實作 IList 的簡單自訂集合範例：

using System;
using System.Collections;

public class CustomCollection : IList
{
    private ArrayList _innerList = new ArrayList();

    public object this[int index]
    {
        get => _innerList[index];
        set => _innerList[index] = value;
    }

    public bool IsFixedSize => _innerList.IsFixedSize;
    public bool IsReadOnly => _innerList.IsReadOnly;
    public int Count => _innerList.Count;
    public bool IsSynchronized => _innerList.IsSynchronized;
    public object SyncRoot => _innerList.SyncRoot;

    public int Add(object value)
    {
        return _innerList.Add(value);
    }

    public void Clear()
    {
        _innerList.Clear();
    }

    public bool Contains(object value)
    {
        return _innerList.Contains(value);
    }

    public int IndexOf(object value)
    {
        return _innerList.IndexOf(value);
    }

    public void Insert(int index, object value)
    {
        _innerList.Insert(index, value);
    }

    public void Remove(object value)
    {
        _innerList.Remove(value);
    }

    public void RemoveAt(int index)
    {
        _innerList.RemoveAt(index);
    }

    public void CopyTo(Array array, int index)
    {
        _innerList.CopyTo(array, index);
    }

    public IEnumerator GetEnumerator()
    {
        return _innerList.GetEnumerator();
    }
}
using System;
using System.Collections;

public class CustomCollection : IList
{
    private ArrayList _innerList = new ArrayList();

    public object this[int index]
    {
        get => _innerList[index];
        set => _innerList[index] = value;
    }

    public bool IsFixedSize => _innerList.IsFixedSize;
    public bool IsReadOnly => _innerList.IsReadOnly;
    public int Count => _innerList.Count;
    public bool IsSynchronized => _innerList.IsSynchronized;
    public object SyncRoot => _innerList.SyncRoot;

    public int Add(object value)
    {
        return _innerList.Add(value);
    }

    public void Clear()
    {
        _innerList.Clear();
    }

    public bool Contains(object value)
    {
        return _innerList.Contains(value);
    }

    public int IndexOf(object value)
    {
        return _innerList.IndexOf(value);
    }

    public void Insert(int index, object value)
    {
        _innerList.Insert(index, value);
    }

    public void Remove(object value)
    {
        _innerList.Remove(value);
    }

    public void RemoveAt(int index)
    {
        _innerList.RemoveAt(index);
    }

    public void CopyTo(Array array, int index)
    {
        _innerList.CopyTo(array, index);
    }

    public IEnumerator GetEnumerator()
    {
        return _innerList.GetEnumerator();
    }
}
$vbLabelText   $csharpLabel

這個 CustomCollection 類封裝了一個 ArrayList 類，這個類本身實作了 IList 。 我們的 CustomCollection 會將呼叫轉發到底層的 ArrayList 上，讓它可以像其他實作 IList 的集合一樣運作。 本範例示範建立一個集合，這個集合可以透過索引存取、修改（新增、插入或移除項目）以及迭代，就像任何實作 IList 的內建 .NET 集合一樣。

使用 IList 進行進階操作。

除了基本的新增、移除和存取操作之外，IList 還允許進行更複雜的操作和查詢。 例如，檢查集合是否包含特定物件，或尋找集合內物件的索引，這些操作對某些應用程式來說可能非常重要：

using System;
using System.Collections;

class Program
{
    static void Main(string[] args)
    {
        IList myIList = new ArrayList { "Hello", 10, new object() };

        // Check if the IList contains a specific object
        bool contains = myIList.Contains(10); // Assuming 10 was added previously
        Console.WriteLine($"Contains 10: {contains}");

        // Find the index of a specific object
        int index = myIList.IndexOf(10);
        Console.WriteLine($"Index of 10: {index}");
    }
}
using System;
using System.Collections;

class Program
{
    static void Main(string[] args)
    {
        IList myIList = new ArrayList { "Hello", 10, new object() };

        // Check if the IList contains a specific object
        bool contains = myIList.Contains(10); // Assuming 10 was added previously
        Console.WriteLine($"Contains 10: {contains}");

        // Find the index of a specific object
        int index = myIList.IndexOf(10);
        Console.WriteLine($"Index of 10: {index}");
    }
}
$vbLabelText   $csharpLabel

這些操作在處理物件集合時特別有用，因為您需要在不遍歷整個集合的情況下，確定特定項目的存在或位置。

IronPDF：C# PDF 函式庫

C# iList (How It Works For Developers)：圖 1 - IronPdf

IronPDF 是專為 .NET 開發人員設計的 PDF 函式庫，可直接在 .NET 應用程式中建立和處理 PDF 文件。 它支援將 HTML轉換為PDF文件、圖像和網頁轉換為PDF。 開發人員可利用此程式庫輕鬆地將 PDF 功能新增至其應用程式。 IronPDF 還包含編輯、合併和分割 PDF 檔案的功能，可全面控制 PDF 的操作。

IronPDF 擅長於 HTML 至 PDF 的轉換，可確保精確保留原始版面與樣式。 它非常適合從網頁內容（如報告、發票和文件）建立 PDF。 IronPDF 支援 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

程式碼範例

以下是一個直接的範例，示範使用 IronPDF 和 IList 介面，從字串清單產生一個簡單的 PDF 文件：

using IronPdf;
using System.Collections.Generic;

public class PDFGenerator
{
    public static void GeneratePDFFromList(IList<string> dataList)
    {
        // Initialize the HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Start building HTML content from the dataList
        var htmlContent = "<h1>My Data List</h1><ul>";
        foreach (var item in dataList)
        {
            htmlContent += $"<li>{item}</li>";
        }
        htmlContent += "</ul>";

        // Convert HTML string to PDF
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF to a file
        pdfDocument.SaveAs("DataList.pdf");
    }
}

// Example usage
class Program
{
    static void Main(string[] args)
    {
        License.LicenseKey = "License-Key";
        IList<string> myDataList = new List<string> { "Apple", "Banana", "Cherry" };
        PDFGenerator.GeneratePDFFromList(myDataList);
    }
}
using IronPdf;
using System.Collections.Generic;

public class PDFGenerator
{
    public static void GeneratePDFFromList(IList<string> dataList)
    {
        // Initialize the HtmlToPdf renderer
        var renderer = new ChromePdfRenderer();

        // Start building HTML content from the dataList
        var htmlContent = "<h1>My Data List</h1><ul>";
        foreach (var item in dataList)
        {
            htmlContent += $"<li>{item}</li>";
        }
        htmlContent += "</ul>";

        // Convert HTML string to PDF
        var pdfDocument = renderer.RenderHtmlAsPdf(htmlContent);

        // Save the PDF to a file
        pdfDocument.SaveAs("DataList.pdf");
    }
}

// Example usage
class Program
{
    static void Main(string[] args)
    {
        License.LicenseKey = "License-Key";
        IList<string> myDataList = new List<string> { "Apple", "Banana", "Cherry" };
        PDFGenerator.GeneratePDFFromList(myDataList);
    }
}
$vbLabelText   $csharpLabel

在這個範例中，一個 IList<string> 用來儲存水果名稱的集合。 然後，GeneratePDFFromList 方法會遍歷這個清單，建立一個 HTML 字串，包含無序清單中的每個項目。IronPDF 的 ChromePdfRenderer 會將這些 HTML 內容轉換成 PDF 文件，並隨後儲存到檔案中。

C# iList (How It Works For Developers)：圖 2 - PDF 輸出

結論

C# iList (How It Works For Developers)：圖 3 - 授權

這本適合初學者的指南旨在涵蓋 C# 中 IList 的基礎知識和實際用途。 透過從簡單用法到自訂實作的範例，我們可以清楚地看到 IList 是 C# 開發人員工具箱中的強大工具。 無論您是操作資料集合或建立您的集合類型，IList 都能提供有效軟體開發所需的功能和彈性。 IronPDF 為有興趣的使用者提供 免費試用其 PDF 函式庫，並提供 $799 起的授權。

常見問題解答

C# 中的 IList 介面是什麼？

`IList` 介面是 .NET Framework 的 Collections 命名空間的一部分，用於建立可透過索引存取的動態集合。它提供了添加、插入、刪除和存取元素的方法，比靜態陣列更靈活。

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

您可以使用 IronPDF 的 `RenderHtmlAsPdf` 方法在 C# 中將 HTML 轉換為 PDF。這允許您將 HTML 字串、文件或 URL 轉換為高品質的 PDF 文件。

IList 介面有哪些關鍵方法？

`IList` 介面的關鍵方法包括 `Add`、`Insert`、`Remove`、`RemoveAt` 和 `IndexOf`。這些方法對於動態管理和修改集合中的元素至關重要。

如何在 C# 中建立自訂 IList？

要在 C# 中建立自訂 `IList`，可以在類別中實作 `IList` 接口，重寫必要的方法和屬性，例如 `Add`、`Remove` 和 `IndexOf`，以自訂集合處理其元素的方式。

IronPDF 如何從 HTML 建立 PDF？

IronPDF 使用 `ChromePdfRenderer` 類別將 HTML 內容轉換為 PDF。它支援從 HTML 字串、文件或 URL 進行轉換，確保從 Web 內容準確建立 PDF。

能否根據數據列表（IList）產生 PDF 文件？

是的，您可以透過遍歷 IList 來建構 HTML 字串，然後使用 IronPDF 的 `ChromePdfRenderer` 將 HTML 轉換為 PDF 文檔，最後使用 `SaveAs` 方法儲存，從而從 IList 產生 PDF。

IList 支援哪些高級操作？

`IList` 中的進階操作包括使用 `Contains` 檢查集合是否包含特定對象，以及使用 `IndexOf` 來尋找對象的索引。這些函數有助於有效率地管理集合，而無需手動搜尋元素。

如何排查C#中PDF生成問題？

如果在使用 C# 產生 PDF 時遇到問題，請確保 HTML 內容格式正確，並確保您使用的是最新版本的 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 技術的創新，同時指導下一代技術領導者。

相關文章

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