IronPDFでクッキーを使用する方法

Chaknith related to IronPDFでクッキーを使用する方法
チャクニット・ビン
2023年11月2日
更新済み 2025年1月8日
共有:
This article was translated from English: Does it need improvement?
Translated
View the article in English

ウェブ技術の文脈におけるクッキーは、ウェブサイトがユーザーのコンピュータやデバイスに保存する小さなデータの断片です。クッキーは、ユーザーのログイン状態を維持するセッション管理から、ユーザーの行動データを収集してウェブサイトの改善に役立てるトラッキングや分析まで、さまざまな目的に使用されます。 しかし、クッキーの使用はプライバシーに関する議論を引き起こし、GDPRやCCPAのような規制を生み出しました。また、現代のウェブブラウザはこれらの懸念に対処するため、ユーザーにクッキー管理の制御を提供しています。

IronPDFを始めましょう

今日から無料トライアルでIronPDFをあなたのプロジェクトで使い始めましょう。

最初のステップ:
green arrow pointer



クッキーの適用例

Cookieを適用するメソッドを使用する前に、RequestContextプロパティをRequestContexts.Globalに設定します。 次に、ChromeHttpLoginCredentialsクラスを作成し、それをApplyCookiesメソッドに渡します。 レンダラーは、クッキーを使用してHTMLコンテンツをPDFにレンダリングするために使用できるようになりました。

:path=/static-assets/pdf/content-code-examples/how-to/cookies-apply-cookies.cs
using IronPdf;

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

renderer.RenderingOptions.RequestContext = IronPdf.Rendering.RequestContexts.Global;

ChromeHttpLoginCredentials credentials = new ChromeHttpLoginCredentials() {
    NetworkUsername = "testUser",
    NetworkPassword = "testPassword"
};

string uri = "http://localhost:51169/Invoice";

// Apply cookies
renderer.ApplyCookies(uri, credentials);

RequestContexts Enum: この列挙型は、個々のレンダリング間の関係を確立するために使用されるブラウザリクエストコンテキストを定義します。 それは、クッキーやユーザープリファレンスを管理するために不可欠です。

  • 隔離:以前または将来のレンダリングから分離された新しいリクエストコンテキストを作成します。 現在のレンダリングが以前のレンダリングによって影響を受けないようにすることを推奨します。
  • グローバル: すべてのレンダー間で共有されるグローバルリクエストコンテキストを使用します。 レンダリング間で特定のブラウザー状態を永続化するためにいくつかのケースで役立ちます。
  • 自動: デフォルトではIronPdf.Rendering.RequestContexts.Isolatedに設定されていますが、ユーザーがIronPdf.ChromePdfRenderer.ApplyCookies(System.String, IronPdf.ChromeHttpLoginCredentials)を一度でも呼び出した場合にはIronPdf.Rendering.RequestContexts.Globalに切り替わります。

カスタムクッキーを適用する例

リクエストでカスタムクッキーを使用するには、CustomCookies プロパティを設定する必要があります。 このプロパティは、キーと値の両方を文字列として持つ辞書を受け入れます。

:path=/static-assets/pdf/content-code-examples/how-to/cookies-apply-custom-cookies.cs
using IronPdf;
using System;
using System.Collections.Generic;

// Instantiate ChromePdfRenderer
ChromePdfRenderer renderer = new ChromePdfRenderer();

Dictionary<string, string> customCookies = new Dictionary<string, string>();

// Apply custom cookies
renderer.RenderingOptions.CustomCookies = customCookies;

var uri = new Uri("https://localhost:44362/invoice");
PdfDocument pdf = renderer.RenderUrlAsPdf(uri);
Chaknith related to カスタムクッキーを適用する例
ソフトウェアエンジニア
チャクニットは開発者のシャーロック・ホームズです。彼がソフトウェアエンジニアリングの将来性に気付いたのは、楽しみでコーディングチャレンジをしていたときでした。彼のフォーカスはIronXLとIronBarcodeにありますが、すべての製品でお客様を助けることに誇りを持っています。チャクニットは顧客と直接話すことで得た知識を活用して、製品自体のさらなる改善に貢献しています。彼の逸話的なフィードバックは、単なるJiraチケットを超えて、製品開発、ドキュメントおよびマーケティングをサポートし、顧客の全体的な体験を向上させます。オフィスにいないときは、機械学習やコーディングについて学んだり、ハイキングを楽しんだりしています。