1. IronPDF
  2. IronPDF 部落格
  3. .NET 幫助
  4. C# IList
.NET 幫助

C# iList（開發人員如何使用）

Kannaopat Udonpant
坎納帕特·烏頓潘
2024年6月6日
分享:

IList 介紹

IList 是 .NET Framework 中 Collections 命名空間的一部分。 它是一種非泛型集合介面，為可以通過其索引單獨訪問的物件集合提供藍圖。 與陣列不同，IList允許對象值元素的動態數量，這意味著您可以根據需要添加或移除集合中的元素。 它作為 .NET Framework 中所有非泛型列表的基礎介面，提供了一種比數組更靈活地管理物件集合的方法。 我們將學習 IList 介面和IronPDF C# PDF 庫在本教程中。

了解 IList 介面

public interface IList 聲明是在 C# 中創建自定義集合的重要部分，這些集合遵循 .NET Framework 的 Collections 命名空間所指定的 IList 合約。 IList 包含的屬性和方法允許訪問集合中的元素，計算元素數量，並通過添加、插入或刪除元素來修改集合。 以下是 IList 接口中定義的一些關鍵屬性和方法：

  • 屬性如 IsFixedSize 和 IsReadOnly 分別指示集合是否為固定大小或唯讀。
  • 在集合中，用於修改元素的方法包括 Add、void Insert、Remove 和 RemoveAt。 您可以添加、插入和移除元素。
  • IndexOf 方法用於定位元素，而 Item 屬性(或索引器在 C#)允許根據元素的索引進行獲取和設定。

公共介面 IList 的實際用法

為了展示 IList 的運作方式，我們來創建一個簡單的示例。 此通用版本範例將演示如何宣告 IList，向其添加項目，以及遍歷其內容。

建立和修改 IList

首先，我們來看看如何聲明一個 IList 並向其添加項目：

using System;
using System.Collections;
class Program
{
    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 interface using count property
        Console.WriteLine($"Number of elements: {myIList.Count}");
        // Access Elements
        foreach (var element in myIList)
        {
            Console.WriteLine(element);
        }
    }
}
using System;
using System.Collections;
class Program
{
    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 interface using count property
        Console.WriteLine($"Number of elements: {myIList.Count}");
        // Access Elements
        foreach (var element in myIList)
        {
            Console.WriteLine(element);
        }
    }
}

在上述範例中，我們使用實作 IList 的類別 ArrayList 來創建一個 IList 實例。 我們添加了不同類型的對象混合，以展示 IList 可以容納任何對象。 最後，我們遍歷了這個集合，打印出每個元素。

基於索引的訪問和修改

透過索引訪問和修改元素是 IList 的一個關鍵功能。 以下的 IList 範例顯示您可以如何執行：

// 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]}");
// 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]}");

實作自訂 IList

有時候，你可能需要一個繼承 IList 的定製集合。 這允許更好地控制元素的儲存、訪問和修改方式。 以下是一個實現 IList 的簡單自定義集合範例：

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;
// int add
    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();
    }
}
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;
// int add
    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();
    }
}

此 CustomCollection 類別封裝了一個 ArrayList，該類別本身實現了 IList。 我們的 CustomCollection 會將呼叫轉發到底層的 ArrayList，使其能夠像其他任何實作 IList 的集合一樣運作。 這個範例展示了創建一個可以透過索引存取並修改的集合。(新增、插入或移除的項目)，就像任何實現 IList 的內建 .NET 集合一樣，可以被迭代。

IList 的進階操作

除了基本的添加、移除和訪問操作外，IList 還允許進行更複雜的操作和查詢。 例如，檢查集合中是否包含特定物件或尋找物件在集合中的索引，這些操作對某些應用程式可能是必不可少的：

// 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}");
// 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}");

這些操作在處理對象集合時特別有用，您需要確定特定項目的存在或位置，而無需遍歷整個集合。

IronPDF：C# PDF 庫

C# iList（它如何為開發人員工作）：圖 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");
    }
}

範例程式碼

以下是一個簡單的示例，展示如何使用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);
    }
}

在此範例中，IList<string>用於儲存一系列水果名稱。 GeneratePDFFromList 方法接著遍歷這個列表，構建一個包含每個項目的無序列表的 HTML 字串。IronPDF 的 ChromePdfRenderer 會將這個 HTML 內容轉換為 PDF 文件，然後將其保存到檔案中。

C# iList（開發人員的工作原理）：圖2 - PDF輸出

結論

C# iList（開發人員的工作方式）：圖 3 - 授權

這本適合初學者的指南旨在涵蓋 C# 中 IList 的基礎知識及其實際用途。 從簡單使用到自定義實現的範例中可以看出，IList 是 C# 開發者工具中的強大工具。 無論您是操作資料集合還是建立自己的集合類型，IList 提供了有效軟體開發所需的功能和靈活性。 IronPDF 提供一個其 PDF 庫的免費試用版對於感興趣的用戶，授權證書從 $749 起提供。

Kannaopat Udonpant
坎納帕特·烏頓潘
  立即與工程團隊聊天
軟體工程師
在成為軟體工程師之前，Kannapat 在日本北海道大學完成了環境資源博士學位。在攻讀學位期間，Kannapat 也成為了車輛機器人實驗室的成員，該實驗室隸屬於生物生產工程學系。2022 年，他利用自己的 C# 技能，加入了 Iron Software 的工程團隊，專注於 IronPDF 的開發。Kannapat 珍視這份工作，因為他可以直接向負責撰寫大部分 IronPDF 程式碼的開發人員學習。除了同儕學習外，Kannapat 還享受在 Iron Software 工作的社交方面。當他不在撰寫程式碼或文件時，Kannapat 通常會在 PS5 上玩遊戲或重看《最後生還者》。
< 上一頁
C# 鏈結串列（開發人員如何使用）
下一個 >
Polly 重試（開發人員如何運作）
從NuGet 免費用於開發

安裝與 NuGet nuget.org/packages/IronPdf

PM > Install-Package IronPdf

報告問題

準備開始了嗎？ 版本： 2025.3 剛剛發布

免費開始
NuGet 下載 DLL 下載 Windows 安裝程式 開始免費試用
查看許可證 >
Textlogo Iron Suite related to C# iList（開發人員如何使用）

IronPDF 是 IRON 的一部分套件

10 .NET API 產品適用於您的辦公文檔

以兩件產品的價格獲得十件產品   開始免費試用