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

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

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

Curtis Chau

Updated: 2026年6月4日

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

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

1Install IronPDF with NuGet Package Manager
PM > Install-Package IronPdf
```
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");

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，透過免費試用

最小工作流程 (5步)

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

什麼是 HTTP 請求標頭？

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

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

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

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

Milan Jovanovic

Microsoft MVP

查看案例研究

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

Brent Matzelle

首席技術官，OPYN

查看案例研究

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

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

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

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

Dim 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")

Imports IronPdf
Imports System.Collections.Generic

Dim 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")

處理多個標頭

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

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

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")

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")

最常用的 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 的標頭支援可無縫地與各種身份驗證系統一起工作。對於基本身份驗證場景：

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

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")

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")

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

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

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

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

使用動態內容的進階標頭

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

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

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

Dim 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")

Imports IronPdf
Imports System.Collections.Generic

Dim 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")

標頭安全的最佳實踐

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

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

有關其他安全考量，請參閱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 = 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

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 = 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

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

結論

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。

What steps should be followed for troubleshooting header-related issues in IronPDF?

For troubleshooting header-related issues in IronPDF, ensure that header values are correct and up to date, use IronPDF's logging features to debug, and verify against server expectations, especially regarding authentication tokens or API keys.

When should I use custom HTTP headers with IronPDF?

Custom HTTP headers should be used with IronPDF when accessing protected resources that require authentication, interacting with APIs expecting specific headers, or when needing to identify the client application making the request.

What are best practices for ensuring security when using HTTP headers in IronPDF?

Best practices include never hardcoding credentials, using secure HTTPS URLs, regularly rotating tokens, validating SSL certificates, and monitoring header usage to ensure the security of sensitive authentication data when rendering PDFs.

Can IronPDF handle rendering for JavaScript-heavy pages with authentication?

Yes, IronPDF can handle JavaScript-heavy pages that require authentication by utilizing headers along with render delays and enabling JavaScript in the rendering options to ensure proper rendering of dynamic content.

How does IronPDF aid in integrating PDF generation with modern web applications?

IronPDF aids integration with modern web applications by supporting custom HTTP headers necessary for OAuth APIs and providing options for executing JavaScript, accommodating the advanced rendering needs of SPAs and PWAs.