1. IronPDF
  2. 如何
  3. HTTP請求標頭
如何使用IronPDF和Cookies在C#中安全生成PDF

如何使用 C# 的 HTTP 請求標頭

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
Translated
View the article in English

C# 中的 HTTP 請求標頭允許您在使用 IronPDF 將 URL 轉換為 PDF 時，傳送額外的中繼資料，如身份驗證令牌或自訂使用者代理。 只需建立一個標頭字典並在渲染之前將它指派給 HttpRequestHeaders 屬性。

快速入門：將 HTTP 標頭新增到 PDF 渲染

  1. 使用NuGet套件管理器安裝https://www.nuget.org/packages/IronPdf

    PM > Install-Package IronPdf

  2. 複製並運行這段程式碼片段。

    new IronPdf.ChromePdfRenderer { RenderingOptions = { HttpRequestHeaders = new Dictionary<string,string> { { "Authorization", "Bearer your_token_here" }, { "User-Agent", "MyApp/1.0" } } } }
    .RenderUrlAsPdf("https://httpbin.org/bearer")
    .SaveAs("withHeaders.pdf");

  3. 部署以在您的實時環境中測試

    今天就開始在您的專案中使用IronPDF，透過免費試用

    arrow pointer

最小工作流程 (5步)

  1. Download IronPDF from NuGet
  2. 準備 HTTP 請求標頭作為 C# 字典
  3. 將字典指派給 HttpRequestHeaders 屬性
  4. 使用 RenderUrlAsPdf 方法將 URL 渲染為 PDF
  5. 將 PDF 保存為文件或匯出為位元組

什麼是 HTTP 請求標頭？

HTTP 請求標頭是由客戶端（如網頁瀏覽器或 API 客戶端）在發出 HTTP 請求時發送給伺服器的中繼資料。標頭提供了關於請求的附加資訊，如身份驗證詳情、內容型別、使用者代理等。

此功能在將 URL 渲染為 PDF 時使用，允許您在發出請求時提供 HTTP 標頭資訊。在使用URL 轉 PDF轉換時，標頭對於存取受保護的內容或需要特定身份驗證機制的 API 而言是必不可少的。

IronPDF 的 HTTP 標頭支援無縫整合了 Chrome PDF 渲染引擎，確保您的標頭在渲染過程中正確發送。 這在處理受保護網站或那些位於 TLS 身份驗證系統之後的網站時特別重要。

Icon Quote related to 什麼是 HTTP 請求標頭？

我最喜歡的程式庫是IronPDF。它允許快速高效地操作PDF文件。它還有許多有價值的功能，例如導出到PDF/A格式和數位簽署PDF文件。

Milan Jovanovic related to 什麼是 HTTP 請求標頭？

Milan Jovanovic

Microsoft MVP

查看案例研究
Icon Quote related to 什麼是 HTTP 請求標頭？

IronOCR意味著我們每年可以從手動處理中節省$40,000，同時提高生產力，釋放資源以進行高影響的任務。我會強烈推薦它。

Brent Matzelle related to 什麼是 HTTP 請求標頭？

Brent Matzelle

首席技術官，OPYN

查看案例研究
Icon Quote related to 什麼是 HTTP 請求標頭？

IronSuite在我們的運營中扮演著至關重要的角色。這些工具增加了包括建立平面圖和改善庫存管理在內的業務效率。

David Jones related to 什麼是 HTTP 請求標頭？

David Jones

首席軟體工程師，Agorus Build

查看案例研究

如何將自訂標頭新增到 PDF 渲染中？

在使用 HttpRequestHeaders 屬性設定 HTTP 請求標頭之前，首先設計一個合適 HTTP 請求標頭物件。 在渲染過程中，該標頭將包含在發送到伺服器的 URL 請求中。 例如，我們會使用httpbin.org，一個有助於顯示標頭請求的網站。

:path=/static-assets/pdf/content-code-examples/how-to/http-request-header.cs
using IronPdf;
using System.Collections.Generic;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HttpRequestHeaders = new Dictionary<string, string>
{
    { "Authorization", "Bearer test-token-123" }
};

// Render PDF from authenticated page
var pdf = renderer.RenderUrlAsPdf("https://httpbin.org/bearer");
pdf.SaveAs("output.pdf");
Imports IronPdf
Imports System.Collections.Generic

Private renderer = New ChromePdfRenderer()
renderer.RenderingOptions.HttpRequestHeaders = New Dictionary(Of String, String) From {
	{"Authorization", "Bearer test-token-123"}
}

' Render PDF from authenticated page
Dim pdf = renderer.RenderUrlAsPdf("https://httpbin.org/bearer")
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

處理多個標頭

在面對複雜的身份驗證場景或 API 時，您通常需要發送多個標頭。 以下是處理各種標頭組合的方法：

:path=/static-assets/pdf/content-code-examples/how-to/http-request-header-3.cs
using IronPdf;
using System.Collections.Generic;

var renderer = new ChromePdfRenderer();

// Configure multiple headers for API access
renderer.RenderingOptions.HttpRequestHeaders = new Dictionary<string, string>
{
    { "Authorization", "Bearer your-api-token" },
    { "Accept", "text/html,application/xhtml+xml" },
    { "Accept-Language", "en-US,en;q=0.9" },
    { "Cache-Control", "no-cache" },
    { "X-Custom-Header", "MyApplication/2.0" }
};

// Additional rendering options for better results
renderer.RenderingOptions.WaitFor.RenderDelay(500); // Wait for dynamic content
renderer.RenderingOptions.ViewPortWidth = 1920;
renderer.RenderingOptions.ViewPortHeight = 1080;

var pdf = renderer.RenderUrlAsPdf("https://api.example.com/report");
pdf.SaveAs("api-report.pdf");

Imports IronPdf
Imports System.Collections.Generic

Dim renderer As New ChromePdfRenderer()

' Configure multiple headers for API access
renderer.RenderingOptions.HttpRequestHeaders = New Dictionary(Of String, String) From {
    {"Authorization", "Bearer your-api-token"},
    {"Accept", "text/html,application/xhtml+xml"},
    {"Accept-Language", "en-US,en;q=0.9"},
    {"Cache-Control", "no-cache"},
    {"X-Custom-Header", "MyApplication/2.0"}
}

' Additional rendering options for better results
renderer.RenderingOptions.WaitFor.RenderDelay(500) ' Wait for dynamic content
renderer.RenderingOptions.ViewPortWidth = 1920
renderer.RenderingOptions.ViewPortHeight = 1080

Dim pdf = renderer.RenderUrlAsPdf("https://api.example.com/report")
pdf.SaveAs("api-report.pdf")
$vbLabelText   $csharpLabel

最常用的 HTTP 標頭有哪些？

  • Authorization：發送身份驗證憑證（Bearer token、Basic auth 等）
  • Content-Type：定義請求正文的格式（例如：application/json）
  • Accept：指定期望的響應格式（例如：text/html、application/json）
  • User-Agent：識別發出請求的客戶端（瀏覽器、API 客戶端等）
  • Referer：指出連結到當前請求的頁面
  • Cookie：發送用於會話追蹤的 Cookie

使用Cookie 進行身份驗證時，您可以將 Cookie 標頭與其他身份驗證方法結合使用以增強安全性。 IronPDF 中的自訂日誌功能可以幫助您在開發過程中除錯與標頭相關的問題。

我應該何時使用自訂標頭？

在存取需要身份驗證的受保護資源時，與期望特定標頭的 API 一同工作時，或在需要伺服器辨識您的應用程式時，自訂標頭極為重要。 它們在從經過身份驗證的網頁或 API 端點中渲染 PDF 時特別有用。

常見情境包括：

  • 存取經身份驗證保護的內部公司儀表板
  • 從需要 API 鑰匙的 REST API 生成報告
  • 將經過身份驗證的 SaaS 應用程式頁面轉換為 PDF
  • 使用基於令牌的身份驗證的微服務

與身份驗證系統整合

IronPDF 的標頭支援可無縫地與各種身份驗證系統一起工作。 對於基本身份驗證場景：

:path=/static-assets/pdf/content-code-examples/how-to/http-request-header-4.cs
using IronPdf;
using System;
using System.Text;

var renderer = new ChromePdfRenderer();

// Create Basic Auth header
string username = "user@example.com";
string password = "securepassword";
string credentials = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{username}:{password}"));

renderer.RenderingOptions.HttpRequestHeaders = new Dictionary<string, string>
{
    { "Authorization", $"Basic {credentials}" }
};

// Render protected resource
var pdf = renderer.RenderUrlAsPdf("https://protected.example.com/report");
pdf.SaveAs("protected-report.pdf");

Imports IronPdf
Imports System
Imports System.Text
Imports System.Collections.Generic

Dim renderer As New ChromePdfRenderer()

' Create Basic Auth header
Dim username As String = "user@example.com"
Dim password As String = "securepassword"
Dim credentials As String = Convert.ToBase64String(Encoding.UTF8.GetBytes($"{username}:{password}"))

renderer.RenderingOptions.HttpRequestHeaders = New Dictionary(Of String, String) From {
    {"Authorization", $"Basic {credentials}"}
}

' Render protected resource
Dim pdf = renderer.RenderUrlAsPdf("https://protected.example.com/report")
pdf.SaveAs("protected-report.pdf")
$vbLabelText   $csharpLabel

如果缺少或標頭不正確會發生什麼事情？

缺少或不正確的標頭可能導致 401 未授權錯誤、403 禁止響應或頁面渲染不完全。 始終確認您的標頭值符合伺服器預期，特別是對於身份驗證令牌和 API 鑰匙。

若需故障排除標頭問題，請考慮使用 IronPDF 的除錯功能以檢查渲染過程。 常見問題包括：

  • 已過期的令牌或 API 鑰匙
  • 錯誤的標頭格式
  • 缺少必要的標頭
  • 大小寫敏感的標頭名稱被輸錯

使用動態內容的進階標頭

處理需要身份驗證的大量 JavaScript 的頁面時，結合標頭與渲染延遲：

:path=/static-assets/pdf/content-code-examples/how-to/http-request-header.cs
using IronPdf;
using System.Collections.Generic;

var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.HttpRequestHeaders = new Dictionary<string, string>
{
    { "Authorization", "Bearer test-token-123" }
};

// Render PDF from authenticated page
var pdf = renderer.RenderUrlAsPdf("https://httpbin.org/bearer");
pdf.SaveAs("output.pdf");
Imports IronPdf
Imports System.Collections.Generic

Private renderer = New ChromePdfRenderer()
renderer.RenderingOptions.HttpRequestHeaders = New Dictionary(Of String, String) From {
	{"Authorization", "Bearer test-token-123"}
}

' Render PDF from authenticated page
Dim pdf = renderer.RenderUrlAsPdf("https://httpbin.org/bearer")
pdf.SaveAs("output.pdf")
$vbLabelText   $csharpLabel

標頭安全的最佳實踐

處理敏感身份驗證標頭時：

  1. 千萬不要將憑證硬編碼：將令牌和 API 鑰匙儲存在安全的配置中
  2. 使用 HTTPS 通訊協定網址：在發送身份驗證標頭時，始終從 HTTPS 端點進行渲染
  3. 定期輪替令牌：對長時間運行的應用程式實施令牌輪替機制
  4. 驗證 SSL 證書：確保對安全連接進行正確的證書驗證
  5. 監控標頭使用：記錄標頭使用情況以進行安全審計

有關其他安全考量，請參閱PDF 權限和密碼指南，以保護生成的 PDF。

與現代網路應用程式整合

現代單頁應用程式（SPAs）和漸進式網頁應用程式（PWAs）通常需要特定標頭以進行正常渲染。 以下是處理 OAuth 2.0 受保護資源的方法：

using IronPdf;
using System.Collections.Generic;
using System.Threading.Tasks;

public async Task<PdfDocument> GenerateOAuthProtectedPdf(string accessToken, string url)
{
    var renderer = new ChromePdfRenderer();

    // Configure OAuth headers
    renderer.RenderingOptions.HttpRequestHeaders = new Dictionary<string, string>
    {
        { "Authorization", $"Bearer {accessToken}" },
        { "Accept", "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8" }
    };

    // Set rendering options for SPAs
    renderer.RenderingOptions.WaitFor.RenderDelay(3000);
    renderer.RenderingOptions.EnableJavaScript = true;

    // Render and return the PDF
    return await Task.Run(() => renderer.RenderUrlAsPdf(url));
}
using IronPdf;
using System.Collections.Generic;
using System.Threading.Tasks;

public async Task<PdfDocument> GenerateOAuthProtectedPdf(string accessToken, string url)
{
    var renderer = new ChromePdfRenderer();

    // Configure OAuth headers
    renderer.RenderingOptions.HttpRequestHeaders = new Dictionary<string, string>
    {
        { "Authorization", $"Bearer {accessToken}" },
        { "Accept", "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8" }
    };

    // Set rendering options for SPAs
    renderer.RenderingOptions.WaitFor.RenderDelay(3000);
    renderer.RenderingOptions.EnableJavaScript = true;

    // Render and return the PDF
    return await Task.Run(() => renderer.RenderUrlAsPdf(url));
}
Imports IronPdf
Imports System.Collections.Generic
Imports System.Threading.Tasks

Public Async Function GenerateOAuthProtectedPdf(accessToken As String, url As String) As Task(Of PdfDocument)
    Dim renderer As New ChromePdfRenderer()

    ' Configure OAuth headers
    renderer.RenderingOptions.HttpRequestHeaders = New Dictionary(Of String, String) From {
        {"Authorization", $"Bearer {accessToken}"},
        {"Accept", "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"}
    }

    ' Set rendering options for SPAs
    renderer.RenderingOptions.WaitFor.RenderDelay(3000)
    renderer.RenderingOptions.EnableJavaScript = True

    ' Render and return the PDF
    Return Await Task.Run(Function() renderer.RenderUrlAsPdf(url))
End Function
$vbLabelText   $csharpLabel

對於涉及非同步操作的更複雜情況，請考慮實施重試邏輯以應對身份驗證失敗嘗試。

結論

IronPDF 中的 HTTP 請求標頭提供了一種強大的方式來存取和轉換經身份驗證的網路內容為 PDF。 通過正確配置標頭，您可以將 PDF 生成無縫整合到現有的身份驗證工作流程中，無論您是在使用簡單的 API 鑰匙還是複雜的 OAuth 系統。 請記得遵循安全最佳實踐並利用 IronPDF 的廣泛渲染選項以取得最佳效果。

常見問題

什麼是HTTP請求標頭，我在建立PDF時為什麼需要它們？

HTTP請求標頭是與web請求一起發送的中繼資料，提供附加資訊如身份驗證詳情、內容型別和使用者代理。使用IronPDF將URL轉換為PDF時，您可以新增自訂標頭來存取受保護的內容、需要身份驗證的API或在安全系統後的網站。這對於渲染需要正確憑證才能存取的受保護網頁非常重要。

如何將自訂HTTP標頭新增到將URL轉換為PDF中？

要在IronPDF中新增自訂HTTP標頭，請建立包含您的標頭鍵值對的Dictionary，然後將其指定給ChromePdfRenderer的RenderingOptions的HttpRequestHeaders屬性。設定標頭後，使用RenderUrlAsPdf方法將URL轉換為PDF。標頭將會在渲染過程中自動包含在發送到伺服器的請求中。

我可以一次新增多個HTTP標頭用於PDF渲染嗎？

可以，IronPDF允許您同時新增多個HTTP標頭。只需在設定HttpRequestHeaders屬性時將所有的標頭鍵值對包含在同一個字典中。這對於複雜的身份驗證情境非常有用，您可能需要在單一請求中發送授權令牌、自訂使用者代理、accept標頭和其他中繼資料。

我可以在URL到PDF轉換中使用哪些型別的身份驗證標頭？

IronPDF支援各種身份驗證標頭，包括Bearer令牌、基本身份驗證、API密鑰和自訂身份驗證方案。您可以通過HttpRequestHeaders屬性新增這些標頭，使得轉換受保護的網頁內容、存取需要特定身份驗證機制的API或與TLS身份驗證系統在後的網站合作成為可能。

有沒有快速的方法可以僅用一行程式碼渲染帶有標頭的URL？

有的，IronPDF提供了一種一行式方法：new IronPdf.ChromePdfRenderer { RenderingOptions = { HttpRequestHeaders = new Dictionary { { "Authorization", "Bearer your_token_here" } } } }.RenderUrlAsPdf("https://your-url.com").SaveAs("output.pdf")。這建立了一個渲染器，設置標頭，渲染URL並在單一語句中保存PDF。

Curtis Chau
Curtis Chau
  立即與工程團隊聊天
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 20,296,129 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想快速獲得證明嗎？ PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。