如何在 C# 中於 PDF 上繪製線條與矩形

更新:2026年4月23日

Translated

View the article in English

若要在 C# 中於 PDF 上繪製線條和矩形，請在 PdfDocument 物件上使用 IronPDF 的 DrawLine 和 DrawRectangle 方法，並指定座標、顏色及尺寸，以程式化方式添加 Professional 幾何圖形。

在 PDF 文件上繪製線條與矩形，是指將幾何形狀（具體而言是線條與矩形）添加至 PDF 檔案內容的過程。此操作通常透過程式化方式進行，使用 C# 或 VB.NET 等程式語言，並搭配 IronPdf 等函式庫。

當您繪製一條線時，會建立一個具有指定起點和終點的可見線段。同樣地，當您繪製一個矩形時，您定義了一個具有指定尺寸與位置的四邊形。這些繪圖功能對於在 PDF 文件中建立表單、圖表、註解以及標示重要段落至關重要。 IronPDF 的繪圖功能與其餘 PDF 編輯功能無縫整合，讓開發人員能夠強化現有 PDF 檔案，或透過自訂圖形建立全新的文件。

快速入門：使用 IronPDF 繪製線條與矩形

使用 IronPDF 在您的 PDF 文件中添加線條和矩形。本指南示範如何使用 DrawLine 方法繪製線條，以及使用 DrawRectangle 方法繪製矩形。只需幾行程式碼，您就能在 PDF 中建立動態圖形元素，為您的應用程式增添 Professional 級的視覺效果。

using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf
PM > Install-Package IronPdf

請複製並執行此程式碼片段。

IronPdf.PdfDocument pdf = IronPdf.PdfDocument.FromFile("input.pdf");
pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2);
pdf.SaveAs("output.pdf");

部署至您的生產環境進行測試

立即透過免費試用，在您的專案中開始使用 IronPDF

簡化工作流程（5 個步驟）

從 NuGet 下載 IronPDF C# 函式庫
匯入目標 PDF 文件或從 HTML 渲染
使用 DrawLine 方法在 PDF 中添加線條
使用 DrawRectangle 方法新增矩形
匯出已編輯的 PDF 文件

如何在 C# 中於 PDF 上繪製線條？

透過使用 物件提供的 方法，您可以向現有的 PDF 文件中添加線條。透過 IronDrawing API 文件中提供的 `` 類別，可實現使用十六進位色碼設定線條顏色的功能。此功能讓您能夠直接在 PDF 文件中建立底線、分隔線、邊框或自訂圖表。

`` 方法接受多個參數，讓您能精確控制線條的外觀：

頁面索引：指定要繪製的頁面（從零開始的索引）
起點：起始座標 (X, Y)
終點：終點座標 (X, Y)
Width：以點為單位的字體粗細
Color：使用十六進位碼或預設顏色設定的線條顏色

:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-draw-line.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Configure the required parameters
int pageIndex = 0;
var start = new IronSoftware.Drawing.PointF(200,150);
var end = new IronSoftware.Drawing.PointF(1000,150);
int width = 10;
var color = new IronSoftware.Drawing.Color("#000000");

// Draw line on PDF
pdf.DrawLine(pageIndex, start, end, width, color);

pdf.SaveAs("drawLine.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Configure the required parameters
Private pageIndex As Integer = 0
Private start = New IronSoftware.Drawing.PointF(200,150)
Private [end] = New IronSoftware.Drawing.PointF(1000,150)
Private width As Integer = 10
Private color = New IronSoftware.Drawing.Color("#000000")

' Draw line on PDF
pdf.DrawLine(pageIndex, start, [end], width, color)

pdf.SaveAs("drawLine.pdf")

$vbLabelText $csharpLabel

如需更進階的 PDF 處理功能，請參閱 API 參考手冊，其中提供了所有可用方法與屬性的完整文件。

線條繪製的輸出效果為何？

進階線條繪製技巧

在處理 PDF 中的線條時，您可能希望創建更複雜的圖案或設計。以下是繪製多條線以建立網格圖案的範例：

// Create a grid pattern with horizontal and vertical lines
for (int i = 0; i < 5; i++)
{
    // Draw horizontal lines
    var horizontalStart = new IronSoftware.Drawing.PointF(100, 100 + (i * 100));
    var horizontalEnd = new IronSoftware.Drawing.PointF(500, 100 + (i * 100));
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));

    // Draw vertical lines
    var verticalStart = new IronSoftware.Drawing.PointF(100 + (i * 100), 100);
    var verticalEnd = new IronSoftware.Drawing.PointF(100 + (i * 100), 500);
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));
}

// Create a grid pattern with horizontal and vertical lines
for (int i = 0; i < 5; i++)
{
    // Draw horizontal lines
    var horizontalStart = new IronSoftware.Drawing.PointF(100, 100 + (i * 100));
    var horizontalEnd = new IronSoftware.Drawing.PointF(500, 100 + (i * 100));
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));

    // Draw vertical lines
    var verticalStart = new IronSoftware.Drawing.PointF(100 + (i * 100), 100);
    var verticalEnd = new IronSoftware.Drawing.PointF(100 + (i * 100), 500);
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, new IronSoftware.Drawing.Color("#0000FF"));
}

' Create a grid pattern with horizontal and vertical lines
For i As Integer = 0 To 4
    ' Draw horizontal lines
    Dim horizontalStart = New IronSoftware.Drawing.PointF(100, 100 + (i * 100))
    Dim horizontalEnd = New IronSoftware.Drawing.PointF(500, 100 + (i * 100))
    pdf.DrawLine(0, horizontalStart, horizontalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))

    ' Draw vertical lines
    Dim verticalStart = New IronSoftware.Drawing.PointF(100 + (i * 100), 100)
    Dim verticalEnd = New IronSoftware.Drawing.PointF(100 + (i * 100), 500)
    pdf.DrawLine(0, verticalStart, verticalEnd, 2, New IronSoftware.Drawing.Color("#0000FF"))
Next

$vbLabelText $csharpLabel

此技術在 PDF 中建立表單或結構化版面時特別有用。如需更多關於建立表單的資訊，請參閱我們的 PDF 表單建立指南。

如何在 C# 中於 PDF 上繪製矩形？

若要在 PDF 中新增矩形，請使用 方法。一旦 PDF 文件被開啟或渲染，此方法即可用於 物件。請使用 IronDrawing API 文件中提供的 `` 類別，設定矩形的座標、寬度和高度。

矩形是一種用途廣泛的圖形，可在 PDF 文件中用於多種目的：

在重要內容周圍建立邊框
標示文字或圖片的特定區段
建立表單欄位與核取方塊
設計頁首與頁尾
在各段落之間建立視覺分隔線

`` 方法提供輪廓色與填充色的選項，讓您能夠繪製帶有輪廓的矩形、填充的矩形，或是兩者的組合。這種靈活性使其非常適合用於自訂浮水印及其他視覺增強效果。

:path=/static-assets/pdf/content-code-examples/how-to/draw-line-and-rectangle-draw-rectangle.cs

using IronPdf;

ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>testing</h1>");

// Configure the required parameters
int pageIndex = 0;
var rectangle = new IronSoftware.Drawing.RectangleF(200, 100, 1000, 100);
var lineColor = new IronSoftware.Drawing.Color("#000000");
var fillColor = new IronSoftware.Drawing.Color("#32AB90");
int lineWidth = 5;

// Draw rectangle on PDF
pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);

pdf.SaveAs("drawRectangle.pdf");

Imports IronPdf

Private renderer As New ChromePdfRenderer()
Private pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>testing</h1>")

' Configure the required parameters
Private pageIndex As Integer = 0
Private rectangle = New IronSoftware.Drawing.RectangleF(200, 100, 1000, 100)
Private lineColor = New IronSoftware.Drawing.Color("#000000")
Private fillColor = New IronSoftware.Drawing.Color("#32AB90")
Private lineWidth As Integer = 5

' Draw rectangle on PDF
pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth)

pdf.SaveAs("drawRectangle.pdf")

$vbLabelText $csharpLabel

矩形繪製的輸出效果為何？

使用矩形建立複雜版面配置

您可以將矩形與其他繪圖功能結合，以建立精緻的版面配置。以下是一個建立名片範本的範例：

// Create a business card template
var cardBorder = new IronSoftware.Drawing.RectangleF(50, 50, 350, 200);
var logoArea = new IronSoftware.Drawing.RectangleF(60, 60, 80, 80);
var textArea = new IronSoftware.Drawing.RectangleF(150, 60, 240, 180);

// Draw the main card border
pdf.DrawRectangle(0, cardBorder, new IronSoftware.Drawing.Color("#000000"), 
                 new IronSoftware.Drawing.Color("#FFFFFF"), 3);

// Draw logo area with light gray background
pdf.DrawRectangle(0, logoArea, new IronSoftware.Drawing.Color("#666666"), 
                 new IronSoftware.Drawing.Color("#F0F0F0"), 1);

// Draw text area border
pdf.DrawRectangle(0, textArea, new IronSoftware.Drawing.Color("#CCCCCC"), 
                 null, 1); // null for no fill

// Create a business card template
var cardBorder = new IronSoftware.Drawing.RectangleF(50, 50, 350, 200);
var logoArea = new IronSoftware.Drawing.RectangleF(60, 60, 80, 80);
var textArea = new IronSoftware.Drawing.RectangleF(150, 60, 240, 180);

// Draw the main card border
pdf.DrawRectangle(0, cardBorder, new IronSoftware.Drawing.Color("#000000"), 
                 new IronSoftware.Drawing.Color("#FFFFFF"), 3);

// Draw logo area with light gray background
pdf.DrawRectangle(0, logoArea, new IronSoftware.Drawing.Color("#666666"), 
                 new IronSoftware.Drawing.Color("#F0F0F0"), 1);

// Draw text area border
pdf.DrawRectangle(0, textArea, new IronSoftware.Drawing.Color("#CCCCCC"), 
                 null, 1); // null for no fill

Imports IronSoftware.Drawing

' Create a business card template
Dim cardBorder As New RectangleF(50, 50, 350, 200)
Dim logoArea As New RectangleF(60, 60, 80, 80)
Dim textArea As New RectangleF(150, 60, 240, 180)

' Draw the main card border
pdf.DrawRectangle(0, cardBorder, New Color("#000000"), New Color("#FFFFFF"), 3)

' Draw logo area with light gray background
pdf.DrawRectangle(0, logoArea, New Color("#666666"), New Color("#F0F0F0"), 1)

' Draw text area border
pdf.DrawRectangle(0, textArea, New Color("#CCCCCC"), Nothing, 1) ' Nothing for no fill

$vbLabelText $csharpLabel

最佳實踐與提示

在處理 PDF 中的線條與矩形時，請遵循以下最佳實務：

座標系統的理解

PDF 座標系統以頁面的左下角為起點，X 軸向右增加，Y 軸向上增加。這與許多基於螢幕的座標系統不同。理解這一點對於精準定位至關重要。有關頁面版面的更多詳細資訊，請參閱我們的自訂邊距指南。

效能考量

繪製多個圖形時，請盡可能採用批次操作。與其每次繪製完一個圖形就儲存 PDF，不如先繪製所有圖形，然後一次性儲存。此方法在處理大型 PDF 檔案時尤為重要。

顏色選擇

請在整份文件中使用一致的配色方案。請考量無障礙設計，確保線條/填充顏色與背景之間具有足夠的對比度。 IronDrawing 函式庫支援多種色彩格式，包括十六進位碼、RGB 數值及命名色彩。

與其他功能的整合

繪圖功能可與其他 IronPDF 功能完美配合。您可以：

基於從檔案載入的現有 PDF 進行繪製
向從 HTML 生成的 PDF 中添加圖形
結合繪圖與文字及圖片加蓋功能
使用帶有頁面方向設定的繪圖功能

有關這些整合功能的範例，請參閱我們關於建立新 PDF、在圖片上加蓋文字以及旋轉頁面方向的指南。

錯誤處理

在繪製 PDF 時，務必實施適當的錯誤處理：

try 
{
    pdf.DrawLine(pageIndex, start, end, width, color);
    pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error drawing on PDF: {ex.Message}");
    // Handle the error appropriately
}

try 
{
    pdf.DrawLine(pageIndex, start, end, width, color);
    pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth);
    pdf.SaveAs("output.pdf");
}
catch (Exception ex)
{
    Console.WriteLine($"Error drawing on PDF: {ex.Message}");
    // Handle the error appropriately
}

Imports System

Try
    pdf.DrawLine(pageIndex, start, end, width, color)
    pdf.DrawRectangle(pageIndex, rectangle, lineColor, fillColor, lineWidth)
    pdf.SaveAs("output.pdf")
Catch ex As Exception
    Console.WriteLine($"Error drawing on PDF: {ex.Message}")
    ' Handle the error appropriately
End Try

$vbLabelText $csharpLabel

開始使用

若要在您的專案中開始使用 IronPDF 的繪圖功能，請參閱我們的安裝概覽，或查閱快速入門指南以獲取 IronPDF 的全面介紹。

若需進行更進階的繪圖操作（例如在 PDF 中加入文字與位圖），請參閱我們的"繪製文字與位圖"指南。這些功能結合線條與矩形繪製功能，提供了一套完整的工具組，用於自訂與強化 PDF 檔案。

常見問題

如何使用 C# 在 PDF 上繪製線條？

若要在 C# 中於 PDF 上繪製直線，請在 PdfDocument 物件上使用 IronPDF 的 DrawLine 方法。只需指定起始與結束座標、顏色（以十六進位碼表示）以及線寬即可。例如：pdf.DrawLine(10, 10, 200, 10, "#FF0000", 2) 將繪製一條紅色的水平線。

DrawLine 方法接受哪些參數？

IronPDF 的 DrawLine 方法接受多個參數：頁碼 (要繪製的頁面)、起點座標 (X, Y)、終點座標 (X, Y)、寬度 (以點為單位的線寬) 以及顏色 (使用十六進位碼或預設顏色)。

我可以向現有的 PDF 文件中添加矩形嗎？

是的，您可以使用 IronPDF 的 DrawRectangle 方法在現有 PDF 檔案中添加矩形。此方法允許您指定矩形的位置、尺寸、邊框顏色、填充顏色及邊框粗細，以便在 PDF 頁面中創建自訂形狀。

我可以在 PDF 上建立哪些類型的幾何圖形？

透過 IronPDF，您可以在 PDF 文件上繪製線條和矩形。這些圖形可用於製作表單、圖表、註解、邊框、分隔線，以及在 PDF 中標示重要段落。

我需要建立新的 PDF 檔案才能新增圖形，還是可以修改現有的圖形？

IronPDF 允許您透過新增圖形來修改現有的 PDF 檔案。您可以使用 PdfDocument.FromFile() 載入現有的 PDF 檔案，然後利用繪圖方法新增線條和矩形，而無需從頭建立新的文件。

如何控制 PDF 中的圖形顏色？

IronPDF 支援使用十六進位色碼（例如紅色為「#FF0000」）或預設顏色進行色彩自訂。IronDrawing API 中的 Color 類別提供了更多選項，讓您能為線條和矩形套用顏色。

Curtis Chau

立即與工程團隊聯繫

技術撰稿人

Curtis Chau 擁有卡爾頓大學（Carleton University）的電腦科學學士學位，專精於前端開發，並精通 Node.js、TypeScript、JavaScript 及 React。他熱衷於打造直觀且美觀的用戶介面，喜歡運用現代框架，並創建結構完善、視覺上吸引人的手冊。

除了開發工作之外，Curtis 對物聯網（IoT）抱有濃厚興趣，致力於探索整合硬體與軟體的創新方法。閒暇時，他喜歡玩遊戲和開發 Discord 機器人，將對科技的熱愛與創意相結合。

準備開始了嗎？

Nuget 下載 19,014,616 | 版本： 2026.5 just released

檢視授權

還在往下捲動嗎？

想要快速確認成果嗎？ PM > Install-Package IronPdf
執行範例觀看您的 HTML 轉為 PDF。

檢視授權

客戶亮點：

開發者焦點：

網路研討會：

立即開始 30天試用

本頁內容

如何在 C# 中於 PDF 上繪製線條與矩形

using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf

請複製並執行此程式碼片段。

部署至您的生產環境進行測試

簡化工作流程（5 個步驟）

如何在 C# 中於 PDF 上繪製線條？

線條繪製的輸出效果為何？

進階線條繪製技巧

如何在 C# 中於 PDF 上繪製矩形？

矩形繪製的輸出效果為何？

使用矩形建立複雜版面配置

最佳實踐與提示

座標系統的理解

效能考量

顏色選擇

與其他功能的整合

錯誤處理

開始使用

常見問題

如何使用 C# 在 PDF 上繪製線條？

DrawLine 方法接受哪些參數？

我可以向現有的 PDF 文件中添加矩形嗎？

我可以在 PDF 上建立哪些類型的幾何圖形？

我需要建立新的 PDF 檔案才能新增圖形，還是可以修改現有的圖形？

如何控制 PDF 中的圖形顏色？

還在往下捲動嗎？

鋼鐵支援團隊

立即開始 30天試用

本頁內容

如何在 C# 中於 PDF 上繪製線條與矩形

using NuGet 套件管理員安裝 https://www.nuget.org/packages/IronPdf

請複製並執行此程式碼片段。

部署至您的生產環境進行測試

簡化工作流程（5 個步驟）

如何在 C# 中於 PDF 上繪製線條？

線條繪製的輸出效果為何？

進階線條繪製技巧

如何在 C# 中於 PDF 上繪製矩形？

矩形繪製的輸出效果為何？

使用矩形建立複雜版面配置

最佳實踐與提示

座標系統的理解

效能考量

顏色選擇

與其他功能的整合

錯誤處理

開始使用

常見問題

如何使用 C# 在 PDF 上繪製線條？

DrawLine 方法接受哪些參數？

我可以向現有的 PDF 文件中添加矩形嗎？

我可以在 PDF 上建立哪些類型的幾何圖形？

我需要建立新的 PDF 檔案才能新增圖形，還是可以修改現有的圖形？

如何控制 PDF 中的圖形顏色？

還在往下捲動嗎？

立即獲取免費

下一步：開始 30天試用

Thank You

下一步：開始 30天試用

Want to deploy IronSuite to a live project for FREE?

What’s included?

獲得全球數百萬工程師的信賴

鋼鐵支援團隊