diff --git a/html/arabic/net/generate-jpg-and-png-images/_index.md b/html/arabic/net/generate-jpg-and-png-images/_index.md index 432f80cdc..900723c95 100644 --- a/html/arabic/net/generate-jpg-and-png-images/_index.md +++ b/html/arabic/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aspose.HTML for .NET هي مكتبة قوية تتيح للمطورين إنشا تعلم كيفية تمكين مضاد التعرج عند تحويل ملفات DOCX إلى صور PNG أو JPG باستخدام Aspose.HTML. ### [تحويل docx إلى png – إنشاء أرشيف zip في C# – دليل تعليمي](./convert-docx-to-png-create-zip-archive-c-tutorial/) تعلم كيفية تحويل ملفات docx إلى صور PNG وإنشاء أرشيف ZIP باستخدام C# و Aspose.HTML. +### [تحديد عرض وارتفاع الصورة عند تحويل Word إلى PNG – دليل كامل](./set-image-width-height-when-converting-word-to-png-full-guid/) +تعلم كيفية ضبط أبعاد الصورة عند تحويل مستندات Word إلى PNG باستخدام Aspose.HTML للـ .NET. ## خاتمة diff --git a/html/arabic/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/arabic/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..44767aff0 --- /dev/null +++ b/html/arabic/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,272 @@ +--- +category: general +date: 2026-05-22 +description: حدد عرض وارتفاع الصورة أثناء تحويل مستند Word إلى PNG. تعلّم كيفية تصدير + ملف docx كصورة بجودة عالية في دليل خطوة بخطوة. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: ar +og_description: تعيين عرض وارتفاع الصورة أثناء تحويل مستند Word إلى PNG. يوضح هذا + الدرس كيفية تصدير ملف docx كصورة بإعدادات عالية الجودة. +og_title: تحديد عرض وارتفاع الصورة عند تحويل Word إلى PNG – دليل كامل +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: تعيين عرض وارتفاع الصورة عند تحويل Word إلى PNG – دليل كامل +url: /ar/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# تحديد عرض وارتفاع الصورة عند تحويل Word إلى PNG – دليل كامل + +هل تساءلت يومًا كيف **تحدد عرض وارتفاع الصورة** أثناء **تحويل Word إلى PNG**؟ لست وحدك. يواجه العديد من المطورين مشكلة عندما ينتج التصدير الافتراضي صورة ضبابية أو بأبعاد غير صحيحة، ثم يقضون ساعات في البحث عن حل فعّال. + +في هذا الدرس سنستعرض حلًا نظيفًا من البداية إلى النهاية يوضح **كيفية عرض مستندات word** كصور PNG، مما يتيح لك **حفظ docx كـ PNG** مع تحكم دقيق في العرض‑الارتفاع وجودة مضادة للتمويه عالية. بنهاية الدرس ستحصل على مقطع شفرة جاهز للتنفيذ، وفهم قوي لخيارات الـ API، وبعض النصائح الاحترافية لتجنب الأخطاء الشائعة. + +## ما ستتعلمه + +- تحميل ملف `.docx` باستخدام Aspose.Words for .NET. +- **تحديد عرض وارتفاع الصورة** باستخدام `ImageRenderingOptions`. +- **تصدير docx كصورة** (PNG) مع تمكين مضاد التمويه. +- كيفية **تحويل word إلى png** لصفحة واحدة أو للمستند بأكمله. +- نصائح للتعامل مع المستندات الكبيرة، اعتبارات DPI، ومسارات نظام الملفات. + +بدون أدوات خارجية، بدون تعقيدات سطر الأوامر—فقط شفرة C# صافية يمكنك إدراجها في أي مشروع .NET. + +--- + +## المتطلبات المسبقة + +قبل أن نبدأ، تأكد من وجود ما يلي: + +| المتطلب | لماذا هو مهم | +|-------------|----------------| +| **.NET 6.0+** (أو .NET Framework 4.7.2) | يدعم Aspose.Words كلاهما، لكن الإصدارات الأحدث تعطي أداءً أفضل. | +| حزمة **Aspose.Words for .NET** عبر NuGet (`Install-Package Aspose.Words`) | توفر الفئة `Document` ومحرك العرض. | +| **مستند Word** (`.docx`) تريد تحويله إلى PNG. | المصدر الذي ستقوم بتحويله. | +| معرفة أساسية بـ C# – ستفهم عبارات `using` وتهيئة الكائنات. | تجعل منحنى التعلم سلسًا. | + +إذا كنت تفتقد حزمة NuGet، نفّذ هذا في وحدة تحكم مدير الحزم: + +```powershell +Install-Package Aspose.Words +``` + +هذا كل شيء—بمجرد تثبيت الحزمة، أنت جاهز للبدء بالبرمجة. + +--- + +## الخطوة 1: تحميل المستند المصدر + +أول شيء تحتاج إلى القيام به هو توجيه المكتبة إلى ملف Word الذي تريد تحويله. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**لماذا هذا مهم:** فئة `Document` تقرأ حزمة Word بالكامل إلى الذاكرة، مما يمنحك إمكانية الوصول إلى الصفحات، الأنماط، وكل شيء آخر. إذا كان المسار غير صحيح، ستحصل على استثناء `FileNotFoundException`، لذا تأكد من وجود الملف وأن المسار يستخدم الشرط المائل العكسي المهرب (`\\`) أو سلسلة حرفية (`@`). + +> **نصيحة احترافية:** غلف استدعاء التحميل داخل كتلة `try/catch` إذا كنت تتوقع أن الملف قد يكون مفقودًا وقت التشغيل. + +--- + +## الخطوة 2: تكوين خيارات عرض الصورة (تحديد عرض وارتفاع الصورة) + +الآن يأتي جوهر الدرس: **كيفية تحديد عرض وارتفاع الصورة** بحيث لا يكون PNG الناتج مشوهًا أو بكسليًا. فئة `ImageRenderingOptions` تمنحك تحكمًا دقيقًا في الأبعاد، DPI، والتمويه. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**شرح الخصائص الرئيسية:** + +- `Width` و `Height` – الأبعاد بالبكسل التي تريدها بالضبط. بتحديدهما، **تحدد عرض وارتفاع الصورة** مباشرة، متجاوزًا حجم الصفحة الافتراضي. +- `UseAntialiasing` – يفعّل تمويهًا عالي الجودة للنصوص والرسومات المتجهية، وهو أمر حاسم عندما **تحول word إلى png** وتريد حوافًا واضحة. +- `Resolution` – DPI أعلى ينتج تفاصيل أكثر، خاصةً في التخطيطات المعقدة. راقب استهلاك الذاكرة؛ فصورة بدقة 300 DPI قد تكون كبيرة. + +> **لماذا لا تعتمد على الحجم الافتراضي؟** الحجم الافتراضي يستخدم أبعاد الصفحة الفيزيائية (مثلاً A4 عند 96 DPI). هذا غالبًا ما ينتج صورة بحجم 794 × 1123 بكسل—مناسب لبعض الحالات لكن ليس عندما تحتاج إلى صورة مصغرة لواجهة مستخدم أو معاينة بحجم ثابت. + +--- + +## الخطوة 3: العرض والحفظ كـ PNG (تصدير Docx كصورة) + +بعد تحميل المستند وتكوين الخيارات، يمكنك أخيرًا **تصدير docx كصورة**. طريقة `RenderToImage` تقوم بالعمل الشاق. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +إذا أردت عرض **المستند بالكامل** (جميع الصفحات) في ملفات PNG منفصلة، استخدم حلقة على مجموعة الصفحات: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**ما الذي يحدث في الخلفية؟** يقوم العارض بتحويل كل صفحة إلى نقطية باستخدام الأبعاد التي زودتها، يطبق مضاد التمويه، ويكتب تدفق بايتات PNG إلى القرص. لأن PNG غير مضغوط، تحتفظ بالدقة الكاملة لتخطيط Word الأصلي. + +**الناتج المتوقع:** ملف PNG واضح بدقة 1024 × 768 بكسل (أو أي حجم حددته). افتحه بأي عارض صور وسترى محتوى Word معروضًا تمامًا كما هو في المستند الأصلي، لكن الآن كصورة نقطية. + +--- + +## نصائح متقدمة وتنوعات + +### 1. الحفاظ على الخلفيات الشفافة + +إذا كان مستند Word يحتوي على أشكال بخلفيات شفافة وتريد الحفاظ على تلك الشفافية، اضبط `BackgroundColor` إلى `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. عرض نطاق محدد فقط + +أحيانًا تحتاج إلى فقرة أو جدول فقط، وليس الصفحة كاملة. استخدم `DocumentVisitor` لاستخراج العقدة وعرضها بشكل منفصل. هذا سيناريو أكثر تقدماً، لكنه يوضح **كيفية عرض word** بمستوى تفصيلي. + +### 3. تعديل DPI ديناميكيًا + +إذا احتجت DPI مختلف لكل صفحة (مثلاً دقة عالية لصفحة الغلاف)، عدّل `Resolution` داخل الحلقة: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. المعالجة الدفعية + +عند تحويل العشرات من المستندات، احزم التدفق الكامل في طريقة وأعد استخدام نفس كائن `ImageRenderingOptions`. إعادة استخدام كائن الخيارات يقلل من استهلاك الذاكرة. + +--- + +## الأخطاء الشائعة وكيفية تجنبها + +| العَرَض | السبب المحتمل | الحل | +|---------|--------------|-----| +| PNG ضبابي رغم DPI عالي | `UseAntialiasing` مُعطَّل | اضبط `UseAntialiasing = true`. | +| حجم الناتج لا يطابق `Width`/`Height` | DPI غير مأخوذ في الاعتبار | اضرب الحجم المطلوب في `Resolution / 96` أو عدّل `Resolution`. | +| استثناء نفاد الذاكرة على مستندات كبيرة | عرض المستند بالكامل عند 300 DPI | اعرض صفحة واحدة في كل مرة، حرّر كل صورة بعد حفظها. | +| PNG يظهر خلفية بيضاء على صور شفافة | `BackgroundColor` غير مضبوط | اضبط `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## مثال كامل يعمل + +فيما يلي برنامج مستقل يمكنك نسخه ولصقه في تطبيق Console. يوضح **تحويل word إلى png**، **حفظ docx كـ PNG**، وطبعًا **تحديد عرض وارتفاع الصورة**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**تشغيله:** ابنِ المشروع، ضع ملف `input.docx` صالحًا في المسار الذي حددته، ثم نفّذ. يجب أن يظهر ملف `output.png` بدقة **1024 × 768** بكسل، مع حواف ناعمة. + +## دروس ذات صلة + +- [How to Enable Antialiasing When Converting DOCX to PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – create zip archive c# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [How to Use Aspose to Render HTML to PNG – Step‑by‑Step Guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/arabic/net/html-extensions-and-conversions/_index.md b/html/arabic/net/html-extensions-and-conversions/_index.md index 980eb7013..1d4dac616 100644 --- a/html/arabic/net/html-extensions-and-conversions/_index.md +++ b/html/arabic/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,10 @@ url: /ar/net/html-extensions-and-conversions/ ## دروس حول امتدادات HTML وتحويلاتها ### [تحويل HTML إلى PDF في .NET باستخدام Aspose.HTML](./convert-html-to-pdf/) قم بتحويل HTML إلى PDF بسهولة باستخدام Aspose.HTML for .NET. اتبع دليلنا خطوة بخطوة واكتشف قوة تحويل HTML إلى PDF. +### [تحويل HTML إلى PDF باستخدام C# – دليل كامل](./convert-html-to-pdf-with-c-complete-guide/) +دليل شامل خطوة بخطوة لتحويل ملفات HTML إلى PDF باستخدام C# ومكتبة Aspose.HTML. +### [تحويل HTML إلى PDF في C# – دليل كامل خطوة بخطوة](./render-html-as-pdf-in-c-full-step-by-step-guide/) +دليل شامل يوضح كيفية تحويل مستندات HTML إلى PDF باستخدام C# ومكتبة Aspose.HTML خطوة بخطوة. ### [إنشاء PDF من HTML – دليل خطوة بخطوة بلغة C#](./create-pdf-from-html-c-step-by-step-guide/) دليل خطوة بخطوة لإنشاء ملف PDF من HTML باستخدام C# ومكتبة Aspose.HTML. ### [إنشاء مستند HTML بنص منسق وتصديره إلى PDF – دليل كامل](./create-html-document-with-styled-text-and-export-to-pdf-full/) @@ -73,6 +77,8 @@ url: /ar/net/html-extensions-and-conversions/ تعلم كيفية حفظ مستند HTML كملف ZIP باستخدام Aspose.HTML في C# خطوة بخطوة. ### [حفظ HTML إلى ZIP في C# – مثال كامل في الذاكرة](./save-html-to-zip-in-c-complete-in-memory-example/) تعلم كيفية حفظ مستند HTML كملف ZIP في الذاكرة باستخدام C# ومكتبة Aspose.HTML. +### [حفظ HTML كملف ZIP – دليل كامل لـ Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +دليل شامل يوضح كيفية حفظ مستند HTML كملف ZIP باستخدام Aspose.HTML خطوة بخطوة. ## خاتمة diff --git a/html/arabic/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/arabic/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..d9bf44696 --- /dev/null +++ b/html/arabic/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,260 @@ +--- +category: general +date: 2026-05-22 +description: تحويل HTML إلى PDF في C# باستخدام Aspose.HTML. تعلم كيفية تحويل HTML + إلى PDF في C# مع كود خطوة بخطوة، الخيارات، وإرشادات لينكس. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: ar +og_description: تحويل HTML إلى PDF في C# باستخدام Aspose.HTML. يوضح هذا الدليل كيفية + تحويل HTML إلى PDF في C# باستخدام خيارات واضحة وتلميحات صديقة لنظام Linux. +og_title: تحويل HTML إلى PDF باستخدام C# – دليل كامل +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: تحويل HTML إلى PDF باستخدام C# – دليل كامل +url: /ar/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# تحويل HTML إلى PDF باستخدام C# – دليل شامل + +إذا كنت بحاجة إلى **تحويل HTML إلى PDF** بسرعة، فإن Aspose.HTML for .NET يجعل العملية سهلة للغاية. في هذا الدرس سنجيب أيضًا على **كيفية تحويل HTML إلى PDF في C#** مع التحكم الكامل في خيارات العرض، حتى لا تظل في حيرة. + +تخيل أن لديك قالب بريد إلكتروني تسويقي، أو صفحة إيصال، أو تقرير معقد مبني باستخدام CSS حديث، وتحتاج إلى تقديمه كملف PDF للعميل أو للطابعة. القيام بذلك يدويًا أمر مزعج، لكن بضع أسطر من كود C# يمكنها أتمتة العملية بالكامل. بحلول نهاية هذا الدليل ستحصل على حل مستقل وجاهز للإنتاج يعمل على Windows *و* Linux. + +## ما ستحتاجه + +قبل أن نبدأ، تأكد من توفر ما يلي: + +- **.NET 6.0 أو أحدث** – Aspose.HTML يستهدف .NET Standard 2.0+، لذا أي SDK حديث يعمل. +- حزمة NuGet **Aspose.HTML for .NET** (`Aspose.Html`) – ستحتاج إلى ترخيص صالح للإنتاج، لكن النسخة التجريبية المجانية تكفي للاختبار. +- **ملف HTML بسيط** تريد تحويله إلى PDF (سنسميه `input.html`). +- بيئة التطوير المفضلة لديك (Visual Studio، Rider، أو VS Code) – لا تحتاج إلى أدوات خاصة. + +هذا كل ما تحتاجه. لا محولات PDF خارجية، ولا حركات سطر أوامر معقدة. مجرد C# نقي. + +![مخطط يوضح سير عمل تحويل HTML إلى PDF باستخدام Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## تحويل HTML إلى PDF – التنفيذ الكامل + +فيما يلي البرنامج الكامل الجاهز للتنفيذ. انسخه والصقه في تطبيق Console جديد، استعد حزم NuGet، واضغط **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### لماذا يعمل هذا + +- **`Document`** هو نقطة الدخول في Aspose.HTML؛ فهو يحلل HTML، يفسر CSS، ويبني DOM جاهزًا للعرض. +- **`PdfRenderingOptions`** يتيح لك تعديل المخرجات. علم `UseHinting` هو السر للحصول على نص واضح في حاويات Linux بدون واجهة رسومية حيث قد يبدو المرسّخ الافتراضي غير واضح. +- **`Save`** يقوم بالعمل الشاق: يرسم الـ DOM على صفحات PDF، يحترم فواصل الصفحات، ويضمّن الخطوط تلقائيًا. + +عند تشغيل البرنامج سيتولد ملف `output.pdf` بجوار ملف المصدر. افتحه بأي عارض PDF وسترى تطابقًا بصريًا دقيقًا مع الـ HTML الأصلي. + +## كيفية تحويل HTML إلى PDF في C# – خطوة بخطوة + +سنقسم العملية إلى أجزاء صغيرة، موضحين **كيفية تحويل HTML إلى PDF في C#** مع تغطية الأخطاء الشائعة. + +### الخطوة 1 – تثبيت حزمة NuGet الخاصة بـ Aspose.HTML + +افتح الطرفية في مجلد المشروع ونفّذ: + +```bash +dotnet add package Aspose.Html +``` + +إذا كنت تفضّل واجهة Visual Studio، انقر بزر الماوس الأيمن على المشروع → **Manage NuGet Packages** → ابحث عن **Aspose.Html** وثبّت أحدث نسخة مستقرة. + +> **نصيحة احترافية:** بعد التثبيت، أضف ملف الترخيص (`Aspose.Total.lic`) إلى جذر مشروعك لتجنب علامات مائية التقييم. + +### الخطوة 2 – تحميل ملف HTML بشكل صحيح + +يمكن لـ Aspose.HTML استيعاب: + +- مسارات ملفات محلية (`new Document("file.html")`) +- عناوين URL (`new Document("https://example.com")`) +- سلاسل HTML خام (`new Document("…", new HtmlLoadOptions())`) + +عند التحميل من نظام الملفات، تأكد أن المسار مطلق أو أن دليل العمل مضبوط بشكل صحيح، وإلا ستحصل على استثناء `FileNotFoundException`. في Linux، استخدم الشرطات المائلة (`/`) أو `Path.Combine`. + +### الخطوة 3 – اختيار خيارات العرض المناسبة + +إلى جانب `UseHinting`، قد ترغب في تعديل: + +| الخيار | ما يفعله | متى يستخدم | +|--------|----------|------------| +| `PageSize` | يحدد أبعاد صفحة PDF (A4، Letter، مخصص) | لتطابق حجم الورق المستهدف | +| `Landscape` | يدير الصفحة إلى الوضع الأفقي | للجداول أو المخططات العريضة | +| `RasterizeVectorGraphics` | يحول الرسومات المتجهة إلى صور نقطية | عندما لا يستطيع مستلم PDF التعامل مع SVG | +| `CompressionLevel` | يتحكم في ضغط الصور (0‑9) | لتقليل حجم الملف للمرفقات البريدية | + +يمكنك ربط هذه الخصائص بسلاسة: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### الخطوة 4 – حفظ ملف PDF + +طريقة التحميل `Save` التي تراها في المثال الكامل تكتب مباشرةً إلى مسار ملف. يمكنك أيضًا بث الـ PDF إلى الذاكرة: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +هذا مفيد عندما تحتاج لإرجاع الـ PDF كتحميل من واجهة برمجة تطبيقات ويب. + +### الخطوة 5 – التحقق من النتيجة + +فحص سريع هو مقارنة عدد صفحات PDF مع عدد أقسام HTML المتوقعة. يمكنك قراءتها مرة أخرى باستخدام Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +إذا كان العدد غير متطابق، راجع قواعد CSS `page-break` أو عدّل `PdfRenderingOptions` وفقًا لذلك. + +## الحالات الخاصة والأخطاء الشائعة + +| الحالة | ما يجب مراقبته | الحل | +|--------|----------------|------| +| **الموارد الخارجية (صور، خطوط) مفقودة** | عناوين URL النسبية تُحلّ بالنسبة لمجلد ملف HTML. | استخدم `HtmlLoadOptions.BaseUri` لتحديد الجذر الصحيح. | +| **بيئة Linux بدون واجهة** | قد يكون عرض النص الافتراضي غير واضح. | عيّن `UseHinting = true` (كما هو موضح) وتأكد من تثبيت `libgdiplus` إذا رجعت إلى System.Drawing. | +| **HTML كبير (> 10 MB)** | استهلاك الذاكرة يرتفع أثناء العرض. | اعرض الصفحة صفحةً باستخدام `PdfRenderer` مع `PdfRenderingOptions` وتخلّص من كل صفحة بعد حفظها. | +| **صفحات تعتمد على JavaScript** | Aspose.HTML لا ينفّذ JS؛ يبقى المحتوى الديناميكي ثابتًا. | عالج الـ HTML مسبقًا على الخادم (مثلاً باستخدام Puppeteer) قبل تمريره إلى Aspose.HTML. | +| **حروف Unicode تظهر كمربعات** | نقص الخطوط في بيئة التشغيل. | ضمّن خطوطًا مخصصة عبر `FontSettings` أو تأكد من تثبيت الخطوط المطلوبة على نظام التشغيل. | + +## ملخص المثال الكامل العامل + +إليك البرنامج بالكامل مرة أخرى، بدون تعليقات لمن يفضّل النظرة المختصرة: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +شغّله، افتح `output.pdf`، وسترى نسخة مطابقة تمامًا للـ `input.html`. هذه هي جوهر **convert html to pdf** باستخدام Aspose.HTML. + +## الخلاصة + +استعرضنا كل ما تحتاجه **لتحويل HTML إلى PDF** باستخدام C#: تثبيت Aspose.HTML، تحميل HTML، تعديل خيارات العرض (بما في ذلك علم `UseHinting` الحاسم)، وحفظ ملف PDF النهائي. الآن تعرف **كيفية تحويل HTML إلى PDF في C#** لكل من بيئات Windows وLinux، وتعلمت كيفية التعامل مع الحالات الخاصة مثل الموارد المفقودة والملفات الكبيرة. + +ما الخطوة التالية؟ جرّب إضافة: + +- **رؤوس/تذييلات** باستخدام `PdfPageTemplate` للعلامة التجارية. +- **حماية بكلمة مرور** عبر `PdfSaveOptions`. +- **تحويل دفعي** عبر حلقة تمر على مجلد من + + +## دروس ذات صلة + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Convert EPUB to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Convert SVG to PDF in .NET with Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/arabic/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/arabic/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..f64696401 --- /dev/null +++ b/html/arabic/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,308 @@ +--- +category: general +date: 2026-05-22 +description: تحويل HTML إلى PDF باستخدام C# مع مثال مختصر. تعلّم كيفية تحويل HTML + إلى PDF باستخدام C# بسرعة وموثوقية. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: ar +og_description: تحويل HTML إلى PDF في C# مع مثال واضح وقابل للتنفيذ. يوضح لك هذا الدليل + كيفية تحويل HTML إلى PDF باستخدام C# وإنشاء PDF من ملف HTML. +og_title: تحويل HTML إلى PDF في C# – دليل برمجي كامل +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: تحويل HTML إلى PDF في C# – دليل كامل خطوة بخطوة +url: /ar/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# تحويل HTML إلى PDF في C# – دليل خطوة بخطوة كامل + +هل احتجت يوماً إلى **render HTML as PDF** لكنك لم تكن متأكدًا أي مكتبة تختار لمشروع .NET؟ لست وحدك. في العديد من تطبيقات الأعمال ستجد نفسك بحاجة إلى **convert HTML to PDF C#** للفواتير، التقارير، أو الكتيبات التسويقية—بشكل أساسي كلما أردت نسخة قابلة للطباعة من صفحة ويب. + +الأمر بسيط: لا تحتاج إلى إعادة اختراع العجلة. ببضع أسطر من الشيفرة يمكنك أخذ ملف `input.html`، تمريره إلى محرك عرض موثوق، والحصول على ملف `output.pdf` واضح. في هذا الدرس سنستعرض العملية بالكامل، من إضافة حزمة NuGet المناسبة إلى التعامل مع الحالات الخاصة مثل CSS الخارجي. في النهاية ستكون قادرًا على **generate PDF from HTML file** في دقائق قليلة. + +## ما ستتعلمه + +- كيفية إعداد تطبيق وحدة تحكم .NET يقوم **creates PDF from HTML C#**. +- الاتصالات الدقيقة للـ API التي تحتاجها **save HTML document as PDF**. +- لماذا بعض خيارات العرض (مثل hinting) مهمة لجودة النص. +- نصائح لاستكشاف الأخطاء الشائعة مثل الخطوط المفقودة أو مسارات الصور النسبية. + +**المتطلبات المسبقة** – يجب أن يكون لديك .NET 6+ أو .NET Framework 4.7 مثبتًا، إلمام أساسي بـ C#، وبيئة تطوير (Visual Studio 2022، Rider، أو VS Code). لا حاجة لخبرة سابقة في PDF. + +--- + +## تحويل HTML إلى PDF – إعداد المشروع + +قبل أن نغوص في الشيفرة، دعنا نتأكد من جاهزية بيئة التطوير. المكتبة التي سنستخدمها هي **Select.Pdf** (مجانية للاستخدام غير التجاري) لأنها توفر API بسيط ودقة عرض قوية. + +### تثبيت مكتبة عرض PDF (convert html to pdf c#) + +افتح طرفية في مجلد مشروعك وشغّل: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*نصيحة احترافية:* إذا كنت تستخدم Visual Studio، يمكنك أيضًا إضافة الحزمة عبر واجهة NuGet Package Manager. قد يكون رقم الإصدار أحدث—فقط احصل على أحدث إصدار ثابت. + +### إنشاء هيكل تطبيق وحدة تحكم + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +هذا كل القالب الأساسي الذي تحتاجه. الجزء الثقيل يحدث داخل `Main`. + +--- + +## تحميل مستند HTML (generate pdf from html file) + +الخطوة الفعلية الأولى هي توجيه العارض إلى ملف HTML على القرص. توفر Select.Pdf طريقتين مريحتين: تمرير سلسلة HTML خام أو مسار ملف. استخدام ملف يبقي الأمور منظمة، خاصة عندما يكون لديك CSS أو صور مرتبطة. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +هنا نتحقق أيضًا من عدم وجود الملف—وهو ما يسبب مشاكل للمبتدئين عندما ينسون نسخ ملف HTML إلى مجلد الإخراج. + +--- + +## ضبط خيارات العرض (create pdf from html c#) + +تأتي Select.Pdf مع كائن `PdfDocumentOptions` غني. للحصول على نص واضح نفعّل الـ hinting، الذي ينعم الحروف بتكلفة بسيطة على الأداء. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +يمكنك تعديل حجم الصفحة، الهوامش، أو حتى تضمين خط مخصص هنا. الفكرة الأساسية هي أن **render html as pdf** ليست مجرد سطر واحد؛ لديك التحكم في مظهر وشعور المستند النهائي. + +--- + +## حفظ مستند HTML كـ PDF (render html as pdf) + +الآن يحدث السحر. نمرر للمحول مسار ملف HTML الخاص بنا ونطلب منه كتابة ملف PDF إلى القرص. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +طريقة `ConvertUrl` تحل تلقائيًا عناوين URL النسبية (الصور، CSS) بناءً على موقع ملف HTML، وهذا ما يجعل هذا النهج قويًا لمعظم السيناريوهات الواقعية. + +### النتيجة المتوقعة + +بعد تشغيل البرنامج يجب أن ترى ملف `output.pdf` في نفس المجلد. افتحه—ستلاحظ: + +- النص معروض مع مضاد التعرج الواضح (بفضل الـ hinting). +- الأنماط من CSS المرتبط مطبقة بشكل صحيح. +- الصور معروضة بالحجم الدقيق المحدد في HTML المصدر. + +إذا كان هناك أي شيء غير صحيح، تحقق مرة أخرى من أن ملفات CSS والصور موجودة بجانب `input.html` أو استخدم عناوين URL مطلقة. + +--- + +## معالجة الحالات الخاصة الشائعة + +### 1. الموارد الخارجية محجوبة بواسطة جدران الحماية + +إذا كان HTML الخاص بك يشير إلى خطوط مستضافة على CDN لا يمكن لخادمك الوصول إليها، قد يلجأ PDF إلى خط عام. لتجنب ذلك، إما قم بتحميل ملفات الخط محليًا أو تضمينها باستخدام `@font-face` مع مسار نسبي. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. ملفات HTML ضخمة جدًا + +عند تحويل مستندات ضخمة، قد تواجه حدود الذاكرة. تسمح لك Select.Pdf ببث التحويل: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +البث يحافظ على خفة العملية لكنه يتطلب تزويد HTML كسلسلة، ويمكنك قراءتها على دفعات إذا لزم الأمر. + +### 3. رؤوس أو تذييلات مخصصة + +إذا كنت تحتاج إلى رقم صفحة أو شعار الشركة على كل صفحة، اضبط خصائص `Header` و `Footer` على `converter.Options` قبل استدعاء `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## مثال كامل يعمل (جميع الخطوات مجمعة) + +فيما يلي البرنامج الكامل جاهز للنسخ واللصق. استبدل `YOUR_DIRECTORY` بالمسار المطلق حيث يوجد ملف HTML الخاص بك. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**شغّله:** `dotnet run` من دليل المشروع. إذا تم الإعداد بشكل صحيح سترى رسالة النجاح وملف `output.pdf` لامع. + +--- + +## ملخص بصري + +![Render HTML as PDF example](render-html-as-pdf.png){alt="مثال على تحويل html إلى pdf"} + +تظهر لقطة الشاشة مخرجات وحدة التحكم وملف PDF الناتج المفتوح في عارض. لاحظ العناوين الواضحة والصور المحمَّلة بشكل صحيح—بالضبط ما تتوقعه عند **render html as pdf**. + +--- + +## الخلاصة + +لقد تعلمت الآن كيفية **render HTML as PDF** في تطبيق C#، من تثبيت المكتبة إلى ضبط خيارات العرض بدقة. المثال الكامل يوضح طريقة موثوقة لـ **convert HTML to PDF C#**, **generate PDF from HTML file**, و **save HTML document as PDF** باستخدام عدد قليل من الأسطر. + +ما التالي؟ جرّب التجربة مع: + +- إضافة خطوط مخصصة لتناسق العلامة التجارية. +- إنشاء ملفات PDF من سلاسل HTML ديناميكية (مثل قوالب Razor). +- دمج ملفات PDF متعددة في تقرير واحد باستخدام `PdfDocument.AddPage`. + +كل من هذه الإضافات يبني على المفاهيم الأساسية التي تم تغطيتها هنا، لذا ستكون جاهزًا لمواجهة سيناريوهات أكثر تقدمًا دون منحنى تعلم حاد. + +هل لديك أسئلة أو واجهت مشكلة؟ اترك تعليقًا أدناه، ولنحلها معًا. برمجة سعيدة! + +## دروس ذات صلة + +- [تحويل HTML إلى PDF في .NET باستخدام Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [إنشاء مستند HTML بنص منسق وتصديره إلى PDF – دليل كامل](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [تحويل HTML إلى PDF باستخدام Aspose.HTML – دليل شامل للتلاعب](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/arabic/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/arabic/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..bed267477 --- /dev/null +++ b/html/arabic/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-05-22 +description: احفظ ملفات HTML كملف ZIP بسرعة باستخدام Aspose.HTML. تعلم كيفية ضغط ملفات + HTML، وتحويل HTML إلى ZIP، وتصدير HTML إلى ملف ZIP مع الكود الكامل. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: ar +og_description: احفظ HTML كملف ZIP باستخدام Aspose.HTML. يوضح هذا الدليل كيفية تحويل + HTML إلى ZIP، وتصدير HTML إلى ملف ZIP، وضغط ملفات HTML برمجياً. +og_title: حفظ HTML كملف ZIP – دليل Aspose.HTML الكامل +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: حفظ HTML كملف ZIP – الدليل الكامل لـ Aspose.HTML +url: /ar/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# حفظ HTML كملف ZIP – دليل كامل لـ Aspose.HTML + +هل تساءلت يومًا كيف **تحفظ HTML كملف ZIP** دون الحاجة إلى أداة أرشفة منفصلة؟ لست وحدك. يحتاج العديد من المطورين إلى تجميع صفحة HTML مع صورها وملفات CSS والسكريبتات لتسهيل توزيعها، والقيام بذلك يدويًا يصبح سريعًا مصدر إزعاج. + +في هذا البرنامج التعليمي سنستعرض حلًا نظيفًا من البداية إلى النهاية **يحوّل HTML إلى ZIP** باستخدام Aspose.HTML for .NET. بنهاية الشرح ستعرف بالضبط كيف **تصدّر HTML إلى ملف ZIP**، وسترى أيضًا تنويعات لـ **كيفية ضغط ملفات HTML** في سيناريوهات مختلفة. + +> *نصيحة محترف:* النهج المعروض يعمل سواءً كنت تُعبئ صفحة واحدة أو مجلد موقع كامل. + +## ما ستحتاجه + +قبل أن نبدأ، تأكد من وجود التالي: + +- .NET 6 (أو أي نسخة حديثة من .NET) مثبتة. +- حزمة NuGet الخاصة بـ Aspose.HTML for .NET (`Aspose.Html`) مُشار إليها في مشروعك. +- ملف `input.html` بسيط موجود في مجلد يمكنك التحكم فيه. +- بعض المعرفة بـ C#—لا شيء معقد، فقط الأساسيات. + +هذا كل ما تحتاجه. لا أدوات ضغط خارجية، لا تمارين سطر أوامر. لنبدأ. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*نص بديل للصورة: مخطط عملية حفظ HTML كملف ZIP* + +## الخطوة 1: تحميل مستند HTML المصدر + +أول شيء علينا هو إخبار Aspose.HTML بمكان المصدر. تقوم فئة `HTMLDocument` بقراءة الملف وبناء DOM في الذاكرة، جاهزًا للعرض. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +لماذا هذا مهم: تحميل المستند يمنح المكتبة سيطرة كاملة على حل الموارد (الصور، CSS، الخطوط). إذا كان HTML يشير إلى مسارات نسبية، فإن Aspose.HTML يحلها تلقائيًا بالنسبة لمجلد الملف. + +## الخطوة 2: (اختياري) إنشاء معالج موارد مخصص + +إذا كنت بحاجة إلى فحص أو تعديل كل مورد—مثلاً تريد ضغط الصور قبل أن تدخل الأرشيف—يمكنك توصيل `ResourceHandler`. هذه الخطوة اختيارية، لكنها الأكثر مرونة لـ **تحويل HTML إلى أرشيف ZIP** بمنطق مخصص. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*ماذا لو لم تحتاج إلى أي معالجة خاصة؟* فقط تخطَ هذه الفئة واستخدم المعالج الافتراضي—ستكتب Aspose.HTML الموارد مباشرةً إلى ZIP. + +## الخطوة 3: تكوين خيارات الحفظ لاستخدام المعالج + +كائن `HtmlSaveOptions` يخبر المُظهر ماذا يفعل بالموارد. من خلال تعيين `MyResourceHandler`، نحصل على سيطرة كاملة على الناتج. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +لاحظ كيف أن اسم الخاصية `ResourceHandler` يشير مباشرةً إلى قدرة **عرض HTML إلى ZIP**. هنا يحدث السحر: كل مورد مرتبط يُبث إلى الأرشيف بدلاً من كتابته على القرص. + +## الخطوة 4: حفظ المستند المعروض داخل أرشيف ZIP + +الآن نُصدّر **HTML إلى ملف ZIP**. طريقة `Save` تقبل أي `Stream`، لذا يمكننا توجيهها إلى `FileStream` يُنشئ `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +هذه هي سير العمل بالكامل. عندما ينتهي الكود، يحتوي `result.zip` على: + +- `input.html` (العلامة الأصلية) +- جميع الصور، ملفات CSS، والخطوط المشار إليها +- أي موارد تم تحويلها إذا عدلتها في `MyResourceHandler` + +## كيفية ضغط ملفات HTML بدون Aspose.HTML (بديل سريع) + +أحيانًا تحتاج فقط إلى طريقة **كيفية ضغط ملفات HTML** بسيطة، ربما لأنك تستخدم محلل HTML مختلف. في هذه الحالة يمكنك استخدام `System.IO.Compression` المدمج في .NET: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +هذه الطريقة بسيطة لكنها تفتقر إلى خطوة العرض؛ فهي فقط تحزم ما هو موجود على القرص. إذا كان HTML يشير إلى عناوين URL خارجية، فإن تلك الموارد لن تُضمّن. لهذا يُفضَّل مسار Aspose.HTML عندما تحتاج إلى حل موثوق لـ **عرض HTML إلى ZIP**. + +## الحالات الخاصة والمشكلات الشائعة + +| الحالة | ما يجب مراقبته | الإصلاح الموصى به | +|-----------|-------------------|-----------------| +| **صور كبيرة** | ارتفاع استهلاك الذاكرة لأن كل صورة تُحمَّل في `MemoryStream`. | بث مباشرةً إلى الـ zip باستخدام معالج مخصص ينسخ تدفق المصدر بدلاً من التخزين المؤقت الكامل. | +| **عناوين URL خارجية** | الموارد المستضافة على الإنترنت لا تُحمَّل تلقائيًا. | ضبط `HtmlLoadOptions` مع `BaseUrl` يشير إلى جذر الموقع، أو تحميل الموارد يدويًا قبل الحفظ. | +| **تصادم أسماء الملفات** | ملفي CSS يحملان نفس الاسم في مجلدات فرعية مختلفة قد يكتبان فوق بعضهما. | التأكد من أن `ResourceHandler` يحافظ على المسار النسبي الكامل عند الكتابة إلى الـ zip. | +| **أخطاء الأذونات** | محاولة الكتابة إلى مجلد للقراءة فقط تُسبب `UnauthorizedAccessException`. | تشغيل العملية بصلاحيات مناسبة أو اختيار دليل إخراج قابل للكتابة. | + +معالجة هذه السيناريوهات تجعل روتين **تحويل HTML إلى أرشيف ZIP** قويًا للاستخدام في بيئات الإنتاج. + +## مثال كامل يعمل (كل الأجزاء معًا) + +فيما يلي البرنامج الكامل الجاهز للتنفيذ. الصقه في تطبيق Console جديد، حدّث المسارات، واضغط **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**الناتج المتوقع:** يطبع الكونسول رسالة نجاح، ويحتوي `result.zip` على `input.html` بالإضافة إلى كل الأصول التابعة. افتح الـ ZIP، انقر مزدوجًا على `input.html`، وسترى الصفحة تُعرض تمامًا كما في المتصفح—بدون صور مفقودة، بدون CSS مكسور. + +## ملخص – لماذا هذا النهج رائع + +- **عرض بخطوة واحدة:** لا تحتاج إلى نسخ كل مورد يدويًا؛ Aspose.HTML يقوم بذلك نيابةً عنك. +- **خط أنابيب قابل للتخصيص:** يمنحك `ResourceHandler` سيطرة كاملة على طريقة تخزين كل ملف، مما يتيح الضغط، التشفير، أو التحويل أثناء النقل. +- **متعدد المنصات:** يعمل على Windows، Linux، و macOS طالما لديك بيئة تشغيل .NET. +- **بدون أدوات خارجية:** عملية **حفظ HTML كملف ZIP** بالكامل داخل قاعدة شفرة C# الخاصة بك. + +## ما التالي؟ + +الآن بعد أن أتقنت **حفظ HTML كملف ZIP**، فكر في استكشاف المواضيع ذات الصلة: + +- **تصدير HTML إلى PDF** – مثالي للتقارير القابلة للطباعة (معرفة `export html to zip file` تساعد عندما تحتاج كلا الصيغتين). +- **بث ZIP مباشرةً إلى استجابة HTTP** – مفيد لواجهات API الويب التي تسمح للمستخدمين بتحميل موقع مُعبأ في الوقت الحقيقي. +- **تشفير أرشيفات ZIP** – إضافة طبقة كلمة مرور إذا كنت تتعامل مع وثائق سرية. + +لا تتردد في التجربة: استبدل `MyResourceHandler` بضغط يقلص حجم الصور، أو أضف ملف بيان يدرج جميع الموارد المعبأة. السماء هي الحد عندما تتحكم في خط أنابيب العرض. + +--- + +*برمجة سعيدة! إذا واجهت أي صعوبات أو كان لديك أفكار للتحسين، اترك تعليقًا أدناه. سنحلها معًا.* + +## دروس ذات صلة + +- [How to Zip HTML in C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Save HTML as ZIP – Complete C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Save HTML to ZIP in C# – Complete In‑Memory Example](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/chinese/net/generate-jpg-and-png-images/_index.md b/html/chinese/net/generate-jpg-and-png-images/_index.md index 3a7bc53dc..6581e61cc 100644 --- a/html/chinese/net/generate-jpg-and-png-images/_index.md +++ b/html/chinese/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aspose.HTML for .NET 提供了一种将 HTML 转换为图像的简单方法。 了解如何在使用 Aspose.HTML for .NET 将 DOCX 文档转换为 PNG 或 JPG 图像时启用抗锯齿，以提升图像质量。 ### [使用 C# 将 docx 转换为 png 并创建 zip 存档教程](./convert-docx-to-png-create-zip-archive-c-tutorial/) 学习如何使用 C# 将 DOCX 文档转换为 PNG 图像并打包为 ZIP 文件的完整步骤。 +### [将 Word 转换为 PNG 时设置图像宽高 – 完整指南](./set-image-width-height-when-converting-word-to-png-full-guid/) +本指南详细说明如何在使用 Aspose.HTML for .NET 将 Word 文档转换为 PNG 时自定义图像的宽度和高度。 ## 结论 diff --git a/html/chinese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/chinese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..ac8d7c4df --- /dev/null +++ b/html/chinese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,270 @@ +--- +category: general +date: 2026-05-22 +description: 在将 Word 文档转换为 PNG 时设置图像的宽度和高度。学习如何在一步步教程中将 docx 导出为高质量渲染的图像。 +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: zh +og_description: 在将 Word 文档转换为 PNG 时设置图像的宽度和高度。本教程展示了如何使用高质量设置将 docx 导出为图像。 +og_title: 将 Word 转换为 PNG 时设置图像宽高 – 完整指南 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: 在将 Word 转换为 PNG 时设置图像宽度和高度 – 完整指南 +url: /zh/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 在将 Word 转换为 PNG 时设置图像宽高 – 完整指南 + +是否曾经想过在 **将 Word 转换为 PNG** 时 **设置图像宽高**？你并不是唯一遇到这个问题的人。许多开发者在默认导出得到模糊的图片或尺寸不对时会卡住，然后花费数小时寻找真正有效的解决方案。 + +在本教程中，我们将一步步演示一个完整、端到端的方案，展示 **如何渲染 word** 文档为 PNG 图像，让你能够 **将 docx 保存为 PNG**，并精确控制宽高以及实现高质量的抗锯齿。完成后，你将拥有可直接运行的代码片段、对 API 选项的深入理解，以及避免常见陷阱的专业技巧。 + +## 你将学到 + +- 使用 Aspose.Words for .NET 加载 `.docx` 文件。 +- 使用 `ImageRenderingOptions` **设置图像宽高**。 +- **将 docx 导出为图像**（PNG）并启用抗锯齿。 +- 如何 **将 word 转换为 png**，无论是单页还是整篇文档。 +- 处理大文档、DPI 考量以及文件系统路径的技巧。 + +无需外部工具，无需繁琐的命令行操作——只需纯 C# 代码，随时可以放入任何 .NET 项目中。 + +--- + +## 前置条件 + +在开始之前，请确保你具备以下条件： + +| Requirement | Why it matters | +|-------------|----------------| +| **.NET 6.0+**（或 .NET Framework 4.7.2） | Aspose.Words 同时支持两者，但更新的运行时性能更佳。 | +| **Aspose.Words for .NET** NuGet 包（`Install-Package Aspose.Words`） | 提供 `Document` 类和渲染引擎。 | +| 一个你想转换为 PNG 的 **Word 文档**（`.docx`） | 需要转换的源文件。 | +| 基础的 C# 知识——了解 `using` 语句和对象初始化。 | 降低学习曲线。 | + +如果缺少 NuGet 包，请在包管理器控制台运行： + +```powershell +Install-Package Aspose.Words +``` + +就这么简单——包安装完成后，即可开始编码。 + +--- + +## 步骤 1：加载源文档 + +首先要做的就是让库指向你想要转换的 Word 文件。 + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**为什么重要：** `Document` 类会将整个 Word 包读取到内存中，随后你可以访问页面、样式以及其他所有内容。如果路径错误，会抛出 `FileNotFoundException`，因此请务必检查文件是否存在，并使用转义的反斜杠（`\\`）或逐字字符串（`@`）来表示路径。 + +> **专业提示：** 如果运行时可能找不到文件，建议将加载代码放在 `try/catch` 块中。 + +--- + +## 步骤 2：配置图像渲染选项（设置图像宽高） + +接下来进入本教程的核心：**如何设置图像宽高**，以避免生成的 PNG 被拉伸或像素化。`ImageRenderingOptions` 类让你能够细粒度地控制尺寸、DPI 和平滑度。 + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**关键属性说明：** + +- `Width` 和 `Height` —— 你想要的精确像素尺寸。通过设置它们，你可以直接 **设置图像宽高**，覆盖默认的页面大小。 +- `UseAntialiasing` —— 为文本和矢量图形启用高质量平滑，这在 **将 word 转换为 png** 并希望边缘清晰时至关重要。 +- `Resolution` —— 更高的 DPI 能提供更多细节，尤其是布局复杂的文档。请留意内存占用；300 DPI 的图像可能会很大。 + +> **为什么不直接使用默认尺寸？** 默认使用页面的物理尺寸（例如 A4 在 96 DPI 下约为 794 × 1123 像素）。这对某些场景足够，但如果你需要特定的 UI 缩略图或固定尺寸的预览，就需要自行指定宽高。 + +--- + +## 步骤 3：渲染并保存为 PNG（导出 Docx 为图像） + +在文档加载并配置好选项后，终于可以 **将 docx 导出为图像** 了。`RenderToImage` 方法负责完成大部分工作。 + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +如果想要将 **整篇文档**（所有页面）分别渲染为 PNG 文件，可以遍历页面集合： + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**内部原理是什么？** 渲染器会使用你提供的尺寸对每一页进行光栅化，应用抗锯齿，然后将 PNG 字节流写入磁盘。由于 PNG 是无损格式，原始 Word 布局的全部细节都会被完整保留。 + +**预期输出：** 一个恰好 1024 × 768 像素（或你设定的尺寸）的清晰 PNG 文件。使用任意图像查看器打开，你会看到 Word 内容以位图形式完整呈现，且与原始文档的外观一致。 + +--- + +## 高级技巧与变体 + +### 1. 保持透明背景 + +如果 Word 文档中包含透明背景的形状，并希望保留透明度，请将 `BackgroundColor` 设置为 `Color.Transparent`： + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. 只渲染特定范围 + +有时只需要渲染段落或表格，而不是整页。可以使用 `DocumentVisitor` 提取节点并单独渲染。这是更高级的用法，但它展示了 **如何渲染 word** 内容到更细粒度的层面。 + +### 3. 动态调整 DPI + +如果需要为不同页面使用不同 DPI（例如封面页需要高分辨率），可以在循环内部修改 `Resolution`： + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. 批量处理 + +在一次性转换大量文档时，将整个流程封装成方法，并复用同一个 `ImageRenderingOptions` 实例。复用选项对象可以减少分配开销。 + +--- + +## 常见陷阱及规避方法 + +| 症状 | 可能原因 | 解决方案 | +|------|----------|----------| +| PNG 模糊，即使 DPI 很高 | `UseAntialiasing` 为 `false` | 将 `UseAntialiasing = true`。 | +| 输出尺寸与 `Width`/`Height` 不符 | 未考虑 DPI | 将期望尺寸乘以 `Resolution / 96`，或相应调整 `Resolution`。 | +| 大文档出现内存不足异常 | 以 300 DPI 渲染整篇文档 | 每次渲染单页，保存后释放图像资源。 | +| 透明图像显示为白色背景 | 未设置 `BackgroundColor` | 设置 `imageOptions.BackgroundColor = Color.Transparent`。 | + +--- + +## 完整工作示例 + +下面是一个可直接复制到控制台应用的完整程序。它演示了 **将 word 转换为 png**、**将 docx 保存为 png**，以及 **设置图像宽高** 的全过程。 + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**运行方式：** 构建项目，在指定路径下放置有效的 `input.docx`，然后执行程序。你将得到一个恰好 **1024 × 768** 像素的 `output.png`，并带有平滑的边缘。 + +## 相关教程 + +- [How to Enable Antialiasing When Converting DOCX to PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – create zip archive c# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [How to Use Aspose to Render HTML to PNG – Step‑by‑Step Guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/chinese/net/html-extensions-and-conversions/_index.md b/html/chinese/net/html-extensions-and-conversions/_index.md index a6c24babf..0b13318ed 100644 --- a/html/chinese/net/html-extensions-and-conversions/_index.md +++ b/html/chinese/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,10 @@ Aspose.HTML for .NET 不仅仅是一个库；它是 Web 开发领域的变革者 ## HTML 扩展和转换教程 ### [使用 Aspose.HTML 在 .NET 中将 HTML 转换为 PDF](./convert-html-to-pdf/) 使用 Aspose.HTML for .NET 轻松将 HTML 转换为 PDF。按照我们的分步指南，释放 HTML 到 PDF 转换的强大功能。 + +### [使用 Aspose.HTML 在 C# 中将 HTML 转换为 PDF – 完整指南](./convert-html-to-pdf-with-c-complete-guide/) +通过完整的分步指南，学习如何在 C# 中使用 Aspose.HTML 将 HTML 转换为 PDF，涵盖代码示例和最佳实践。 + ### [使用 Aspose.HTML 在 .NET 中将 EPUB 转换为图像](./convert-epub-to-image/) 了解如何使用 Aspose.HTML for .NET 将 EPUB 转换为图像。带有代码示例和可自定义选项的分步教程。 ### [使用 Aspose.HTML 在 .NET 中将 EPUB 转换为 PDF](./convert-epub-to-pdf/) @@ -69,11 +73,14 @@ Aspose.HTML for .NET 不仅仅是一个库；它是 Web 开发领域的变革者 本完整指南展示如何使用 Aspose.HTML for .NET 创建带样式的 HTML 文档并将其导出为 PDF，包含详细步骤和代码示例。 ### [使用 Aspose.HTML 在 C# 中将 HTML 创建为 PDF – 完整指南](./create-pdf-from-html-c-step-by-step-guide/) 使用 Aspose.HTML for .NET 在 C# 中将 HTML 转换为 PDF 的完整分步指南，涵盖代码示例和最佳实践。 +### [使用 Aspose.HTML 在 C# 中将 HTML 渲染为 PDF – 完整指南](./render-html-as-pdf-in-c-full-step-by-step-guide/) +通过完整的分步教程，学习在 C# 中使用 Aspose.HTML 将 HTML 渲染为 PDF，涵盖代码示例和最佳实践。 ### [使用 Aspose.HTML 在 .NET 中将 HTML 保存为 ZIP – 完整的 C# 教程](./save-html-as-zip-complete-c-tutorial/) 使用 Aspose.HTML for .NET 将 HTML 内容打包为 ZIP 文件的完整 C# 示例，包含代码演示和关键步骤。 - ### [在 C# 中将 HTML 保存为 ZIP – 完整内存示例](./save-html-to-zip-in-c-complete-in-memory-example/) 演示如何使用 Aspose.HTML for .NET 在 C# 中将 HTML 内容压缩为 ZIP 文件，完整的内存操作示例。 +### [使用 Aspose.HTML 将 HTML 保存为 ZIP – 完整指南](./save-html-as-zip-complete-guide-for-aspose-html/) +使用 Aspose.HTML 将 HTML 内容压缩为 ZIP 文件的完整指南，提供代码示例和关键步骤。 ## 结论 diff --git a/html/chinese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/chinese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..7f7afd693 --- /dev/null +++ b/html/chinese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,257 @@ +--- +category: general +date: 2026-05-22 +description: 使用 Aspose.HTML 在 C# 中将 HTML 转换为 PDF。学习如何在 C# 中通过逐步代码、选项和 Linux 提示将 HTML + 渲染为 PDF。 +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: zh +og_description: 使用 Aspose.HTML 在 C# 中将 HTML 转换为 PDF。本指南展示了如何在 C# 中使用清晰的选项和适用于 Linux + 的提示将 HTML 渲染为 PDF。 +og_title: 使用 C# 将 HTML 转换为 PDF – 完整指南 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: 使用 C# 将 HTML 转换为 PDF – 完整指南 +url: /zh/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 将 HTML 转换为 PDF（C#） – 完整指南 + +如果您需要快速 **将 HTML 转换为 PDF**，Aspose.HTML for .NET 能让这变得轻而易举。在本教程中，我们还将回答 **如何在 C# 中将 HTML 渲染为 PDF**，并提供对渲染选项的完整控制，让您不再猜测。 + +想象一下，您有一个营销邮件模板、收据页面，或使用现代 CSS 构建的复杂报告，需要将其交付为 PDF 给客户或打印机。手动完成这一步非常麻烦，但几行 C# 代码即可自动化整个流程。阅读完本指南后，您将拥有一个自包含、可投入生产的解决方案，能够在 Windows *和* Linux 上运行。 + +![使用 Aspose.HTML 将 HTML 转换为 PDF 工作流示意图](/images/convert-html-to-pdf-workflow.png "HTML 转 PDF 工作流") + +## 您需要的准备 + +- **.NET 6.0 或更高** – Aspose.HTML 目标为 .NET Standard 2.0+，因此任何近期的 SDK 都可使用。 +- **Aspose.HTML for .NET** NuGet 包 (`Aspose.Html`) – 生产环境需要有效许可证，但免费试用可用于测试。 +- 一个您想转换为 PDF 的 **简单 HTML 文件**（我们称之为 `input.html`）。 +- 您喜欢的 IDE（Visual Studio、Rider 或 VS Code）– 无需特殊工具。 + +就这么简单。无需外部 PDF 转换器，也不需要命令行技巧。纯粹使用 C#。 + +## 将 HTML 转换为 PDF – 完整实现 + +下面是完整的、可直接运行的程序。将其复制粘贴到新的控制台应用程序中，恢复 NuGet 包，然后按 **F5**。 + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### 为什么这样可行 + +- **`Document`** 是 Aspose.HTML 的入口点；它解析 HTML，解析 CSS，并构建可用于渲染的 DOM。 +- **`PdfRenderingOptions`** 允许您微调输出。`UseHinting` 标志是让无头 Linux 容器中默认光栅化器产生模糊文本时保持文字清晰的关键。 +- **`Save`** 完成繁重的工作：它将 DOM 光栅化到 PDF 页面，遵守分页符，并自动嵌入字体。 + +运行程序后会在源文件所在目录生成 `output.pdf`。使用任意 PDF 查看器打开，您应能看到与原始 HTML 完全一致的视觉效果。 + +## 如何在 C# 中将 HTML 渲染为 PDF – 步骤详解 + +下面我们将整个过程拆分为易于理解的步骤，解释 **如何在 C# 中将 HTML 渲染为 PDF**，并覆盖常见的陷阱。 + +### 步骤 1 – 安装 Aspose.HTML NuGet 包 + +在项目文件夹的终端中执行以下命令： + +```bash +dotnet add package Aspose.Html +``` + +如果您更喜欢使用 Visual Studio UI，右键单击项目 → **管理 NuGet 包** → 搜索 **Aspose.Html** 并安装最新的稳定版本。 + +> **小技巧：** 安装后，将许可证文件 (`Aspose.Total.lic`) 添加到项目根目录，以避免评估水印。 + +### 步骤 2 – 正确加载 HTML + +Aspose.HTML 可以读取以下来源： + +- 本地文件路径 (`new Document("file.html")`) +- URL (`new Document("https://example.com")`) +- 原始 HTML 字符串 (`new Document("…", new HtmlLoadOptions())`) + +从文件系统加载时，请确保路径为绝对路径或工作目录已正确设置，否则会出现 `FileNotFoundException`。在 Linux 上，请使用正斜杠 (`/`) 或 `Path.Combine`。 + +### 步骤 3 – 选择合适的渲染选项 + +除了 `UseHinting`，您可能还想调整以下选项： + +| Option | 功能说明 | 使用时机 | +|--------|----------|----------| +| `PageSize` | 设置 PDF 页面尺寸（A4、Letter、自定义） | 与目标纸张尺寸匹配 | +| `Landscape` | 将页面旋转为横向 | 宽表格或图表 | +| `RasterizeVectorGraphics` | 强制将矢量图形转为光栅图像 | 当 PDF 阅读器无法处理 SVG 时 | +| `CompressionLevel` | 控制图像压缩程度（0‑9） | 为电子邮件附件减小文件大小 | + +您可以流式链式设置这些属性： + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### 步骤 4 – 保存 PDF + +`Save` 方法的重载在完整示例中直接写入文件路径。您也可以将 PDF 流式写入内存： + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +当需要从 Web API 返回 PDF 下载时，这非常方便。 + +### 步骤 5 – 验证输出 + +一个快速的合理性检查是将 PDF 页数与预期的 HTML 部分数进行比较。您可以使用 Aspose.PDF 读取： + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +如果页数不符，请检查 CSS `page-break` 规则或相应调整 `PdfRenderingOptions`。 + +## 边缘情况与常见陷阱 + +| 情况 | 需要注意的点 | 解决方案 | +|-----------|-------------------|-----| +| **外部资源（图片、字体）缺失** | 相对 URL 会相对于 HTML 文件所在文件夹解析。 | 使用 `HtmlLoadOptions.BaseUri` 指向正确的根目录。 | +| **Linux 无头环境** | 默认文本渲染可能模糊。 | 设置 `UseHinting = true`（如示例所示），并确保已安装 `libgdiplus`（如果回退到 System.Drawing）。 | +| **大型 HTML（> 10 MB）** | 渲染期间内存消耗激增。 | 使用 `PdfRenderer` 与 `PdfRenderingOptions` 按页渲染，并在保存后释放每页。 | +| **JavaScript 大量页面** | Aspose.HTML 不执行 JS；动态内容保持静态。 | 在服务器端预处理 HTML（例如使用 Puppeteer），再交给 Aspose.HTML。 | +| **Unicode 字符显示为方块** | 运行时环境缺少字体。 | 通过 `FontSettings` 嵌入自定义字体，或确保操作系统已安装所需字体。 | + +## 完整工作示例回顾 + +以下是完整程序（已去除注释），适合想要简洁视图的读者： + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +运行它，打开 `output.pdf`，您将看到 `input.html` 的像素级完美复制。这就是使用 Aspose.HTML **将 HTML 转换为 PDF** 的核心。 + +## 结论 + +我们已经完整演示了在 C# 中 **将 HTML 转换为 PDF** 所需的全部步骤：安装 Aspose.HTML、加载 HTML、微调渲染选项（包括关键的 `UseHinting` 标志），以及保存最终的 PDF。您现在了解了在 Windows 和 Linux 环境下 **如何在 C# 中将 HTML 渲染为 PDF**，并掌握了处理常见边缘情况（如资源缺失和大文件）的方法。 + +接下来可以尝试添加： + +- 使用 `PdfPageTemplate` 添加 **页眉/页脚** 以实现品牌化。 +- 通过 `PdfSaveOptions` 实现 **密码保护**。 +- 通过遍历文件夹实现 **批量转换**。 + +## 相关教程 + +- [在 .NET 中使用 Aspose.HTML 将 HTML 转换为 PDF](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [在 .NET 中使用 Aspose.HTML 将 EPUB 转换为 PDF](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [在 .NET 中使用 Aspose.HTML 将 SVG 转换为 PDF](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/chinese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/chinese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..cfb41c140 --- /dev/null +++ b/html/chinese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,307 @@ +--- +category: general +date: 2026-05-22 +description: 使用 C# 将 HTML 渲染为 PDF，并提供简洁示例。快速可靠地学习如何在 C# 中将 HTML 转换为 PDF。 +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: zh +og_description: 在 C# 中将 HTML 渲染为 PDF，提供清晰可运行的示例。本指南展示如何在 C# 中将 HTML 转换为 PDF，并从 HTML + 文件生成 PDF。 +og_title: 在 C# 中将 HTML 渲染为 PDF – 完整编程教程 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: 在 C# 中将 HTML 渲染为 PDF – 完整分步指南 +url: /zh/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 在 C# 中将 HTML 渲染为 PDF – 完整分步指南 + +是否曾经需要 **render HTML as PDF**，但不确定该为 .NET 项目选择哪个库？你并不孤单。在许多行业应用中，你会发现自己需要 **convert HTML to PDF C#** 来生成发票、报告或营销手册——基本上，只要想要网页的可打印版本时，都需要这样做。 + +事情是这样的：你不必重新发明轮子。只需几行代码，你就可以拿一个 `input.html` 文件，交给成熟的渲染引擎，最终得到一个清晰的 `output.pdf`。在本教程中，我们将完整演示整个过程，从添加合适的 NuGet 包到处理诸如外部 CSS 等边缘情况。结束时，你将能够在几分钟内 **generate PDF from HTML file**。 + +## 你将学到的内容 + +- 如何设置一个能够 **creates PDF from HTML C#** 代码的 .NET 控制台应用。 +- 完成 **save HTML document as PDF** 所需的确切 API 调用。 +- 为什么某些渲染选项（如 hinting）对文本质量很重要。 +- 排查常见问题的技巧，例如缺少字体或相对图片路径。 + +**先决条件** – 你应已安装 .NET 6+ 或 .NET Framework 4.7，具备基本的 C# 知识，并拥有一个 IDE（Visual Studio 2022、Rider 或 VS Code）。不需要任何 PDF 经验。 + +--- + +## 将 HTML 渲染为 PDF – 项目设置 + +在深入代码之前，让我们确保开发环境已就绪。我们将使用的库是 **Select.Pdf**（非商业用途免费），因为它提供了简洁的 API 和可靠的渲染保真度。 + +### 安装 PDF 渲染库 (convert html to pdf c#) + +打开项目文件夹中的终端并运行： + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*小技巧：* 如果你使用 Visual Studio，也可以通过 NuGet 包管理器 UI 添加该包。版本号可能更新——只需获取最新的稳定版即可。 + +### 创建控制台骨架 + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +这就是你所需的全部样板代码。真正的工作在 `Main` 中完成。 + +--- + +## 加载 HTML 文档 (generate pdf from html file) + +第一步是真正将渲染器指向磁盘上的 HTML 文件。Select.Pdf 提供两种便捷方式：传入原始 HTML 字符串或文件路径。使用文件可以保持整洁，尤其是当你有链接的 CSS 或图片时。 + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +这里我们还对可能缺失的文件进行检查——初学者常因忘记将 HTML 复制到输出文件夹而出错。 + +--- + +## 配置渲染选项 (create pdf from html c#) + +Select.Pdf 附带功能丰富的 `PdfDocumentOptions` 对象。为了获得清晰的文字，我们启用 hinting，它会在微小的性能损耗下平滑字形。 + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +你可以在此调整页面尺寸、边距，甚至嵌入自定义字体。关键点是 **render html as pdf** 并非只有一行代码；你可以控制最终文档的外观和感觉。 + +--- + +## 将 HTML 文档保存为 PDF (render html as pdf) + +现在魔法出现了。我们将 HTML 文件的路径交给转换器，让它写出 PDF 到磁盘。 + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +`ConvertUrl` 方法会自动根据 HTML 文件所在位置解析相对 URL（图片、CSS），这也是此方法在大多数真实场景中稳健的原因。 + +### 预期输出 + +运行程序后，你应该在同一文件夹中看到 `output.pdf` 文件。打开它——你会注意到： + +- 文本使用清晰的抗锯齿渲染（得益于 hinting）。 +- 来自链接 CSS 的样式正确应用。 +- 图片以源 HTML 中定义的精确尺寸显示。 + +如果有任何显示异常，请再次确认 CSS 和图片文件与 `input.html` 位于同一目录，或使用绝对 URL。 + +--- + +## 处理常见边缘情况 + +### 1. 防火墙阻止的外部资源 + +如果你的 HTML 引用了服务器无法访问的 CDN 上的字体，PDF 可能会回退到通用字体。为避免此情况，可将字体文件下载到本地，或使用相对路径通过 `@font-face` 嵌入。 + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. 超大 HTML 文件 + +在转换超大文档时，可能会遇到内存限制。Select.Pdf 允许你流式转换： + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +流式处理保持进程轻量，但需要你以字符串形式提供 HTML，必要时可以分块读取。 + +### 3. 自定义页眉或页脚 + +如果需要在每页添加页码或公司徽标，请在调用 `ConvertUrl` 之前在 `converter.Options` 上设置 `Header` 和 `Footer` 属性。 + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## 完整可运行示例（所有步骤合并） + +下面是完整的、可直接复制粘贴的程序。将 `YOUR_DIRECTORY` 替换为你的 HTML 所在的绝对路径。 + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**运行它：** 在项目目录下执行 `dotnet run`。如果一切配置正确，你将看到成功信息以及一个闪亮的 `output.pdf`。 + +--- + +## 可视化摘要 + +![Render HTML as PDF example](render-html-as-pdf.png){alt="渲染 HTML 为 PDF 示例"} + +截图显示了控制台输出以及在查看器中打开的生成的 PDF。请注意清晰的标题和正确加载的图片——这正是你在 **render html as pdf** 时所期待的效果。 + +--- + +## 结论 + +你刚刚学习了如何在 C# 应用中 **render HTML as PDF**，从安装库到微调渲染选项。完整示例展示了一种可靠的方式来 **convert HTML to PDF C#**、**generate PDF from HTML file**，以及仅用几行代码 **save HTML document as PDF**。 + +接下来可以尝试以下实验： + +- 为品牌一致性添加自定义字体。 +- 从动态 HTML 字符串（例如 Razor 模板）生成 PDF。 +- 使用 `PdfDocument.AddPage` 将多个 PDF 合并为单个报告。 + +上述每个扩展都基于此处介绍的核心概念，因此你可以在没有陡峭学习曲线的情况下应对更高级的场景。 + +有问题或遇到困难？在下方留言，我们一起排查。祝编码愉快！ + +## 相关教程 + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Create HTML Document with Styled Text and Export to PDF – Full Guide](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Convert HTML to PDF with Aspose.HTML – Full Manipulation Guide](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/chinese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/chinese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..cb7d0d614 --- /dev/null +++ b/html/chinese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-05-22 +description: 使用 Aspose.HTML 快速将 HTML 保存为 ZIP。学习如何压缩 HTML 文件、将 HTML 渲染为 ZIP，以及使用完整代码将 + HTML 导出为 ZIP 文件。 +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: zh +og_description: 使用 Aspose.HTML 将 HTML 保存为 ZIP。本指南展示了如何将 HTML 渲染为 ZIP、将 HTML 导出为 ZIP + 文件，以及如何以编程方式压缩 HTML 文件。 +og_title: 将HTML保存为ZIP – 完整的Aspose.HTML教程 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: 将HTML保存为ZIP – Aspose.HTML完整指南 +url: /zh/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 将 HTML 保存为 ZIP – Aspose.HTML 完整指南 + +是否曾想过在不使用单独压缩工具的情况下 **将 HTML 保存为 ZIP**？你并不是唯一有此需求的人。许多开发者需要将 HTML 页面连同其图片、CSS 和脚本打包，以便轻松分发，而手动操作很快就会成为痛点。 + +在本教程中，我们将一步步演示使用 Aspose.HTML for .NET **将 HTML 渲染为 ZIP** 的完整解决方案。完成后，你将清楚地知道如何 **将 HTML 导出为 ZIP 文件**，并且还能看到在不同场景下 **如何压缩 HTML 文件** 的变体。 + +> *小技巧：* 下面的方法无论是打包单个页面还是整个站点文件夹都适用。 + +## 你需要准备的东西 + +在开始之前，请确保你已经： + +- 安装了 .NET 6（或任意近期的 .NET 运行时）。 +- 在项目中引用了 Aspose.HTML for .NET NuGet 包（`Aspose.Html`）。 +- 在可控的文件夹中放置了一个简单的 `input.html` 文件。 +- 对 C# 有一点基础——不需要高级技巧，只要会基本语法即可。 + +就这些。无需外部 zip 工具，也不需要命令行技巧。让我们开始吧。 + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*图片说明：保存 HTML 为 ZIP 过程图示* + +## 第一步：加载源 HTML 文档 + +首先我们需要告诉 Aspose.HTML 源文件的位置。`HTMLDocument` 类会读取文件并在内存中构建 DOM，准备进行渲染。 + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +为什么这一步重要：加载文档后，库能够完全控制资源解析（图片、CSS、字体）。如果 HTML 使用相对路径，Aspose.HTML 会自动相对于文件所在文件夹进行解析。 + +## 第二步：（可选）创建自定义资源处理器 + +如果你需要检查或处理每个资源——比如在写入归档前压缩图片——可以插入一个 `ResourceHandler`。此步骤是可选的，但它是实现 **将 HTML 转换为 ZIP 归档** 并加入自定义逻辑的最灵活方式。 + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*如果你不需要任何特殊处理怎么办？* 直接跳过此类，使用默认处理器即可——Aspose.HTML 会直接把资源写入 ZIP。 + +## 第三步：配置保存选项以使用处理器 + +`HtmlSaveOptions` 对象告诉渲染器如何处理资源。通过将我们的 `MyResourceHandler` 赋给它，即可完全掌控输出。 + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +请注意属性名 `ResourceHandler` 直接关联了 **将渲染的 HTML 保存为 ZIP** 的能力。这里就是魔法发生的地方：每个链接的资源都会被流式写入归档，而不是写入磁盘。 + +## 第四步：将渲染后的文档保存到 ZIP 归档 + +现在我们终于 **将 HTML 导出为 ZIP 文件**。`Save` 方法接受任意 `Stream`，因此我们可以把它指向创建 `result.zip` 的 `FileStream`。 + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +这就是完整的工作流。当代码执行完毕，`result.zip` 包含： + +- `input.html`（原始标记） +- 所有引用的图片、CSS 文件和字体 +- 如果在 `MyResourceHandler` 中进行了转换，则包含相应的已处理资源 + +## 不使用 Aspose.HTML 的 HTML 文件压缩方式（快速替代） + +有时你只需要一个普通的 **如何压缩 HTML 文件** 方法，可能是因为已经在使用其他 HTML 解析器。此时可以使用 .NET 内置的 `System.IO.Compression`： + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +这种方法简单，但缺少渲染步骤；它仅仅把磁盘上的文件打包。如果你的 HTML 引用了外部 URL，这些资源不会被包含进来。这也是在需要可靠的 **将渲染的 HTML 保存为 ZIP** 解决方案时，推荐使用 Aspose.HTML 的原因。 + +## 边缘情况与常见陷阱 + +| 情况 | 需要注意的点 | 推荐的解决方案 | +|-----------|-------------------|-----------------| +| **大图片** | 每张图片都会加载到 `MemoryStream`，导致内存使用激增。 | 使用自定义处理器直接将源流复制到 zip，而不是完整缓冲。 | +| **外部 URL** | 托管在互联网上的资源不会自动下载。 | 在 `HtmlLoadOptions` 中设置 `BaseUrl` 指向站点根目录，或在保存前手动下载资源。 | +| **文件名冲突** | 不同子文件夹下的两个 CSS 文件同名会相互覆盖。 | 确保 `ResourceHandler` 在写入 zip 时保留完整的相对路径。 | +| **权限错误** | 写入只读文件夹会抛出 `UnauthorizedAccessException`。 | 使用具备相应权限的账号运行，或选择可写的输出目录。 | + +处理好这些情况后，你的 **将 HTML 转换为 ZIP 归档** 过程即可在生产环境中稳健运行。 + +## 完整示例（所有代码片段组合） + +下面是可直接运行的完整程序。将其粘贴到新的控制台应用，更新路径后按 **F5** 即可。 + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**预期输出：** 控制台会打印成功信息，`result.zip` 文件中包含 `input.html` 以及所有依赖的资源。打开 ZIP，双击 `input.html`，即可看到页面与浏览器中完全一致——没有缺失的图片，也没有破损的 CSS。 + +## 小结 – 为什么这种方式如此强大 + +- **一步渲染：** 不需要手动复制每个资源，Aspose.HTML 会自动完成。 +- **可定制管道：** `ResourceHandler` 让你完全掌控每个文件的存储方式，可实现压缩、加密或即时转换。 +- **跨平台：** 在 Windows、Linux、macOS 上均可运行，只要有 .NET 运行时。 +- **无需外部工具：** 整个 **将 HTML 保存为 ZIP** 过程全部在 C# 代码中完成。 + +## 接下来该做什么？ + +掌握了 **将 HTML 保存为 ZIP** 后，你可以进一步探索以下相关主题： + +- **将 HTML 导出为 PDF** – 适用于可打印的报告（在需要两种格式时，`export html to zip file` 的知识会很有帮助）。 +- **直接将 ZIP 流式输出到 HTTP 响应** – 适用于让用户即时下载打包站点的 Web API。 +- **为 ZIP 归档加密** – 当处理机密文档时，可添加密码层。 + +欢迎尝试：将 `MyResourceHandler` 替换为压缩图片的处理器，或添加一个列出所有打包资源的清单文件。只要你掌握了渲染管道，想象力就是唯一的限制。 + +--- + +*祝编码愉快！如果遇到问题或有改进建议，欢迎在下方留言。我们一起解决。* + + +## 相关教程 + +- [How to Zip HTML in C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Save HTML as ZIP – Complete C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Save HTML to ZIP in C# – Complete In‑Memory Example](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/czech/net/generate-jpg-and-png-images/_index.md b/html/czech/net/generate-jpg-and-png-images/_index.md index 11b9c8465..9f9aead1d 100644 --- a/html/czech/net/generate-jpg-and-png-images/_index.md +++ b/html/czech/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Naučte se používat Aspose.HTML pro .NET k manipulaci s dokumenty HTML, převo Naučte se, jak při převodu dokumentů DOCX na PNG nebo JPG povolit antialiasing pro hladší výstup. ### [Převod docx na png – vytvoření zip archivu C# tutoriál](./convert-docx-to-png-create-zip-archive-c-tutorial/) Naučte se převést soubory DOCX na PNG a zabalit je do ZIP archivu pomocí C# a Aspose.HTML. +### [Nastavte šířku a výšku obrázku při převodu Wordu na PNG – Kompletní průvodce](./set-image-width-height-when-converting-word-to-png-full-guid/) +Naučte se, jak nastavit šířku a výšku výstupního PNG při konverzi dokumentu Word pomocí Aspose.HTML pro .NET. ## Závěr diff --git a/html/czech/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/czech/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..a622936ed --- /dev/null +++ b/html/czech/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,273 @@ +--- +category: general +date: 2026-05-22 +description: Nastavte šířku a výšku obrázku při převodu dokumentu Word do PNG. Naučte + se, jak exportovat docx jako obrázek s vysoce kvalitním vykreslením v podrobném + návodu krok za krokem. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: cs +og_description: Nastavte šířku a výšku obrázku při převodu dokumentu Word do PNG. + Tento tutoriál ukazuje, jak exportovat docx jako obrázek s nastavením vysoké kvality. +og_title: Nastavte šířku a výšku obrázku při převodu Wordu na PNG – kompletní průvodce +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Nastavte šířku a výšku obrázku při převodu Wordu na PNG – kompletní průvodce +url: /cs/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Nastavte šířku a výšku obrázku při převodu Wordu na PNG – Kompletní průvodce + +Už jste se někdy zamýšleli, jak **nastavit šířku a výšku obrázku**, když **převádíte Word na PNG**? Nejste jediní. Mnoho vývojářů narazí na problém, když výchozí export vytvoří rozmazaný obrázek nebo nesprávné rozměry, a pak stráví hodiny hledáním oprav, které skutečně fungují. + +V tomto tutoriálu projdeme čistým, end‑to‑end řešením, které ukazuje **jak renderovat word** dokumenty jako PNG obrázky, což vám umožní **uložit docx jako PNG** s přesnou kontrolou šířky‑výšky a vysoce kvalitním antialiasingem. Na konci budete mít připravený kód, solidní pochopení možností API a několik profesionálních tipů, jak se vyhnout běžným úskalím. + +## Co se naučíte + +- Načíst soubor `.docx` pomocí Aspose.Words for .NET. +- **Nastavit šířku a výšku obrázku** pomocí `ImageRenderingOptions`. +- **Exportovat docx jako obrázek** (PNG) s povoleným antialiasingem. +- Jak **převést word na png** pro jednu stránku nebo celý dokument. +- Tipy pro práci s velkými dokumenty, úvahy o DPI a cesty v souborovém systému. + +Žádné externí nástroje, žádné nešikovné příkazy v terminálu — jen čistý C# kód, který můžete vložit do libovolného .NET projektu. + +--- + +## Předpoklady + +Než se pustíme dál, ujistěte se, že máte následující: + +| Požadavek | Proč je důležité | +|-------------|----------------| +| **.NET 6.0+** (nebo .NET Framework 4.7.2) | Aspose.Words podporuje oba, ale novější runtime poskytuje lepší výkon. | +| **Aspose.Words for .NET** NuGet balíček (`Install-Package Aspose.Words`) | Poskytuje třídu `Document` a renderovací engine. | +| Wordový dokument (`.docx`), který chcete převést na PNG. | Zdroj, který budete konvertovat. | +| Základní znalost C# — budete rozumět `using` příkazům a inicializaci objektů. | Umožní plynulejší učení. | + +Pokud vám chybí NuGet balíček, spusťte následující příkaz v Package Manager Console: + +```powershell +Install-Package Aspose.Words +``` + +A to je vše — jakmile je balíček nainstalován, můžete začít kódovat. + +--- + +## Krok 1: Načtěte zdrojový dokument + +První věc, kterou musíte udělat, je nasměrovat knihovnu na Word soubor, který chcete transformovat. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Proč je to důležité:** Třída `Document` načte celý Word balíček do paměti, čímž získáte přístup ke stránkám, stylům a všemu ostatnímu. Pokud je cesta špatná, dostanete `FileNotFoundException`, takže dvakrát zkontrolujte, že soubor existuje a že cesta používá escapované zpětné lomítka (`\\`) nebo doslovný řetězec (`@`). + +> **Pro tip:** Zabalte volání načtení do `try/catch` bloku, pokud očekáváte, že soubor může během běhu chybět. + +--- + +## Krok 2: Nakonfigurujte možnosti renderování obrázku (Set Image Width Height) + +Nyní přichází jádro tutoriálu: **jak nastavit šířku a výšku obrázku**, aby výsledný PNG nebyl roztažený nebo pixelovaný. Třída `ImageRenderingOptions` vám poskytuje detailní kontrolu nad rozměry, DPI a vyhlazováním. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Vysvětlení klíčových vlastností:** + +- `Width` a `Height` — Jedná se o přesné rozměry v pixelech, které chcete. Nastavením těchto hodnot **nastavíte šířku a výšku obrázku** přímo a přepíšete výchozí velikost stránky. +- `UseAntialiasing` — Povoluje vysoce kvalitní vyhlazování textu a vektorové grafiky, což je klíčové, když **převádíte word na png** a chcete ostré hrany. +- `Resolution` — Vyšší DPI poskytuje více detailů, zejména u složitých rozvržení. Dávejte pozor na spotřebu paměti; 300 DPI obrázek může být velký. + +> **Proč nepoužít jen výchozí velikost?** Výchozí používá fyzické rozměry stránky (např. A4 při 96 DPI). To často vytvoří obrázek 794 × 1123 pixelů — v pořádku pro některé případy, ale ne když potřebujete konkrétní náhled UI nebo fixní velikost. + +--- + +## Krok 3: Renderujte a uložte jako PNG (Export Docx as Image) + +Po načtení dokumentu a nastavení možností můžete konečně **exportovat docx jako obrázek**. Metoda `RenderToImage` udělá těžkou práci. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Pokud chcete renderovat **celý dokument** (všechny stránky) do samostatných PNG souborů, projděte kolekci stránek ve smyčce: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Co se děje pod kapotou?** Renderér rasterizuje každou stránku pomocí vámi zadaných rozměrů, aplikuje antialiasing a zapíše PNG bajtový proud na disk. Protože PNG je bezztrátový, zachováte plnou věrnost původního rozvržení Wordu. + +**Očekávaný výstup:** Ostrý PNG soubor přesně 1024 × 768 pixelů (nebo jakoukoliv velikost jste nastavili). Otevřete jej v libovolném prohlížeči obrázků a uvidíte Word obsah vykreslený přesně tak, jak je v původním dokumentu, ale nyní jako bitmapový obrázek. + +--- + +## Pokročilé tipy a variace + +### 1. Zachování transparentního pozadí + +Pokud váš Word dokument obsahuje tvary s transparentním pozadím a chcete tuto transparentnost zachovat, nastavte `BackgroundColor` na `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Renderovat jen konkrétní rozsah + +Někdy potřebujete jen odstavec nebo tabulku, ne celou stránku. Použijte `DocumentVisitor` k extrakci uzlu a renderujte jej samostatně. Jedná se o pokročilejší scénář, ale ukazuje **jak renderovat word** obsah na granulární úrovni. + +### 3. Dynamické nastavení DPI + +Pokud potřebujete jiné DPI pro různé stránky (např. vysoké rozlišení pro obálku), upravte `Resolution` uvnitř smyčky: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Hromadné zpracování + +Při konverzi desítek dokumentů zabalte celý tok do metody a znovu použijte stejnou instanci `ImageRenderingOptions`. Opakované používání objektu s možnostmi snižuje alokační režii. + +--- + +## Běžné úskalí a jak se jim vyhnout + +| Symptom | Pravděpodobná příčina | Řešení | +|---------|-----------------------|--------| +| PNG je rozmazaný i přes vysoké DPI | `UseAntialiasing` zůstalo `false` | Nastavte `UseAntialiasing = true`. | +| Výstupní velikost neodpovídá `Width`/`Height` | DPI nebylo zohledněno | Vynásobte požadovanou velikost hodnotou `Resolution / 96` nebo upravte `Resolution`. | +| Výjimka Out‑of‑memory u velkých dokumentů | Renderování celého dokumentu při 300 DPI | Renderujte po jedné stránce, po uložení každého obrázku uvolněte paměť. | +| PNG má bílou barvu pozadí u transparentních obrázků | `BackgroundColor` nebylo nastaveno | Nastavte `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Kompletní funkční příklad + +Níže je samostatný program, který můžete zkopírovat do konzolové aplikace. Demonstruje **convert word to png**, **save docx as png** a samozřejmě **set image width height**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Spusťte ho:** Sestavte projekt, umístěte platný `input.docx` na zadanou cestu a spusťte. Měli byste získat `output.png` přesně **1024 × 768** pixelů, renderovaný s hladkými hranami. + +## Související tutoriály + +- [How to Enable Antialiasing When Converting DOCX to PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – create zip archive c# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [How to Use Aspose to Render HTML to PNG – Step‑by‑Step Guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/czech/net/html-extensions-and-conversions/_index.md b/html/czech/net/html-extensions-and-conversions/_index.md index dc8f6f072..2b66e6c20 100644 --- a/html/czech/net/html-extensions-and-conversions/_index.md +++ b/html/czech/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,8 @@ Aspose.HTML for .NET není jen knihovna; je to změna hry ve světě vývoje web ## Výukové programy pro rozšíření a konverze HTML ### [Převeďte HTML do PDF v .NET pomocí Aspose.HTML](./convert-html-to-pdf/) Převeďte HTML do PDF bez námahy pomocí Aspose.HTML pro .NET. Postupujte podle našeho podrobného průvodce a uvolněte sílu převodu HTML do PDF. +### [Vykreslete HTML jako PDF v C# – Kompletní průvodce krok za krokem](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Kompletní průvodce, jak v C# pomocí Aspose.HTML převést HTML na PDF, s podrobnými ukázkami kódu a nastavením. ### [Vytvořte PDF z HTML v C# – průvodce krok za krokem](./create-pdf-from-html-c-step-by-step-guide/) Naučte se, jak pomocí Aspose.HTML v C# převést HTML dokument do PDF pomocí podrobného průvodce krok za krokem. ### [Převeďte EPUB na obrázek v .NET pomocí Aspose.HTML](./convert-epub-to-image/) @@ -67,12 +69,14 @@ Naučte se převádět HTML na TIFF pomocí Aspose.HTML pro .NET. Postupujte pod Objevte sílu Aspose.HTML pro .NET: Převeďte HTML na XPS bez námahy. Součástí jsou předpoklady, podrobný průvodce a často kladené otázky. ### [Jak zkomprimovat HTML v C# – Uložit HTML do ZIP](./how-to-zip-html-in-c-save-html-to-zip/) Naučte se, jak pomocí Aspose.HTML pro .NET zabalit HTML soubor do ZIP archivu v C#. -### [Vytvořte HTML dokument se stylovaným textem a exportujte do PDF – Kompletní průvodce](./create-html-document-with-styled-text-and-export-to-pdf-full/) -Naučte se vytvořit HTML dokument se stylovaným textem a převést jej do PDF pomocí Aspose.HTML pro .NET. ### [Uložte HTML jako ZIP – Kompletní C# tutoriál](./save-html-as-zip-complete-c-tutorial/) Naučte se, jak uložit HTML soubor jako ZIP archiv pomocí Aspose.HTML pro .NET v kompletním C# tutoriálu. ### [Uložte HTML do ZIP v C# – Kompletní příklad v paměti](./save-html-to-zip-in-c-complete-in-memory-example/) Naučte se, jak uložit HTML soubor do ZIP archivu v paměti pomocí Aspose.HTML pro .NET v C#. +### [Uložte HTML jako ZIP – Kompletní průvodce pro Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Naučte se, jak uložit HTML soubor jako ZIP archiv pomocí Aspose.HTML v podrobném průvodci. +### [Převod HTML do PDF v C# – Kompletní průvodce](./convert-html-to-pdf-with-c-complete-guide/) +Kompletní návod, jak v C# převést HTML do PDF pomocí Aspose.HTML, včetně ukázek kódu a nastavení. ## Závěr diff --git a/html/czech/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/czech/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..52b69ae13 --- /dev/null +++ b/html/czech/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,257 @@ +--- +category: general +date: 2026-05-22 +description: Převod HTML na PDF v C# pomocí Aspose.HTML. Naučte se, jak v C# renderovat + HTML do PDF pomocí krok‑za‑krokem kódu, možností a tipů pro Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: cs +og_description: Převod HTML do PDF v C# s Aspose.HTML. Tento návod ukazuje, jak v + C# převést HTML na PDF pomocí přehledných možností a Linux‑přátelských tipů. +og_title: Převod HTML do PDF pomocí C# – Kompletní průvodce +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Převod HTML do PDF pomocí C# – Kompletní průvodce +url: /cs/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Převod HTML do PDF pomocí C# – Kompletní průvodce + +Pokud potřebujete **převést HTML do PDF** rychle, Aspose.HTML pro .NET to usnadňuje. V tomto tutoriálu také odpovíme na otázku **jak vykreslit HTML do PDF v C#** s plnou kontrolou nad možnostmi vykreslování, takže nebudete hádat. + +Představte si, že máte marketingový e‑mailový šablonu, stránku s účtenkou nebo složitou zprávu vytvořenou pomocí moderního CSS a musíte ji předat jako PDF klientovi nebo tiskaři. Udělat to ručně je obtížné, ale několik řádků C# kódu může celý proces automatizovat. Na konci tohoto průvodce budete mít samostatné, připravené řešení pro produkci, které funguje na Windows *i* Linuxu. + +## Co budete potřebovat + +- **.NET 6.0 nebo novější** – Aspose.HTML cílí na .NET Standard 2.0+, takže jakýkoli recent SDK funguje. +- **Aspose.HTML for .NET** NuGet balíček (`Aspose.Html`) – budete potřebovat platnou licenci pro produkci, ale bezplatná zkušební verze stačí pro testování. +- **Jednoduchý HTML soubor**, který chcete převést do PDF (budeme ho nazývat `input.html`). +- Vaše oblíbené IDE (Visual Studio, Rider nebo VS Code) – žádné speciální nástroje nejsou potřeba. + +To je vše. Žádné externí PDF konvertory, žádné příkazové řádky. Pouze čistý C#. + +![Diagram illustrating the convert html to pdf workflow using Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## Převod HTML do PDF – Kompletní implementace + +Níže je kompletní, připravený program. Zkopírujte jej do nové konzolové aplikace, obnovte NuGet balíčky a stiskněte **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Proč to funguje + +- **`Document`** je vstupní bod Aspose.HTML; parsuje HTML, řeší CSS a vytváří DOM připravený k vykreslení. +- **`PdfRenderingOptions`** vám umožňuje doladit výstup. Příznak `UseHinting` je tajná ingredience pro ostrý text v headless Linux kontejnerech, kde výchozí rasterizér může vypadat rozmazaně. +- **`Save`** vykonává těžkou práci: rasterizuje DOM na PDF stránky, respektuje zalomení stránek a automaticky vkládá fonty. + +Spuštěním programu se vytvoří `output.pdf` vedle vašeho zdrojového souboru. Otevřete jej libovolným PDF prohlížečem a měli byste vidět věrnou vizuální shodu s původním HTML. + +## Jak vykreslit HTML do PDF v C# – Krok za krokem + +Níže rozkládáme proces na malé části a vysvětlujeme **jak vykreslit HTML do PDF v C#**, přičemž upozorňujeme na běžné úskalí. + +### Krok 1 – Instalace NuGet balíčku Aspose.HTML + +Otevřete terminál ve složce projektu a spusťte: + +```bash +dotnet add package Aspose.Html +``` + +Pokud dáváte přednost UI ve Visual Studiu, klikněte pravým tlačítkem na projekt → **Manage NuGet Packages** → vyhledejte **Aspose.Html** a nainstalujte nejnovější stabilní verzi. + +> **Pro tip:** Po instalaci přidejte licenční soubor (`Aspose.Total.lic`) do kořenové složky projektu, aby se odstranily vodotiskové značky evaluace. + +### Krok 2 – Načtěte svůj HTML správně + +Aspose.HTML může načíst: + +- Lokální cesty k souborům (`new Document("file.html")`) +- URL adresy (`new Document("https://example.com")`) +- Surové HTML řetězce (`new Document("…", new HtmlLoadOptions())`) + +Když načítáte ze souborového systému, ujistěte se, že cesta je absolutní nebo že je správně nastavený pracovní adresář, jinak narazíte na `FileNotFoundException`. Na Linuxu používejte lomítka (`/`) nebo `Path.Combine`. + +### Krok 3 – Vyberte správné možnosti vykreslování + +Kromě `UseHinting` možná budete chtít upravit: + +| Možnost | Co dělá | Kdy použít | +|--------|--------------|----------------| +| `PageSize` | Nastavuje rozměry PDF stránky (A4, Letter, vlastní) | Odpovídá cílové velikosti papíru | +| `Landscape` | Otočí stránku na šířku | Široké tabulky nebo grafy | +| `RasterizeVectorGraphics` | Vynutí převod vektorové grafiky na rastrové obrázky | Když PDF čtečka neumí zpracovat SVG | +| `CompressionLevel` | Řídí kompresi obrázků (0‑9) | Snížení velikosti souboru pro e‑mailové přílohy | + +Tyto vlastnosti můžete řetězit plynule: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Krok 4 – Uložte PDF + +Metoda `Save`, kterou vidíte v kompletním příkladu, zapisuje přímo na cestu souboru. PDF můžete také streamovat do paměti: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +To je užitečné, když potřebujete PDF vrátit jako stažení z webového API. + +### Krok 5 – Ověřte výstup + +Rychlá kontrola je porovnat počet stránek PDF s očekávaným počtem HTML sekcí. Můžete jej načíst zpět pomocí Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Pokud se počet neshoduje, podívejte se na CSS pravidla `page-break` nebo upravte `PdfRenderingOptions` podle potřeby. + +## Edge Cases & Common Gotchas + +| Situace | Na co si dát pozor | Oprava | +|-----------|-------------------|-----| +| **Chybějící externí zdroje (obrázky, fonty)** | Relativní URL se řeší vůči složce HTML souboru. | Použijte `HtmlLoadOptions.BaseUri` k nastavení správného kořene. | +| **Linuxové headless prostředí** | Výchozí vykreslování textu může být rozmazané. | Nastavte `UseHinting = true` (jak je ukázáno) a ujistěte se, že je nainstalován `libgdiplus`, pokud přecházíte na System.Drawing. | +| **Velké HTML (> 10 MB)** | Spotřeba paměti během vykreslování prudce stoupá. | Vykreslujte stránku po stránce pomocí `PdfRenderer` s `PdfRenderingOptions` a po uložení uvolněte každou stránku. | +| **Stránky s těžkým JavaScriptem** | Aspose.HTML neprovádí JS; dynamický obsah zůstává statický. | Předzpracujte HTML na serveru (např. pomocí Puppeteer) před předáním Aspose.HTML. | +| **Unicode znaky se zobrazují jako čtverečky** | Chybějící fonty v běhovém prostředí. | Vložte vlastní fonty pomocí `FontSettings` nebo zajistěte, aby OS měla požadované fonty nainstalované. | + +## Full Working Example Recap + +Zde je celý program znovu, bez komentářů pro ty, kteří preferují stručný pohled: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Spusťte jej, otevřete `output.pdf` a uvidíte pixel‑dokonalou repliku `input.html`. To je podstata **convert html to pdf** s Aspose.HTML. + +## Závěr + +Prošli jsme vším, co potřebujete k **převodu HTML do PDF** v C#: instalace Aspose.HTML, načtení HTML, doladění možností vykreslování (včetně klíčového příznaku `UseHinting`) a uložení finálního PDF. Nyní rozumíte **jak vykreslit HTML do PDF v C#** pro prostředí Windows i Linux a viděli jste, jak řešit běžné edge cases jako chybějící zdroje a velké soubory. + +Co dál? Zkuste přidat: + +- **Záhlaví/patky** pomocí `PdfPageTemplate` pro branding. +- **Ochranu heslem** přes `PdfSaveOptions`. +- **Dávkový převod** iterací přes složku s… + +## Související tutoriály + +- [Převod HTML do PDF v .NET s Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Převod EPUB do PDF v .NET s Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Převod SVG do PDF v .NET s Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/czech/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/czech/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..9d7370afb --- /dev/null +++ b/html/czech/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,308 @@ +--- +category: general +date: 2026-05-22 +description: Vykreslete HTML do PDF pomocí C# s stručným příkladem. Naučte se rychle + a spolehlivě převádět HTML do PDF v C#. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: cs +og_description: Vykreslete HTML jako PDF v C# s jasným, spustitelným příkladem. Tento + průvodce vám ukáže, jak převést HTML do PDF v C# a vytvořit PDF ze souboru HTML. +og_title: Vykreslení HTML do PDF v C# – Kompletní programovací tutoriál +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Vykreslení HTML do PDF v C# – Kompletní krok‑za‑krokem průvodce +url: /cs/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Vykreslení HTML jako PDF v C# – Kompletní průvodce krok za krokem + +Už jste někdy potřebovali **render HTML as PDF**, ale nebyli jste si jisti, kterou knihovnu zvolit pro .NET projekt? Nejste v tom sami. V mnoha podnikových aplikacích se setkáte s potřebou **convert HTML to PDF C#** pro faktury, zprávy nebo marketingové brožury – v podstatě kdykoli chcete tisknutelnou verzi webové stránky. + +Takže, není třeba znovu vymýšlet kolo. Několika řádky kódu můžete vzít soubor `input.html`, předat jej osvědčenému vykreslovacímu enginu a získat ostrý `output.pdf`. V tomto tutoriálu projdeme celý proces, od přidání správného NuGet balíčku až po řešení okrajových případů, jako je externí CSS. Na konci budete schopni **generate PDF from HTML file** během několika minut. + +## Co se naučíte + +- Jak nastavit .NET konzolovou aplikaci, která **creates PDF from HTML C#** kód. +- Přesné volání API, které potřebujete k **save HTML document as PDF**. +- Proč některé možnosti vykreslování (např. hinting) ovlivňují kvalitu textu. +- Tipy pro řešení běžných problémů, jako jsou chybějící fonty nebo relativní cesty k obrázkům. + +**Prerequisites** – měli byste mít nainstalovaný .NET 6+ nebo .NET Framework 4.7, základní znalost C# a IDE (Visual Studio 2022, Rider nebo VS Code). Předchozí zkušenost s PDF není vyžadována. + +--- + +## Vykreslení HTML jako PDF – Nastavení projektu + +Než se ponoříme do kódu, ujistěme se, že vývojové prostředí je připravené. Knihovna, kterou použijeme, je **Select.Pdf** (zdarma pro nekomerční použití), protože nabízí jednoduché API a solidní věrnost vykreslování. + +### Instalace knihovny pro vykreslování PDF (convert html to pdf c#) + +Otevřete terminál ve složce projektu a spusťte: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Pokud používáte Visual Studio, můžete balíček také přidat přes UI NuGet Package Manageru. Číslo verze může být novější – prostě si stáhněte nejnovější stabilní verzi. + +### Vytvoření základní konzolové struktury + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +To je vše, co potřebujete jako boilerplate. Náročná část se odehrává uvnitř `Main`. + +--- + +## Načtení HTML dokumentu (generate pdf from html file) + +Prvním skutečným krokem je nasměrovat renderer na HTML soubor na disku. Select.Pdf nabízí dva pohodlné způsoby: předání surového HTML řetězce nebo cesty k souboru. Použití souboru udržuje věci přehledné, zejména když máte propojené CSS nebo obrázky. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Zde také chráníme před chybějícím souborem – něco, co nováčky často překvapí, když zapomenou zkopírovat HTML do výstupní složky. + +--- + +## Konfigurace možností vykreslování (create pdf from html c#) + +Select.Pdf přichází s bohatým objektem `PdfDocumentOptions`. Pro ostrý text povolíme hinting, který vyhlazuje glyfy za cenu malého dopadu na výkon. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Zde můžete upravit velikost stránky, okraje nebo dokonce vložit vlastní font. Hlavní myšlenkou je, že **render html as pdf** není jen jednorázový řádek; máte kontrolu nad vzhledem a pocitem finálního dokumentu. + +--- + +## Uložení HTML dokumentu jako PDF (render html as pdf) + +Nyní se děje magie. Předáme konvertoru cestu k našemu HTML souboru a požádáme jej, aby zapsal PDF na disk. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +Metoda `ConvertUrl` automaticky řeší relativní URL (obrázky, CSS) na základě umístění HTML souboru, což je důvod, proč je tento přístup robustní pro většinu reálných scénářů. + +### Očekávaný výstup + +Po spuštění programu byste měli vidět soubor `output.pdf` ve stejné složce. Otevřete jej – všimnete si: + +- Text vykreslený s čistým anti‑aliasingem (díky hintingu). +- Styly z propojeného CSS aplikovány správně. +- Obrázky zobrazené ve přesné velikosti definované ve zdrojovém HTML. + +Pokud něco vypadá špatně, dvojitě zkontrolujte, že soubory CSS a obrázky jsou umístěny vedle `input.html`, nebo použijte absolutní URL. + +--- + +## Řešení běžných okrajových případů + +### 1. Externí zdroje blokované firewally + +Pokud vaše HTML odkazuje na fonty hostované na CDN, ke které váš server nemůže přistupovat, PDF může přejít na generický font. Aby se tomu předešlo, buď stáhněte soubory fontů lokálně, nebo je vložte pomocí `@font-face` s relativní cestou. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Velmi velké HTML soubory + +Při převodu obrovských dokumentů můžete narazit na limity paměti. Select.Pdf vám umožní streamovat konverzi: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Streamování udržuje proces lehký, ale vyžaduje, abyste poskytli HTML jako řetězec, který můžete číst po částech, pokud je to potřeba. + +### 3. Vlastní záhlaví nebo zápatí + +Pokud potřebujete číslo stránky nebo logo společnosti na každé stránce, nastavte vlastnosti `Header` a `Footer` na `converter.Options` před voláním `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Kompletní funkční příklad (všechny kroky dohromady) + +Níže je kompletní program připravený ke zkopírování a vložení. Nahraďte `YOUR_DIRECTORY` absolutní cestou, kde se nachází váš HTML. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** `dotnet run` z adresáře projektu. Pokud je vše nastaveno správně, uvidíte úspěšnou zprávu a lesklý `output.pdf`. + +--- + +## Vizualizace + +![Příklad renderování HTML jako PDF](render-html-as-pdf.png){alt="příklad renderování html jako pdf"} + +Snímek obrazovky ukazuje výstup konzole a výsledné PDF otevřené ve vieweru. Všimněte si ostrých nadpisů a správně načtených obrázků – přesně to, co očekáváte při **render html as pdf**. + +--- + +## Závěr + +Právě jste se naučili, jak **render HTML as PDF** v C# aplikaci, od instalace knihovny až po jemné ladění možností vykreslování. Kompletní příklad ukazuje spolehlivý způsob, jak **convert HTML to PDF C#**, **generate PDF from HTML file** a **save HTML document as PDF** pomocí několika řádků kódu. + +Co dál? Vyzkoušejte experimentovat s: + +- Přidání vlastních fontů pro konzistenci značky. +- Generování PDF z dynamických HTML řetězců (např. Razor šablony). +- Sloučení více PDF do jedné zprávy pomocí `PdfDocument.AddPage`. + +Každé z těchto rozšíření staví na základních konceptech zde pokrytých, takže budete připraveni řešit pokročilejší scénáře bez strmého učebního křivky. + +Máte otázky nebo jste narazili na problém? Zanechte komentář níže a pojďme to společně vyřešit. Šťastné kódování! + +## Související tutoriály + +- [Převod HTML do PDF v .NET s Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Vytvoření HTML dokumentu se stylovaným textem a export do PDF – Kompletní průvodce](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Převod HTML do PDF s Aspose.HTML – Kompletní průvodce manipulací](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/czech/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/czech/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..0a2ea5cfa --- /dev/null +++ b/html/czech/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-05-22 +description: Rychle uložte HTML jako ZIP pomocí Aspose.HTML. Naučte se, jak zabalit + HTML soubory do ZIP, renderovat HTML do ZIP a exportovat HTML do ZIP souboru s kompletním + kódem. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: cs +og_description: Uložte HTML jako ZIP pomocí Aspose.HTML. Tento průvodce ukazuje, jak + renderovat HTML do ZIP, exportovat HTML do souboru ZIP a programově zabalit HTML + soubory do ZIP. +og_title: Uložení HTML jako ZIP – Kompletní tutoriál Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Uložení HTML do ZIP – Kompletní průvodce pro Aspose.HTML +url: /cs/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Uložení HTML jako ZIP – Kompletní průvodce pro Aspose.HTML + +Už jste se někdy zamysleli, jak **uložit HTML jako ZIP** bez použití samostatného archivního nástroje? Nejste v tom sami. Mnoho vývojářů potřebuje zabalit HTML stránku spolu s jejími obrázky, CSS a skripty pro snadnou distribuci, a ruční provádění se rychle stane bolestivým bodem. + +V tomto tutoriálu projdeme čistým, end‑to‑end řešením, které **převádí HTML do ZIP** pomocí Aspose.HTML pro .NET. Na konci přesně budete vědět, jak **exportovat HTML do ZIP souboru**, a také uvidíte varianty **jak zabalit HTML soubory** v různých scénářích. + +> *Pro tip:* Přístup ukázaný zde funguje, ať už balíte jedinou stránku nebo celý složku webu. + +## Co budete potřebovat + +Předtím, než se ponoříme, ujistěte se, že máte: + +- .NET 6 (nebo jakýkoli aktuální .NET runtime) nainstalovaný. +- NuGet balíček Aspose.HTML pro .NET (`Aspose.Html`) přidaný do projektu. +- Jednoduchý soubor `input.html` umístěný ve složce, kterou ovládáte. +- Trochu znalostí C# — nic složitého, jen základy. + +To je vše. Žádné externí zip nástroje, žádné příkazové řádky. Pojďme začít. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*Alt text obrázku: diagram procesu ukládání HTML jako ZIP* + +## Krok 1: Načtení zdrojového HTML dokumentu + +První věc, kterou musíme udělat, je říct Aspose.HTML, kde se náš zdroj nachází. Třída `HTMLDocument` načte soubor a vytvoří DOM v paměti, připravený pro renderování. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Proč je to důležité: načtení dokumentu dává knihovně plnou kontrolu nad řešením zdrojů (obrázky, CSS, fonty). Pokud HTML odkazuje na relativní cesty, Aspose.HTML je automaticky vyřeší relativně k složce souboru. + +## Krok 2: (Volitelné) Vytvoření vlastního Resource Handleru + +Pokud potřebujete prozkoumat nebo upravit každý zdroj — například chcete komprimovat obrázky před tím, než se dostanou do archivu — můžete připojit `ResourceHandler`. Tento krok je volitelný, ale je to nejflexibilnější způsob, jak **převést HTML do ZIP archivu** s vlastní logikou. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Co když nepotřebujete žádné speciální zpracování?* Jednoduše tuto třídu přeskočte a použijte výchozí handler — Aspose.HTML zapíše zdroje přímo do ZIP. + +## Krok 3: Konfigurace možností uložení pro použití handleru + +Objekt `HtmlSaveOptions` říká rendereru, co má dělat se zdroji. Přiřazením našeho `MyResourceHandler` získáme plnou kontrolu nad výstupem. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Všimněte si, že vlastnost `ResourceHandler` přímo odkazuje na schopnost **render HTML to ZIP**. Zde se děje magie: každý propojený zdroj je streamován do archivu místo zápisu na disk. + +## Krok 4: Uložení renderovaného dokumentu do ZIP archivu + +Nyní konečně **exportujeme HTML do ZIP souboru**. Metoda `Save` přijímá libovolný `Stream`, takže ji můžeme nasměrovat na `FileStream`, který vytvoří `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +To je celý pracovní postup. Když kód skončí, `result.zip` obsahuje: + +- `input.html` (původní markup) +- Všechny odkazované obrázky, CSS soubory a fonty +- Jakékoli transformované zdroje, pokud jste je upravili v `MyResourceHandler` + +## Jak zabalit HTML soubory bez Aspose.HTML (rychlá alternativa) + +Někdy potřebujete jen klasický **jak zabalit HTML soubory** přístup, možná protože už používáte jiný HTML parser. V takovém případě můžete použít vestavěný .NET `System.IO.Compression`: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Tato metoda je jednoduchá, ale postrádá krok renderování; jen zabalí to, co je na disku. Pokud vaše HTML odkazuje na externí URL, tyto zdroje nebudou zahrnuty. Proto je cesta přes Aspose.HTML preferována, když potřebujete spolehlivé řešení **render HTML to ZIP**. + +## Okrajové případy a běžné úskalí + +| Situace | Na co si dát pozor | Doporučené řešení | +|-----------|-------------------|-----------------| +| **Velké obrázky** | Spotřeba paměti stoupá, protože každý obrázek je načten do `MemoryStream`. | Streamujte přímo do zipu pomocí vlastního handleru, který kopíruje zdrojový stream místo úplného bufferování. | +| **Externí URL** | Zdroje hostované na internetu nejsou staženy automaticky. | Nastavte `HtmlLoadOptions` s `BaseUrl` ukazujícím na kořen webu, nebo ručně stáhněte zdroje před uložením. | +| **Kolize názvů souborů** | Dva CSS soubory se stejným názvem v různých podsložkách se mohou přepsat. | Zajistěte, aby `ResourceHandler` zachovával plnou relativní cestu při zápisu do zipu. | +| **Chyby oprávnění** | Pokus o zápis do složky jen pro čtení vyvolá `UnauthorizedAccessException`. | Spusťte proces s odpovídajícími oprávněními nebo vyberte zapisovatelný výstupní adresář. | + +Řešením těchto scénářů učiníte vaši rutinu **convert HTML to ZIP archive** robustní pro produkční nasazení. + +## Kompletní funkční příklad (vše dohromady) + +Níže je kompletní, připravený program. Vložte jej do nové konzolové aplikace, aktualizujte cesty a stiskněte **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Očekávaný výstup:** Konzole vypíše zprávu o úspěchu a soubor `result.zip` obsahuje `input.html` plus všechny závislé assety. Otevřete ZIP, dvakrát klikněte na `input.html` a uvidíte stránku vykreslenou přesně tak, jak byla v prohlížeči — žádné chybějící obrázky, žádné poškozené CSS. + +## Shrnutí – Proč je tento přístup skvělý + +- **Jednostupňové renderování:** Nemusíte ručně kopírovat každý zdroj; Aspose.HTML to udělá za vás. +- **Přizpůsobitelný pipeline:** `ResourceHandler` vám dává plnou kontrolu nad tím, jak je každý soubor uložen, umožňuje kompresi, šifrování nebo transformaci za běhu. +- **Cross‑platform:** Funguje na Windows, Linuxu i macOS, pokud máte .NET runtime. +- **Žádné externí nástroje:** Celý proces **save HTML as ZIP** běží uvnitř vašeho C# kódu. + +## Co dál? + +Nyní, když ovládáte **save HTML as ZIP**, zvažte prozkoumání těchto souvisejících témat: + +- **Export HTML to PDF** – ideální pro tisknutelné reporty (znalost `export html to zip file` pomáhá, když potřebujete oba formáty). +- **Streaming ZIP přímo do HTTP odpovědi** – skvělé pro webové API, které uživatelům umožní stáhnout zabalený web za běhu. +- **Šifrování ZIP archivů** – přidejte vrstvu hesla, pokud pracujete s důvěrnou dokumentací. + +Nebojte se experimentovat: vyměňte `MyResourceHandler` za kompresor, který zmenší obrázky, nebo přidejte manifest soubor, který vypíše všechny zabalené zdroje. Možnosti jsou neomezené, když máte kontrolu nad renderovacím pipeline. + +*Šťastné kódování! Pokud narazíte na problémy nebo máte nápady na vylepšení, zanechte komentář níže. Společně to vyřešíme.* + +## Související tutoriály + +- [Jak zabalit HTML v C# – Uložit HTML do ZIP](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Uložit HTML jako ZIP – Kompletní C# tutoriál](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Uložit HTML do ZIP v C# – Kompletní In‑Memory příklad](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/dutch/net/generate-jpg-and-png-images/_index.md b/html/dutch/net/generate-jpg-and-png-images/_index.md index e05f0c0a7..50752e3ff 100644 --- a/html/dutch/net/generate-jpg-and-png-images/_index.md +++ b/html/dutch/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Leer hoe u Aspose.HTML voor .NET kunt gebruiken om HTML-documenten te bewerken, Leer hoe u antialiasing inschakelt bij het omzetten van DOCX-bestanden naar PNG- of JPG-afbeeldingen met Aspose.HTML. ### [docx naar png converteren – zip-archief maken C#-tutorial](./convert-docx-to-png-create-zip-archive-c-tutorial/) Leer hoe u een DOCX-bestand naar PNG converteert en de resultaten in een zip-archief opslaat met C# en Aspose.HTML. +### [Afbeeldingsbreedte en -hoogte instellen bij conversie van Word naar PNG – Volledige gids](./set-image-width-height-when-converting-word-to-png-full-guid/) +Leer hoe u de breedte en hoogte van afbeeldingen kunt definiëren bij het converteren van Word-documenten naar PNG met Aspose.HTML. ## Conclusie diff --git a/html/dutch/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/dutch/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..50419cdb2 --- /dev/null +++ b/html/dutch/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,277 @@ +--- +category: general +date: 2026-05-22 +description: Stel de breedte en hoogte van de afbeelding in bij het converteren van + een Word‑document naar PNG. Leer hoe je een docx exporteert als afbeelding met hoogwaardige + weergave in een stapsgewijze tutorial. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: nl +og_description: Stel de breedte en hoogte van de afbeelding in bij het converteren + van een Word‑document naar PNG. Deze tutorial laat zien hoe je een docx exporteert + als afbeelding met instellingen voor hoge kwaliteit. +og_title: Afbeeldingsbreedte en -hoogte instellen bij het converteren van Word naar + PNG – Complete gids +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Stel afbeeldingsbreedte en -hoogte in bij het converteren van Word naar PNG + – volledige gids +url: /nl/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Stel afbeeldingsbreedte en -hoogte in bij het converteren van Word naar PNG – Complete gids + +Heb je je ooit afgevraagd hoe je **afbeeldingsbreedte en -hoogte** kunt **instellen terwijl je Word naar PNG converteert**? Je bent niet de enige. Veel ontwikkelaars lopen tegen een muur aan wanneer de standaardexport een wazige afbeelding of de verkeerde afmetingen oplevert, en vervolgens besteden ze uren aan het zoeken naar een oplossing die echt werkt. + +In deze tutorial lopen we stap voor stap door een schone, end‑to‑end oplossing die laat zien **hoe je Word‑documenten rendert** als PNG‑afbeeldingen, zodat je **docx als PNG kunt opslaan** met precieze breedte‑hoogte‑controle en hoogwaardige antialiasing. Aan het einde heb je een kant‑klaar code‑fragment, een solide begrip van de API‑opties, en een paar pro‑tips om veelvoorkomende valkuilen te vermijden. + +## Wat je zult leren + +- Een `.docx`‑bestand laden met Aspose.Words for .NET. +- **Afbeeldingsbreedte en -hoogte instellen** met `ImageRenderingOptions`. +- **Docx exporteren als afbeelding** (PNG) met ingeschakelde antialiasing. +- Hoe je **Word naar PNG converteert** voor één pagina of het hele document. +- Tips voor het verwerken van grote documenten, DPI‑overwegingen en bestandspad‑beheer. + +Geen externe tools, geen rommelige command‑line gymnastics—alleen pure C#‑code die je in elk .NET‑project kunt plaatsen. + +--- + +## Vereisten + +Voordat we beginnen, zorg dat je het volgende hebt: + +| Vereiste | Waarom het belangrijk is | +|----------|--------------------------| +| **.NET 6.0+** (of .NET Framework 4.7.2) | Aspose.Words ondersteunt beide, maar nieuwere runtimes geven betere prestaties. | +| **Aspose.Words for .NET** NuGet‑package (`Install-Package Aspose.Words`) | Biedt de `Document`‑klasse en renderengine. | +| Een **Word‑document** (`.docx`) dat je wilt omzetten naar een PNG. | De bron die je gaat converteren. | +| Basiskennis van C# – je begrijpt `using`‑statements en objectinitialisatie. | Houdt de leercurve zacht. | + +Als je het NuGet‑package mist, voer dan het volgende uit in de Package Manager Console: + +```powershell +Install-Package Aspose.Words +``` + +Dat is alles—zodra het package aanwezig is, kun je beginnen met coderen. + +--- + +## Stap 1: Laad het bron‑document + +Het eerste wat je moet doen is de bibliotheek wijzen naar het Word‑bestand dat je wilt transformeren. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Waarom dit belangrijk is:** De `Document`‑klasse leest het volledige Word‑pakket in het geheugen, waardoor je toegang krijgt tot pagina's, stijlen en alles daartussen. Als het pad onjuist is, krijg je een `FileNotFoundException`, dus controleer dubbel of het bestand bestaat en of het pad escaped backslashes (`\\`) of een verbatim string (`@`) gebruikt. + +> **Pro tip:** Plaats de laad‑aanroep in een `try/catch`‑blok als je verwacht dat het bestand tijdens runtime kan ontbreken. + +--- + +## Stap 2: Configureer Image Rendering Options (Afbeeldingsbreedte en -hoogte instellen) + +Nu komt het hart van de tutorial: **hoe je afbeeldingsbreedte en -hoogte instelt** zodat de resulterende PNG niet uitgerekt of gepixeld is. De `ImageRenderingOptions`‑klasse geeft je fijne controle over afmetingen, DPI en smoothing. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Uitleg van de belangrijkste eigenschappen:** + +- `Width` en `Height` – Dit zijn de exacte pixelafmetingen die je wilt. Door ze in te stellen, **stel je afbeeldingsbreedte en -hoogte** direct in, waardoor de standaard paginagrootte wordt overschreven. +- `UseAntialiasing` – Schakelt hoogwaardige smoothing in voor tekst en vector‑graphics, wat cruciaal is wanneer je **word naar png converteert** en scherpe randen wilt. +- `Resolution` – Een hogere DPI levert meer detail, vooral bij complexe lay‑outs. Houd het geheugenverbruik in de gaten; een 300 DPI‑afbeelding kan groot worden. + +> **Waarom niet gewoon de standaardgrootte gebruiken?** De standaard gebruikt de fysieke afmetingen van de pagina (bijv. A4 op 96 DPI). Dat levert vaak een afbeelding van 794 × 1123 pixel op—prima voor sommige gevallen, maar niet wanneer je een specifieke UI‑thumbnail of een vaste preview‑grootte nodig hebt. + +--- + +## Stap 3: Renderen en opslaan als PNG (Docx exporteren als afbeelding) + +Met het document geladen en de opties geconfigureerd, kun je eindelijk **docx exporteren als afbeelding**. De `RenderToImage`‑methode doet het zware werk. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Wil je **het hele document** (alle pagina's) renderen naar afzonderlijke PNG‑bestanden, gebruik dan een lus over de paginacollectie: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Wat gebeurt er onder de motorkap?** De renderer rastert elke pagina met de door jou opgegeven afmetingen, past antialiasing toe, en schrijft een PNG‑byte‑stream naar schijf. Omdat PNG lossless is, behoud je de volledige getrouwheid van de oorspronkelijke Word‑lay‑out. + +**Verwachte output:** Een scherpe PNG‑file exact 1024 × 768 pixel (of welke grootte je ook hebt ingesteld). Open het in een willekeurige afbeeldingsviewer en je ziet de Word‑inhoud precies zoals in het originele document, maar nu als bitmap‑afbeelding. + +--- + +## Geavanceerde tips & variaties + +### 1. Transparante achtergronden behouden + +Als je Word‑document vormen met transparante achtergronden bevat en je die transparantie wilt behouden, stel dan `BackgroundColor` in op `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Alleen een specifiek bereik renderen + +Soms heb je alleen een alinea of een tabel nodig, niet de hele pagina. Gebruik `DocumentVisitor` om de node te extraheren en apart te renderen. Dat is een meer geavanceerd scenario, maar het laat zien **hoe je Word‑inhoud rendert** op een granulaire manier. + +### 3. DPI dynamisch aanpassen + +Als je per pagina een andere DPI nodig hebt (bijv. hoge resolutie voor de omslagpagina), wijzig dan `Resolution` binnen de lus: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Batch‑verwerking + +Wanneer je tientallen documenten converteert, verpak de hele flow in een methode en hergebruik dezelfde `ImageRenderingOptions`‑instantie. Het hergebruiken van het opties‑object vermindert allocatie‑overhead. + +--- + +## Veelvoorkomende valkuilen & hoe ze te vermijden + +| Symptoom | Waarschijnlijke oorzaak | Oplossing | +|----------|--------------------------|-----------| +| PNG is wazig ondanks hoge DPI | `UseAntialiasing` staat op `false` | Zet `UseAntialiasing = true`. | +| Uitvoergrootte komt niet overeen met `Width`/`Height` | DPI niet meegenomen | Vermenigvuldig gewenste grootte met `Resolution / 96` of pas `Resolution` aan. | +| Out‑of‑memory‑exception bij grote documenten | Het hele document renderen op 300 DPI | Render één pagina tegelijk, en dispose elke afbeelding na opslaan. | +| PNG toont een witte achtergrond bij transparante afbeeldingen | `BackgroundColor` niet ingesteld | Zet `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Volledig werkend voorbeeld + +Hieronder vind je een zelfstandig programma dat je kunt kopiëren‑plakken in een console‑app. Het demonstreert **word naar png converteren**, **docx als PNG opslaan**, en uiteraard **afbeeldingsbreedte en -hoogte instellen**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Uitvoeren:** Bouw het project, plaats een geldig `input.docx` op het opgegeven pad, en start het. Je zou een `output.png` moeten zien van exact **1024 × 768** pixel, gerenderd met vloeiende randen. + + +## Gerelateerde tutorials + +- [How to Enable Antialiasing When Converting DOCX to PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – create zip archive c# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [How to Use Aspose to Render HTML to PNG – Step‑by‑Step Guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/dutch/net/html-extensions-and-conversions/_index.md b/html/dutch/net/html-extensions-and-conversions/_index.md index fd924a78c..288d29239 100644 --- a/html/dutch/net/html-extensions-and-conversions/_index.md +++ b/html/dutch/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,10 @@ Aspose.HTML voor .NET is niet zomaar een bibliotheek; het is een game-changer in ## HTML-extensies en conversiehandleidingen ### [Converteer HTML naar PDF in .NET met Aspose.HTML](./convert-html-to-pdf/) Converteer moeiteloos HTML naar PDF met Aspose.HTML voor .NET. Volg onze stapsgewijze handleiding en ontketen de kracht van HTML-naar-PDF-conversie. +### [HTML renderen als PDF in C# – Volledige stap‑voor‑stap gids](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Leer hoe u HTML rendert naar PDF met C# en Aspose.HTML voor .NET via een volledige stap‑voor‑stap handleiding. +### [Converteer HTML naar PDF met C# – Complete gids](./convert-html-to-pdf-with-c-complete-guide/) +Volledige stap‑voor‑stap gids om HTML naar PDF te converteren met C# en Aspose.HTML voor .NET. ### [Converteer EPUB naar afbeelding in .NET met Aspose.HTML](./convert-epub-to-image/) Leer hoe u EPUB naar afbeeldingen converteert met Aspose.HTML voor .NET. Stapsgewijze tutorial met codevoorbeelden en aanpasbare opties. ### [Converteer EPUB naar PDF in .NET met Aspose.HTML](./convert-epub-to-pdf/) @@ -72,6 +76,8 @@ Leer hoe u met Aspose.HTML voor .NET PDF's genereert vanuit HTML met een duideli ### [HTML opslaan als ZIP – Complete C#-tutorial](./save-html-as-zip-complete-c-tutorial/) ### [HTML opslaan naar ZIP in C# – Volledig In‑Memory voorbeeld](./save-html-to-zip-in-c-complete-in-memory-example/) Leer hoe u HTML-inhoud in het geheugen comprimeert en opslaat als ZIP-bestand met Aspose.HTML voor .NET in C#. +### [HTML opslaan als ZIP – Complete gids voor Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Volledige stap‑voor‑stap gids om HTML naar een ZIP‑bestand te bewaren met Aspose.HTML voor .NET. ## Conclusie diff --git a/html/dutch/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/dutch/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..d5b7db536 --- /dev/null +++ b/html/dutch/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,257 @@ +--- +category: general +date: 2026-05-22 +description: HTML naar PDF converteren in C# met Aspose.HTML. Leer hoe je HTML naar + PDF rendert in C# met stap‑voor‑stap code, opties en Linux‑tips. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: nl +og_description: Converteer HTML naar PDF in C# met Aspose.HTML. Deze gids laat zien + hoe je HTML naar PDF rendert in C# met duidelijke opties en Linux‑vriendelijke hinting. +og_title: HTML naar PDF converteren met C# – Complete gids +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: HTML naar PDF converteren met C# – Complete gids +url: /nl/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML naar PDF converteren met C# – Complete gids + +Als je snel **HTML naar PDF moet converteren**, maakt Aspose.HTML voor .NET het een fluitje van een cent. In deze tutorial beantwoorden we ook **hoe je HTML naar PDF rendert in C#** met volledige controle over renderopties, zodat je niet meer hoeft te gokken. + +Stel je voor dat je een marketing‑e‑mailtemplate, een bonpagina of een complex rapport hebt gebouwd met moderne CSS, en je moet dit als PDF aan een klant of printer overhandigen. Handmatig doen is een gedoe, maar een paar regels C#‑code kunnen de hele pijplijn automatiseren. Aan het einde van deze gids heb je een zelfstandige, productie‑klare oplossing die werkt op Windows *en* Linux. + +## Wat je nodig hebt + +- **.NET 6.0 of later** – Aspose.HTML richt zich op .NET Standard 2.0+, dus elke recente SDK werkt. +- **Aspose.HTML for .NET** NuGet‑pakket (`Aspose.Html`) – je hebt een geldige licentie nodig voor productie, maar de gratis proefversie werkt voor testen. +- Een **eenvoudig HTML‑bestand** dat je wilt omzetten naar een PDF (we noemen het `input.html`). +- Je favoriete IDE (Visual Studio, Rider, of VS Code) – geen speciale tooling vereist. + +Dat is alles. Geen externe PDF‑converters, geen command‑line acrobatiek. Gewoon pure C#. + +![Diagram dat de workflow voor HTML naar PDF converteren met Aspose.HTML illustreert](/images/convert-html-to-pdf-workflow.png "workflow voor html naar pdf converteren") + +## HTML naar PDF converteren – Volledige implementatie + +Hieronder staat het volledige, kant‑klaar programma. Kopieer‑en‑plak het in een nieuwe console‑app, herstel de NuGet‑pakketten, en druk op **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Waarom dit werkt + +- **`Document`** is het toegangspunt van Aspose.HTML; het parseert de HTML, lost CSS op en bouwt een DOM klaar voor rendering. +- **`PdfRenderingOptions`** laat je de output aanpassen. De `UseHinting`‑vlag is de geheime saus voor scherpe tekst in headless Linux‑containers waar de standaard rasterizer wazig kan lijken. +- **`Save`** doet het zware werk: het rasteriseert de DOM op PDF‑pagina’s, respecteert pagina‑breuken en embedt lettertypen automatisch. + +Het uitvoeren van het programma genereert `output.pdf` direct naast je bronbestand. Open het met een PDF‑viewer en je zou een getrouwe visuele weergave van de originele HTML moeten zien. + +## Hoe HTML naar PDF renderen in C# – Stap‑voor‑stap + +Hieronder splitsen we het proces op in hapklare stukjes, waarbij we **uitleggen hoe je HTML naar PDF rendert in C#** en veelvoorkomende valkuilen behandelen. + +### Stap 1 – Installeer het Aspose.HTML NuGet‑pakket + +Open je terminal in de projectmap en voer uit: + +```bash +dotnet add package Aspose.Html +``` + +Als je de Visual Studio‑UI verkiest, klik met de rechtermuisknop op het project → **Manage NuGet Packages** → zoek naar **Aspose.Html** en installeer de nieuwste stabiele versie. + +> **Pro tip:** Voeg na de installatie een licentiebestand (`Aspose.Total.lic`) toe aan de root van je project om evaluatiewatermerken te vermijden. + +### Stap 2 – Laad je HTML correct + +Aspose.HTML kan verwerken: + +- Lokale bestands‑paden (`new Document("file.html")`) +- URL’s (`new Document("https://example.com")`) +- Ruwe HTML‑strings (`new Document("…", new HtmlLoadOptions())`) + +Wanneer je laadt vanaf het bestandssysteem, zorg ervoor dat het pad absoluut is of dat de werkmap correct is ingesteld, anders krijg je een `FileNotFoundException`. Op Linux gebruik je schuine strepen (`/`) of `Path.Combine`. + +### Stap 3 – Kies de juiste renderopties + +Naast `UseHinting` wil je misschien nog het volgende aanpassen: + +| Optie | Wat het doet | Wanneer te gebruiken | +|--------|--------------|----------------------| +| `PageSize` | Stelt de PDF‑paginamaten in (A4, Letter, aangepast) | Pas de doel‑papiergrootte aan | +| `Landscape` | Roteert de pagina naar landschap | Brede tabellen of grafieken | +| `RasterizeVectorGraphics` | Dwingt vector‑graphics tot raster‑afbeeldingen | Wanneer de PDF‑lezer geen SVG aankan | +| `CompressionLevel` | Regelt de beeldcompressie (0‑9) | Bestandsgrootte verkleinen voor e‑mailbijlagen | + +Je kunt deze eigenschappen vloeiend chainen: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Stap 4 – Sla de PDF op + +De `Save`‑method overload die je in het volledige voorbeeld ziet, schrijft direct naar een bestandspad. Je kunt de PDF ook naar geheugen streamen: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Dat is handig wanneer je de PDF als download wilt teruggeven vanuit een web‑API. + +### Stap 5 – Verifieer de output + +Een snelle sanity‑check is om het aantal PDF‑pagina's te vergelijken met het verwachte aantal HTML‑secties. Je kunt het teruglezen met Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Als het aantal niet klopt, bekijk dan de CSS `page-break`‑regels opnieuw of pas `PdfRenderingOptions` dienovereenkomstig aan. + +## Randgevallen & Veelvoorkomende valkuilen + +| Situatie | Waar op te letten | Oplossing | +|-----------|-------------------|----------| +| **Externe bronnen (afbeeldingen, lettertypen) ontbreken** | Relatieve URL’s worden opgelost ten opzichte van de map van het HTML‑bestand. | Gebruik `HtmlLoadOptions.BaseUri` om naar de juiste root te wijzen. | +| **Linux headless‑omgeving** | Standaard tekstrendering kan wazig zijn. | Stel `UseHinting = true` in (zoals getoond) en zorg dat `libgdiplus` geïnstalleerd is als je terugvalt op System.Drawing. | +| **Grote HTML (> 10 MB)** | Het geheugenverbruik stijgt tijdens het renderen. | Render pagina‑voor‑pagina met `PdfRenderer` en `PdfRenderingOptions` en maak elke pagina na het opslaan vrij. | +| **JavaScript‑zware pagina’s** | Aspose.HTML voert geen JS uit; dynamische inhoud blijft statisch. | Pre‑process het HTML server‑side (bijv. met Puppeteer) voordat je het aan Aspose.HTML doorgeeft. | +| **Unicode‑tekens verschijnen als vierkanten** | Ontbrekende lettertypen in de runtime‑omgeving. | Embed aangepaste lettertypen via `FontSettings` of zorg dat het OS de benodigde lettertypen heeft geïnstalleerd. | + +## Volledig werkend voorbeeld – Samenvatting + +Hier is het volledige programma opnieuw, zonder commentaren voor wie een beknopte weergave prefereert: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Voer het uit, open `output.pdf`, en je ziet een pixel‑perfecte replica van `input.html`. Dat is de essentie van **html naar pdf converteren** met Aspose.HTML. + +## Conclusie + +We hebben alles doorgenomen wat je nodig hebt om **HTML naar PDF te converteren** in C#: het installeren van Aspose.HTML, het laden van HTML, het afstemmen van renderopties (inclusief de cruciale `UseHinting`‑vlag), en het opslaan van de uiteindelijke PDF. Je begrijpt nu **hoe je HTML naar PDF rendert in C#** voor zowel Windows‑ als Linux‑omgevingen, en je hebt gezien hoe je veelvoorkomende randgevallen zoals ontbrekende bronnen en grote bestanden aanpakt. + +Wat is de volgende stap? Probeer toe te voegen: + +- **Headers/footers** met `PdfPageTemplate` voor branding. +- **Wachtwoordbeveiliging** via `PdfSaveOptions`. +- **Batch‑conversie** door over een map met + +## Gerelateerde tutorials + +- [HTML naar PDF converteren in .NET met Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [EPUB naar PDF converteren in .NET met Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [SVG naar PDF converteren in .NET met Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/dutch/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/dutch/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..b6a80b889 --- /dev/null +++ b/html/dutch/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,307 @@ +--- +category: general +date: 2026-05-22 +description: Render HTML als PDF met C# met een beknopt voorbeeld. Leer hoe je HTML + naar PDF kunt converteren met C# snel en betrouwbaar. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: nl +og_description: Render HTML als PDF in C# met een duidelijk, uitvoerbaar voorbeeld. + Deze gids laat je zien hoe je HTML naar PDF converteert in C# en een PDF genereert + vanuit een HTML‑bestand. +og_title: HTML renderen als PDF in C# – Complete programmeertutorial +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: HTML renderen als PDF in C# – Volledige stapsgewijze handleiding +url: /nl/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Render HTML als PDF in C# – Volledige stapsgewijze handleiding + +Heb je ooit **HTML als PDF moeten renderen** maar wist je niet welke bibliotheek je moet kiezen voor een .NET‑project? Je bent niet de enige. In veel line‑of‑business‑applicaties zul je **HTML naar PDF C#** moeten converteren voor facturen, rapporten of marketingbrochures – eigenlijk elke keer dat je een afdrukbare versie van een webpagina wilt. + +Het punt is: je hoeft het wiel niet opnieuw uit te vinden. Met een paar regels code kun je een `input.html`‑bestand nemen, het aan een bewezen renderengine voeren en eindigen met een scherp `output.pdf`. In deze tutorial lopen we het volledige proces door, van het toevoegen van het juiste NuGet‑pakket tot het afhandelen van randgevallen zoals externe CSS. Aan het einde kun je **PDF genereren vanuit een HTML‑bestand** in een paar minuten. + +## Wat je zult leren + +- Hoe je een .NET‑console‑app instelt die **PDF maakt vanuit HTML C#** code. +- De exacte API‑aanroepen die je nodig hebt om **HTML‑document op te slaan als PDF**. +- Waarom bepaalde renderopties (zoals hinting) belangrijk zijn voor de tekstkwaliteit. +- Tips voor het oplossen van veelvoorkomende valkuilen zoals ontbrekende lettertypen of relatieve afbeeldingspaden. + +**Prerequisites** – je moet .NET 6+ of .NET Framework 4.7 geïnstalleerd hebben, een basiskennis van C#, en een IDE (Visual Studio 2022, Rider, of VS Code). Er is geen eerdere PDF‑ervaring vereist. + +--- + +## Render HTML als PDF – Het project opzetten + +Voordat we in de code duiken, laten we ervoor zorgen dat de ontwikkelomgeving klaar is. De bibliotheek die we gaan gebruiken is **Select.Pdf** (gratis voor niet‑commercieel gebruik) omdat deze een eenvoudige API en solide renderkwaliteit biedt. + +### Installeer de PDF‑renderbibliotheek (convert html to pdf c#) + +Open een terminal in je projectmap en voer uit: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Als je Visual Studio gebruikt, kun je het pakket ook toevoegen via de NuGet Package Manager‑UI. Het versienummer kan nieuwer zijn – pak gewoon de laatste stabiele release. + +### Create a console skeleton + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Dat is alle boilerplate die je nodig hebt. Het zware werk gebeurt binnen `Main`. + +--- + +## Laad het HTML‑document (generate pdf from html file) + +De eerste echte stap is de renderer te wijzen naar een HTML‑bestand op schijf. Select.Pdf biedt twee handige manieren: een ruwe HTML‑string doorgeven of een bestandspad. Een bestand gebruiken houdt alles overzichtelijk, vooral wanneer je gekoppelde CSS of afbeeldingen hebt. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Hier beschermen we ook tegen een ontbrekend bestand – iets dat beginners in de problemen brengt wanneer ze vergeten de HTML naar de output‑map te kopiëren. + +--- + +## Configureer renderopties (create pdf from html c#) + +Select.Pdf wordt geleverd met een rijk `PdfDocumentOptions`‑object. Voor scherpe tekst schakelen we hinting in, wat glyphs gladstrijkt tegen een minimale prestatie‑impact. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Je kunt hier paginagrootte, marges of zelfs een aangepast lettertype insluiten aanpassen. Het belangrijkste is dat **render html as pdf** geen één‑regelige oplossing is; je hebt controle over het uiterlijk en gevoel van het uiteindelijke document. + +--- + +## Sla HTML‑document op als PDF (render html as pdf) + +Nu gebeurt de magie. We geven de converter het pad naar ons HTML‑bestand en vragen het een PDF naar schijf te schrijven. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +De methode `ConvertUrl` lost automatisch relatieve URL’s (afbeeldingen, CSS) op op basis van de locatie van het HTML‑bestand, waardoor deze aanpak robuust is voor de meeste real‑world scenario’s. + +### Verwachte output + +Na het uitvoeren van het programma zou je een bestand `output.pdf` in dezelfde map moeten zien. Open het – je zult merken: + +- Tekst gerenderd met duidelijke anti‑aliasing (dankzij hinting). +- Stijlen van gekoppelde CSS correct toegepast. +- Afbeeldingen weergegeven op de exacte grootte die in de bron‑HTML is gedefinieerd. + +Als er iets niet klopt, controleer dan of de CSS‑ en afbeeldingsbestanden naast `input.html` staan of gebruik absolute URL’s. + +--- + +## Veelvoorkomende randgevallen afhandelen + +### 1. Externe bronnen geblokkeerd door firewalls + +Als je HTML verwijst naar lettertypen gehost op een CDN die je server niet kan bereiken, kan de PDF terugvallen op een generiek lettertype. Om dit te voorkomen, download je de lettertypebestanden lokaal of embed je ze met `@font-face` en een relatief pad. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Zeer grote HTML‑bestanden + +Bij het converteren van enorme documenten kun je geheugenlimieten bereiken. Select.Pdf laat je de conversie streamen: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Streaming houdt het proces lichtgewicht, maar vereist dat je de HTML als string aanlevert, die je indien nodig in stukken kunt lezen. + +### 3. Aangepaste headers of footers + +Als je een paginanummer of bedrijfslogo op elke pagina nodig hebt, stel je de `Header`‑ en `Footer`‑eigenschappen in op `converter.Options` voordat je `ConvertUrl` aanroept. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Volledig werkend voorbeeld (alle stappen gecombineerd) + +Hieronder staat het volledige, kant‑klaar‑te‑kopiëren programma. Vervang `YOUR_DIRECTORY` door het absolute pad waar je HTML zich bevindt. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** `dotnet run` vanuit de projectmap. Als alles correct is ingesteld zie je het succesbericht en een glanzende `output.pdf`. + +--- + +## Visuele samenvatting + +![Render HTML als PDF voorbeeld](render-html-as-pdf.png){alt="render html als pdf voorbeeld"} + +De screenshot toont de console‑output en de resulterende PDF geopend in een viewer. Let op de scherpe koppen en correct geladen afbeeldingen – precies wat je verwacht wanneer je **render html as pdf**. + +## Conclusie + +Je hebt zojuist geleerd hoe je **HTML als PDF kunt renderen** in een C#‑applicatie, van het installeren van de bibliotheek tot het fijn afstellen van renderopties. Het volledige voorbeeld toont een betrouwbare manier om **HTML naar PDF C# te converteren**, **PDF te genereren vanuit een HTML‑bestand**, en **HTML‑document op te slaan als PDF** met slechts een handvol regels. + +Wat is het volgende? Probeer te experimenteren met: + +- Aangepaste lettertypen toevoegen voor merkconsistentie. +- PDF’s genereren vanuit dynamische HTML‑strings (bijv. Razor‑templates). +- Meerdere PDF’s samenvoegen tot één rapport met `PdfDocument.AddPage`. + +Elk van deze uitbreidingen bouwt voort op de kernconcepten die hier behandeld zijn, zodat je klaar bent om meer geavanceerde scenario’s aan te pakken zonder een steile leercurve. + +Heb je vragen of ben je tegen een probleem aangelopen? Laat een reactie achter hieronder, en laten we samen het probleem oplossen. Happy coding! + +## Gerelateerde tutorials + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Create HTML Document with Styled Text and Export to PDF – Full Guide](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Convert HTML to PDF with Aspose.HTML – Full Manipulation Guide](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/dutch/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/dutch/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..6ff19eae3 --- /dev/null +++ b/html/dutch/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,229 @@ +--- +category: general +date: 2026-05-22 +description: Sla HTML snel op als ZIP met Aspose.HTML. Leer hoe je HTML‑bestanden + zipt, HTML rendert naar ZIP en HTML exporteert naar een ZIP‑bestand met volledige + code. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: nl +og_description: Sla HTML op als ZIP met Aspose.HTML. Deze gids laat zien hoe je HTML + naar ZIP rendert, HTML exporteert naar een ZIP‑bestand en HTML‑bestanden programmatic + zip. +og_title: HTML opslaan als ZIP – Volledige Aspose.HTML‑tutorial +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: HTML opslaan als ZIP – Complete gids voor Aspose.HTML +url: /nl/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML opslaan als ZIP – Complete gids voor Aspose.HTML + +Heb je je ooit afgevraagd hoe je **HTML als ZIP kunt opslaan** zonder een apart archiveringshulpmiddel te gebruiken? Je bent niet de enige. Veel ontwikkelaars moeten een HTML‑pagina bundelen met zijn afbeeldingen, CSS en scripts voor eenvoudige distributie, en dit handmatig doen wordt al snel een pijnpunt. + +In deze tutorial lopen we een schone, end‑to‑end oplossing door die **HTML rendert naar ZIP** met Aspose.HTML voor .NET. Aan het einde weet je precies hoe je **HTML exporteert naar een ZIP‑bestand**, en zie je ook variaties voor **hoe je HTML‑bestanden zipt** in verschillende scenario’s. + +> *Pro tip:* De getoonde aanpak werkt zowel bij het verpakken van één enkele pagina als van een volledige site‑map. + +## Wat je nodig hebt + +Voordat we beginnen, zorg dat je het volgende hebt: + +- .NET 6 (of een recente .NET‑runtime) geïnstalleerd. +- Het Aspose.HTML for .NET NuGet‑pakket (`Aspose.Html`) toegevoegd aan je project. +- Een eenvoudig `input.html`‑bestand in een map die je beheert. +- Een beetje C#‑comfort – niets fancy, alleen de basis. + +Dat is alles. Geen externe zip‑hulpmiddelen, geen command‑line acrobatiek. Laten we beginnen. + +![Diagram die het proces van HTML opslaan als ZIP met Aspose.HTML toont](save-html-as-zip.png) + +*Afbeeldings‑alt‑tekst: diagram van het proces HTML opslaan als ZIP* + +## Stap 1: Laad het bron‑HTML‑document + +Het eerste wat we moeten doen is Aspose.HTML vertellen waar onze bron zich bevindt. De `HTMLDocument`‑klasse leest het bestand en bouwt een in‑memory DOM, klaar om gerenderd te worden. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Waarom dit belangrijk is: het laden van het document geeft de bibliotheek volledige controle over resource‑resolutie (afbeeldingen, CSS, fonts). Als de HTML relatieve paden gebruikt, lost Aspose.HTML deze automatisch op ten opzichte van de map van het bestand. + +## Stap 2: (Optioneel) Maak een aangepaste Resource Handler + +Als je elke resource wilt inspecteren of manipuleren – bijvoorbeeld om afbeeldingen te comprimeren voordat ze in het archief komen – kun je een `ResourceHandler` aansluiten. Deze stap is optioneel, maar het is de meest flexibele manier om **HTML naar ZIP‑archief te converteren** met aangepaste logica. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Wat als je geen speciale verwerking nodig hebt?* Sla deze klasse dan over en gebruik de standaard handler – Aspose.HTML schrijft de resources direct naar de ZIP. + +## Stap 3: Configureer Save‑opties om de handler te gebruiken + +Het `HtmlSaveOptions`‑object vertelt de renderer wat er met de resources moet gebeuren. Door onze `MyResourceHandler` toe te wijzen, krijgen we volledige controle over de output. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Let op hoe de eigenschapsnaam `ResourceHandler` direct verwijst naar de **render HTML to ZIP**‑functionaliteit. Hier gebeurt de magie: elke gekoppelde resource wordt gestreamd naar het archief in plaats van naar schijf geschreven. + +## Stap 4: Sla het gerenderde document op in een ZIP‑archief + +Nu exporteren we eindelijk **HTML naar een ZIP‑bestand**. De `Save`‑methode accepteert elke `Stream`, dus we kunnen hem laten wijzen naar een `FileStream` die `result.zip` aanmaakt. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Dat is de volledige workflow. Wanneer de code klaar is, bevat `result.zip`: + +- `input.html` (de oorspronkelijke markup) +- Alle verwezen afbeeldingen, CSS‑bestanden en fonts +- Eventuele getransformeerde resources als je ze in `MyResourceHandler` hebt aangepast + +## Hoe HTML‑bestanden zippen zonder Aspose.HTML (Snelle alternatieve methode) + +Soms heb je gewoon een ouderwetse **hoe je HTML‑bestanden zipt**‑aanpak nodig, bijvoorbeeld omdat je al een andere HTML‑parser gebruikt. In dat geval kun je .NET’s ingebouwde `System.IO.Compression` gebruiken: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Deze methode is simpel maar mist de renderstap; hij verpakt alleen wat er op schijf staat. Als je HTML externe URL’s verwijst, worden die resources niet meegenomen. Daarom heeft de Aspose.HTML‑route de voorkeur wanneer je een betrouwbare **render HTML to ZIP**‑oplossing nodig hebt. + +## Randgevallen & Veelvoorkomende valkuilen + +| Situatie | Waar je op moet letten | Aanbevolen oplossing | +|-----------|------------------------|----------------------| +| **Grote afbeeldingen** | Het geheugenverbruik stijgt omdat elke afbeelding in een `MemoryStream` wordt geladen. | Stream direct naar de zip met een aangepaste handler die de bron‑stream kopieert in plaats van volledig te bufferen. | +| **Externe URL’s** | Resources die op internet gehost worden, worden niet automatisch gedownload. | Stel `HtmlLoadOptions` in met `BaseUrl` die naar de site‑root wijst, of download resources handmatig vóór het opslaan. | +| **Bestandsnaam‑conflicten** | Twee CSS‑bestanden met dezelfde naam in verschillende submappen kunnen elkaar overschrijven. | Zorg ervoor dat de `ResourceHandler` het volledige relatieve pad behoudt bij het schrijven naar de zip. | +| **Toestemmingsfouten** | Schrijven naar een alleen‑lezen map veroorzaakt `UnauthorizedAccessException`. | Voer het proces uit met de juiste rechten of kies een schrijfbare doelmap. | + +Door deze scenario’s aan te pakken, wordt je **convert HTML to ZIP archive**‑routine robuust voor productiegebruik. + +## Volledig werkend voorbeeld (Alle onderdelen samen) + +Hieronder staat het complete, kant‑en‑klaar programma. Plak het in een nieuwe console‑app, werk de paden bij en druk op **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Verwachte output:** De console toont een succesbericht, en het `result.zip`‑bestand bevat `input.html` plus alle afhankelijke assets. Open de ZIP, dubbel‑klik `input.html`, en je ziet de pagina exact zoals die in de browser werd weergegeven – geen missende afbeeldingen, geen kapotte CSS. + +## Samenvatting – Waarom deze aanpak geweldig is + +- **Single‑step rendering:** Je hoeft niet handmatig elke resource te kopiëren; Aspose.HTML doet het voor je. +- **Aanpasbare pipeline:** De `ResourceHandler` geeft volledige controle over hoe elk bestand wordt opgeslagen, waardoor compressie, encryptie of on‑the‑fly transformatie mogelijk is. +- **Cross‑platform:** Werkt op Windows, Linux en macOS zolang je een .NET‑runtime hebt. +- **Geen externe tools:** Het volledige **save HTML as ZIP**‑proces leeft binnen je C#‑codebase. + +## Wat is het vervolg? + +Nu je **HTML opslaan als ZIP** onder de knie hebt, kun je deze gerelateerde onderwerpen verkennen: + +- **HTML exporteren naar PDF** – perfect voor afdrukbare rapporten (de kennis van `export html to zip file` helpt wanneer je beide formaten nodig hebt). +- **ZIP direct streamen naar HTTP‑response** – ideaal voor web‑API’s die gebruikers een verpakte site on‑the‑fly laten downloaden. +- **ZIP‑archieven versleutelen** – voeg een wachtwoord toe als je met vertrouwelijke documentatie werkt. + +Voel je vrij om te experimenteren: vervang de `MyResourceHandler` door een compressor die afbeeldingen verkleint, of voeg een manifest‑bestand toe dat alle gebundelde resources opsomt. De mogelijkheden zijn eindeloos zodra je de render‑pipeline beheerst. + +--- + +*Happy coding! Als je tegen problemen aanloopt of ideeën hebt voor verbetering, laat dan een reactie achter hieronder. We lossen het samen op.* + +## Gerelateerde tutorials + +- [Hoe HTML zippen in C# – HTML opslaan naar Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [HTML opslaan als ZIP – Complete C#‑tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [HTML opslaan naar ZIP in C# – Volledig in‑memory voorbeeld](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/english/net/generate-jpg-and-png-images/_index.md b/html/english/net/generate-jpg-and-png-images/_index.md index 3cc4b6acd..8d68d13e7 100644 --- a/html/english/net/generate-jpg-and-png-images/_index.md +++ b/html/english/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Learn to use Aspose.HTML for .NET to manipulate HTML documents, convert HTML to Learn how to enable antialiasing for sharper PNG/JPG output when converting DOCX files using Aspose.HTML for .NET. ### [convert docx to png – create zip archive c# tutorial](./convert-docx-to-png-create-zip-archive-c-tutorial/) Learn how to convert DOCX files to PNG images and package them into a ZIP archive using C# and Aspose.HTML. +### [Set Image Width Height When Converting Word to PNG – Full Guide](./set-image-width-height-when-converting-word-to-png-full-guid/) +Learn how to set custom width and height for PNG images generated from Word documents using Aspose.HTML for .NET. ## Conclusion diff --git a/html/english/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/english/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..b35917a5e --- /dev/null +++ b/html/english/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,273 @@ +--- +category: general +date: 2026-05-22 +description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: en +og_description: Set image width height while converting a Word document to PNG. This + tutorial shows how to export docx as image with high‑quality settings. +og_title: Set Image Width Height When Converting Word to PNG – Complete Guide +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Set Image Width Height When Converting Word to PNG – Full Guide +url: /net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Set Image Width Height When Converting Word to PNG – Complete Guide + +Ever wondered how to **set image width height** while you **convert Word to PNG**? You're not the only one. Many developers hit a wall when the default export gives a blurry picture or the wrong dimensions, and then they spend hours hunting for a fix that actually works. + +In this tutorial we’ll walk through a clean, end‑to‑end solution that shows **how to render word** documents as PNG images, letting you **save docx as PNG** with precise width‑height control and high‑quality antialiasing. By the end you’ll have a ready‑to‑run code snippet, a solid understanding of the API options, and a few pro tips to avoid common pitfalls. + +## What You’ll Learn + +- Load a `.docx` file using Aspose.Words for .NET. +- **Set image width height** with `ImageRenderingOptions`. +- **Export docx as image** (PNG) with antialiasing enabled. +- How to **convert word to png** for a single page or the whole document. +- Tips for handling large documents, DPI considerations, and file‑system paths. + +No external tools, no messy command‑line gymnastics—just pure C# code that you can drop into any .NET project. + +--- + +## Prerequisites + +Before we dive in, make sure you have the following: + +| Requirement | Why it matters | +|-------------|----------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words supports both, but newer runtimes give better performance. | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | Provides the `Document` class and rendering engine. | +| A **Word document** (`.docx`) you want to turn into a PNG. | The source you’ll be converting. | +| Basic C# knowledge – you’ll understand `using` statements and object initialization. | Keeps the learning curve gentle. | + +If you’re missing the NuGet package, run this in the Package Manager Console: + +```powershell +Install-Package Aspose.Words +``` + +That’s it—once the package is in place, you’re ready to start coding. + +--- + +## Step 1: Load the Source Document + +The very first thing you need to do is point the library at the Word file you want to transform. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Why this matters:** The `Document` class reads the entire Word package into memory, giving you access to pages, styles, and everything else. If the path is wrong, you’ll get a `FileNotFoundException`, so double‑check that the file exists and the path uses escaped backslashes (`\\`) or a verbatim string (`@`). + +> **Pro tip:** Wrap the load call in a `try/catch` block if you expect the file might be missing at runtime. + +--- + +## Step 2: Configure Image Rendering Options (Set Image Width Height) + +Now comes the heart of the tutorial: **how to set image width height** so the resulting PNG isn’t stretched or pixelated. The `ImageRenderingOptions` class gives you fine‑grained control over dimensions, DPI, and smoothing. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Explanation of the key properties:** + +- `Width` and `Height` – These are the exact pixel dimensions you want. By setting them, you **set image width height** directly, overriding the default page size. +- `UseAntialiasing` – Enables high‑quality smoothing for text and vector graphics, which is crucial when you **convert word to png** and want crisp edges. +- `Resolution` – Higher DPI yields more detail, especially for complex layouts. Keep an eye on memory usage; a 300 DPI image can be large. + +> **Why not just rely on the default size?** The default uses the page’s physical dimensions (e.g., A4 at 96 DPI). That often produces a 794 × 1123 pixel image—fine for some cases but not when you need a specific UI thumbnail or a fixed‑size preview. + +--- + +## Step 3: Render and Save as PNG (Export Docx as Image) + +With the document loaded and options configured, you can finally **export docx as image**. The `RenderToImage` method does the heavy lifting. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +If you want to render **the whole document** (all pages) into separate PNG files, loop over the page collection: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**What’s happening under the hood?** The renderer rasterizes each page using the dimensions you supplied, applies antialiasing, and writes a PNG byte stream to disk. Because PNG is lossless, you retain the full fidelity of the original Word layout. + +**Expected output:** A crisp PNG file exactly 1024 × 768 pixels (or whatever size you set). Open it in any image viewer and you’ll see the Word content rendered exactly as it appears in the original document, but now as a bitmap image. + +--- + +## Advanced Tips & Variations + +### 1. Preserve Transparent Backgrounds + +If your Word document contains shapes with transparent backgrounds and you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Render Only a Specific Range + +Sometimes you only need a paragraph or a table, not the whole page. Use `DocumentVisitor` to extract the node and render it separately. That’s a more advanced scenario, but it shows **how to render word** content at a granular level. + +### 3. Adjust DPI Dynamically + +If you need different DPI per page (e.g., high‑resolution for the cover page), modify `Resolution` inside the loop: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Batch Processing + +When converting dozens of documents, wrap the whole flow in a method and reuse the same `ImageRenderingOptions` instance. Re‑using the options object reduces allocation overhead. + +--- + +## Common Pitfalls & How to Avoid Them + +| Symptom | Likely Cause | Fix | +|---------|--------------|-----| +| PNG is blurry despite high DPI | `UseAntialiasing` left `false` | Set `UseAntialiasing = true`. | +| Output size doesn’t match `Width`/`Height` | DPI not considered | Multiply desired size by `Resolution / 96` or adjust `Resolution`. | +| Out‑of‑memory exception on large docs | Rendering whole document at 300 DPI | Render one page at a time, dispose of each image after saving. | +| PNG shows a white background on transparent images | `BackgroundColor` not set | Set `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Complete Working Example + +Below is a self‑contained program you can copy‑paste into a console app. It demonstrates **convert word to png**, **save docx as png**, and of course **set image width height**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Run it:** Build the project, place a valid `input.docx` at the path you specified, and execute. You should see a `output.png` exactly **1024 × 768** pixels, rendered with smooth edges. + + +## Related Tutorials + +- [How to Enable Antialiasing When Converting DOCX to PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – create zip archive c# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [How to Use Aspose to Render HTML to PNG – Step‑by‑Step Guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/english/net/html-extensions-and-conversions/_index.md b/html/english/net/html-extensions-and-conversions/_index.md index a50bc9ccb..3ac2af72c 100644 --- a/html/english/net/html-extensions-and-conversions/_index.md +++ b/html/english/net/html-extensions-and-conversions/_index.md @@ -41,6 +41,10 @@ Aspose.HTML for .NET is not just a library; it's a game-changer in the world of Convert HTML to PDF effortlessly with Aspose.HTML for .NET. Follow our step-by-step guide and unleash the power of HTML-to-PDF conversion. ### [Create PDF from HTML – C# Step‑by‑Step Guide](./create-pdf-from-html-c-step-by-step-guide/) Learn how to generate PDF files from HTML using Aspose.HTML for .NET with a detailed C# step‑by‑step guide. +### [Convert HTML to PDF with C# – Complete Guide](./convert-html-to-pdf-with-c-complete-guide/) +Learn how to convert HTML to PDF using C# and Aspose.HTML with a comprehensive step-by-step guide. +### [Render HTML as PDF in C# – Full Step‑by‑Step Guide](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Learn how to render HTML to PDF using C# and Aspose.HTML with a comprehensive step‑by‑step guide. ### [Convert EPUB to Image in .NET with Aspose.HTML](./convert-epub-to-image/) Learn how to convert EPUB to images using Aspose.HTML for .NET. Step-by-step tutorial with code examples and customizable options. ### [Convert EPUB to PDF in .NET with Aspose.HTML](./convert-epub-to-pdf/) @@ -71,6 +75,8 @@ Learn how to zip HTML files in C# using Aspose.HTML, saving HTML content to a ZI Learn how to create an HTML document with styled text and export it to PDF using Aspose.HTML for .NET in this comprehensive guide. ### [Save HTML as ZIP – Complete C# Tutorial](./save-html-as-zip-complete-c-tutorial/) Learn how to save HTML files as a ZIP archive using Aspose.HTML for .NET with a complete C# example. +### [Save HTML as ZIP – Complete Guide for Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Learn how to save HTML files as a ZIP archive using Aspose.HTML for .NET in this comprehensive guide. ### [Convert EPUB to Image in .NET with Aspose.HTML](./convert-epub-to-image/) Learn how to convert EPUB to images using Aspose.HTML for .NET. Step-by-step tutorial with code examples and customizable options. ### [Convert EPUB to PDF in .NET with Aspose.HTML](./convert-epub-to-pdf/) diff --git a/html/english/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/english/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..8ffc87eb6 --- /dev/null +++ b/html/english/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,260 @@ +--- +category: general +date: 2026-05-22 +description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: en +og_description: Convert HTML to PDF in C# with Aspose.HTML. This guide shows how to + render HTML to PDF in C# using clear options and Linux‑friendly hinting. +og_title: Convert HTML to PDF with C# – Complete Guide +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Convert HTML to PDF with C# – Complete Guide +url: /net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convert HTML to PDF with C# – Complete Guide + +If you need to **convert HTML to PDF** quickly, Aspose.HTML for .NET makes it a breeze. In this tutorial we’ll also answer **how to render HTML to PDF in C#** with full control over rendering options, so you won’t be left guessing. + +Imagine you have a marketing email template, a receipt page, or a complex report built with modern CSS, and you must hand it off as a PDF to a client or a printer. Doing that manually is a pain, but a few lines of C# code can automate the whole pipeline. By the end of this guide you’ll have a self‑contained, production‑ready solution that works on Windows *and* Linux. + +## What You’ll Need + +Before we dive in, make sure you have the following: + +- **.NET 6.0 or later** – Aspose.HTML targets .NET Standard 2.0+, so any recent SDK works. +- **Aspose.HTML for .NET** NuGet package (`Aspose.Html`) – you’ll need a valid license for production, but the free trial works for testing. +- A **simple HTML file** you want to turn into a PDF (we’ll call it `input.html`). +- Your favorite IDE (Visual Studio, Rider, or VS Code) – no special tooling required. + +That’s it. No external PDF converters, no command‑line gymnastics. Just pure C#. + +![Diagram illustrating the convert html to pdf workflow using Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## Convert HTML to PDF – Full Implementation + +Below is the complete, ready‑to‑run program. Copy‑paste it into a new console app, restore NuGet packages, and hit **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Why This Works + +- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves CSS, and builds a DOM ready for rendering. +- **`PdfRenderingOptions`** lets you tweak the output. The `UseHinting` flag is the secret sauce for crisp text on headless Linux containers where the default rasterizer can look fuzzy. +- **`Save`** does the heavy lifting: it rasterizes the DOM onto PDF pages, respects page breaks, and embeds fonts automatically. + +Running the program will generate `output.pdf` right next to your source file. Open it with any PDF viewer and you should see a faithful visual match of the original HTML. + +## How to Render HTML to PDF in C# – Step‑by‑Step + +Below we break the process down into bite‑size pieces, explaining **how to render HTML to PDF in C#** while covering common pitfalls. + +### Step 1 – Install the Aspose.HTML NuGet Package + +Open your terminal in the project folder and execute: + +```bash +dotnet add package Aspose.Html +``` + +If you prefer the Visual Studio UI, right‑click the project → **Manage NuGet Packages** → search for **Aspose.Html** and install the latest stable version. + +> **Pro tip:** After installing, add a license file (`Aspose.Total.lic`) to the root of your project to avoid evaluation watermarks. + +### Step 2 – Load Your HTML Correctly + +Aspose.HTML can ingest: + +- Local file paths (`new Document("file.html")`) +- URLs (`new Document("https://example.com")`) +- Raw HTML strings (`new Document("…", new HtmlLoadOptions())`) + +When you load from the file system, make sure the path is absolute or the working directory is set appropriately, otherwise you’ll hit a `FileNotFoundException`. On Linux, use forward slashes (`/`) or `Path.Combine`. + +### Step 3 – Choose the Right Rendering Options + +Aside from `UseHinting`, you might want to adjust: + +| Option | What it does | When to use it | +|--------|--------------|----------------| +| `PageSize` | Sets the PDF page dimensions (A4, Letter, custom) | Match the target paper size | +| `Landscape` | Rotates the page to landscape | Wide tables or charts | +| `RasterizeVectorGraphics` | Forces vector graphics to raster images | When the PDF consumer can’t handle SVG | +| `CompressionLevel` | Controls image compression (0‑9) | Reduce file size for email attachments | + +You can chain these properties fluently: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Step 4 – Save the PDF + +The `Save` method overload you see in the full example writes directly to a file path. You can also stream the PDF to memory: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +That’s handy when you need to return the PDF as a download from a web API. + +### Step 5 – Verify the Output + +A quick sanity check is to compare the PDF page count with the expected number of HTML sections. You can read it back with Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +If the count looks off, revisit CSS `page-break` rules or adjust `PdfRenderingOptions` accordingly. + +## Edge Cases & Common Gotchas + +| Situation | What to watch for | Fix | +|-----------|-------------------|-----| +| **External resources (images, fonts) missing** | Relative URLs resolve against the HTML file’s folder. | Use `HtmlLoadOptions.BaseUri` to point to the correct root. | +| **Linux headless environment** | Default text rendering may be blurry. | Set `UseHinting = true` (as shown) and ensure `libgdiplus` is installed if you fall back to System.Drawing. | +| **Large HTML (> 10 MB)** | Memory consumption spikes during rendering. | Render page‑by‑page using `PdfRenderer` with `PdfRenderingOptions` and dispose each page after saving. | +| **JavaScript‑heavy pages** | Aspose.HTML does not execute JS; dynamic content stays static. | Pre‑process the HTML server‑side (e.g., using Puppeteer) before feeding it to Aspose.HTML. | +| **Unicode characters showing as squares** | Missing fonts in the runtime environment. | Embed custom fonts via `FontSettings` or ensure the OS has the required fonts installed. | + +## Full Working Example Recap + +Here’s the entire program again, stripped of comments for those who prefer a concise view: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Run it, open `output.pdf`, and you’ll see a pixel‑perfect replica of `input.html`. That’s the essence of **convert html to pdf** with Aspose.HTML. + +## Conclusion + +We’ve walked through everything you need to **convert HTML to PDF** in C#: installing Aspose.HTML, loading HTML, tweaking rendering options (including the crucial `UseHinting` flag), and saving the final PDF. You now understand **how to render HTML to PDF in C#** for both Windows and Linux environments, and you’ve seen how to handle common edge cases like missing resources and large files. + +What’s next? Try adding: + +- **Headers/footers** with `PdfPageTemplate` for branding. +- **Password protection** via `PdfSaveOptions`. +- **Batch conversion** by looping over a folder of + + +## Related Tutorials + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Convert EPUB to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Convert SVG to PDF in .NET with Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/english/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/english/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..e1c4811a3 --- /dev/null +++ b/html/english/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,309 @@ +--- +category: general +date: 2026-05-22 +description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: en +og_description: Render HTML as PDF in C# with a clear, runnable example. This guide + shows you how to convert HTML to PDF C# and generate PDF from HTML file. +og_title: Render HTML as PDF in C# – Complete Programming Tutorial +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Render HTML as PDF in C# – Full Step‑by‑Step Guide +url: /net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Render HTML as PDF in C# – Full Step‑by‑Step Guide + +Ever needed to **render HTML as PDF** but weren’t sure which library to pick for a .NET project? You’re not alone. In many line‑of‑business apps you’ll find yourself needing to **convert HTML to PDF C#** for invoices, reports, or marketing brochures—basically any time you want a printable version of a web page. + +Here’s the thing: you don’t have to reinvent the wheel. With a few lines of code you can take an `input.html` file, feed it to a proven rendering engine, and end up with a crisp `output.pdf`. In this tutorial we’ll walk through the entire process, from adding the right NuGet package to handling edge‑cases like external CSS. By the end you’ll be able to **generate PDF from HTML file** in a matter of minutes. + +## What You’ll Learn + +- How to set up a .NET console app that **creates PDF from HTML C#** code. +- The exact API calls you need to **save HTML document as PDF**. +- Why certain rendering options (like hinting) matter for text quality. +- Tips for troubleshooting common pitfalls such as missing fonts or relative image paths. + +**Prerequisites** – you should have .NET 6+ or .NET Framework 4.7 installed, a basic familiarity with C#, and an IDE (Visual Studio 2022, Rider, or VS Code). No prior PDF experience required. + +--- + +## Render HTML as PDF – Setting Up the Project + +Before we dive into code, let’s make sure the development environment is ready. The library we’ll use is **Select.Pdf** (free for non‑commercial use) because it offers a simple API and solid rendering fidelity. + +### Install the PDF rendering library (convert html to pdf c#) + +Open a terminal in your project folder and run: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* If you’re using Visual Studio, you can also add the package via the NuGet Package Manager UI. The version number may be newer—just grab the latest stable release. + +### Create a console skeleton + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +That’s all the boilerplate you need. The heavy lifting happens inside `Main`. + +--- + +## Load the HTML Document (generate pdf from html file) + +The first real step is to point the renderer at an HTML file on disk. Select.Pdf offers two convenient ways: passing raw HTML string or a file path. Using a file keeps things tidy, especially when you have linked CSS or images. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Here we also guard against a missing file—something that trips up beginners when they forget to copy the HTML into the output folder. + +--- + +## Configure Rendering Options (create pdf from html c#) + +Select.Pdf ships with a rich `PdfDocumentOptions` object. For crisp text we enable hinting, which smooths glyphs at the cost of a tiny performance hit. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +You can tweak page size, margins, or even embed a custom font here. The key takeaway is that **render html as pdf** isn’t just a one‑liner; you have control over the final document’s look and feel. + +--- + +## Save HTML Document as PDF (render html as pdf) + +Now the magic happens. We hand the converter the path to our HTML file and ask it to write a PDF to disk. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +The method `ConvertUrl` automatically resolves relative URLs (images, CSS) based on the HTML file’s location, which is why this approach is robust for most real‑world scenarios. + +### Expected output + +After running the program you should see a file `output.pdf` in the same folder. Open it—you’ll notice: + +- Text rendered with clear anti‑aliasing (thanks to hinting). +- Styles from linked CSS applied correctly. +- Images displayed at the exact size defined in the source HTML. + +If anything looks off, double‑check that the CSS and image files are placed alongside `input.html` or use absolute URLs. + +--- + +## Handling Common Edge Cases + +### 1. External resources blocked by firewalls + +If your HTML references fonts hosted on a CDN that your server can’t reach, the PDF may fall back to a generic font. To avoid this, either download the font files locally or embed them using `@font-face` with a relative path. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Very large HTML files + +When converting massive documents, you might hit memory limits. Select.Pdf lets you stream the conversion: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Streaming keeps the process lightweight but requires you to supply the HTML as a string, which you can read in chunks if needed. + +### 3. Custom headers or footers + +If you need a page number or company logo on every page, set the `Header` and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Full Working Example (All Steps Combined) + +Below is the complete, copy‑and‑paste‑ready program. Replace `YOUR_DIRECTORY` with the absolute path where your HTML lives. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** `dotnet run` from the project directory. If everything is set up correctly you’ll see the success message and a shiny `output.pdf`. + +--- + +## Visual Summary + +![Render HTML as PDF example](render-html-as-pdf.png){alt="render html as pdf example"} + +The screenshot shows the console output and the resulting PDF opened in a viewer. Notice the crisp headings and correctly loaded images—exactly what you expect when you **render html as pdf**. + +--- + +## Conclusion + +You’ve just learned how to **render HTML as PDF** in a C# application, from installing the library to fine‑tuning rendering options. The full example demonstrates a reliable way to **convert HTML to PDF C#**, **generate PDF from HTML file**, and **save HTML document as PDF** with just a handful of lines. + +What’s next? Try experimenting with: + +- Adding custom fonts for brand consistency. +- Generating PDFs from dynamic HTML strings (e.g., Razor templates). +- Merging multiple PDFs into a single report using `PdfDocument.AddPage`. + +Each of those extensions builds on the core concepts covered here, so you’ll be ready to tackle more advanced scenarios without a steep learning curve. + +Got questions or ran into a hiccup? Drop a comment below, and let’s troubleshoot together. Happy coding! + + +## Related Tutorials + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Create HTML Document with Styled Text and Export to PDF – Full Guide](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Convert HTML to PDF with Aspose.HTML – Full Manipulation Guide](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..692c01e9d --- /dev/null +++ b/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-05-22 +description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: en +og_description: Save HTML as ZIP with Aspose.HTML. This guide shows how to render + HTML to ZIP, export HTML to a ZIP file, and zip HTML files programmatically. +og_title: Save HTML as ZIP – Complete Aspose.HTML Tutorial +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Save HTML as ZIP – Complete Guide for Aspose.HTML +url: /net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Save HTML as ZIP – Complete Guide for Aspose.HTML + +Ever wondered how to **save HTML as ZIP** without pulling out a separate archiving tool? You’re not the only one. Many developers need to bundle an HTML page together with its images, CSS, and scripts for easy distribution, and doing it manually quickly becomes a pain point. + +In this tutorial we’ll walk through a clean, end‑to‑end solution that **renders HTML to ZIP** using Aspose.HTML for .NET. By the end you’ll know exactly how to **export HTML to a ZIP file**, and you’ll also see variations for **how to zip HTML files** in different scenarios. + +> *Pro tip:* The approach shown works whether you’re packaging a single page or an entire site folder. + +## What You’ll Need + +Before we dive in, make sure you have: + +- .NET 6 (or any recent .NET runtime) installed. +- The Aspose.HTML for .NET NuGet package (`Aspose.Html`) referenced in your project. +- A simple `input.html` file placed in a folder you control. +- A bit of C# comfort—nothing fancy, just the basics. + +That’s it. No external zip utilities, no command‑line gymnastics. Let’s get started. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*Image alt text: save html as zip process diagram* + +## Step 1: Load the Source HTML Document + +The first thing we have to do is tell Aspose.HTML where our source lives. The `HTMLDocument` class reads the file and builds an in‑memory DOM, ready for rendering. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Why this matters: loading the document gives the library full control over resource resolution (images, CSS, fonts). If the HTML references relative paths, Aspose.HTML automatically resolves them relative to the file’s folder. + +## Step 2: (Optional) Create a Custom Resource Handler + +If you need to inspect or manipulate each resource—say you want to compress images before they hit the archive—you can plug in a `ResourceHandler`. This step is optional, but it’s the most flexible way to **convert HTML to ZIP archive** with custom logic. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*What if you don’t need any special processing?* Just skip this class and use the default handler—Aspose.HTML will write the resources straight into the ZIP. + +## Step 3: Configure Save Options to Use the Handler + +The `HtmlSaveOptions` object tells the renderer what to do with the resources. By assigning our `MyResourceHandler`, we gain full control over the output. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Notice how the property name `ResourceHandler` directly references the **render HTML to ZIP** capability. This is where the magic happens: every linked resource is streamed into the archive instead of being written to disk. + +## Step 4: Save the Rendered Document into a ZIP Archive + +Now we finally **export HTML to a ZIP file**. The `Save` method accepts any `Stream`, so we can point it at a `FileStream` that creates `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +That’s the entire workflow. When the code finishes, `result.zip` contains: + +- `input.html` (the original markup) +- All referenced images, CSS files, and fonts +- Any transformed resources if you tweaked them in `MyResourceHandler` + +## How to Zip HTML Files Without Aspose.HTML (Quick Alternative) + +Sometimes you just need a plain‑old **how to zip HTML files** approach, perhaps because you’re already using a different HTML parser. In that case you can use .NET’s built‑in `System.IO.Compression`: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +This method is simple but lacks the rendering step; it merely packs whatever is on disk. If your HTML references external URLs, those resources won’t be included. That’s why the Aspose.HTML route is preferred when you need a reliable **render HTML to ZIP** solution. + +## Edge Cases & Common Pitfalls + +| Situation | What to Watch For | Recommended Fix | +|-----------|-------------------|-----------------| +| **Large images** | Memory usage spikes because each image is loaded into a `MemoryStream`. | Stream directly to the zip using a custom handler that copies the source stream instead of buffering fully. | +| **External URLs** | Resources hosted on the internet aren’t downloaded automatically. | Set `HtmlLoadOptions` with `BaseUrl` pointing to the site root, or manually download resources before saving. | +| **File name collisions** | Two CSS files with the same name in different subfolders may overwrite each other. | Ensure the `ResourceHandler` preserves the full relative path when writing to the zip. | +| **Permission errors** | Trying to write to a read‑only folder throws `UnauthorizedAccessException`. | Run the process with proper privileges or choose a writable output directory. | + +Addressing these scenarios makes your **convert HTML to ZIP archive** routine robust for production use. + +## Full Working Example (All Pieces Together) + +Below is the complete, ready‑to‑run program. Paste it into a new console app, update the paths, and hit **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Expected output:** The console prints a success message, and the `result.zip` file contains `input.html` plus every dependent asset. Open the ZIP, double‑click `input.html`, and you’ll see the page rendered exactly as it did in the browser—no missing images, no broken CSS. + +## Recap – Why This Approach Rocks + +- **Single‑step rendering:** You don’t have to manually copy each resource; Aspose.HTML does it for you. +- **Customizable pipeline:** The `ResourceHandler` gives you full control over how each file is stored, enabling compression, encryption, or on‑the‑fly transformation. +- **Cross‑platform:** Works on Windows, Linux, and macOS as long as you have .NET runtime. +- **No external tools:** The entire **save HTML as ZIP** process lives inside your C# codebase. + +## What’s Next? + +Now that you’ve mastered **save HTML as ZIP**, consider exploring these related topics: + +- **Export HTML to PDF** – perfect for printable reports (`export html to zip file` knowledge helps when you need both formats). +- **Streaming ZIP directly to HTTP response** – great for web APIs that let users download a packaged site on the fly. +- **Encrypting ZIP archives** – add a password layer if you’re dealing with confidential documentation. + +Feel free to experiment: swap the `MyResourceHandler` for a compressor that shrinks images, or add a manifest file that lists all bundled resources. The sky’s the limit when you control the rendering pipeline. + +--- + +*Happy coding! If you hit any snags or have ideas for improvement, drop a comment below. We’ll figure it out together.* + + +## Related Tutorials + +- [How to Zip HTML in C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Save HTML as ZIP – Complete C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Save HTML to ZIP in C# – Complete In‑Memory Example](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/french/net/generate-jpg-and-png-images/_index.md b/html/french/net/generate-jpg-and-png-images/_index.md index 59ca2dad1..0ab3c558a 100644 --- a/html/french/net/generate-jpg-and-png-images/_index.md +++ b/html/french/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Apprenez à utiliser Aspose.HTML pour .NET pour manipuler des documents HTML, co Apprenez à activer l'anticrénelage pour améliorer la qualité des images PNG/JPG générées à partir de documents DOCX avec Aspose.HTML. ### [Convertir docx en png – créer une archive zip tutoriel C#](./convert-docx-to-png-create-zip-archive-c-tutorial/) Apprenez à convertir des fichiers DOCX en images PNG et à les compresser dans une archive ZIP avec C#. +### [Définir la largeur et la hauteur de l'image lors de la conversion de Word en PNG – Guide complet](./set-image-width-height-when-converting-word-to-png-full-guid/) +Apprenez à spécifier la largeur et la hauteur lors de la conversion de documents Word en images PNG avec Aspose.HTML pour .NET. ## Conclusion diff --git a/html/french/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/french/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..1c8209099 --- /dev/null +++ b/html/french/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,277 @@ +--- +category: general +date: 2026-05-22 +description: Définissez la largeur et la hauteur de l'image lors de la conversion + d'un document Word en PNG. Apprenez à exporter un docx en image avec un rendu haute + qualité grâce à un tutoriel étape par étape. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: fr +og_description: Définissez la largeur et la hauteur de l'image lors de la conversion + d'un document Word en PNG. Ce tutoriel montre comment exporter un docx en image + avec des paramètres haute qualité. +og_title: Définir la largeur et la hauteur de l'image lors de la conversion de Word + en PNG – Guide complet +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Définir la largeur et la hauteur de l'image lors de la conversion de Word en + PNG – Guide complet +url: /fr/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Définir la largeur et la hauteur d'une image lors de la conversion de Word en PNG – Guide complet + +Vous êtes-vous déjà demandé comment **définir la largeur et la hauteur d'une image** tout en **convertissant Word en PNG** ? Vous n'êtes pas le seul. De nombreux développeurs se heurtent à un mur lorsque l'exportation par défaut donne une image floue ou aux mauvaises dimensions, puis ils passent des heures à chercher une solution qui fonctionne réellement. + +Dans ce tutoriel, nous parcourrons une solution propre, de bout en bout, qui montre **comment rendre des documents Word** en images PNG, vous permettant de **sauvegarder un docx en PNG** avec un contrôle précis de la largeur‑hauteur et un antialiasing de haute qualité. À la fin, vous disposerez d’un extrait de code prêt à l’emploi, d’une compréhension solide des options de l’API et de quelques astuces professionnelles pour éviter les pièges courants. + +## Ce que vous allez apprendre + +- Charger un fichier `.docx` avec Aspose.Words for .NET. +- **Définir la largeur et la hauteur d’une image** avec `ImageRenderingOptions`. +- **Exporter un docx en image** (PNG) avec l’antialiasing activé. +- Comment **convertir Word en PNG** pour une page unique ou l’ensemble du document. +- Astuces pour gérer les documents volumineux, les considérations DPI et les chemins de système de fichiers. + +Aucun outil externe, aucune gymnastique de ligne de commande désordonnée—juste du code C# pur que vous pouvez intégrer dans n’importe quel projet .NET. + +--- + +## Prérequis + +Avant de commencer, assurez‑vous de disposer de ce qui suit : + +| Prérequis | Pourquoi c’est important | +|-----------|---------------------------| +| **.NET 6.0+** (ou .NET Framework 4.7.2) | Aspose.Words prend en charge les deux, mais les runtimes plus récents offrent de meilleures performances. | +| **Aspose.Words for .NET** package NuGet (`Install-Package Aspose.Words`) | Fournit la classe `Document` et le moteur de rendu. | +| Un **document Word** (`.docx`) que vous souhaitez transformer en PNG. | La source que vous allez convertir. | +| Connaissances de base en C# – vous comprendrez les instructions `using` et l’initialisation d’objets. | Facilite la courbe d’apprentissage. | + +Si le package NuGet vous manque, exécutez ceci dans la console du gestionnaire de packages : + +```powershell +Install-Package Aspose.Words +``` + +C’est tout—une fois le package installé, vous êtes prêt à coder. + +--- + +## Étape 1 : Charger le document source + +La toute première chose à faire est d’indiquer à la bibliothèque le fichier Word que vous voulez transformer. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Pourquoi c’est important :** La classe `Document` lit l’ensemble du package Word en mémoire, vous donnant accès aux pages, aux styles et à tout le reste. Si le chemin est incorrect, vous obtiendrez une `FileNotFoundException`, alors vérifiez que le fichier existe et que le chemin utilise des antislashs échappés (`\\`) ou une chaîne verbatim (`@`). + +> **Astuce pro :** Enveloppez l’appel de chargement dans un bloc `try/catch` si le fichier peut être absent à l’exécution. + +--- + +## Étape 2 : Configurer les options de rendu d’image (Définir la largeur et la hauteur) + +Voici le cœur du tutoriel : **comment définir la largeur et la hauteur d’une image** afin que le PNG résultant ne soit ni étiré ni pixelisé. La classe `ImageRenderingOptions` vous offre un contrôle granulaire sur les dimensions, le DPI et le lissage. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Explication des propriétés clés :** + +- `Width` et `Height` – Ce sont les dimensions exactes en pixels que vous désirez. En les définissant, vous **définissez la largeur et la hauteur de l’image** directement, en écrasant la taille de page par défaut. +- `UseAntialiasing` – Active le lissage de haute qualité pour le texte et les graphiques vectoriels, ce qui est crucial lorsque vous **convertissez Word en PNG** et que vous voulez des bords nets. +- `Resolution` – Un DPI plus élevé produit plus de détails, surtout pour les mises en page complexes. Gardez un œil sur la consommation mémoire ; une image à 300 DPI peut être volumineuse. + +> **Pourquoi ne pas se contenter de la taille par défaut ?** Le réglage par défaut utilise les dimensions physiques de la page (par ex., A4 à 96 DPI). Cela produit souvent une image de 794 × 1123 pixels—suffisant dans certains cas, mais pas quand vous avez besoin d’une vignette UI ou d’un aperçu à taille fixe. + +--- + +## Étape 3 : Rendre et sauvegarder en PNG (Exporter le docx en image) + +Avec le document chargé et les options configurées, vous pouvez enfin **exporter le docx en image**. La méthode `RenderToImage` fait le gros du travail. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Si vous souhaitez rendre **l’ensemble du document** (toutes les pages) en fichiers PNG séparés, parcourez la collection de pages : + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Que se passe‑t‑il en coulisses ?** Le moteur rasterise chaque page en utilisant les dimensions que vous avez fournies, applique l’antialiasing et écrit un flux d’octets PNG sur le disque. Comme le PNG est sans perte, vous conservez toute la fidélité de la mise en page Word d’origine. + +**Résultat attendu :** Un PNG net exactement de 1024 × 768 pixels (ou la taille que vous avez définie). Ouvrez‑le avec n’importe quel visualiseur d’images et vous verrez le contenu Word rendu exactement comme dans le document original, mais désormais sous forme de bitmap. + +--- + +## Astuces avancées & variantes + +### 1. Conserver les arrière‑plans transparents + +Si votre document Word contient des formes avec des arrière‑plans transparents et que vous voulez garder cette transparence, définissez `BackgroundColor` sur `Color.Transparent` : + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Rendre uniquement une plage spécifique + +Parfois vous n’avez besoin que d’un paragraphe ou d’un tableau, pas de toute la page. Utilisez `DocumentVisitor` pour extraire le nœud et le rendre séparément. C’est un scénario plus avancé, mais cela montre **comment rendre du contenu Word** de façon granulaire. + +### 3. Ajuster le DPI dynamiquement + +Si vous avez besoin d’un DPI différent par page (par ex., haute résolution pour la page de garde), modifiez `Resolution` à l’intérieur de la boucle : + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Traitement par lots + +Lorsque vous convertissez des dizaines de documents, encapsulez le flux complet dans une méthode et réutilisez la même instance de `ImageRenderingOptions`. Réutiliser l’objet d’options réduit la surcharge d’allocation. + +--- + +## Problèmes courants & comment les éviter + +| Symptom | Cause probable | Solution | +|---------|----------------|----------| +| Le PNG est flou malgré un DPI élevé | `UseAntialiasing` laissé à `false` | Définissez `UseAntialiasing = true`. | +| La taille de sortie ne correspond pas à `Width`/`Height` | DPI non pris en compte | Multipliez la taille désirée par `Resolution / 96` ou ajustez `Resolution`. | +| Exception Out‑of‑memory sur de gros documents | Rendu du document complet à 300 DPI | Rendre une page à la fois, libérer chaque image après sauvegarde. | +| Le PNG montre un fond blanc sur des images transparentes | `BackgroundColor` non défini | Définissez `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Exemple complet fonctionnel + +Voici un programme autonome que vous pouvez copier‑coller dans une application console. Il montre **convertir Word en PNG**, **sauvegarder le docx en PNG**, et bien sûr **définir la largeur et la hauteur d’une image**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Exécution :** Compilez le projet, placez un `input.docx` valide au chemin indiqué, puis lancez l’application. Vous devriez obtenir un `output.png` exactement **1024 × 768** pixels, rendu avec des bords lisses. + + +## Tutoriels associés + +- [Comment activer l’antialiasing lors de la conversion de DOCX en PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convertir docx en png – créer une archive zip c# tutoriel](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Comment utiliser Aspose pour rendre du HTML en PNG – Guide étape par étape](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/french/net/html-extensions-and-conversions/_index.md b/html/french/net/html-extensions-and-conversions/_index.md index f4e02735c..4e9e00556 100644 --- a/html/french/net/html-extensions-and-conversions/_index.md +++ b/html/french/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,13 @@ Aspose.HTML pour .NET n'est pas seulement une bibliothèque ; c'est un outil ré ## Tutoriels sur les extensions et conversions HTML ### [Convertir HTML en PDF dans .NET avec Aspose.HTML](./convert-html-to-pdf/) Convertissez facilement du HTML en PDF avec Aspose.HTML pour .NET. Suivez notre guide étape par étape et exploitez la puissance de la conversion HTML en PDF. + +### [Rendre le HTML en PDF en C# – Guide complet étape par étape](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Apprenez à convertir du HTML en PDF en C# avec Aspose.HTML grâce à un guide complet étape par étape. + +### [Convertir HTML en PDF avec C# – Guide complet](./convert-html-to-pdf-with-c-complete-guide/) +Convertissez du HTML en PDF avec C# grâce à notre guide complet étape par étape. + ### [Créer un PDF à partir de HTML – Guide étape par étape en C#](./create-pdf-from-html-c-step-by-step-guide/) Apprenez à créer un PDF à partir de HTML en C# avec Aspose.HTML, guide complet pas à pas. ### [Créer un document HTML avec du texte stylisé et l'exporter en PDF – Guide complet](./create-html-document-with-styled-text-and-export-to-pdf-full/) @@ -72,6 +79,8 @@ Découvrez la puissance d'Aspose.HTML pour .NET : convertissez facilement du HT Apprenez à compresser du HTML en un fichier zip avec C# grâce à notre guide détaillé. ### [Enregistrer le HTML en ZIP – Tutoriel complet C#](./save-html-as-zip-complete-c-tutorial/) Apprenez à enregistrer un document HTML dans un fichier ZIP en C# avec Aspose.HTML pour .NET. Guide complet étape par étape. +### [Enregistrer le HTML en ZIP – Guide complet pour Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Apprenez à enregistrer du HTML dans un fichier ZIP avec Aspose.HTML, guide complet étape par étape. ### [Enregistrer HTML en ZIP en C# – Exemple complet en mémoire](./save-html-to-zip-in-c-complete-in-memory-example/) Enregistrez du HTML dans un fichier ZIP en mémoire avec Aspose.HTML pour .NET. diff --git a/html/french/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/french/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..bf66566a7 --- /dev/null +++ b/html/french/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,258 @@ +--- +category: general +date: 2026-05-22 +description: Convertir HTML en PDF en C# avec Aspose.HTML. Apprenez à rendre du HTML + en PDF en C# grâce à du code étape par étape, des options et des astuces pour Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: fr +og_description: Convertir du HTML en PDF en C# avec Aspose.HTML. Ce guide montre comment + rendre du HTML en PDF en C# en utilisant des options claires et des indications + compatibles Linux. +og_title: Convertir HTML en PDF avec C# – Guide complet +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Convertir le HTML en PDF avec C# – Guide complet +url: /fr/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convertir HTML en PDF avec C# – Guide complet + +Si vous devez **convertir HTML en PDF** rapidement, Aspose.HTML pour .NET rend cela très simple. Dans ce tutoriel, nous répondrons également à la question **comment rendre HTML en PDF en C#** avec un contrôle complet sur les options de rendu, afin que vous ne restiez pas dans le doute. + +Imaginez que vous avez un modèle d'email marketing, une page de reçu, ou un rapport complexe construit avec du CSS moderne, et que vous devez le livrer sous forme de PDF à un client ou à une imprimante. Le faire manuellement est fastidieux, mais quelques lignes de code C# peuvent automatiser tout le pipeline. À la fin de ce guide, vous disposerez d’une solution autonome, prête pour la production, qui fonctionne sous Windows *et* Linux. + +## Ce dont vous avez besoin + +- **.NET 6.0 ou ultérieur** – Aspose.HTML cible .NET Standard 2.0+, donc tout SDK récent fonctionne. +- **Package NuGet Aspose.HTML for .NET** (`Aspose.Html`) – vous aurez besoin d’une licence valide pour la production, mais l’essai gratuit suffit pour les tests. +- Un **fichier HTML simple** que vous souhaitez convertir en PDF (nous l’appellerons `input.html`). +- Votre IDE préféré (Visual Studio, Rider ou VS Code) – aucun outil spécial requis. + +C’est tout. Aucun convertisseur PDF externe, aucune gymnastique en ligne de commande. Juste du pur C#. + +![Diagramme illustrant le flux de conversion de HTML en PDF avec Aspose.HTML](/images/convert-html-to-pdf-workflow.png "flux de conversion de html en pdf") + +## Convertir HTML en PDF – Implémentation complète + +Voici le programme complet, prêt à être exécuté. Copiez‑collez‑le dans une nouvelle application console, restaurez les packages NuGet, puis appuyez sur **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Pourquoi cela fonctionne + +- `Document` est le point d’entrée d’Aspose.HTML ; il analyse le HTML, résout le CSS et construit un DOM prêt pour le rendu. +- `PdfRenderingOptions` vous permet d’ajuster la sortie. Le drapeau `UseHinting` est la sauce secrète pour obtenir un texte net sur les conteneurs Linux sans affichage où le rasteriseur par défaut peut sembler flou. +- `Save` fait le travail lourd : il rasterise le DOM sur les pages PDF, respecte les sauts de page et intègre les polices automatiquement. + +L’exécution du programme générera `output.pdf` juste à côté de votre fichier source. Ouvrez-le avec n’importe quel lecteur PDF et vous devriez voir une correspondance visuelle fidèle au HTML d’origine. + +## Comment rendre HTML en PDF en C# – Étape par étape + +Ci-dessous, nous décomposons le processus en morceaux faciles à digérer, expliquant **comment rendre HTML en PDF en C#** tout en couvrant les pièges courants. + +### Étape 1 – Installer le package NuGet Aspose.HTML + +Ouvrez votre terminal dans le dossier du projet et exécutez : + +```bash +dotnet add package Aspose.Html +``` + +Si vous préférez l’interface Visual Studio, faites un clic droit sur le projet → **Manage NuGet Packages** → recherchez **Aspose.Html** et installez la dernière version stable. + +> **Astuce :** Après l’installation, ajoutez un fichier de licence (`Aspose.Total.lic`) à la racine de votre projet pour éviter les filigranes d’évaluation. + +### Étape 2 – Charger correctement votre HTML + +Aspose.HTML peut ingérer : + +- Chemins de fichiers locaux (`new Document("file.html")`) +- URL (`new Document("https://example.com")`) +- Chaînes HTML brutes (`new Document("…", new HtmlLoadOptions())`) + +Lorsque vous chargez depuis le système de fichiers, assurez‑vous que le chemin est absolu ou que le répertoire de travail est correctement défini, sinon vous obtiendrez une `FileNotFoundException`. Sous Linux, utilisez des barres obliques (`/`) ou `Path.Combine`. + +### Étape 3 – Choisir les bonnes options de rendu + +En plus de `UseHinting`, vous pourriez vouloir ajuster : + +| Option | Ce que ça fait | Quand l’utiliser | +|--------|----------------|-------------------| +| `PageSize` | Définit les dimensions de la page PDF (A4, Letter, personnalisé) | Correspondre à la taille de papier cible | +| `Landscape` | Fait pivoter la page en mode paysage | Tableaux ou graphiques larges | +| `RasterizeVectorGraphics` | Force les graphiques vectoriels à devenir des images raster | Lorsque le lecteur PDF ne peut pas gérer le SVG | +| `CompressionLevel` | Contrôle la compression des images (0‑9) | Réduire la taille du fichier pour les pièces jointes d’e‑mail | + +Vous pouvez chaîner ces propriétés de manière fluide : + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Étape 4 – Enregistrer le PDF + +La surcharge de la méthode `Save` que vous voyez dans l’exemple complet écrit directement vers un chemin de fichier. Vous pouvez également diffuser le PDF en mémoire : + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +C’est pratique lorsque vous devez renvoyer le PDF en téléchargement depuis une API web. + +### Étape 5 – Vérifier la sortie + +Une vérification rapide consiste à comparer le nombre de pages du PDF avec le nombre attendu de sections HTML. Vous pouvez le relire avec Aspose.PDF : + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Si le nombre semble incorrect, revoyez les règles CSS `page-break` ou ajustez `PdfRenderingOptions` en conséquence. + +## Cas limites et problèmes courants + +| Situation | À surveiller | Solution | +|-----------|--------------|----------| +| **Ressources externes (images, polices) manquantes** | Les URL relatives sont résolues par rapport au dossier du fichier HTML. | Utilisez `HtmlLoadOptions.BaseUri` pour pointer vers la racine correcte. | +| **Environnement Linux sans affichage** | Le rendu texte par défaut peut être flou. | Définissez `UseHinting = true` (comme indiqué) et assurez‑vous que `libgdiplus` est installé si vous revenez à System.Drawing. | +| **HTML volumineux (> 10 Mo)** | La consommation mémoire augmente fortement pendant le rendu. | Rendez page par page en utilisant `PdfRenderer` avec `PdfRenderingOptions` et libérez chaque page après l’enregistrement. | +| **Pages lourdes en JavaScript** | Aspose.HTML n’exécute pas le JS ; le contenu dynamique reste statique. | Pré‑traitez le HTML côté serveur (par ex., avec Puppeteer) avant de le fournir à Aspose.HTML. | +| **Caractères Unicode affichés comme des carrés** | Polices manquantes dans l’environnement d’exécution. | Intégrez des polices personnalisées via `FontSettings` ou assurez‑vous que le système d’exploitation possède les polices requises. | + +## Récapitulatif de l’exemple complet fonctionnel + +Voici à nouveau le programme complet, dépouillé des commentaires pour ceux qui préfèrent une vue concise : + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Exécutez‑le, ouvrez `output.pdf`, et vous verrez une réplique pixel‑parfaite de `input.html`. C’est l’essence de **convertir html en pdf** avec Aspose.HTML. + +## Conclusion + +Nous avons parcouru tout ce dont vous avez besoin pour **convertir HTML en PDF** en C# : installer Aspose.HTML, charger le HTML, ajuster les options de rendu (y compris le drapeau crucial `UseHinting`), et enregistrer le PDF final. Vous comprenez désormais **comment rendre HTML en PDF en C#** pour les environnements Windows et Linux, et vous avez vu comment gérer les cas limites courants tels que les ressources manquantes et les fichiers volumineux. + +Et ensuite ? Essayez d’ajouter : + +- **En‑têtes/pieds de page** avec `PdfPageTemplate` pour le branding. +- **Protection par mot de passe** via `PdfSaveOptions`. +- **Conversion par lot** en parcourant un dossier de + +## Tutoriels associés + +- [Convertir HTML en PDF avec .NET et Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Convertir EPUB en PDF avec .NET et Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Convertir SVG en PDF avec .NET et Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/french/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/french/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..44d947f69 --- /dev/null +++ b/html/french/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,309 @@ +--- +category: general +date: 2026-05-22 +description: Rendre le HTML en PDF avec C# grâce à un exemple concis. Apprenez à convertir + rapidement et de façon fiable le HTML en PDF avec C#. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: fr +og_description: Rendre le HTML en PDF en C# avec un exemple clair et exécutable. Ce + guide vous montre comment convertir du HTML en PDF avec C# et générer un PDF à partir + d’un fichier HTML. +og_title: Convertir le HTML en PDF en C# – Tutoriel complet de programmation +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Convertir le HTML en PDF en C# – Guide complet étape par étape +url: /fr/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Rendre du HTML en PDF avec C# – Guide complet étape par étape + +Vous avez déjà eu besoin de **rendre du HTML en PDF** mais vous ne saviez pas quelle bibliothèque choisir pour un projet .NET ? Vous n'êtes pas seul. Dans de nombreuses applications métier, vous vous retrouverez à devoir **convertir du HTML en PDF C#** pour des factures, des rapports ou des brochures marketing — en gros chaque fois que vous souhaitez une version imprimable d’une page web. + +Voici le point : vous n’avez pas besoin de réinventer la roue. En quelques lignes de code, vous pouvez prendre un fichier `input.html`, le transmettre à un moteur de rendu éprouvé, et obtenir un `output.pdf` net. Dans ce tutoriel, nous parcourrons l’ensemble du processus, de l’ajout du bon package NuGet à la gestion des cas particuliers comme le CSS externe. À la fin, vous serez capable de **générer un PDF à partir d’un fichier HTML** en quelques minutes. + +## Ce que vous allez apprendre + +- Comment configurer une application console .NET qui **crée un PDF à partir de HTML C#**. +- Les appels d’API exacts dont vous avez besoin pour **enregistrer un document HTML en PDF**. +- Pourquoi certaines options de rendu (comme le hinting) sont importantes pour la qualité du texte. +- Astuces pour dépanner les problèmes courants tels que les polices manquantes ou les chemins d’image relatifs. + +**Prérequis** – vous devez disposer de .NET 6+ ou .NET Framework 4.7 installé, d’une connaissance de base du C#, et d’un IDE (Visual Studio 2022, Rider ou VS Code). Aucune expérience préalable du PDF n’est requise. + +--- + +## Rendre du HTML en PDF – Configuration du projet + +Avant de plonger dans le code, assurons‑nous que l’environnement de développement est prêt. La bibliothèque que nous allons utiliser est **Select.Pdf** (gratuite pour un usage non commercial) car elle offre une API simple et une fidélité de rendu solide. + +### Installer la bibliothèque de rendu PDF (convert html to pdf c#) + +Ouvrez un terminal dans le dossier de votre projet et exécutez : + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Conseil pro :* Si vous utilisez Visual Studio, vous pouvez également ajouter le package via l’interface du Gestionnaire de packages NuGet. Le numéro de version peut être plus récent — prenez simplement la dernière version stable. + +### Créer une structure de console + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +C’est tout le code de démarrage dont vous avez besoin. Le vrai travail se fait à l’intérieur de `Main`. + +--- + +## Charger le document HTML (generate pdf from html file) + +La première étape réelle consiste à indiquer au moteur de rendu le fichier HTML présent sur le disque. Select.Pdf propose deux méthodes pratiques : passer une chaîne HTML brute ou un chemin de fichier. Utiliser un fichier garde les choses ordonnées, surtout lorsque vous avez du CSS ou des images liés. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Ici, nous protégeons également contre un fichier manquant — un problème qui bloque souvent les débutants lorsqu’ils oublient de copier le HTML dans le dossier de sortie. + +--- + +## Configurer les options de rendu (create pdf from html c#) + +Select.Pdf fournit un objet riche `PdfDocumentOptions`. Pour un texte net, nous activons le hinting, qui lisse les glyphes au prix d’une légère perte de performance. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Vous pouvez ajuster la taille de la page, les marges, ou même incorporer une police personnalisée ici. L’essentiel est que **render html as pdf** n’est pas simplement une ligne de code ; vous avez le contrôle sur l’apparence finale du document. + +--- + +## Enregistrer le document HTML en PDF (render html as pdf) + +Maintenant, la magie opère. Nous transmettons au convertisseur le chemin de notre fichier HTML et lui demandons d’écrire un PDF sur le disque. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +La méthode `ConvertUrl` résout automatiquement les URL relatives (images, CSS) en fonction de l’emplacement du fichier HTML, ce qui rend cette approche robuste pour la plupart des scénarios réels. + +### Résultat attendu + +Après avoir exécuté le programme, vous devriez voir un fichier `output.pdf` dans le même dossier. Ouvrez‑le — vous remarquerez : + +- Un texte rendu avec un anti‑aliasing clair (grâce au hinting). +- Les styles du CSS lié appliqués correctement. +- Des images affichées à la taille exacte définie dans le HTML source. + +Si quelque chose semble incorrect, revérifiez que les fichiers CSS et image sont placés à côté de `input.html` ou utilisez des URL absolues. + +--- + +## Gestion des cas limites courants + +### 1. Ressources externes bloquées par les pare‑feux + +Si votre HTML référence des polices hébergées sur un CDN que votre serveur ne peut pas atteindre, le PDF peut revenir à une police générique. Pour éviter cela, téléchargez les fichiers de police localement ou intégrez‑les avec `@font-face` en utilisant un chemin relatif. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Fichiers HTML très volumineux + +Lorsque vous convertissez des documents massifs, vous pouvez atteindre les limites de mémoire. Select.Pdf vous permet de diffuser la conversion : + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Le streaming garde le processus léger mais nécessite que vous fournissiez le HTML sous forme de chaîne, que vous pouvez lire par morceaux si besoin. + +### 3. En‑têtes ou pieds de page personnalisés + +Si vous avez besoin d’un numéro de page ou du logo de l’entreprise sur chaque page, définissez les propriétés `Header` et `Footer` sur `converter.Options` avant d’appeler `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Exemple complet fonctionnel (Toutes les étapes combinées) + +Voici le programme complet, prêt à copier‑coller. Remplacez `YOUR_DIRECTORY` par le chemin absolu où se trouve votre HTML. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Exécutez‑le :** `dotnet run` depuis le répertoire du projet. Si tout est correctement configuré, vous verrez le message de succès et un brillant `output.pdf`. + +--- + +## Résumé visuel + +![Render HTML as PDF example](render-html-as-pdf.png){alt="exemple de rendu HTML en PDF"} + +La capture d’écran montre la sortie console et le PDF résultant ouvert dans un lecteur. Notez les titres nets et les images correctement chargées — exactement ce à quoi vous vous attendez lorsque vous **render html as pdf**. + +--- + +## Conclusion + +Vous venez d’apprendre comment **rendre du HTML en PDF** dans une application C#, de l’installation de la bibliothèque à l’ajustement fin des options de rendu. L’exemple complet montre une méthode fiable pour **convertir du HTML en PDF C#**, **générer un PDF à partir d’un fichier HTML**, et **enregistrer un document HTML en PDF** avec seulement quelques lignes de code. + +Et après ? Essayez d’expérimenter avec : + +- Ajouter des polices personnalisées pour la cohérence de la marque. +- Générer des PDFs à partir de chaînes HTML dynamiques (par ex., modèles Razor). +- Fusionner plusieurs PDFs en un seul rapport avec `PdfDocument.AddPage`. + +Chacune de ces extensions s’appuie sur les concepts de base présentés ici, vous préparant à aborder des scénarios plus avancés sans courbe d’apprentissage abrupte. + +Des questions ou un problème ? Laissez un commentaire ci‑dessous, et résolvons‑le ensemble. Bon codage ! + +## Tutoriels associés + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Create HTML Document with Styled Text and Export to PDF – Full Guide](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Convert HTML to PDF with Aspose.HTML – Full Manipulation Guide](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/french/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/french/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..1622244b3 --- /dev/null +++ b/html/french/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,223 @@ +--- +category: general +date: 2026-05-22 +description: Enregistrez rapidement du HTML au format ZIP avec Aspose.HTML. Apprenez + à compresser des fichiers HTML, à rendre du HTML en ZIP et à exporter du HTML vers + un fichier ZIP avec le code complet. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: fr +og_description: Enregistrez le HTML au format ZIP avec Aspose.HTML. Ce guide montre + comment rendre le HTML en ZIP, exporter le HTML vers un fichier ZIP et compresser + des fichiers HTML de manière programmatique. +og_title: Enregistrer le HTML au format ZIP – Tutoriel complet Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Enregistrer le HTML en ZIP – Guide complet pour Aspose.HTML +url: /fr/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Enregistrer le HTML en ZIP – Guide complet pour Aspose.HTML + +Vous vous êtes déjà demandé comment **enregistrer le HTML en ZIP** sans faire appel à un outil d'archivage séparé ? Vous n'êtes pas le seul. De nombreux développeurs doivent regrouper une page HTML avec ses images, ses CSS et ses scripts pour une distribution facile, et le faire manuellement devient rapidement un point douloureux. + +Dans ce tutoriel, nous parcourrons une solution propre, de bout en bout, qui **rend le HTML en ZIP** en utilisant Aspose.HTML pour .NET. À la fin, vous saurez exactement comment **exporter le HTML vers un fichier ZIP**, et vous verrez également des variantes pour **comment zipper des fichiers HTML** dans différents scénarios. + +> *Astuce :* L'approche présentée fonctionne que vous empaquetiez une page unique ou un dossier complet de site. + +## Ce dont vous avez besoin + +- .NET 6 (ou tout runtime .NET récent) installé. +- Le package NuGet Aspose.HTML pour .NET (`Aspose.Html`) référencé dans votre projet. +- Un fichier `input.html` simple placé dans un dossier que vous contrôlez. +- Un peu de familiarité avec C# — rien de compliqué, juste les bases. + +C’est tout. Aucun utilitaire zip externe, aucune gymnastique en ligne de commande. Commençons. + +![Diagramme montrant le processus d'enregistrement du HTML en ZIP avec Aspose.HTML](save-html-as-zip.png) + +*Texte alternatif de l'image : diagramme du processus d'enregistrement du HTML en ZIP* + +## Étape 1 : Charger le document HTML source + +La première chose à faire est d'indiquer à Aspose.HTML où se trouve notre source. La classe `HTMLDocument` lit le fichier et construit un DOM en mémoire, prêt pour le rendu. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Pourquoi c’est important : charger le document donne à la bibliothèque le contrôle complet de la résolution des ressources (images, CSS, polices). Si le HTML fait référence à des chemins relatifs, Aspose.HTML les résout automatiquement par rapport au dossier du fichier. + +## Étape 2 : (Facultatif) Créer un gestionnaire de ressources personnalisé + +Si vous devez inspecter ou manipuler chaque ressource — par exemple, compresser les images avant qu'elles n'entrent dans l'archive — vous pouvez brancher un `ResourceHandler`. Cette étape est facultative, mais c’est la façon la plus flexible de **convertir le HTML en archive ZIP** avec une logique personnalisée. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Et si vous n’avez besoin d’aucun traitement spécial ?* Il suffit d’ignorer cette classe et d’utiliser le gestionnaire par défaut — Aspose.HTML écrira les ressources directement dans le ZIP. + +## Étape 3 : Configurer les options d’enregistrement pour utiliser le gestionnaire + +L’objet `HtmlSaveOptions` indique au moteur de rendu quoi faire avec les ressources. En assignant notre `MyResourceHandler`, nous obtenons un contrôle total sur la sortie. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Remarquez comment la propriété `ResourceHandler` fait directement référence à la capacité de **rendre le HTML en ZIP**. C’est ici que la magie opère : chaque ressource liée est diffusée dans l’archive au lieu d’être écrite sur le disque. + +## Étape 4 : Enregistrer le document rendu dans une archive ZIP + +Nous allons maintenant enfin **exporter le HTML vers un fichier ZIP**. La méthode `Save` accepte n’importe quel `Stream`, nous pouvons donc la diriger vers un `FileStream` qui crée `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +C’est l’ensemble du flux de travail. Lorsque le code se termine, `result.zip` contient : + +- `input.html` (le balisage original) +- Toutes les images, fichiers CSS et polices référencés +- Toutes les ressources transformées si vous les avez modifiées dans `MyResourceHandler` + +## Comment zipper des fichiers HTML sans Aspose.HTML (alternative rapide) + +Parfois, vous avez simplement besoin d’une approche **comment zipper des fichiers HTML** classique, peut‑être parce que vous utilisez déjà un autre analyseur HTML. Dans ce cas, vous pouvez utiliser le `System.IO.Compression` intégré à .NET : + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Cette méthode est simple mais ne comporte pas l’étape de rendu ; elle se contente d’archiver ce qui se trouve sur le disque. Si votre HTML fait référence à des URL externes, ces ressources ne seront pas incluses. C’est pourquoi la voie Aspose.HTML est préférée lorsque vous avez besoin d’une solution fiable de **rendu du HTML en ZIP**. + +## Cas limites et pièges courants + +| Situation | Points d’attention | Solution recommandée | +|-----------|-------------------|-----------------| +| **Images volumineuses** | L'utilisation de la mémoire augmente car chaque image est chargée dans un `MemoryStream`. | Diffuser directement vers le zip à l'aide d'un gestionnaire personnalisé qui copie le flux source au lieu de le mettre entièrement en mémoire tampon. | +| **URL externes** | Les ressources hébergées sur Internet ne sont pas téléchargées automatiquement. | Définissez `HtmlLoadOptions` avec `BaseUrl` pointant vers la racine du site, ou téléchargez manuellement les ressources avant l’enregistrement. | +| **Collisions de noms de fichiers** | Deux fichiers CSS portant le même nom dans des sous‑dossiers différents peuvent s’écraser mutuellement. | Assurez‑vous que le `ResourceHandler` conserve le chemin relatif complet lors de l’écriture dans le zip. | +| **Erreurs de permission** | Essayer d’écrire dans un dossier en lecture seule génère une `UnauthorizedAccessException`. | Exécutez le processus avec les privilèges appropriés ou choisissez un répertoire de sortie accessible en écriture. | + +## Exemple complet (Tous les éléments ensemble) + +Voici le programme complet, prêt à être exécuté. Collez‑le dans une nouvelle application console, mettez à jour les chemins, et appuyez sur **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Sortie attendue :** La console affiche un message de succès, et le fichier `result.zip` contient `input.html` ainsi que toutes les ressources dépendantes. Ouvrez le ZIP, double‑cliquez sur `input.html`, et vous verrez la page rendue exactement comme dans le navigateur — aucune image manquante, aucun CSS cassé. + +## Récapitulatif – Pourquoi cette approche est géniale + +- **Rendu en une seule étape :** Vous n’avez pas besoin de copier manuellement chaque ressource ; Aspose.HTML le fait pour vous. +- **Pipeline personnalisable :** Le `ResourceHandler` vous donne un contrôle total sur la façon dont chaque fichier est stocké, permettant compression, chiffrement ou transformation à la volée. +- **Multi‑plateforme :** Fonctionne sous Windows, Linux et macOS tant que vous avez le runtime .NET. +- **Pas d’outils externes :** L’ensemble du processus de **enregistrement du HTML en ZIP** vit à l’intérieur de votre code C#. + +## Et après ? + +Maintenant que vous avez maîtrisé **l’enregistrement du HTML en ZIP**, envisagez d’explorer ces sujets connexes : + +- **Exporter le HTML en PDF** – parfait pour les rapports imprimables (la connaissance de `export html to zip file` aide lorsque vous avez besoin des deux formats). +- **Diffuser le ZIP directement dans la réponse HTTP** – idéal pour les API web qui permettent aux utilisateurs de télécharger un site empaqueté à la volée. +- **Chiffrer les archives ZIP** – ajoutez une couche de mot de passe si vous traitez des documents confidentiels. + +N’hésitez pas à expérimenter : remplacez le `MyResourceHandler` par un compresseur qui réduit les images, ou ajoutez un fichier manifeste listant toutes les ressources empaquetées. Le ciel est la limite lorsque vous contrôlez le pipeline de rendu. + +*Bon codage ! Si vous rencontrez des problèmes ou avez des idées d’amélioration, laissez un commentaire ci‑dessous. Nous résoudrons cela ensemble.* + +## Tutoriels associés + +- [Comment zipper du HTML en C# – Enregistrer le HTML en Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Enregistrer le HTML en ZIP – Tutoriel complet C#](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Enregistrer le HTML en ZIP en C# – Exemple complet en mémoire](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/german/net/generate-jpg-and-png-images/_index.md b/html/german/net/generate-jpg-and-png-images/_index.md index 8c24c4537..8f1a8bc93 100644 --- a/html/german/net/generate-jpg-and-png-images/_index.md +++ b/html/german/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Erfahren Sie, wie Sie mit Aspose.HTML für .NET HTML-Dokumente bearbeiten, HTML Erfahren Sie, wie Sie beim Konvertieren von DOCX-Dokumenten in PNG oder JPG Antialiasing aktivieren, um hochwertige Bilder zu erhalten. ### [DOCX in PNG konvertieren – ZIP-Archiv erstellen C#‑Tutorial](./convert-docx-to-png-create-zip-archive-c-tutorial/) Erfahren Sie, wie Sie DOCX‑Dateien in PNG‑Bilder umwandeln und diese in ein ZIP‑Archiv packen – Schritt‑für‑Schritt‑Anleitung in C#. +### [Bildbreite und -höhe beim Konvertieren von Word zu PNG festlegen – Vollständige Anleitung](./set-image-width-height-when-converting-word-to-png-full-guid/) +Erfahren Sie, wie Sie beim Konvertieren von Word-Dokumenten nach PNG die Bildbreite und -höhe gezielt festlegen. ## Abschluss diff --git a/html/german/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/german/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..400b5622b --- /dev/null +++ b/html/german/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,276 @@ +--- +category: general +date: 2026-05-22 +description: Bildbreite und -höhe beim Konvertieren eines Word‑Dokuments in PNG festlegen. + Erfahren Sie, wie Sie docx als Bild mit hochwertiger Darstellung in einer Schritt‑für‑Schritt‑Anleitung + exportieren. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: de +og_description: Bildbreite und -höhe beim Konvertieren eines Word‑Dokuments in PNG + festlegen. Dieses Tutorial zeigt, wie man eine DOCX‑Datei als Bild mit hochwertigen + Einstellungen exportiert. +og_title: Bildbreite und -höhe beim Konvertieren von Word in PNG festlegen – Vollständige + Anleitung +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Bildbreite und -höhe beim Konvertieren von Word in PNG festlegen – Vollständige + Anleitung +url: /de/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Bildbreite und -höhe beim Konvertieren von Word zu PNG festlegen – Komplettanleitung + +Haben Sie sich jemals gefragt, wie man **set image width height** festlegt, während man **convert Word to PNG**? Sie sind nicht der Einzige. Viele Entwickler stoßen an Grenzen, wenn der Standardexport ein unscharfes Bild oder falsche Abmessungen liefert, und verbringen dann Stunden damit, nach einer Lösung zu suchen, die tatsächlich funktioniert. + +In diesem Tutorial führen wir Sie durch eine saubere, End‑zu‑End‑Lösung, die zeigt, **how to render word** Dokumente als PNG‑Bilder rendert, sodass Sie **save docx as PNG** können, mit präziser Breiten‑Höhen‑Kontrolle und hochqualitativer Antialiasing. Am Ende haben Sie einen einsatzbereiten Code‑Snippet, ein solides Verständnis der API‑Optionen und ein paar Profi‑Tipps, um häufige Stolperfallen zu vermeiden. + +## Was Sie lernen werden + +- Laden Sie eine `.docx`‑Datei mit Aspose.Words für .NET. +- **Set image width height** mit `ImageRenderingOptions`. +- **Export docx as image** (PNG) mit aktiviertem Antialiasing. +- Wie man **convert word to png** für eine einzelne Seite oder das gesamte Dokument durchführt. +- Tipps zum Umgang mit großen Dokumenten, DPI‑Überlegungen und Dateisystem‑Pfaden. + +Keine externen Werkzeuge, kein unordentliches Kommandozeilen‑Gymnastik—nur reiner C#‑Code, den Sie in jedes .NET‑Projekt einbinden können. + +--- + +## Voraussetzungen + +Bevor wir einsteigen, stellen Sie sicher, dass Sie Folgendes haben: + +| Requirement | Why it matters | +|-------------|----------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words unterstützt beides, aber neuere Laufzeiten bieten bessere Leistung. | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | Stellt die `Document`‑Klasse und die Rendering‑Engine bereit. | +| Ein **Word‑Dokument** (`.docx`), das Sie in ein PNG umwandeln möchten. | Die Quelle, die Sie konvertieren werden. | +| Grundkenntnisse in C# – Sie verstehen `using`‑Anweisungen und Objektinitialisierung. | Hält die Lernkurve sanft. | + +Falls Ihnen das NuGet‑Paket fehlt, führen Sie dies in der Package‑Manager‑Konsole aus: + +```powershell +Install-Package Aspose.Words +``` + +Das war's—sobald das Paket installiert ist, können Sie mit dem Codieren beginnen. + +--- + +## Schritt 1: Laden des Quelldokuments + +Das allererste, was Sie tun müssen, ist die Bibliothek auf die Word‑Datei zu verweisen, die Sie transformieren möchten. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Why this matters:** Die `Document`‑Klasse liest das gesamte Word‑Paket in den Speicher, sodass Sie Zugriff auf Seiten, Stile und alles andere haben. Wenn der Pfad falsch ist, erhalten Sie eine `FileNotFoundException`, also überprüfen Sie doppelt, dass die Datei existiert und der Pfad escaped Backslashes (`\\`) oder einen verbatim‑String (`@`) verwendet. + +> **Pro tip:** Wickeln Sie den Ladevorgang in einen `try/catch`‑Block ein, falls die Datei zur Laufzeit fehlen könnte. + +--- + +## Schritt 2: Konfigurieren der Bildrender‑Optionen (Set Image Width Height) + +Jetzt kommt das Herzstück des Tutorials: **how to set image width height**, damit das resultierende PNG nicht verzerrt oder pixelig ist. Die `ImageRenderingOptions`‑Klasse bietet Ihnen feinkörnige Kontrolle über Abmessungen, DPI und Glättung. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Erklärung der wichtigsten Eigenschaften:** + +- `Width` und `Height` – Dies sind die genauen Pixelabmessungen, die Sie wünschen. Durch das Setzen überschreiben Sie die Standard‑Seitengröße und **set image width height** direkt. +- `UseAntialiasing` – Aktiviert hochqualitative Glättung für Text und Vektorgrafiken, was entscheidend ist, wenn Sie **convert word to png** und scharfe Kanten wollen. +- `Resolution` – Höhere DPI liefert mehr Details, besonders bei komplexen Layouts. Achten Sie auf den Speicherverbrauch; ein 300 DPI‑Bild kann groß sein. + +> **Warum nicht einfach die Standardgröße verwenden?** Der Standard nutzt die physischen Seitenabmessungen (z. B. A4 bei 96 DPI). Das erzeugt oft ein 794 × 1123‑Pixel‑Bild – in manchen Fällen okay, aber nicht, wenn Sie ein bestimmtes UI‑Thumbnail oder eine feste Vorschaugröße benötigen. + +--- + +## Schritt 3: Rendern und als PNG speichern (Export Docx as Image) + +Nachdem das Dokument geladen und die Optionen konfiguriert sind, können Sie endlich **export docx as image**. Die Methode `RenderToImage` übernimmt die schwere Arbeit. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Wenn Sie **the whole document** (alle Seiten) in separate PNG‑Dateien rendern möchten, iterieren Sie über die Seitensammlung: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Was passiert im Hintergrund?** Der Renderer rastert jede Seite mit den von Ihnen angegebenen Abmessungen, wendet Antialiasing an und schreibt einen PNG‑Byte‑Stream auf die Festplatte. Da PNG verlustfrei ist, behalten Sie die volle Treue des ursprünglichen Word‑Layouts bei. + +**Erwartete Ausgabe:** Eine scharfe PNG‑Datei exakt 1024 × 768 Pixel (oder welche Größe Sie festgelegt haben). Öffnen Sie sie in einem Bildbetrachter und Sie sehen den Word‑Inhalt genau so, wie er im Originaldokument erscheint, nun jedoch als Bitmap‑Bild. + +--- + +## Erweiterte Tipps & Varianten + +### 1. Transparente Hintergründe erhalten + +Falls Ihr Word‑Dokument Formen mit transparenten Hintergründen enthält und Sie diese Transparenz beibehalten möchten, setzen Sie `BackgroundColor` auf `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Nur einen bestimmten Bereich rendern + +Manchmal benötigen Sie nur einen Absatz oder eine Tabelle, nicht die ganze Seite. Verwenden Sie `DocumentVisitor`, um den Knoten zu extrahieren und separat zu rendern. Das ist ein fortgeschritteneres Szenario, zeigt jedoch **how to render word** Inhalte auf granularer Ebene. + +### 3. DPI dynamisch anpassen + +Falls Sie pro Seite unterschiedliche DPI benötigen (z. B. hohe Auflösung für die Titelseite), ändern Sie `Resolution` innerhalb der Schleife: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Stapelverarbeitung + +Beim Konvertieren von Dutzenden Dokumenten kapseln Sie den gesamten Ablauf in einer Methode ein und verwenden dieselbe `ImageRenderingOptions`‑Instanz erneut. Das Wiederverwenden des Options‑Objekts reduziert den Allokations‑Overhead. + +--- + +## Häufige Fallstricke & wie man sie vermeidet + +| Symptom | Likely Cause | Fix | +|---------|--------------|-----| +| PNG ist trotz hohem DPI unscharf | `UseAntialiasing` left `false` | Set `UseAntialiasing = true`. | +| Ausgabengröße stimmt nicht mit `Width`/`Height` überein | DPI not considered | Multiply desired size by `Resolution / 96` or adjust `Resolution`. | +| Out‑of‑Memory‑Ausnahme bei großen Dokumenten | Rendering whole document at 300 DPI | Render one page at a time, dispose of each image after saving. | +| PNG zeigt einen weißen Hintergrund bei transparenten Bildern | `BackgroundColor` not set | Set `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Vollständiges funktionierendes Beispiel + +Unten finden Sie ein eigenständiges Programm, das Sie in eine Konsolen‑App kopieren können. Es demonstriert **convert word to png**, **save docx as png** und natürlich **set image width height**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Ausführen:** Bauen Sie das Projekt, legen Sie ein gültiges `input.docx` an dem von Ihnen angegebenen Pfad ab und führen Sie es aus. Sie sollten ein `output.png` exakt **1024 × 768** Pixel sehen, mit glatten Kanten gerendert. + +## Verwandte Tutorials + +- [Wie man Antialiasing beim Konvertieren von DOCX zu PNG/JPG aktiviert](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – ZIP-Archiv erstellen C#‑Tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Wie man Aspose verwendet, um HTML zu PNG zu rendern – Schritt‑für‑Schritt‑Anleitung](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/german/net/html-extensions-and-conversions/_index.md b/html/german/net/html-extensions-and-conversions/_index.md index 607896d28..cb36ccdd8 100644 --- a/html/german/net/html-extensions-and-conversions/_index.md +++ b/html/german/net/html-extensions-and-conversions/_index.md @@ -22,57 +22,65 @@ Bevor wir uns in die Tutorials vertiefen, sollten wir uns kurz ansehen, was Aspo ## HTML-Erweiterungen entmystifiziert -HTML-Erweiterungen sind eine wertvolle Ressource für Entwickler. Sie ermöglichen es Ihnen, die Funktionalität Ihrer Webanwendungen durch Hinzufügen benutzerdefinierter Elemente und Attribute zu erweitern. In dieser Tutorial-Reihe werden wir die verschiedenen HTML-Erweiterungen erkunden, die Aspose.HTML für .NET bietet. Sie erfahren, wie Sie diese Erweiterungen nahtlos in Ihre Projekte integrieren und Ihre Webanwendungen dynamischer und interaktiver gestalten können. +HTML-Erweiterungen sind eine wertvolle Ressource für Entwickler. Sie ermöglichen es Ihnen, die Funktionalität Ihrer Webanwendungen durch Hinzufügen benutzerdefinierter Elemente und Attribute zu erweitern. In dieser Tutorial‑Reihe werden wir die verschiedenen HTML-Erweiterungen erkunden, die Aspose.HTML für .NET bietet. Sie erfahren, wie Sie diese Erweiterungen nahtlos in Ihre Projekte integrieren und Ihre Webanwendungen dynamischer und interaktiver gestalten können. -## Umbau-Tutorials für alle Fälle +## Umbau‑Tutorials für alle Fälle -Bei der Webentwicklung müssen HTML-Dokumente häufig in verschiedene Formate konvertiert werden. Aspose.HTML für .NET vereinfacht diesen Prozess. Unsere Tutorials führen Sie durch die Schritte zur Konvertierung von HTML in PDF, Bildformate und mehr. Egal, ob Sie Berichte erstellen, Inhalte freigeben oder einfach die Benutzererfahrung verbessern möchten, diese Konvertierungs-Tutorials helfen Ihnen dabei. +Bei der Webentwicklung müssen HTML‑Dokumente häufig in verschiedene Formate konvertiert werden. Aspose.HTML für .NET vereinfacht diesen Prozess. Unsere Tutorials führen Sie durch die Schritte zur Konvertierung von HTML in PDF, Bildformate und mehr. Egal, ob Sie Berichte erstellen, Inhalte freigeben oder einfach die Benutzererfahrung verbessern möchten, diese Konvertierungs‑Tutorials helfen Ihnen dabei. ## Erste Schritte mit Aspose.HTML -Sind Sie bereit, loszulegen? Die Tutorials von Aspose.HTML für .NET richten sich sowohl an Anfänger als auch an erfahrene Entwickler. Egal, ob Sie neu bei HTML-Erweiterungen und -Konvertierungen sind oder fortgeschrittene Tipps suchen, unsere Schritt-für-Schritt-Anleitungen sind auf Ihre Bedürfnisse zugeschnitten. +Sind Sie bereit, loszulegen? Die Tutorials von Aspose.HTML für .NET richten sich sowohl an Anfänger als auch an erfahrene Entwickler. Egal, ob Sie neu bei HTML‑Erweiterungen und -Konvertierungen sind oder fortgeschrittene Tipps suchen, unsere Schritt‑für‑Schritt‑Anleitungen sind auf Ihre Bedürfnisse zugeschnitten. ## Warum Aspose.HTML für .NET? -Aspose.HTML für .NET ist nicht nur eine Bibliothek; es verändert die Welt der Webentwicklung grundlegend. Es bietet eine umfassende Palette an Funktionen und Tools, die Ihre HTML-bezogenen Aufgaben rationalisieren. Am Ende dieser Tutorials verfügen Sie über das Wissen und die Fähigkeiten, um das Potenzial von Aspose.HTML für .NET optimal zu nutzen. +Aspose.HTML für .NET ist nicht nur eine Bibliothek; es verändert die Welt der Webentwicklung grundlegend. Es bietet eine umfassende Palette an Funktionen und Tools, die Ihre HTML‑bezogenen Aufgaben rationalisieren. Am Ende dieser Tutorials verfügen Sie über das Wissen und die Fähigkeiten, um das Potenzial von Aspose.HTML für .NET optimal zu nutzen. ## Tutorials zu HTML-Erweiterungen und -Konvertierungen ### [Konvertieren Sie HTML in .NET in PDF mit Aspose.HTML](./convert-html-to-pdf/) -Konvertieren Sie HTML mühelos in PDF mit Aspose.HTML für .NET. Folgen Sie unserer Schritt-für-Schritt-Anleitung und entfesseln Sie die Leistungsfähigkeit der HTML-zu-PDF-Konvertierung. +Konvertieren Sie HTML mühelos in PDF mit Aspose.HTML für .NET. Folgen Sie unserer Schritt‑für‑Schritt‑Anleitung und entfesseln Sie die Leistungsfähigkeit der HTML‑zu‑PDF‑Konvertierung. + +### [HTML in PDF mit C# – Komplettanleitung](./convert-html-to-pdf-with-c-complete-guide/) +Erfahren Sie, wie Sie HTML mit C# und Aspose.HTML in PDF konvertieren – vollständige Schritt‑für‑Schritt‑Anleitung. + ### [Konvertieren Sie EPUB in .NET mit Aspose.HTML in ein Bild](./convert-epub-to-image/) -Erfahren Sie, wie Sie mit Aspose.HTML für .NET EPUB in Bilder konvertieren. Schritt-für-Schritt-Anleitung mit Codebeispielen und anpassbaren Optionen. +Erfahren Sie, wie Sie mit Aspose.HTML für .NET EPUB in Bilder konvertieren. Schritt‑für‑Schritt‑Anleitung mit Codebeispielen und anpassbaren Optionen. ### [Konvertieren Sie EPUB in .NET mit Aspose.HTML in PDF](./convert-epub-to-pdf/) -Erfahren Sie, wie Sie mit Aspose.HTML für .NET EPUB in PDF konvertieren. Diese Schritt-für-Schritt-Anleitung umfasst Anpassungsoptionen, FAQs und mehr für eine nahtlose Dokumentkonvertierung. +Erfahren Sie, wie Sie mit Aspose.HTML für .NET EPUB in PDF konvertieren. Diese Schritt‑für‑Schritt‑Anleitung umfasst Anpassungsoptionen, FAQs und mehr für eine nahtlose Dokumentkonvertierung. ### [Konvertieren Sie EPUB in XPS in .NET mit Aspose.HTML](./convert-epub-to-xps/) -Erfahren Sie, wie Sie mit Aspose.HTML für .NET EPUB in XPS in .NET konvertieren. Folgen Sie unserer Schritt-für-Schritt-Anleitung für mühelose Konvertierungen. +Erfahren Sie, wie Sie mit Aspose.HTML für .NET EPUB in XPS in .NET konvertieren. Folgen Sie unserer Schritt‑für‑Schritt‑Anleitung für mühelose Konvertierungen. ### [Konvertieren Sie HTML in BMP in .NET mit Aspose.HTML](./convert-html-to-bmp/) Erfahren Sie, wie Sie mit Aspose.HTML für .NET HTML in BMP in .NET konvertieren. Umfassender Leitfaden für Webentwickler zur Nutzung von Aspose.HTML für .NET. ### [Konvertieren Sie HTML in .NET in DOC und DOCX mit Aspose.HTML](./convert-html-to-doc-docx/) -Erfahren Sie in dieser Schritt-für-Schritt-Anleitung, wie Sie die Leistung von Aspose.HTML für .NET nutzen. Konvertieren Sie HTML mühelos in DOCX und verbessern Sie Ihre .NET-Projekte. Legen Sie noch heute los! +Erfahren Sie in dieser Schritt‑für‑Schritt‑Anleitung, wie Sie die Leistung von Aspose.HTML für .NET nutzen. Konvertieren Sie HTML mühelos in DOCX und verbessern Sie Ihre .NET‑Projekte. Legen Sie noch heute los! ### [Konvertieren Sie HTML in GIF in .NET mit Aspose.HTML](./convert-html-to-gif/) -Entdecken Sie die Leistungsfähigkeit von Aspose.HTML für .NET: Eine Schritt-für-Schritt-Anleitung zur Konvertierung von HTML in GIF. Voraussetzungen, Codebeispiele, FAQs und mehr! Optimieren Sie Ihre HTML-Manipulation mit Aspose.HTML. +Entdecken Sie die Leistungsfähigkeit von Aspose.HTML für .NET: Eine Schritt‑für‑Schritt‑Anleitung zur Konvertierung von HTML in GIF. Voraussetzungen, Codebeispiele, FAQs und mehr! Optimieren Sie Ihre HTML‑Manipulation mit Aspose.HTML. ### [Konvertieren Sie HTML in JPEG in .NET mit Aspose.HTML](./convert-html-to-jpeg/) -Erfahren Sie, wie Sie mit Aspose.HTML für .NET HTML in JPEG in .NET konvertieren. Eine Schritt-für-Schritt-Anleitung zur Nutzung der Leistungsfähigkeit von Aspose.HTML für .NET. Optimieren Sie Ihre Webentwicklungsaufgaben mühelos. +Erfahren Sie, wie Sie mit Aspose.HTML für .NET HTML in JPEG in .NET konvertieren. Eine Schritt‑für‑Schritt‑Anleitung zur Nutzung der Leistungsfähigkeit von Aspose.HTML für .NET. Optimieren Sie Ihre Webentwicklungsaufgaben mühelos. ### [Konvertieren Sie HTML in .NET in Markdown mit Aspose.HTML](./convert-html-to-markdown/) -Erfahren Sie, wie Sie HTML in .NET mit Aspose.HTML in Markdown konvertieren, um Inhalte effizient zu bearbeiten. Erhalten Sie eine Schritt-für-Schritt-Anleitung für einen nahtlosen Konvertierungsprozess. +Erfahren Sie, wie Sie HTML in .NET mit Aspose.HTML in Markdown konvertieren, um Inhalte effizient zu bearbeiten. Erhalten Sie eine Schritt‑für‑Schritt‑Anleitung für einen nahtlosen Konvertierungsprozess. ### [Konvertieren Sie HTML in MHTML in .NET mit Aspose.HTML](./convert-html-to-mhtml/) -Konvertieren Sie HTML in .NET in MHTML mit Aspose.HTML – Eine Schritt-für-Schritt-Anleitung zum effizienten Archivieren von Webinhalten. Erfahren Sie, wie Sie mit Aspose.HTML für .NET MHTML-Archive erstellen. +Konvertieren Sie HTML in .NET in MHTML mit Aspose.HTML – Eine Schritt‑für‑Schritt‑Anleitung zum effizienten Archivieren von Webinhalten. Erfahren Sie, wie Sie mit Aspose.HTML für .NET MHTML‑Archive erstellen. ### [Konvertieren Sie HTML in PNG in .NET mit Aspose.HTML](./convert-html-to-png/) -Entdecken Sie, wie Sie mit Aspose.HTML für .NET HTML-Dokumente bearbeiten und konvertieren. Schritt-für-Schritt-Anleitung für effektive .NET-Entwicklung. +Entdecken Sie, wie Sie mit Aspose.HTML für .NET HTML‑Dokumente bearbeiten und konvertieren. Schritt‑für‑Schritt‑Anleitung für effektive .NET‑Entwicklung. ### [Konvertieren Sie HTML in TIFF in .NET mit Aspose.HTML](./convert-html-to-tiff/) -Erfahren Sie, wie Sie mit Aspose.HTML für .NET HTML in TIFF konvertieren. Folgen Sie unserer Schritt-für-Schritt-Anleitung zur effizienten Optimierung von Webinhalten. +Erfahren Sie, wie Sie mit Aspose.HTML für .NET HTML in TIFF konvertieren. Folgen Sie unserer Schritt‑für‑Schritt‑Anleitung zur effizienten Optimierung von Webinhalten. ### [Konvertieren Sie HTML in XPS in .NET mit Aspose.HTML](./convert-html-to-xps/) -Entdecken Sie die Leistungsfähigkeit von Aspose.HTML für .NET: Konvertieren Sie HTML mühelos in XPS. Voraussetzungen, Schritt-für-Schritt-Anleitung und FAQs inklusive. +Entdecken Sie die Leistungsfähigkeit von Aspose.HTML für .NET: Konvertieren Sie HTML mühelos in XPS. Voraussetzungen, Schritt‑für‑Schritt‑Anleitung und FAQs inklusive. ### [HTML in C# zippen – HTML in Zip speichern](./how-to-zip-html-in-c-save-html-to-zip/) -Erfahren Sie, wie Sie HTML-Inhalte mit Aspose.HTML für .NET in eine ZIP-Datei komprimieren und speichern. -### [HTML-Dokument mit formatiertem Text erstellen und in PDF exportieren – Vollständige Anleitung](./create-html-document-with-styled-text-and-export-to-pdf-full/) -Erfahren Sie, wie Sie ein HTML-Dokument mit formatiertem Text erstellen und es mit Aspose.HTML für .NET in ein PDF exportieren. +Erfahren Sie, wie Sie HTML‑Inhalte mit Aspose.HTML für .NET in eine ZIP‑Datei komprimieren und speichern. +### [HTML‑Dokument mit formatiertem Text erstellen und in PDF exportieren – Vollständige Anleitung](./create-html-document-with-styled-text-and-export-to-pdf-full/) +Erfahren Sie, wie Sie ein HTML‑Dokument mit formatiertem Text erstellen und es mit Aspose.HTML für .NET in ein PDF exportieren. ### [PDF aus HTML erstellen – C# Schritt‑für‑Schritt‑Anleitung](./create-pdf-from-html-c-step-by-step-guide/) Erstellen Sie PDF aus HTML mit C# – eine detaillierte Schritt‑für‑Schritt‑Anleitung mit Aspose.HTML für .NET. ### [HTML als ZIP speichern – Komplettes C#‑Tutorial](./save-html-as-zip-complete-c-tutorial/) Erfahren Sie, wie Sie HTML‑Inhalte mit Aspose.HTML für .NET in ein ZIP‑Archiv speichern – vollständige Schritt‑für‑Schritt‑Anleitung in C#. ### [HTML in ZIP speichern in C# – Komplettes In‑Memory‑Beispiel](./save-html-to-zip-in-c-complete-in-memory-example/) -Speichern Sie HTML-Inhalte in ein ZIP-Archiv komplett im Speicher mit Aspose.HTML für .NET. Schritt‑für‑Schritt‑Anleitung. +Speichern Sie HTML‑Inhalte in ein ZIP‑Archiv komplett im Speicher mit Aspose.HTML für .NET. Schritt‑für‑Schritt‑Anleitung. +### [HTML als ZIP speichern – Vollständige Anleitung für Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Erfahren Sie, wie Sie HTML‑Inhalte mit Aspose.HTML für .NET in ein ZIP‑Archiv komprimieren und speichern – komplette Schritt‑für‑Schritt‑Anleitung. +### [HTML als PDF rendern in C# – Vollständige Schritt‑für‑Schritt‑Anleitung](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Erfahren Sie, wie Sie HTML mit C# und Aspose.HTML in PDF rendern – vollständige Schritt‑für‑Schritt‑Anleitung. ## Abschluss diff --git a/html/german/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/german/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..1a406ad28 --- /dev/null +++ b/html/german/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,259 @@ +--- +category: general +date: 2026-05-22 +description: HTML in PDF in C# mit Aspose.HTML konvertieren. Erfahren Sie, wie Sie + HTML in PDF in C# mit Schritt‑für‑Schritt‑Code, Optionen und Hinweisen für Linux + rendern. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: de +og_description: HTML in PDF in C# mit Aspose.HTML konvertieren. Dieser Leitfaden zeigt, + wie man HTML in PDF in C# rendert, wobei klare Optionen und Linux‑freundliche Hinweise + verwendet werden. +og_title: HTML mit C# in PDF konvertieren – Vollständige Anleitung +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: HTML mit C# in PDF konvertieren – Vollständige Anleitung +url: /de/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML zu PDF mit C# – Komplettanleitung + +Wenn Sie **HTML schnell in PDF konvertieren** müssen, macht Aspose.HTML für .NET das ganz einfach. In diesem Tutorial beantworten wir außerdem **wie man HTML zu PDF in C# rendert** mit voller Kontrolle über die Rendering‑Optionen, sodass Sie nicht im Dunkeln tappen. + +Stellen Sie sich vor, Sie haben eine Marketing‑E‑Mail‑Vorlage, eine Quittungsseite oder einen komplexen Bericht, der mit modernem CSS erstellt wurde, und Sie müssen ihn als PDF an einen Kunden oder Drucker übergeben. Das manuell zu erledigen ist mühsam, aber ein paar Zeilen C#‑Code können die gesamte Pipeline automatisieren. Am Ende dieses Leitfadens besitzen Sie eine eigenständige, produktionsreife Lösung, die sowohl unter Windows *als auch* Linux funktioniert. + +## Was Sie benötigen + +- **.NET 6.0 oder höher** – Aspose.HTML zielt auf .NET Standard 2.0+ ab, sodass jedes aktuelle SDK funktioniert. +- **Aspose.HTML for .NET** NuGet‑Paket (`Aspose.Html`) – Sie benötigen eine gültige Lizenz für die Produktion, aber die kostenlose Testversion funktioniert für Tests. +- Eine **einfache HTML‑Datei**, die Sie in ein PDF umwandeln möchten (wir nennen sie `input.html`). +- Ihre bevorzugte IDE (Visual Studio, Rider oder VS Code) – keine spezielle Tool‑Kette nötig. + +Das war’s. Keine externen PDF‑Konverter, keine Kommandozeilen‑Akrobatik. Nur reines C#. + +![Diagramm, das den Workflow zum Konvertieren von HTML zu PDF mit Aspose.HTML](/images/convert-html-to-pdf-workflow.png "Workflow zum Konvertieren von HTML zu PDF") + +## HTML zu PDF – Vollständige Implementierung + +Unten finden Sie das komplette, sofort lauffähige Programm. Kopieren Sie es in eine neue Konsolen‑App, stellen Sie die NuGet‑Pakete wieder her und drücken Sie **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Warum das funktioniert + +- **`Document`** ist der Einstiegspunkt von Aspose.HTML; es parsed das HTML, löst CSS auf und baut ein DOM, das bereit zum Rendern ist. +- **`PdfRenderingOptions`** lässt Sie die Ausgabe anpassen. Das Flag `UseHinting` ist das Geheimnis für gestochen scharfen Text in headless Linux‑Containern, wo der Standard‑Rasterizer unscharf wirken kann. +- **`Save`** übernimmt die schwere Arbeit: Es rastert das DOM auf PDF‑Seiten, respektiert Seitenumbrüche und bettet Schriften automatisch ein. + +Wenn Sie das Programm ausführen, wird `output.pdf` direkt neben Ihrer Quelldatei erzeugt. Öffnen Sie es mit einem beliebigen PDF‑Viewer und Sie sollten eine getreue visuelle Übereinstimmung zum ursprünglichen HTML sehen. + +## Wie man HTML zu PDF in C# rendert – Schritt für Schritt + +Im Folgenden zerlegen wir den Prozess in handliche Stücke und erklären **wie man HTML zu PDF in C# rendert**, während wir häufige Stolperfallen behandeln. + +### Schritt 1 – Installieren Sie das Aspose.HTML NuGet‑Paket + +Öffnen Sie Ihr Terminal im Projektordner und führen Sie aus: + +```bash +dotnet add package Aspose.Html +``` + +Wenn Sie die Visual‑Studio‑Benutzeroberfläche bevorzugen, klicken Sie mit der rechten Maustaste auf das Projekt → **Manage NuGet Packages** → suchen Sie nach **Aspose.Html** und installieren Sie die neueste stabile Version. + +> **Pro‑Tipp:** Nach der Installation fügen Sie eine Lizenzdatei (`Aspose.Total.lic`) im Stammverzeichnis Ihres Projekts hinzu, um Evaluations‑Wasserzeichen zu vermeiden. + +### Schritt 2 – Laden Sie Ihr HTML korrekt + +Aspose.HTML kann verarbeiten: + +- Lokale Dateipfade (`new Document("file.html")`) +- URLs (`new Document("https://example.com")`) +- Roh‑HTML‑Strings (`new Document("…", new HtmlLoadOptions())`) + +Wenn Sie aus dem Dateisystem laden, stellen Sie sicher, dass der Pfad absolut ist oder das Arbeitsverzeichnis passend gesetzt wurde, sonst erhalten Sie eine `FileNotFoundException`. Unter Linux verwenden Sie Vorwärtsschrägstriche (`/`) oder `Path.Combine`. + +### Schritt 3 – Wählen Sie die richtigen Rendering‑Optionen + +Abgesehen von `UseHinting` möchten Sie vielleicht folgende Einstellungen anpassen: + +| Option | Was es macht | Wann zu verwenden | +|--------|--------------|-------------------| +| `PageSize` | Legt die PDF‑Seitengröße fest (A4, Letter, benutzerdefiniert) | An die Zielpapiergröße anpassen | +| `Landscape` | Dreht die Seite ins Querformat | Breite Tabellen oder Diagramme | +| `RasterizeVectorGraphics` | Erzwingt die Umwandlung von Vektorgrafiken in Rasterbilder | Wenn der PDF‑Empfänger SVG nicht verarbeiten kann | +| `CompressionLevel` | Steuert die Bildkompression (0‑9) | Dateigröße für E‑Mail‑Anhänge reduzieren | + +Sie können diese Eigenschaften flüssig verketten: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Schritt 4 – PDF speichern + +Die `Save`‑Methode, die Sie im vollständigen Beispiel sehen, schreibt direkt in einen Dateipfad. Sie können das PDF auch in den Speicher streamen: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Das ist praktisch, wenn Sie das PDF als Download aus einer Web‑API zurückgeben müssen. + +### Schritt 5 – Ausgabe überprüfen + +Ein schneller Plausibilitäts‑Check besteht darin, die PDF‑Seitenzahl mit der erwarteten Anzahl an HTML‑Abschnitten zu vergleichen. Sie können das mit Aspose.PDF wieder einlesen: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Wenn die Anzahl nicht stimmt, überprüfen Sie die CSS‑`page-break`‑Regeln oder passen Sie `PdfRenderingOptions` entsprechend an. + +## Sonderfälle & häufige Stolperfallen + +| Situation | Worauf zu achten ist | Lösung | +|-----------|----------------------|--------| +| **Externe Ressourcen (Bilder, Schriften) fehlen** | Relative URLs werden relativ zum Ordner der HTML‑Datei aufgelöst. | Verwenden Sie `HtmlLoadOptions.BaseUri`, um auf das korrekte Stammverzeichnis zu zeigen. | +| **Linux‑Headless‑Umgebung** | Standard‑Text‑Rendering kann verschwommen sein. | Setzen Sie `UseHinting = true` (wie gezeigt) und stellen Sie sicher, dass `libgdiplus` installiert ist, falls Sie auf System.Drawing zurückgreifen. | +| **Großes HTML (> 10 MB)** | Der Speicherverbrauch steigt während des Renderns stark an. | Rendern Sie Seite für Seite mit `PdfRenderer` und `PdfRenderingOptions` und entsorgen Sie jede Seite nach dem Speichern. | +| **JavaScript‑intensive Seiten** | Aspose.HTML führt kein JS aus; dynamischer Inhalt bleibt statisch. | Vorverarbeiten Sie das HTML serverseitig (z. B. mit Puppeteer), bevor Sie es an Aspose.HTML übergeben. | +| **Unicode‑Zeichen werden als Kästchen angezeigt** | Fehlende Schriften in der Laufzeitumgebung. | Betten Sie benutzerdefinierte Schriften über `FontSettings` ein oder stellen Sie sicher, dass das OS die benötigten Schriften installiert hat. | + +## Vollständiges funktionierendes Beispiel – Zusammenfassung + +Hier ist das gesamte Programm noch einmal, ohne Kommentare für diejenigen, die eine kompakte Ansicht bevorzugen: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Führen Sie es aus, öffnen Sie `output.pdf` und Sie sehen eine pixelgenaue Kopie von `input.html`. Das ist das Wesentliche von **HTML zu PDF konvertieren** mit Aspose.HTML. + +## Fazit + +Wir haben alles durchgegangen, was Sie benötigen, um **HTML in PDF** mit C# zu **konvertieren**: Installation von Aspose.HTML, Laden von HTML, Anpassen der Rendering‑Optionen (inklusive des entscheidenden `UseHinting`‑Flags) und Speichern des finalen PDFs. Sie verstehen jetzt **wie man HTML zu PDF in C# rendert** für Windows‑ und Linux‑Umgebungen und kennen gängige Sonderfälle wie fehlende Ressourcen und große Dateien. + +Was kommt als Nächstes? Versuchen Sie folgendes hinzuzufügen: + +- **Kopf‑/Fußzeilen** mit `PdfPageTemplate` für Branding. +- **Passwortschutz** via `PdfSaveOptions`. +- **Batch‑Konvertierung** durch Durchlaufen eines Ordners von + +## Verwandte Tutorials + +- [HTML zu PDF in .NET mit Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [EPUB zu PDF in .NET mit Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [SVG zu PDF in .NET mit Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/german/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/german/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..61018be21 --- /dev/null +++ b/html/german/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,295 @@ +--- +category: general +date: 2026-05-22 +description: HTML mit C# als PDF rendern – ein kurzes Beispiel. Erfahren Sie, wie + Sie HTML mit C# schnell und zuverlässig in PDF konvertieren. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: de +og_description: HTML in PDF in C# rendern mit einem klaren, ausführbaren Beispiel. + Dieser Leitfaden zeigt Ihnen, wie Sie HTML in PDF in C# konvertieren und ein PDF + aus einer HTML‑Datei erzeugen. +og_title: HTML als PDF rendern in C# – Komplettes Programmier‑Tutorial +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: HTML in C# als PDF rendern – Vollständige Schritt‑für‑Schritt‑Anleitung +url: /de/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML in PDF rendern in C# – Vollständige Schritt‑für‑Schritt‑Anleitung + +Haben Sie jemals **HTML als PDF rendern** müssen, waren sich aber nicht sicher, welche Bibliothek Sie für ein .NET‑Projekt wählen sollen? Sie sind nicht allein. In vielen Business‑Anwendungen werden Sie **HTML zu PDF C#** für Rechnungen, Berichte oder Marketing‑Broschüren benötigen – im Grunde jedes Mal, wenn Sie eine druckbare Version einer Webseite benötigen. + +Hier ist die Sache: Sie müssen das Rad nicht neu erfinden. Mit ein paar Code‑Zeilen können Sie eine `input.html`‑Datei nehmen, sie an eine bewährte Rendering‑Engine übergeben und erhalten ein gestochen scharfes `output.pdf`. In diesem Tutorial gehen wir den gesamten Prozess durch, von der Installation des richtigen NuGet‑Pakets bis hin zur Behandlung von Randfällen wie externem CSS. Am Ende können Sie **PDF aus HTML‑Datei generieren** in wenigen Minuten. + +## Was Sie lernen werden + +- Wie Sie eine .NET‑Konsolen‑App einrichten, die **PDF aus HTML C#** erstellt. +- Die genauen API‑Aufrufe, die Sie benötigen, um **HTML‑Dokument als PDF zu speichern**. +- Warum bestimmte Rendering‑Optionen (wie Hinting) für die Textqualität wichtig sind. +- Tipps zur Fehlersuche bei häufigen Stolpersteinen wie fehlenden Schriften oder relativen Bildpfaden. + +**Voraussetzungen** – Sie sollten .NET 6+ oder .NET Framework 4.7 installiert haben, Grundkenntnisse in C# besitzen und eine IDE (Visual Studio 2022, Rider oder VS Code) verwenden. Vorkenntnisse im PDF‑Bereich sind nicht nötig. + +--- + +## HTML als PDF rendern – Projekt einrichten + +Bevor wir in den Code eintauchen, stellen wir sicher, dass die Entwicklungsumgebung bereit ist. Die Bibliothek, die wir verwenden, ist **Select.Pdf** (kostenlos für nicht‑kommerzielle Nutzung), weil sie eine einfache API und solide Rendering‑Treue bietet. + +### PDF‑Rendering‑Bibliothek installieren (convert html to pdf c#) + +Öffnen Sie ein Terminal in Ihrem Projektordner und führen Sie aus: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Wenn Sie Visual Studio benutzen, können Sie das Paket auch über die NuGet Package Manager‑UI hinzufügen. Die Versionsnummer kann neuer sein – holen Sie einfach die neueste stabile Version. + +### Konsolen‑Skeleton erstellen + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Das ist alles, was Sie an Boilerplate benötigen. Das eigentliche Schwergewicht passiert innerhalb von `Main`. + +## HTML‑Dokument laden (generate pdf from html file) + +Der erste echte Schritt besteht darin, den Renderer auf eine HTML‑Datei auf der Festplatte zu verweisen. Select.Pdf bietet zwei bequeme Wege: einen rohen HTML‑String oder einen Dateipfad zu übergeben. Die Verwendung einer Datei hält die Dinge ordentlich, besonders wenn Sie verknüpftes CSS oder Bilder haben. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Hier prüfen wir zusätzlich, ob die Datei fehlt – ein häufiges Problem für Einsteiger, die vergessen, die HTML‑Datei in den Ausgabepfad zu kopieren. + +## Rendering‑Optionen konfigurieren (create pdf from html c#) + +Select.Pdf liefert ein umfangreiches `PdfDocumentOptions`‑Objekt. Für scharfen Text aktivieren wir Hinting, das Glyphen glättet, allerdings mit einem winzigen Performance‑Einbruch. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Sie können hier Seitenformat, Ränder oder sogar eine benutzerdefinierte Schrift einbetten. Die zentrale Erkenntnis ist, dass **render html as pdf** kein Einzeiler ist; Sie haben die Kontrolle über das Aussehen des finalen Dokuments. + +## HTML‑Dokument als PDF speichern (render html as pdf) + +Jetzt passiert die Magie. Wir übergeben dem Konverter den Pfad zu unserer HTML‑Datei und lassen ihn ein PDF auf die Festplatte schreiben. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +Die Methode `ConvertUrl` löst relative URLs (Bilder, CSS) automatisch basierend auf dem Speicherort der HTML‑Datei auf, weshalb dieser Ansatz für die meisten realen Szenarien robust ist. + +### Erwartete Ausgabe + +Nach dem Ausführen des Programms sollten Sie eine Datei `output.pdf` im selben Ordner sehen. Öffnen Sie sie – Sie werden bemerken: + +- Text, der mit klarer Anti‑Aliasing gerendert wird (dank Hinting). +- Styles aus verknüpftem CSS werden korrekt angewendet. +- Bilder werden in exakt der im Quell‑HTML definierten Größe angezeigt. + +Falls etwas nicht stimmt, prüfen Sie, ob die CSS‑ und Bilddateien neben `input.html` liegen oder verwenden Sie absolute URLs. + +## Häufige Randfälle behandeln + +### 1. Externe Ressourcen durch Firewalls blockiert + +Wenn Ihr HTML Schriftarten von einem CDN referenziert, das Ihr Server nicht erreichen kann, fällt das PDF auf eine generische Schrift zurück. Um das zu vermeiden, laden Sie die Schriftdateien lokal herunter oder betten Sie sie mit `@font-face` und einem relativen Pfad ein. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Sehr große HTML‑Dateien + +Beim Konvertieren riesiger Dokumente können Speichergrenzen erreicht werden. Select.Pdf ermöglicht das Streamen der Konvertierung: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Streaming hält den Prozess leichtgewichtig, erfordert jedoch, dass Sie das HTML als String bereitstellen, den Sie bei Bedarf in Teilen einlesen können. + +### 3. Benutzerdefinierte Header oder Footer + +Wenn Sie eine Seitenzahl oder ein Firmenlogo auf jeder Seite benötigen, setzen Sie die Eigenschaften `Header` und `Footer` auf `converter.Options`, bevor Sie `ConvertUrl` aufrufen. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +## Vollständiges funktionierendes Beispiel (Alle Schritte kombiniert) + +Unten finden Sie das komplette, copy‑and‑paste‑bereite Programm. Ersetzen Sie `YOUR_DIRECTORY` durch den absoluten Pfad, in dem Ihre HTML‑Datei liegt. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Ausführen:** `dotnet run` aus dem Projektverzeichnis. Wenn alles korrekt eingerichtet ist, sehen Sie die Erfolgsmeldung und ein glänzendes `output.pdf`. + +## Visuelle Zusammenfassung + +![Render HTML as PDF example](render-html-as-pdf.png){alt="Beispiel für HTML zu PDF rendern"} + +Der Screenshot zeigt die Konsolenausgabe und das resultierende PDF, das in einem Viewer geöffnet ist. Beachten Sie die scharfen Überschriften und korrekt geladenen Bilder – genau das, was Sie erwarten, wenn Sie **render html as pdf**. + +## Fazit + +Sie haben gerade gelernt, wie man **HTML als PDF rendern** in einer C#‑Anwendung durchführt, von der Installation der Bibliothek bis zur Feinabstimmung der Rendering‑Optionen. Das vollständige Beispiel demonstriert einen zuverlässigen Weg, **HTML zu PDF C#** zu **konvertieren**, **PDF aus HTML‑Datei zu generieren** und **HTML‑Dokument als PDF zu speichern** mit nur wenigen Zeilen Code. + +Was kommt als Nächstes? Experimentieren Sie mit: + +- Hinzufügen benutzerdefinierter Schriften für Marken‑Konsistenz. +- Generieren von PDFs aus dynamischen HTML‑Strings (z. B. Razor‑Templates). +- Zusammenführen mehrerer PDFs zu einem einzigen Bericht mittels `PdfDocument.AddPage`. + +Jede dieser Erweiterungen baut auf den hier behandelten Kernkonzepten auf, sodass Sie bereit sind, komplexere Szenarien ohne steile Lernkurve zu meistern. + +Haben Sie Fragen oder sind Sie auf ein Problem gestoßen? Hinterlassen Sie unten einen Kommentar, und wir lösen das gemeinsam. Happy coding! + +## Verwandte Tutorials + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Create HTML Document with Styled Text and Export to PDF – Full Guide](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Convert HTML to PDF with Aspose.HTML – Full Manipulation Guide](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/german/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/german/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..61bad857d --- /dev/null +++ b/html/german/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,230 @@ +--- +category: general +date: 2026-05-22 +description: Speichern Sie HTML schnell als ZIP mit Aspose.HTML. Erfahren Sie, wie + Sie HTML‑Dateien zippen, HTML zu ZIP rendern und HTML in eine ZIP‑Datei exportieren + – mit vollständigem Code. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: de +og_description: Speichern Sie HTML als ZIP mit Aspose.HTML. Dieser Leitfaden zeigt, + wie Sie HTML in ZIP rendern, HTML in eine ZIP‑Datei exportieren und HTML‑Dateien + programmgesteuert zippen. +og_title: HTML als ZIP speichern – Komplettes Aspose.HTML‑Tutorial +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: HTML als ZIP speichern – Komplettanleitung für Aspose.HTML +url: /de/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML als ZIP speichern – Komplett‑Anleitung für Aspose.HTML + +Haben Sie sich schon einmal gefragt, wie man **HTML als ZIP** speichert, ohne ein separates Archivierungs‑Tool zu verwenden? Sie sind nicht allein. Viele Entwickler müssen eine HTML‑Seite zusammen mit ihren Bildern, CSS‑Dateien und Skripten bündeln, um sie einfach zu verteilen, und das manuelle Vorgehen wird schnell zum Problem. + +In diesem Tutorial führen wir Sie Schritt für Schritt durch eine saubere End‑to‑End‑Lösung, die **HTML zu ZIP rendert** mit Aspose.HTML für .NET. Am Ende wissen Sie genau, wie Sie **HTML in eine ZIP‑Datei exportieren** und sehen außerdem Varianten, **wie man HTML‑Dateien zippt** in unterschiedlichen Szenarien. + +> *Pro‑Tipp:* Der gezeigte Ansatz funktioniert sowohl beim Verpacken einer einzelnen Seite als auch eines gesamten Site‑Ordners. + +## Was Sie benötigen + +Bevor wir starten, stellen Sie sicher, dass Sie folgendes haben: + +- .NET 6 (oder irgendeine aktuelle .NET‑Runtime) installiert. +- Das NuGet‑Paket **Aspose.HTML für .NET** (`Aspose.Html`) in Ihrem Projekt referenziert. +- Eine einfache `input.html`‑Datei in einem Ordner Ihrer Wahl. +- Ein wenig C#‑Erfahrung – nichts Besonderes, nur die Grundlagen. + +Das war’s. Keine externen ZIP‑Utilities, keine Kommandozeilen‑Akrobatik. Los geht’s. + +![Diagramm, das den Prozess des Speicherns von HTML als ZIP mit Aspose.HTML zeigt](save-html-as-zip.png) + +*Bild‑Alt‑Text: Diagramm zum Prozess „HTML als ZIP speichern“* + +## Schritt 1: Das Quell‑HTML‑Dokument laden + +Als erstes müssen wir Aspose.HTML mitteilen, wo unser Quell‑HTML liegt. Die Klasse `HTMLDocument` liest die Datei ein und baut ein In‑Memory‑DOM, das bereit zum Rendern ist. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Warum das wichtig ist: Das Laden des Dokuments gibt der Bibliothek die volle Kontrolle über die Auflösung von Ressourcen (Bilder, CSS, Schriften). Wenn das HTML relative Pfade verwendet, löst Aspose.HTML diese automatisch relativ zum Ordner der Datei auf. + +## Schritt 2: (Optional) Einen benutzerdefinierten Resource‑Handler erstellen + +Falls Sie jede Ressource inspizieren oder manipulieren möchten – zum Beispiel, um Bilder zu komprimieren, bevor sie ins Archiv gelangen – können Sie einen `ResourceHandler` einbinden. Dieser Schritt ist optional, aber er ist der flexibelste Weg, **HTML in ein ZIP‑Archiv zu konvertieren** mit eigener Logik. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Was, wenn Sie keine spezielle Verarbeitung benötigen?* Überspringen Sie einfach diese Klasse und verwenden Sie den Standard‑Handler – Aspose.HTML schreibt die Ressourcen direkt ins ZIP. + +## Schritt 3: Speicheroptionen konfigurieren, um den Handler zu verwenden + +Das Objekt `HtmlSaveOptions` sagt dem Renderer, was mit den Ressourcen geschehen soll. Durch Zuweisung unseres `MyResourceHandler` erhalten wir die volle Kontrolle über die Ausgabe. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Beachten Sie, dass die Property `ResourceHandler` direkt die Fähigkeit **HTML zu ZIP rendern** referenziert. Hier passiert die Magie: Jede verknüpfte Ressource wird in das Archiv gestreamt, anstatt auf die Festplatte geschrieben zu werden. + +## Schritt 4: Das gerenderte Dokument in ein ZIP‑Archiv speichern + +Jetzt exportieren wir endlich **HTML in eine ZIP‑Datei**. Die Methode `Save` akzeptiert jeden `Stream`, sodass wir ihr einen `FileStream` übergeben können, der `result.zip` erzeugt. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Damit ist der gesamte Workflow abgeschlossen. Wenn der Code fertig ist, enthält `result.zip`: + +- `input.html` (das ursprüngliche Markup) +- Alle referenzierten Bilder, CSS‑Dateien und Schriften +- Alle transformierten Ressourcen, falls Sie sie in `MyResourceHandler` angepasst haben + +## HTML‑Dateien ohne Aspose.HTML zippen (Schnelle Alternative) + +Manchmal benötigen Sie einfach einen altmodischen **Wie man HTML‑Dateien zippt**‑Ansatz, etwa weil Sie bereits einen anderen HTML‑Parser verwenden. In diesem Fall können Sie .NETs integriertes `System.IO.Compression` nutzen: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Diese Methode ist simpel, enthält jedoch keinen Rendering‑Schritt; sie packt lediglich das, was bereits auf der Festplatte liegt. Wenn Ihr HTML externe URLs referenziert, werden diese Ressourcen nicht mit eingeschlossen. Deshalb ist der Aspose.HTML‑Weg zu bevorzugen, wenn Sie eine zuverlässige **HTML‑zu‑ZIP‑Lösung** benötigen. + +## Randfälle & häufige Stolperfallen + +| Situation | Worauf zu achten ist | Empfohlene Lösung | +|-----------|----------------------|-------------------| +| **Große Bilder** | Der Speicherverbrauch steigt, weil jedes Bild in einen `MemoryStream` geladen wird. | Direkt in das ZIP streamen mittels eines benutzerdefinierten Handlers, der den Quell‑Stream kopiert, anstatt vollständig zu puffern. | +| **Externe URLs** | Ressourcen, die im Internet gehostet werden, werden nicht automatisch heruntergeladen. | `HtmlLoadOptions` mit `BaseUrl` auf das Site‑Root setzen oder Ressourcen vor dem Speichern manuell herunterladen. | +| **Dateinamen‑Kollisionen** | Zwei CSS‑Dateien mit gleichem Namen in unterschiedlichen Unterordnern können sich überschreiben. | Sicherstellen, dass der `ResourceHandler` den vollständigen relativen Pfad beim Schreiben ins ZIP beibehält. | +| **Berechtigungsfehler** | Schreiben in einen schreibgeschützten Ordner löst `UnauthorizedAccessException` aus. | Prozess mit ausreichenden Rechten ausführen oder ein beschreibbares Ausgabeverzeichnis wählen. | + +Durch die Beachtung dieser Szenarien wird Ihre **HTML‑zu‑ZIP‑Archiv**‑Routine robust für den Produktionseinsatz. + +## Vollständiges Beispiel (Alle Teile zusammen) + +Unten finden Sie das komplette, lauffähige Programm. Kopieren Sie es in ein neues Konsolen‑App‑Projekt, passen Sie die Pfade an und drücken Sie **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Erwartete Ausgabe:** Die Konsole gibt eine Erfolgsmeldung aus, und die Datei `result.zip` enthält `input.html` plus alle abhängigen Assets. Öffnen Sie das ZIP, doppelklicken Sie `input.html` und Sie sehen die Seite exakt so, wie sie im Browser gerendert wurde – keine fehlenden Bilder, kein kaputtes CSS. + +## Zusammenfassung – Warum dieser Ansatz großartig ist + +- **Ein‑Schritt‑Rendering:** Sie müssen nicht jede Ressource manuell kopieren; Aspose.HTML erledigt das für Sie. +- **Anpassbare Pipeline:** Der `ResourceHandler` gibt Ihnen volle Kontrolle darüber, wie jede Datei gespeichert wird, und ermöglicht Kompression, Verschlüsselung oder On‑the‑Fly‑Transformationen. +- **Plattformübergreifend:** Funktioniert unter Windows, Linux und macOS, solange die .NET‑Runtime vorhanden ist. +- **Keine externen Tools:** Der gesamte **HTML‑als‑ZIP‑Speicher‑**Prozess lebt innerhalb Ihres C#‑Codes. + +## Was kommt als Nächstes? + +Jetzt, wo Sie **HTML als ZIP speichern** beherrschen, können Sie sich verwandten Themen zuwenden: + +- **HTML nach PDF exportieren** – ideal für druckbare Berichte (das Wissen über `export html to zip file` hilft, wenn Sie beide Formate benötigen). +- **ZIP‑Stream direkt als HTTP‑Antwort** – praktisch für Web‑APIs, die Nutzern ein paketiertes Site‑Download on‑the‑fly anbieten. +- **ZIP‑Archive verschlüsseln** – ein Passwort hinzufügen, wenn vertrauliche Dokumentation verarbeitet wird. + +Experimentieren Sie gern: Ersetzen Sie `MyResourceHandler` durch einen Kompressor, der Bilder verkleinert, oder fügen Sie eine Manifest‑Datei hinzu, die alle gebündelten Ressourcen auflistet. Der Himmel ist die Grenze, wenn Sie die Rendering‑Pipeline kontrollieren. + +--- + +*Viel Spaß beim Coden! Wenn Sie auf Probleme stoßen oder Ideen zur Verbesserung haben, hinterlassen Sie einen Kommentar unten. Wir finden gemeinsam eine Lösung.* + + +## Verwandte Tutorials + +- [How to Zip HTML in C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Save HTML as ZIP – Complete C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Save HTML to ZIP in C# – Complete In‑Memory Example](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/greek/net/generate-jpg-and-png-images/_index.md b/html/greek/net/generate-jpg-and-png-images/_index.md index 5fd47cce3..c9b370fcd 100644 --- a/html/greek/net/generate-jpg-and-png-images/_index.md +++ b/html/greek/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ url: /el/net/generate-jpg-and-png-images/ Μάθετε πώς να βελτιώσετε την ποιότητα των εικόνων ενεργοποιώντας το antialiasing κατά τη μετατροπή αρχείων DOCX σε PNG ή JPG. ### [Μετατροπή docx σε png – δημιουργία αρχείου zip με C# σεμινάριο](./convert-docx-to-png-create-zip-archive-c-tutorial/) Μάθετε πώς να μετατρέψετε αρχεία DOCX σε PNG και να δημιουργήσετε αρχείο ZIP χρησιμοποιώντας C#. +### [Ορίστε το Πλάτος και το Ύψος της Εικόνας κατά τη Μετατροπή Word σε PNG – Πλήρης Οδηγός](./set-image-width-height-when-converting-word-to-png-full-guid/) +Μάθετε πώς να ορίσετε προσαρμοσμένες διαστάσεις εικόνας κατά τη μετατροπή εγγράφων Word σε PNG χρησιμοποιώντας Aspose.HTML για .NET. ## Σύναψη diff --git a/html/greek/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/greek/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..d864c2aa4 --- /dev/null +++ b/html/greek/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,275 @@ +--- +category: general +date: 2026-05-22 +description: Ορίστε το πλάτος και το ύψος της εικόνας κατά τη μετατροπή ενός εγγράφου + Word σε PNG. Μάθετε πώς να εξάγετε το docx ως εικόνα με υψηλής ποιότητας απόδοση + σε έναν βήμα‑βήμα οδηγό. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: el +og_description: Ορίστε το πλάτος και το ύψος της εικόνας κατά τη μετατροπή ενός εγγράφου + Word σε PNG. Αυτό το σεμινάριο δείχνει πώς να εξάγετε το docx ως εικόνα με ρυθμίσεις + υψηλής ποιότητας. +og_title: Ορισμός Πλάτους και Ύψους Εικόνας Κατά τη Μετατροπή Word σε PNG – Πλήρης + Οδηγός +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Ορισμός Πλάτους και Ύψους Εικόνας κατά τη Μετατροπή Word σε PNG – Πλήρης Οδηγός +url: /el/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Ορισμός Πλάτους και Ύψους Εικόνας Κατά τη Μετατροπή Word σε PNG – Πλήρης Οδηγός + +Έχετε αναρωτηθεί ποτέ πώς να **ορίσετε πλάτος ύψος εικόνας** ενώ **μετατρέπετε Word σε PNG**; Δεν είστε οι μόνοι. Πολλοί προγραμματιστές συναντούν πρόβλημα όταν η προεπιλεγμένη εξαγωγή δίνει θολή εικόνα ή λάθος διαστάσεις, και στη συνέχεια ξοδεύουν ώρες ψάχνοντας για μια λύση που λειτουργεί πραγματικά. + +Σε αυτό το tutorial θα περάσουμε βήμα‑βήμα από μια καθαρή, ολοκληρωμένη λύση που δείχνει **πώς να αποδίδουμε word** έγγραφα ως εικόνες PNG, επιτρέποντάς σας να **αποθηκεύσετε docx ως PNG** με ακριβή έλεγχο πλάτους‑ύψους και υψηλής ποιότητας antialiasing. Στο τέλος θα έχετε ένα έτοιμο κομμάτι κώδικα, καλή κατανόηση των επιλογών του API, και μερικές επαγγελματικές συμβουλές για την αποφυγή κοινών παγίδων. + +## Τι Θα Μάθετε + +- Φόρτωση αρχείου `.docx` χρησιμοποιώντας το Aspose.Words for .NET. +- **Ορισμός πλάτους ύψους εικόνας** με `ImageRenderingOptions`. +- **Εξαγωγή docx ως εικόνα** (PNG) με ενεργοποιημένο antialiasing. +- Πώς να **μετατρέψετε word σε png** για μία σελίδα ή ολόκληρο το έγγραφο. +- Συμβουλές για διαχείριση μεγάλων εγγράφων, DPI και διαδρομές αρχείων. + +Χωρίς εξωτερικά εργαλεία, χωρίς πολύπλοκες εντολές γραμμής εντολών—απλός κώδικας C# που μπορείτε να ενσωματώσετε σε οποιοδήποτε .NET project. + +--- + +## Προαπαιτούμενα + +Πριν ξεκινήσουμε, βεβαιωθείτε ότι έχετε τα εξής: + +| Απαίτηση | Γιατί είναι σημαντικό | +|----------|-----------------------| +| **.NET 6.0+** (ή .NET Framework 4.7.2) | Το Aspose.Words υποστηρίζει και τα δύο, αλλά τα νεότερα runtime προσφέρουν καλύτερη απόδοση. | +| **Aspose.Words for .NET** πακέτο NuGet (`Install-Package Aspose.Words`) | Παρέχει την κλάση `Document` και τη μηχανή απόδοσης. | +| Ένα **Word έγγραφο** (`.docx`) που **θέλετε να μετατρέψετε σε PNG**. | Η πηγή που θα μετατρέψετε. | +| Βασικές γνώσεις C# – θα καταλάβετε τις δηλώσεις `using` και την αρχικοποίηση αντικειμένων. | Κρατά το επίπεδο δυσκολίας χαμηλό. | + +Αν λείπει το πακέτο NuGet, εκτελέστε την παρακάτω εντολή στο Package Manager Console: + +```powershell +Install-Package Aspose.Words +``` + +Αυτό είναι όλο—μόλις **το πακέτο είναι εγκατεστημένο**, είστε έτοιμοι να ξεκινήσετε τον κώδικα. + +--- + +## Βήμα 1: Φόρτωση του Πηγαίου Εγγράφου + +Το πρώτο πράγμα που πρέπει να κάνετε είναι να **δείξετε στη βιβλιοθήκη το αρχείο Word που θέλετε να μετατρέψετε**. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Γιατί είναι σημαντικό:** Η κλάση `Document` διαβάζει ολόκληρο το πακέτο Word στη μνήμη, δίνοντάς σας πρόσβαση σε σελίδες, στυλ και όλα τα υπόλοιπα. Αν η διαδρομή είναι λανθασμένη, θα **πάρετε ένα `FileNotFoundException`**, οπότε ελέγξτε ξανά ότι το αρχείο υπάρχει και ότι η διαδρομή χρησιμοποιεί **διαφθορά (escaped) backslashes (`\\`)** ή **ακριβή συμβολοσειρά (`@`)**. + +> **Pro tip:** Τυλίξτε την κλήση φόρτωσης **σε ένα `try/catch` block** αν **αναμένετε ότι το αρχείο μπορεί να λείπει κατά την εκτέλεση**. + +--- + +## Βήμα 2: Διαμόρφωση Επιλογών Απόδοσης Εικόνας (Set Image Width Height) + +Τώρα έρχεται **η καρδιά** του tutorial: **πώς να ορίσετε πλάτος ύψος εικόνας** ώστε το παραγόμενο PNG να μην είναι **τεντωμένο** ή **pixelated**. Η κλάση `ImageRenderingOptions` σας δίνει λεπτομερή έλεγχο διαστάσεων, DPI και εξομάλυνσης. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Επεξήγηση των βασικών ιδιοτήτων:** + +- `Width` και `Height` – **ακριβείς** διαστάσεις σε pixel που **θέλετε**. Με το **να τις ορίσετε**, **ορίζετε πλάτος ύψος εικόνας** άμεσα, παρακάμπτοντας το προεπιλεγμένο μέγεθος σελίδας. +- `UseAntialiasing` – Ενεργοποιεί υψηλής ποιότητας εξομάλυνση κειμένου και διανυσματικών γραφικών, κάτι κρίσιμο όταν **μετατρέπετε word σε png** και θέλετε καθαρά άκρα. +- `Resolution` – Υψηλότερο DPI προσφέρει περισσότερη λεπτομέρεια, ειδικά για σύνθετες διατάξεις. Προσέξτε τη χρήση μνήμης· μια εικόνα 300 DPI μπορεί να είναι μεγάλη. + +> **Γιατί να μην βασιστείτε στο προεπιλεγμένο μέγεθος;** Το προεπιλεγμένο χρησιμοποιεί τις φυσικές διαστάσεις της σελίδας (π.χ., A4 στα 96 DPI). Αυτό συχνά παράγει εικόνα 794 × 1123 pixel—καλό για κάποιες περιπτώσεις, αλλά όχι όταν χρειάζεστε συγκεκριμένο μικρογραφικό UI ή σταθερό προεπισκόπηση. + +--- + +## Βήμα 3: Απόδοση και Αποθήκευση ως PNG (Export Docx as Image) + +Με το έγγραφο φορτωμένο και τις επιλογές ρυθμισμένες, μπορείτε τελικά να **εξάγετε docx ως εικόνα**. Η μέθοδος `RenderToImage` κάνει το σκληρό κομμάτι. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Αν θέλετε να αποδώσετε **ολόκληρο το έγγραφο** (όλες τις σελίδες) σε ξεχωριστά αρχεία PNG, κάντε βρόχο πάνω στη συλλογή σελίδων: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Τι συμβαίνει στο παρασκήνιο;** Ο renderer rasterizes κάθε σελίδα χρησιμοποιώντας τις διαστάσεις που δώσατε, εφαρμόζει antialiasing και γράφει ένα byte stream PNG στο δίσκο. Επειδή το PNG είναι lossless, διατηρείτε την πλήρη πιστότητα της αρχικής διάταξης του Word. + +**Αναμενόμενο αποτέλεσμα:** Μια καθαρή εικόνα PNG ακριβώς 1024 × 768 pixel (ή όποιο μέγεθος έχετε ορίσει). Ανοίξτε την σε οποιονδήποτε προβολέα εικόνων και θα δείτε το περιεχόμενο του Word αποδομένο ακριβώς όπως εμφανίζεται στο αρχικό έγγραφο, αλλά τώρα ως bitmap. + +--- + +## Προχωρημένες Συμβουλές & Παραλλαγές + +### 1. Διατήρηση Διαφανών Φόντων + +Αν το Word έγγραφό σας περιέχει σχήματα με διαφανές φόντο και θέλετε να το διατηρήσετε, ορίστε το `BackgroundColor` σε `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Απόδοση Μόνο Συγκεκριμένου Εύρους + +Μερικές φορές χρειάζεστε μόνο μια παράγραφο ή έναν πίνακα, όχι ολόκληρη τη σελίδα. Χρησιμοποιήστε `DocumentVisitor` για να εξάγετε τον κόμβο και να τον αποδώσετε ξεχωριστά. Είναι πιο προχωρημένο σενάριο, αλλά δείχνει **πώς να αποδίδετε word** περιεχόμενο σε πιο λεπτομερή επίπεδο. + +### 3. Δυναμική Ρύθμιση DPI + +Αν χρειάζεστε διαφορετικό DPI ανά σελίδα (π.χ., υψηλή ανάλυση για την εξώφυλλο), τροποποιήστε το `Resolution` μέσα στον βρόχο: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Επεξεργασία σε Παρτίδες + +Όταν μετατρέπετε δεκάδες έγγραφα, τυλίξτε όλη τη ροή σε μια μέθοδο και επαναχρησιμοποιήστε το ίδιο αντικείμενο `ImageRenderingOptions`. Η επαναχρήση του αντικειμένου μειώνει το κόστος κατανομής μνήμης. + +--- + +## Συχνές Παγίδες & Πώς να τις Αποφύγετε + +| Συμπτωμα | Πιθανή Αιτία | Διόρθωση | +|----------|--------------|----------| +| Το PNG είναι θολό παρά το υψηλό DPI | `UseAntialiasing` είναι `false` | Ορίστε `UseAntialiasing = true`. | +| Το μέγεθος εξόδου δεν ταιριάζει με `Width`/`Height` | Δεν λήφθηκε υπόψη το DPI | Πολλαπλασιάστε το επιθυμητό μέγεθος με `Resolution / 96` ή προσαρμόστε το `Resolution`. | +| Εξαίρεση Out‑of‑memory σε μεγάλα έγγραφα | Απόδοση ολόκληρου εγγράφου στα 300 DPI | Αποδώστε μία σελίδα τη φορά, απελευθερώνοντας κάθε εικόνα μετά την αποθήκευση. | +| Το PNG εμφανίζει λευκό φόντο σε διαφανείς εικόνες | `BackgroundColor` δεν έχει οριστεί | Ορίστε `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Πλήρες Παράδειγμα Εργασίας + +Παρακάτω υπάρχει ένα αυτόνομο πρόγραμμα που μπορείτε να αντιγράψετε‑επικολλήσετε σε μια εφαρμογή console. Δείχνει **convert word to png**, **save docx as png**, και φυσικά **set image width height**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Τρέξτε το:** Κατασκευάστε το project, τοποθετήστε ένα έγκυρο `input.docx` στη διαδρομή που καθορίσατε, και εκτελέστε. Θα πρέπει να δείτε ένα `output.png` ακριβώς **1024 × 768** pixel, αποδομένο με ομαλές άκρες. + +## Σχετικά Tutorials + +- [How to Enable Antialiasing When Converting DOCX to PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – create zip archive c# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [How to Use Aspose to Render HTML to PNG – Step‑by‑Step Guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/greek/net/html-extensions-and-conversions/_index.md b/html/greek/net/html-extensions-and-conversions/_index.md index 013b0ec4b..df63898ad 100644 --- a/html/greek/net/html-extensions-and-conversions/_index.md +++ b/html/greek/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,13 @@ url: /el/net/html-extensions-and-conversions/ ## Εκμάθηση επεκτάσεων και μετατροπών HTML ### [Μετατροπή HTML σε PDF στο .NET με το Aspose.HTML](./convert-html-to-pdf/) Μετατρέψτε HTML σε PDF χωρίς κόπο με το Aspose.HTML για .NET. Ακολουθήστε τον οδηγό βήμα προς βήμα και απελευθερώστε τη δύναμη της μετατροπής HTML σε PDF. + +### [Μετατροπή HTML σε PDF με C# – Πλήρης Οδηγός](./convert-html-to-pdf-with-c-complete-guide/) +Μάθετε πώς να μετατρέψετε HTML σε PDF χρησιμοποιώντας C# με έναν πλήρη οδηγό βήμα‑βήμα. + +### [Απόδοση HTML ως PDF σε C# – Πλήρης Οδηγός Βήμα‑Βήμα](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Μάθετε πώς να αποδίδετε HTML σε PDF χρησιμοποιώντας C# με έναν πλήρη οδηγό βήμα‑βήμα. + ### [Δημιουργία PDF από HTML – Οδηγός βήμα‑βήμα C#](./create-pdf-from-html-c-step-by-step-guide/) Δημιουργήστε PDF από HTML με C# χρησιμοποιώντας το Aspose.HTML. Οδηγός βήμα‑βήμα για γρήγορη και εύκολη υλοποίηση. ### [Μετατρέψτε το EPUB σε Εικόνα στο .NET με το Aspose.HTML](./convert-epub-to-image/) @@ -68,17 +75,16 @@ url: /el/net/html-extensions-and-conversions/ ### [Πώς να συμπιέσετε HTML σε C# – Αποθήκευση HTML σε Zip](./how-to-zip-html-in-c-save-html-to-zip/) Μάθετε πώς να συμπιέσετε αρχεία HTML σε αρχείο ZIP χρησιμοποιώντας το Aspose.HTML για .NET σε C#. ### [Δημιουργία εγγράφου HTML με μορφοποιημένο κείμενο και εξαγωγή σε PDF – Πλήρης οδηγός](./create-html-document-with-styled-text-and-export-to-pdf-full/) -Μάθετε πώς να δημιουργήσετε ένα έγγραφο HTML με μορφοποιημένο κείμενο και να το εξάγετε σε PDF χρησιμοποιώντας το Aspose.HTML για .NET. +Μάθετε πώς να δημιουργήσετε ένα έγγραφο HTML με μορφοποιμένο κείμενο και να το εξάγετε σε PDF χρησιμοποιώντας το Aspose.HTML για .NET. ### [Αποθήκευση HTML ως ZIP – Πλήρης Εκπαιδευτικό C#](./save-html-as-zip-complete-c-tutorial/) Μάθετε πώς να αποθηκεύετε HTML σε αρχείο ZIP με C# και Aspose.HTML. -### [Αποθήκευση HTML σε ZIP σε C# – Πλήρες Παράδειγμα Εντός Μνήμης](./save-html-to-zip-in-c-complete-in-memory-example/) +### [Αποθήκευση HTML σε ZIP – Πλήρης Εκπαιδευτικό C#](./save-html-as-zip-complete-c-tutorial/) +Μάθετε πώς να αποθηκεύετε HTML σε αρχείο ZIP με C# και Aspose.HTML. +### [Αποθήκευση HTML σε ZIP – Πλήρης Εκπαιδευτικό C#](./save-html-to-zip-in-c-complete-in-memory-example/) Μάθετε πώς να αποθηκεύετε HTML σε αρχείο ZIP με C# χρησιμοποιώντας πλήρες παράδειγμα εντός μνήμης. +### [Αποθήκευση HTML ως ZIP – Πλήρης Οδηγός για Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Μάθετε πώς να αποθηκεύσετε HTML σε αρχείο ZIP με Aspose.HTML – πλήρης οδηγός βήμα‑βήμα. -## Σύναψη - -Συμπερασματικά, οι επεκτάσεις και οι μετατροπές HTML είναι βασικά στοιχεία της σύγχρονης ανάπτυξης ιστού. Το Aspose.HTML για .NET απλοποιεί τη διαδικασία και το καθιστά προσβάσιμο σε προγραμματιστές όλων των επιπέδων. Ακολουθώντας τα σεμινάρια μας, θα είστε σε καλό δρόμο για να γίνετε ικανός προγραμματιστής ιστού με ευρύ σύνολο δεξιοτήτων. - -Λοιπόν, τι περιμένετε; Ας ξεκινήσουμε αυτό το συναρπαστικό ταξίδι για να εξερευνήσουμε επεκτάσεις και μετατροπές HTML χρησιμοποιώντας το Aspose.HTML για .NET. Τα έργα ανάπτυξης Ιστού σας δεν θα είναι ποτέ τα ίδια! {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} diff --git a/html/greek/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/greek/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..405f5e040 --- /dev/null +++ b/html/greek/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,261 @@ +--- +category: general +date: 2026-05-22 +description: Μετατρέψτε HTML σε PDF σε C# χρησιμοποιώντας το Aspose.HTML. Μάθετε πώς + να αποδίδετε HTML σε PDF σε C# με κώδικα βήμα‑βήμα, επιλογές και συμβουλές για Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: el +og_description: Μετατρέψτε HTML σε PDF σε C# με το Aspose.HTML. Αυτός ο οδηγός δείχνει + πώς να αποδίδετε HTML σε PDF σε C# χρησιμοποιώντας σαφείς επιλογές και συμβουλές + φιλικές προς το Linux. +og_title: Μετατροπή HTML σε PDF με C# – Πλήρης Οδηγός +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Μετατροπή HTML σε PDF με C# – Πλήρης Οδηγός +url: /el/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Μετατροπή HTML σε PDF με C# – Πλήρης Οδηγός + +Αν χρειάζεστε **γρήγορη μετατροπή HTML σε PDF**, το Aspose.HTML for .NET το κάνει παιχνιδάκι. Σε αυτό το tutorial θα απαντήσουμε επίσης στο **πώς να αποδώσετε HTML σε PDF με C#** με πλήρη έλεγχο των επιλογών απόδοσης, ώστε να μην μένετε σε αβεβαιότητα. + +Φανταστείτε ότι έχετε ένα πρότυπο email μάρκετινγκ, μια σελίδα απόδειξης ή μια σύνθετη αναφορά με σύγχρονα CSS, και πρέπει να το παραδώσετε ως PDF σε πελάτη ή εκτυπωτή. Η χειροκίνητη διαδικασία είναι επίπονη, αλλά με λίγες γραμμές κώδικα C# μπορείτε να αυτοματοποιήσετε όλο το pipeline. Στο τέλος αυτού του οδηγού θα έχετε μια αυτόνομη, έτοιμη για παραγωγή λύση που λειτουργεί σε Windows *και* Linux. + +## Τι Θα Χρειαστείτε + +Πριν ξεκινήσουμε, βεβαιωθείτε ότι έχετε τα εξής: + +- **.NET 6.0 ή νεότερο** – Το Aspose.HTML στοχεύει στο .NET Standard 2.0+, οπότε οποιοδήποτε πρόσφατο SDK λειτουργεί. +- **Aspose.HTML for .NET** πακέτο NuGet (`Aspose.Html`) – θα χρειαστείτε έγκυρη άδεια για παραγωγή, αλλά η δωρεάν δοκιμή αρκεί για δοκιμές. +- Ένα **απλό αρχείο HTML** που θέλετε να μετατρέψετε σε PDF (θα το ονομάσουμε `input.html`). +- Το αγαπημένο σας IDE (Visual Studio, Rider ή VS Code) – δεν απαιτείται ειδικό εργαλείο. + +Αυτό είναι όλο. Χωρίς εξωτερικούς μετατροπείς PDF, χωρίς εντολές γραμμής εντολών. Απλώς καθαρό C#. + +![Διάγραμμα που απεικονίζει τη ροή εργασίας μετατροπής html σε pdf χρησιμοποιώντας το Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## Μετατροπή HTML σε PDF – Πλήρης Υλοποίηση + +Παρακάτω βρίσκεται το πλήρες, έτοιμο‑για‑εκτέλεση πρόγραμμα. Αντιγράψτε‑και‑επικολλήστε το σε μια νέα εφαρμογή console, επαναφέρετε τα πακέτα NuGet και πατήστε **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Γιατί Λειτουργεί Αυτό + +- **`Document`** είναι το σημείο εισόδου του Aspose.HTML· αναλύει το HTML, επιλύει τα CSS και δημιουργεί ένα DOM έτοιμο για απόδοση. +- **`PdfRenderingOptions`** σας επιτρέπει να ρυθμίσετε την έξοδο. Η σημαία `UseHinting` είναι το μυστικό συστατικό για καθαρό κείμενο σε headless Linux containers όπου ο προεπιλεγμένος rasterizer μπορεί να φαίνεται θολός. +- **`Save`** κάνει το βαρύ έργο: rasterizes το DOM σε σελίδες PDF, σέβεται τα page breaks και ενσωματώνει τις γραμματοσειρές αυτόματα. + +Η εκτέλεση του προγράμματος θα δημιουργήσει το `output.pdf` ακριβώς δίπλα στο αρχείο πηγής σας. Ανοίξτε το με οποιονδήποτε προβολέα PDF και θα δείτε μια πιστή οπτική αντιστοιχία με το αρχικό HTML. + +## Πώς να Αποδώσετε HTML σε PDF με C# – Βήμα‑Βήμα + +Παρακάτω διασπάμε τη διαδικασία σε μικρά κομμάτια, εξηγώντας **πώς να αποδώσετε HTML σε PDF με C#** ενώ καλύπτουμε κοινά προβλήματα. + +### Βήμα 1 – Εγκατάσταση του Πακέτου NuGet Aspose.HTML + +Ανοίξτε το τερματικό σας στο φάκελο του έργου και εκτελέστε: + +```bash +dotnet add package Aspose.Html +``` + +Αν προτιμάτε το UI του Visual Studio, κάντε δεξί‑κλικ στο έργο → **Manage NuGet Packages** → ψάξτε για **Aspose.Html** και εγκαταστήστε την πιο πρόσφατη σταθερή έκδοση. + +> **Pro tip:** Μετά την εγκατάσταση, προσθέστε ένα αρχείο άδειας (`Aspose.Total.lic`) στη ρίζα του έργου σας για να αποφύγετε τα υδατογραφήματα αξιολόγησης. + +### Βήμα 2 – Φόρτωση του HTML Σας Σωστά + +Το Aspose.HTML μπορεί να καταναλώσει: + +- Τοπικές διαδρομές αρχείων (`new Document("file.html")`) +- URLs (`new Document("https://example.com")`) +- Ακατέργαστες συμβολοσειρές HTML (`new Document("…", new HtmlLoadOptions())`) + +Όταν φορτώνετε από το σύστημα αρχείων, βεβαιωθείτε ότι η διαδρομή είναι απόλυτη ή ότι το working directory έχει οριστεί σωστά, διαφορετικά θα αντιμετωπίσετε `FileNotFoundException`. Σε Linux, χρησιμοποιήστε μπροστιγές κάθετες (`/`) ή `Path.Combine`. + +### Βήμα 3 – Επιλογή των Κατάλληλων Ρυθμίσεων Απόδοσης + +Εκτός από το `UseHinting`, ίσως θέλετε να προσαρμόσετε: + +| Επιλογή | Τι κάνει | Πότε να τη χρησιμοποιήσετε | +|--------|----------|----------------------------| +| `PageSize` | Ορίζει τις διαστάσεις της σελίδας PDF (A4, Letter, προσαρμοσμένο) | Συμφωνήστε με το μέγεθος του τελικού χαρτιού | +| `Landscape` | Περιστρέφει τη σελίδα σε οριζόντια διάταξη | Πλάστις πίνακες ή διαγράμματα | +| `RasterizeVectorGraphics` | Μετατρέπει τα διανυσματικά γραφικά σε raster εικόνες | Όταν ο παραλήπτης PDF δεν υποστηρίζει SVG | +| `CompressionLevel` | Ελέγχει τη συμπίεση εικόνων (0‑9) | Μείωση μεγέθους αρχείου για συνημμένα email | + +Μπορείτε να αλυσίδετε αυτές τις ιδιότητες με fluent τρόπο: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Βήμα 4 – Αποθήκευση του PDF + +Η υπερφόρτωση της μεθόδου `Save` που βλέπετε στο πλήρες παράδειγμα γράφει απευθείας σε διαδρομή αρχείου. Μπορείτε επίσης να ρέξετε το PDF στη μνήμη: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Αυτό είναι χρήσιμο όταν χρειάζεται να επιστρέψετε το PDF ως λήψη από ένα web API. + +### Βήμα 5 – Επαλήθευση του Αποτελέσματος + +Μια γρήγορη λογική επαλήθευση είναι να συγκρίνετε τον αριθμό σελίδων του PDF με τον αναμενόμενο αριθμό ενοτήτων HTML. Μπορείτε να το διαβάσετε ξανά με το Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Αν ο αριθμός φαίνεται λανθασμένος, επανεξετάστε τους κανόνες CSS `page-break` ή προσαρμόστε τις `PdfRenderingOptions` αναλόγως. + +## Σενάρια Ακραίων Περιπτώσεων & Συνηθισμένα Προβλήματα + +| Κατάσταση | Τι να προσέξετε | Διόρθωση | +|-----------|-----------------|----------| +| **Εξωτερικοί πόροι (εικόνες, γραμματοσειρές) λείπουν** | Σχετικές URL λύνουν σε σχέση με το φάκελο του αρχείου HTML. | Χρησιμοποιήστε `HtmlLoadOptions.BaseUri` για να δείξετε στη σωστή ρίζα. | +| **Περιβάλλον Linux χωρίς οθόνη** | Η προεπιλεγμένη απόδοση κειμένου μπορεί να είναι θολή. | Ορίστε `UseHinting = true` (όπως φαίνεται) και βεβαιωθείτε ότι το `libgdiplus` είναι εγκατεστημένο αν επιστρέφετε στο System.Drawing. | +| **Μεγάλο HTML (> 10 MB)** | Η κατανάλωση μνήμης αυξάνεται κατά την απόδοση. | Αποδίδετε σελίδα‑με‑σελίδα χρησιμοποιώντας `PdfRenderer` με `PdfRenderingOptions` και απελευθερώνετε κάθε σελίδα μετά την αποθήκευση. | +| **Σελίδες με πολύ JavaScript** | Το Aspose.HTML δεν εκτελεί JS· το δυναμικό περιεχόμενο παραμένει στατικό. | Προεπεξεργαστείτε το HTML στο server‑side (π.χ., με Puppeteer) πριν το δώσετε στο Aspose.HTML. | +| **Unicode χαρακτήρες εμφανίζονται ως τετράγωνα** | Λείπουν γραμματοσειρές στο περιβάλλον εκτέλεσης. | Ενσωματώστε προσαρμοσμένες γραμματοσειρές μέσω `FontSettings` ή βεβαιωθείτε ότι το OS έχει τις απαιτούμενες γραμματοσειρές εγκατεστημένες. | + +## Συνοπτικό Παράδειγμα Πλήρους Λειτουργίας + +Εδώ είναι ξανά ολόκληρο το πρόγραμμα, χωρίς σχόλια, για όσους προτιμούν μια συνοπτική άποψη: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Τρέξτε το, ανοίξτε το `output.pdf` και θα δείτε μια pixel‑perfect αναπαραγωγή του `input.html`. Αυτή είναι η ουσία της **μετατροπής html σε pdf** με το Aspose.HTML. + +## Συμπέρασμα + +Διασχίσαμε όλα όσα χρειάζεστε για **να μετατρέψετε HTML σε PDF** με C#: εγκατάσταση του Aspose.HTML, φόρτωση του HTML, ρύθμιση επιλογών απόδοσης (συμπεριλαμβανομένης της κρίσιμης σημαίας `UseHinting`) και αποθήκευση του τελικού PDF. Τώρα καταλαβαίνετε **πώς να αποδώσετε HTML σε PDF με C#** τόσο σε Windows όσο και σε Linux, και έχετε δει πώς να αντιμετωπίσετε κοινές ακραίες περιπτώσεις όπως ελλιπείς πόροι και μεγάλα αρχεία. + +Τι ακολουθεί; Δοκιμάστε να προσθέσετε: + +- **Κεφαλίδες/υποσέλιδα** με `PdfPageTemplate` για branding. +- **Προστασία με κωδικό** μέσω `PdfSaveOptions`. +- **Μαζική μετατροπή** επαναλαμβάνοντας πάνω από έναν φάκελο από + + +## Σχετικά Tutorials + +- [Μετατροπή HTML σε PDF σε .NET με Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Μετατροπή EPUB σε PDF σε .NET με Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Μετατροπή SVG σε PDF σε .NET με Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/greek/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/greek/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..cf0660556 --- /dev/null +++ b/html/greek/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,309 @@ +--- +category: general +date: 2026-05-22 +description: Απόδοση HTML ως PDF χρησιμοποιώντας C# με ένα σύντομο παράδειγμα. Μάθετε + πώς να μετατρέψετε HTML σε PDF με C# γρήγορα και αξιόπιστα. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: el +og_description: Απόδοση HTML ως PDF σε C# με ένα σαφές, εκτελέσιμο παράδειγμα. Αυτός + ο οδηγός σας δείχνει πώς να μετατρέψετε HTML σε PDF με C# και να δημιουργήσετε PDF + από αρχείο HTML. +og_title: Απόδοση HTML ως PDF σε C# – Πλήρης οδηγός προγραμματισμού +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Απόδοση HTML σε PDF σε C# – Πλήρης Οδηγός Βήμα‑βήμα +url: /el/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Απόδοση HTML ως PDF σε C# – Πλήρης Οδηγός Βήμα‑βήμα + +Έχετε ποτέ χρειαστεί να **αποδώσετε HTML ως PDF** αλλά δεν ήσασταν σίγουροι ποια βιβλιοθήκη να επιλέξετε για ένα έργο .NET; Δεν είστε μόνοι. Σε πολλές εφαρμογές γραμμής επιχειρήσεων θα βρείτε τον εαυτό σας να χρειάζεται να **μετατρέψετε HTML σε PDF C#** για τιμολόγια, αναφορές ή διαφημιστικά φυλλάδια—βασικά κάθε φορά που θέλετε μια εκτυπώσιμη έκδοση μιας ιστοσελίδας. + +Το θέμα είναι: δεν χρειάζεται να εφεύρετε τη ρόδα. Με λίγες γραμμές κώδικα μπορείτε να πάρετε ένα αρχείο `input.html`, να το δώσετε σε μια αποδεδειγμένη μηχανή απόδοσης και να καταλήξετε με ένα καθαρό `output.pdf`. Σε αυτό το tutorial θα περάσουμε από όλη τη διαδικασία, από την προσθήκη του σωστού πακέτου NuGet μέχρι τη διαχείριση ειδικών περιπτώσεων όπως εξωτερικό CSS. Στο τέλος θα μπορείτε να **δημιουργήσετε PDF από αρχείο HTML** σε λίγα λεπτά. + +## Τι Θα Μάθετε + +- Πώς να ρυθμίσετε μια εφαρμογή κονσόλας .NET που **δημιουργεί PDF από HTML C#** κώδικα. +- Τις ακριβείς κλήσεις API που χρειάζεστε για να **αποθηκεύσετε έγγραφο HTML ως PDF**. +- Γιατί ορισμένες επιλογές απόδοσης (όπως το hinting) είναι σημαντικές για την ποιότητα του κειμένου. +- Συμβουλές για την αντιμετώπιση κοινών προβλημάτων όπως ελλιπείς γραμματοσειρές ή σχετικές διαδρομές εικόνων. + +**Prerequisites** – θα πρέπει να έχετε εγκατεστημένο .NET 6+ ή .NET Framework 4.7, βασική εξοικείωση με C# και ένα IDE (Visual Studio 2022, Rider ή VS Code). Δεν απαιτείται προηγούμενη εμπειρία με PDF. + +--- + +## Απόδοση HTML ως PDF – Ρύθμιση του Έργου + +Πριν βουτήξουμε στον κώδικα, ας βεβαιωθούμε ότι το περιβάλλον ανάπτυξης είναι έτοιμο. Η βιβλιοθήκη που θα χρησιμοποιήσουμε είναι **Select.Pdf** (δωρεάν για μη εμπορική χρήση) επειδή προσφέρει ένα απλό API και αξιόπιστη πιστότητα απόδοσης. + +### Εγκατάσταση της βιβλιοθήκης απόδοσης PDF (convert html to pdf c#) + +Ανοίξτε ένα τερματικό στο φάκελο του έργου σας και εκτελέστε: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Αν χρησιμοποιείτε Visual Studio, μπορείτε επίσης να προσθέσετε το πακέτο μέσω του UI του NuGet Package Manager. Ο αριθμός έκδοσης μπορεί να είναι νεότερος—απλώς πάρτε την πιο πρόσφατη σταθερή έκδοση. + +### Δημιουργία σκελετού κονσόλας + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Αυτό είναι όλο το boilerplate που χρειάζεστε. Η βαριά δουλειά γίνεται μέσα στο `Main`. + +--- + +## Φόρτωση του Εγγράφου HTML (generate pdf from html file) + +Το πρώτο πραγματικό βήμα είναι να κατευθύνετε τον renderer σε ένα αρχείο HTML στο δίσκο. Το Select.Pdf προσφέρει δύο βολικούς τρόπους: να περάσετε ακατέργαστη συμβολοσειρά HTML ή μια διαδρομή αρχείου. Η χρήση αρχείου διατηρεί τα πράγματα τακτικά, ειδικά όταν έχετε συνδεδεμένο CSS ή εικόνες. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Εδώ επίσης προστατεύουμε από ένα ελλιπές αρχείο—κάτι που προκαλεί προβλήματα στους αρχάριους όταν ξεχνούν να αντιγράψουν το HTML στον φάκελο εξόδου. + +--- + +## Διαμόρφωση Επιλογών Απόδοσης (create pdf from html c#) + +Το Select.Pdf έρχεται με ένα πλούσιο αντικείμενο `PdfDocumentOptions`. Για καθαρό κείμενο ενεργοποιούμε το hinting, το οποίο λειαίνει τα γλύφους με μικρό κόστος στην απόδοση. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Μπορείτε να ρυθμίσετε το μέγεθος σελίδας, τα περιθώρια ή ακόμη και να ενσωματώσετε μια προσαρμοσμένη γραμματοσειρά εδώ. Το βασικό συμπέρασμα είναι ότι **render html as pdf** δεν είναι μόνο μια γραμμή κώδικα· έχετε έλεγχο πάνω στην εμφάνιση και την αίσθηση του τελικού εγγράφου. + +--- + +## Αποθήκευση Εγγράφου HTML ως PDF (render html as pdf) + +Τώρα συμβαίνει η μαγεία. Παραδίδουμε στον μετατροπέα τη διαδρομή του αρχείου HTML μας και του ζητάμε να γράψει ένα PDF στο δίσκο. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +Η μέθοδος `ConvertUrl` επιλύει αυτόματα σχετικές URL (εικόνες, CSS) βάσει της τοποθεσίας του αρχείου HTML, γι' αυτόν τον λόγο η προσέγγιση αυτή είναι αξιόπιστη για τις περισσότερες πραγματικές περιπτώσεις. + +### Αναμενόμενη έξοδος + +Μετά την εκτέλεση του προγράμματος θα πρέπει να δείτε ένα αρχείο `output.pdf` στον ίδιο φάκελο. Ανοίξτε το—θα παρατηρήσετε: + +- Κείμενο αποδομένο με καθαρό anti‑aliasing (ευχαριστώντας το hinting). +- Στυλ από το συνδεδεμένο CSS εφαρμόζονται σωστά. +- Εικόνες εμφανίζονται στο ακριβές μέγεθος που ορίζεται στο πηγαίο HTML. + +Αν κάτι φαίνεται λανθασμένο, ελέγξτε ξανά ότι τα αρχεία CSS και εικόνων βρίσκονται δίπλα στο `input.html` ή χρησιμοποιήστε απόλυτες URL. + +--- + +## Διαχείριση Κοινών Ειδικών Περιπτώσεων + +### 1. Εξωτερικοί πόροι που μπλοκάρονται από τείχη προστασίας + +Αν το HTML σας αναφέρει γραμματοσειρές που φιλοξενούνται σε CDN που ο διακομιστής σας δεν μπορεί να προσεγγίσει, το PDF μπορεί να επιστρέψει σε μια γενική γραμματοσειρά. Για να το αποφύγετε, είτε κατεβάστε τα αρχεία γραμματοσειρών τοπικά είτε ενσωματώστε τα χρησιμοποιώντας `@font-face` με σχετική διαδρομή. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Πολύ μεγάλα αρχεία HTML + +Κατά τη μετατροπή τεράστιων εγγράφων, μπορεί να φτάσετε τα όρια μνήμης. Το Select.Pdf σας επιτρέπει να κάνετε streaming τη μετατροπή: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Το streaming διατηρεί τη διαδικασία ελαφριά, αλλά απαιτεί να παρέχετε το HTML ως συμβολοσειρά, την οποία μπορείτε να διαβάζετε σε τμήματα αν χρειαστεί. + +### 3. Προσαρμοσμένες κεφαλίδες ή υποσέλιδα + +Αν χρειάζεστε αριθμό σελίδας ή λογότυπο εταιρείας σε κάθε σελίδα, ορίστε τις ιδιότητες `Header` και `Footer` στο `converter.Options` πριν καλέσετε το `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Πλήρες Παράδειγμα Εργασίας (Όλα τα Βήματα Συνδυασμένα) + +Παρακάτω είναι το πλήρες, έτοιμο για αντιγραφή‑και‑επικόλληση πρόγραμμα. Αντικαταστήστε το `YOUR_DIRECTORY` με την απόλυτη διαδρομή όπου βρίσκεται το HTML σας. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** `dotnet run` από τον φάκελο του έργου. Αν όλα είναι ρυθμισμένα σωστά, θα δείτε το μήνυμα επιτυχίας και ένα λαμπρό `output.pdf`. + +--- + +## Οπτική Σύνοψη + +![Render HTML as PDF example](render-html-as-pdf.png){alt="παράδειγμα απόδοσης html ως pdf"} + +Το στιγμιότυπο δείχνει την έξοδο της κονσόλας και το παραγόμενο PDF ανοιγμένο σε προβολέα. Παρατηρήστε τις καθαρές επικεφαλίδες και τις σωστά φορτωμένες εικόνες—ακριβώς αυτό που περιμένετε όταν **render html as pdf**. + +--- + +## Συμπέρασμα + +Μόλις μάθατε πώς να **render HTML as PDF** σε μια εφαρμογή C#, από την εγκατάσταση της βιβλιοθήκης μέχρι τη λεπτομερή ρύθμιση των επιλογών απόδοσης. Το πλήρες παράδειγμα δείχνει έναν αξιόπιστο τρόπο για **convert HTML to PDF C#**, **generate PDF from HTML file**, και **save HTML document as PDF** με μόνο λίγες γραμμές κώδικα. + +Τι έπεται; Δοκιμάστε να πειραματιστείτε με: + +- Προσθήκη προσαρμοσμένων γραμματοσειρών για συνέπεια της μάρκας. +- Δημιουργία PDF από δυναμικές συμβολοσειρές HTML (π.χ., Razor templates). +- Συγχώνευση πολλαπλών PDF σε μια ενιαία αναφορά χρησιμοποιώντας `PdfDocument.AddPage`. + +Κάθε μία από αυτές τις επεκτάσεις βασίζεται στις βασικές έννοιες που καλύφθηκαν εδώ, ώστε να είστε έτοιμοι να αντιμετωπίσετε πιο προχωρημένα σενάρια χωρίς απότομη καμπύλη εκμάθησης. + +Έχετε ερωτήσεις ή αντιμετωπίσατε κάποιο πρόβλημα; Αφήστε ένα σχόλιο παρακάτω και ας το αντιμετωπίσουμε μαζί. Καλό κώδικα! + +## Σχετικά Tutorials + +- [Μετατροπή HTML σε PDF σε .NET με Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Δημιουργία Εγγράφου HTML με Στυλιζαρισμένο Κείμενο και Εξαγωγή σε PDF – Πλήρης Οδηγός](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Μετατροπή HTML σε PDF με Aspose.HTML – Πλήρης Οδηγός Χειρισμού](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/greek/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/greek/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..d5854b6a4 --- /dev/null +++ b/html/greek/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,225 @@ +--- +category: general +date: 2026-05-22 +description: Αποθηκεύστε το HTML ως ZIP γρήγορα χρησιμοποιώντας το Aspose.HTML. Μάθετε + πώς να συμπιέζετε αρχεία HTML σε ZIP, να μετατρέπετε HTML σε ZIP και να εξάγετε + HTML σε αρχείο ZIP με πλήρη κώδικα. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: el +og_description: Αποθηκεύστε το HTML ως ZIP με το Aspose.HTML. Αυτός ο οδηγός δείχνει + πώς να μετατρέψετε το HTML σε ZIP, να εξάγετε το HTML σε αρχείο ZIP και να συμπιέζετε + αρχεία HTML προγραμματιστικά. +og_title: Αποθήκευση HTML ως ZIP – Πλήρης Εκπαιδευτικό Σεμινάριο Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Αποθήκευση HTML ως ZIP – Πλήρης Οδηγός για το Aspose.HTML +url: /el/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Αποθήκευση HTML ως ZIP – Πλήρης Οδηγός για Aspose.HTML + +Έχετε αναρωτηθεί ποτέ πώς να **αποθηκεύσετε HTML ως ZIP** χωρίς να χρησιμοποιήσετε ένα ξεχωριστό εργαλείο αρχειοθέτησης; Δεν είστε οι μόνοι. Πολλοί προγραμματιστές χρειάζονται να συσκευάσουν μια σελίδα HTML μαζί με τις εικόνες, τα CSS και τα scripts της για εύκολη διανομή, και η χειροκίνητη διαδικασία γίνεται γρήγορα ένα πρόβλημα. + +Σε αυτό το tutorial θα περάσουμε βήμα‑βήμα μια καθαρή, ολοκληρωμένη λύση που **αποδίδει HTML σε ZIP** χρησιμοποιώντας το Aspose.HTML για .NET. Στο τέλος θα γνωρίζετε ακριβώς πώς να **εξάγετε HTML σε αρχείο ZIP**, και θα δείτε επίσης παραλλαγές για **πώς να συμπιέζετε αρχεία HTML** σε διαφορετικά σενάρια. + +> *Συμβουλή επαγγελματία:* Η προσέγγιση που παρουσιάζεται λειτουργεί είτε πακετάρετε μια μόνο σελίδα είτε ολόκληρο φάκελο ιστοτόπου. + +## Τι Θα Χρειαστεί + +- .NET 6 (ή οποιοδήποτε πρόσφατο .NET runtime) εγκατεστημένο. +- Το πακέτο NuGet Aspose.HTML for .NET (`Aspose.Html`) που αναφέρεται στο έργο σας. +- Ένα απλό αρχείο `input.html` τοποθετημένο σε φάκελο που ελέγχετε. +- Λίγη εξοικείωση με C# — τίποτα περίπλοκο, μόνο τα βασικά. + +Αυτό είναι όλο. Χωρίς εξωτερικά εργαλεία zip, χωρίς γυμναστική γραμμής εντολών. Ας ξεκινήσουμε. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*Κείμενο εναλλακτικής εικόνας: διάγραμμα διαδικασίας αποθήκευσης html ως zip* + +## Βήμα 1: Φόρτωση του Πηγαίου Εγγράφου HTML + +Το πρώτο πράγμα που πρέπει να κάνουμε είναι να πούμε στο Aspose.HTML πού βρίσκεται η πηγή μας. Η κλάση `HTMLDocument` διαβάζει το αρχείο και δημιουργεί ένα DOM στη μνήμη, έτοιμο για απόδοση. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Γιατί είναι σημαντικό: η φόρτωση του εγγράφου δίνει στη βιβλιοθήκη πλήρη έλεγχο της επίλυσης πόρων (εικόνες, CSS, γραμματοσειρές). Αν το HTML αναφέρει σχετικές διαδρομές, το Aspose.HTML τις επιλύει αυτόματα σε σχέση με το φάκελο του αρχείου. + +## Βήμα 2: (Προαιρετικό) Δημιουργία Προσαρμοσμένου Διαχειριστή Πόρων + +Αν χρειάζεται να εξετάσετε ή να επεξεργαστείτε κάθε πόρο — π.χ. θέλετε να συμπιέσετε εικόνες πριν μπουν στο αρχείο — μπορείτε να ενσωματώσετε ένα `ResourceHandler`. Αυτό το βήμα είναι προαιρετικό, αλλά είναι ο πιο ευέλικτος τρόπος για **μετατροπή HTML σε αρχείο ZIP** με προσαρμοσμένη λογική. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Τι γίνεται αν δεν χρειάζεστε ειδική επεξεργασία;* Απλώς παραλείψτε αυτήν την κλάση και χρησιμοποιήστε τον προεπιλεγμένο διαχειριστή — το Aspose.HTML θα γράψει τους πόρους απευθείας στο ZIP. + +## Βήμα 3: Διαμόρφωση Επιλογών Αποθήκευσης για Χρήση του Διαχειριστή + +Το αντικείμενο `HtmlSaveOptions` λέει στον αποδοχέα τι να κάνει με τους πόρους. Αναθέτοντας το `MyResourceHandler`, αποκτούμε πλήρη έλεγχο της εξόδου. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Παρατηρήστε πώς το όνομα ιδιότητας `ResourceHandler` αναφέρεται άμεσα στη δυνατότητα **απόδοσης HTML σε ZIP**. Εδώ συμβαίνει η μαγεία: κάθε συνδεδεμένος πόρος μεταδίδεται στο αρχείο αντί να γράφεται στο δίσκο. + +## Βήμα 4: Αποθήκευση του Αποδοθέντος Εγγράφου σε Αρχείο ZIP + +Τώρα τελικά **εξάγουμε HTML σε αρχείο ZIP**. Η μέθοδος `Save` δέχεται οποιοδήποτε `Stream`, έτσι μπορούμε να το κατευθύνουμε σε ένα `FileStream` που δημιουργεί το `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Αυτή είναι η πλήρης ροή εργασίας. Όταν ο κώδικας ολοκληρωθεί, το `result.zip` περιέχει: + +- `input.html` (το αρχικό markup) +- Όλες οι αναφερόμενες εικόνες, αρχεία CSS και γραμματοσειρές +- Οποιεσδήποτε μετασχηματισμένοι πόροι αν τα τροποποιήσατε στο `MyResourceHandler` + +## Πώς να Συμπιέσετε Αρχεία HTML Χωρίς το Aspose.HTML (Γρήγορη Εναλλακτική) + +Μερικές φορές χρειάζεστε απλώς μια παραδοσιακή προσέγγιση **πώς να συμπιέσετε αρχεία HTML**, ίσως επειδή χρησιμοποιείτε ήδη διαφορετικό parser HTML. Σε αυτήν την περίπτωση μπορείτε να χρησιμοποιήσετε το ενσωματωμένο στο .NET `System.IO.Compression`: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Αυτή η μέθοδος είναι απλή αλλά λείπει το βήμα απόδοσης· απλώς πακετάρει ό,τι υπάρχει στο δίσκο. Αν το HTML σας αναφέρει εξωτερικές URL, αυτοί οι πόροι δεν θα συμπεριληφθούν. Γι' αυτό η διαδρομή Aspose.HTML προτιμάται όταν χρειάζεστε αξιόπιστη λύση **απόδοσης HTML σε ZIP**. + +## Περιπτώσεις Ορίων & Συνηθισμένα Πιθανά Σφάλματα + +| Situation | What to Watch For | Recommended Fix | +|-----------|-------------------|-----------------| +| **Μεγάλες εικόνες** | Η χρήση μνήμης αυξάνεται επειδή κάθε εικόνα φορτώνεται σε `MemoryStream`. | Μετάδοση απευθείας στο zip χρησιμοποιώντας προσαρμοσμένο διαχειριστή που αντιγράφει το πηγαίο stream αντί για πλήρη buffer. | +| **Εξωτερικές URLs** | Οι πόροι που φιλοξενούνται στο διαδίκτυο δεν κατεβάζονται αυτόματα. | Ορίστε `HtmlLoadOptions` με `BaseUrl` που δείχνει στη ρίζα του ιστότοπου, ή κατεβάστε χειροκίνητα τους πόρους πριν την αποθήκευση. | +| **Σύγκρουση ονομάτων αρχείων** | Δύο αρχεία CSS με το ίδιο όνομα σε διαφορετικούς υποφακέλους μπορεί να αντικαταστήσουν το ένα το άλλο. | Βεβαιωθείτε ότι ο `ResourceHandler` διατηρεί την πλήρη σχετική διαδρομή κατά τη γραφή στο zip. | +| **Σφάλματα δικαιωμάτων** | Η προσπάθεια εγγραφής σε φάκελο μόνο για ανάγνωση προκαλεί `UnauthorizedAccessException`. | Εκτελέστε τη διαδικασία με τα κατάλληλα δικαιώματα ή επιλέξτε φάκελο εξόδου με δυνατότητα εγγραφής. | + +Η αντιμετώπιση αυτών των σεναρίων κάνει τη ρουτίνα **μετατροπής HTML σε αρχείο ZIP** ανθεκτική για παραγωγική χρήση. + +## Πλήρες Παράδειγμα Εργασίας (Όλα τα Μέρη Μαζί) + +Παρακάτω βρίσκεται το πλήρες, έτοιμο προς εκτέλεση πρόγραμμα. Επικολλήστε το σε μια νέα εφαρμογή κονσόλας, ενημερώστε τις διαδρομές και πατήστε **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Αναμενόμενο αποτέλεσμα:** Η κονσόλα εμφανίζει μήνυμα επιτυχίας, και το αρχείο `result.zip` περιέχει το `input.html` συν όλα τα εξαρτημένα περιουσιακά στοιχεία. Ανοίξτε το ZIP, κάντε διπλό κλικ στο `input.html`, και θα δείτε τη σελίδα να αποδίδεται ακριβώς όπως στο πρόγραμμα περιήγησης — χωρίς ελλιπείς εικόνες, χωρίς σπασμένο CSS. + +## Ανακεφαλαίωση – Γιατί Αυτή η Προσέγγιση Είναι Εξαιρετική + +- **Απόδοση σε ένα βήμα:** Δεν χρειάζεται να αντιγράψετε χειροκίνητα κάθε πόρο· το Aspose.HTML το κάνει για εσάς. +- **Προσαρμόσιμο pipeline:** Ο `ResourceHandler` σας δίνει πλήρη έλεγχο του τρόπου αποθήκευσης κάθε αρχείου, επιτρέποντας συμπίεση, κρυπτογράφηση ή μετασχηματισμό εν κινήσει. +- **Δια-πλατφόρμα:** Λειτουργεί σε Windows, Linux και macOS εφόσον υπάρχει .NET runtime. +- **Χωρίς εξωτερικά εργαλεία:** Η πλήρης διαδικασία **αποθήκευσης HTML ως ZIP** ζει μέσα στον κώδικα C# σας. + +## Τι Ακολουθεί; + +Τώρα που έχετε κατακτήσει την **αποθήκευση HTML ως ZIP**, σκεφτείτε να εξερευνήσετε τα παρακάτω συναφή θέματα: + +- **Εξαγωγή HTML σε PDF** – ιδανικό για εκτυπώσιμες αναφορές (η γνώση `export html to zip file` βοηθά όταν χρειάζεστε και τις δύο μορφές). +- **Ροή ZIP απευθείας σε HTTP response** – εξαιρετικό για web APIs που επιτρέπουν στους χρήστες να κατεβάσουν ένα πακεταρισμένο site άμεσα. +- **Κρυπτογράφηση αρχείων ZIP** – προσθέστε επίπεδο κωδικού πρόσβασης εάν διαχειρίζεστε εμπιστευτική τεκμηρίωση. + +Μη διστάσετε να πειραματιστείτε: αντικαταστήστε το `MyResourceHandler` με έναν συμπιεστή που μειώνει τις εικόνες, ή προσθέστε ένα αρχείο manifest που καταγράφει όλους τους πακεταρισμένους πόρους. Ο ουρανός είναι το όριο όταν ελέγχετε το pipeline απόδοσης. + +*Καλό κώδικα! Αν αντιμετωπίσετε προβλήματα ή έχετε ιδέες για βελτίωση, αφήστε ένα σχόλιο παρακάτω. Θα το λύσουμε μαζί.* + +## Σχετικά Μαθήματα + +- [Πώς να Συμπιέσετε HTML σε C# – Αποθήκευση HTML σε Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Αποθήκευση HTML ως ZIP – Πλήρης C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Αποθήκευση HTML σε ZIP σε C# – Πλήρες Παράδειγμα In‑Memory](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hindi/net/generate-jpg-and-png-images/_index.md b/html/hindi/net/generate-jpg-and-png-images/_index.md index b35cbb62e..018c87fb1 100644 --- a/html/hindi/net/generate-jpg-and-png-images/_index.md +++ b/html/hindi/net/generate-jpg-and-png-images/_index.md @@ -44,7 +44,9 @@ HTML दस्तावेज़ों में हेरफेर करने ### [DOCX को PNG/JPG में बदलते समय एंटीएलियासिंग कैसे सक्षम करें](./how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) DOCX फ़ाइलों को PNG या JPG में परिवर्तित करते समय एंटीएलियासिंग को सक्षम करने के चरणों को जानें। ### [DOCX को PNG में परिवर्तित करें – ZIP आर्काइव बनाएं C# ट्यूटोरियल](./convert-docx-to-png-create-zip-archive-c-tutorial/) -C# में DOCX फ़ाइलों को PNG छवियों में बदलें और उन्हें ZIP आर्काइव में संकलित करना सीखें। चरण-दर-चरण मार्गदर्शिका। +C# में DOCX फ़ाइलों को PNG छवियों में बदलें और उन्हें ZIP आर्काइव में संकलित करना सीखें। चरण-दर-शरण मार्गदर्शिका। +### [Word को PNG में परिवर्तित करते समय इमेज की चौड़ाई और ऊँचाई सेट करें – पूर्ण गाइड](./set-image-width-height-when-converting-word-to-png-full-guid/) +Word दस्तावेज़ को PNG में बदलते समय इमेज की चौड़ाई और ऊँचाई कैसे निर्धारित करें, इस पूर्ण गाइड में सीखें। ## निष्कर्ष diff --git a/html/hindi/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/hindi/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..5b671d2d5 --- /dev/null +++ b/html/hindi/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,261 @@ +--- +category: general +date: 2026-05-22 +description: Word दस्तावेज़ को PNG में बदलते समय छवि की चौड़ाई और ऊँचाई सेट करें। + चरण‑दर‑चरण ट्यूटोरियल में जानें कि कैसे docx को उच्च‑गुणवत्ता वाले रेंडरिंग के साथ + छवि के रूप में निर्यात किया जाए। +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: hi +og_description: Word दस्तावेज़ को PNG में बदलते समय छवि की चौड़ाई और ऊँचाई सेट करें। + यह ट्यूटोरियल दिखाता है कि कैसे docx को उच्च‑गुणवत्ता सेटिंग्स के साथ छवि के रूप + में निर्यात किया जाए। +og_title: वर्ड को पीएनजी में बदलते समय इमेज की चौड़ाई और ऊँचाई सेट करें – पूर्ण गाइड +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Word को PNG में परिवर्तित करते समय इमेज की चौड़ाई और ऊँचाई सेट करें – पूर्ण + मार्गदर्शिका +url: /hi/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word को PNG में बदलते समय इमेज की चौड़ाई और ऊँचाई सेट करें – पूर्ण गाइड + +क्या आपने कभी सोचा है कि **set image width height** कैसे सेट करें जबकि आप **convert Word to PNG** कर रहे हैं? आप अकेले नहीं हैं। कई डेवलपर्स को डिफ़ॉल्ट एक्सपोर्ट से धुंधली तस्वीर या गलत आयाम मिलने पर समस्या आती है, और फिर वे वास्तव में काम करने वाला समाधान खोजने में घंटे बिता देते हैं। + +इस ट्यूटोरियल में हम एक साफ़, अंत‑से‑अंत समाधान के माध्यम से चलेंगे जो दिखाता है **how to render word** दस्तावेज़ों को PNG इमेजेज़ के रूप में, जिससे आप **save docx as PNG** सटीक चौड़ाई‑ऊँचाई नियंत्रण और उच्च‑गुणवत्ता एंटीएलियासिंग के साथ कर सकते हैं। अंत तक आपके पास चलाने योग्य कोड स्निपेट, API विकल्पों की ठोस समझ, और कुछ प्रो टिप्स होंगी जो सामान्य समस्याओं से बचाएंगी। + +## आप क्या सीखेंगे + +- Aspose.Words for .NET का उपयोग करके `.docx` फ़ाइल लोड करें। +- `ImageRenderingOptions` के साथ **Set image width height** सेट करें। +- एंटीएलियासिंग सक्षम के साथ **Export docx as image** (PNG) करें। +- एक पेज या पूरे दस्तावेज़ के लिए **convert word to png** कैसे करें। +- बड़े दस्तावेज़ों को संभालने, DPI विचारों, और फ़ाइल‑सिस्टम पाथ्स के लिए टिप्स। + +कोई बाहरी टूल नहीं, कोई उलझनभरा कमांड‑लाइन जिम्नास्टिक नहीं—सिर्फ शुद्ध C# कोड जिसे आप किसी भी .NET प्रोजेक्ट में डाल सकते हैं। + +## पूर्वापेक्षाएँ + +शुरू करने से पहले, सुनिश्चित करें कि आपके पास निम्नलिखित हैं: + +| आवश्यकता | क्यों महत्वपूर्ण है | +|-------------|----------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words दोनों को सपोर्ट करता है, लेकिन नए रनटाइम बेहतर प्रदर्शन देते हैं। | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | `Document` क्लास और रेंडरिंग इंजन प्रदान करता है। | +| A **Word document** (`.docx`) you want to turn into a PNG. | वह स्रोत जिसे आप परिवर्तित करेंगे। | +| Basic C# knowledge – you’ll understand `using` statements and object initialization. | सीखने की कठिनाई को आसान रखता है। | + +यदि आपके पास NuGet पैकेज नहीं है, तो पैकेज मैनेजर कंसोल में यह चलाएँ: + +```powershell +Install-Package Aspose.Words +``` + +बस इतना ही—एक बार पैकेज स्थापित हो जाने पर, आप कोडिंग शुरू करने के लिए तैयार हैं। + +## चरण 1: स्रोत दस्तावेज़ लोड करें + +सबसे पहला काम जो आपको करना है वह है लाइब्रेरी को उस Word फ़ाइल की ओर इंगित करना जिसे आप बदलना चाहते हैं। + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Why this matters:** `Document` क्लास पूरे Word पैकेज को मेमोरी में पढ़ता है, जिससे आपको पेज, स्टाइल और बाकी सब कुछ तक पहुंच मिलती है। यदि पाथ गलत है, तो आपको `FileNotFoundException` मिलेगा, इसलिए दोबारा जांचें कि फ़ाइल मौजूद है और पाथ एस्केप्ड बैकस्लैश (`\\`) या वर्बेट स्ट्रिंग (`@`) का उपयोग करता है। + +> **Pro tip:** यदि आप उम्मीद करते हैं कि रनटाइम पर फ़ाइल गायब हो सकती है, तो लोड कॉल को `try/catch` ब्लॉक में रखें। + +## चरण 2: इमेज रेंडरिंग विकल्प कॉन्फ़िगर करें (Set Image Width Height) + +अब ट्यूटोरियल का मुख्य भाग आता है: **how to set image width height** ताकि परिणामी PNG खिंचा हुआ या पिक्सेलेटेड न हो। `ImageRenderingOptions` क्लास आपको आयाम, DPI, और स्मूदिंग पर सूक्ष्म नियंत्रण देती है। + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**मुख्य गुणों की व्याख्या:** + +- `Width` और `Height` – ये वही सटीक पिक्सेल आयाम हैं जो आप चाहते हैं। इन्हें सेट करके, आप सीधे **set image width height** करते हैं, डिफ़ॉल्ट पेज आकार को ओवरराइड करते हुए। +- `UseAntialiasing` – टेक्स्ट और वेक्टर ग्राफ़िक्स के लिए उच्च‑गुणवत्ता स्मूदिंग सक्षम करता है, जो **convert word to png** करते समय स्पष्ट किनारे पाने के लिए महत्वपूर्ण है। +- `Resolution` – उच्च DPI अधिक विवरण देता है, विशेषकर जटिल लेआउट्स के लिए। मेमोरी उपयोग पर ध्यान रखें; 300 DPI की इमेज बड़ी हो सकती है। + +> **डिफ़ॉल्ट आकार पर क्यों भरोसा न करें?** डिफ़ॉल्ट पेज के भौतिक आयामों (जैसे A4 96 DPI पर) का उपयोग करता है। यह अक्सर 794 × 1123 पिक्सेल की इमेज बनाता है—कुछ मामलों में ठीक है लेकिन जब आपको विशिष्ट UI थंबनेल या निश्चित‑आकार का प्रीव्यू चाहिए तब नहीं। + +## चरण 3: PNG के रूप में रेंडर और सेव करें (Export Docx as Image) + +दस्तावेज़ लोड हो जाने और विकल्प कॉन्फ़िगर हो जाने के बाद, आप अंततः **export docx as image** कर सकते हैं। `RenderToImage` मेथड यह काम करता है। + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +यदि आप **the whole document** (सभी पेज) को अलग‑अलग PNG फ़ाइलों में रेंडर करना चाहते हैं, तो पेज कलेक्शन पर लूप करें: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**आंतरिक प्रक्रिया क्या है?** रेंडरर प्रत्येक पेज को आपके द्वारा दिए गए आयामों का उपयोग करके रास्टराइज़ करता है, एंटीएलियासिंग लागू करता है, और PNG बाइट स्ट्रीम को डिस्क पर लिखता है। क्योंकि PNG लॉसलेस है, आप मूल Word लेआउट की पूरी शुद्धता बनाए रखते हैं। + +**अपेक्षित आउटपुट:** एक स्पष्ट PNG फ़ाइल बिल्कुल 1024 × 768 पिक्सेल (या जो भी आकार आपने सेट किया हो)। इसे किसी भी इमेज व्यूअर में खोलें और आप देखेंगे कि Word सामग्री बिल्कुल उसी तरह रेंडर हुई है जैसा मूल दस्तावेज़ में है, लेकिन अब यह एक बिटमैप इमेज है। + +## उन्नत टिप्स और विविधताएँ + +### 1. पारदर्शी बैकग्राउंड को संरक्षित रखें + +यदि आपके Word दस्तावेज़ में पारदर्शी बैकग्राउंड वाले शैप्स हैं और आप वह पारदर्शिता रखना चाहते हैं, तो `BackgroundColor` को `Color.Transparent` सेट करें: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. केवल एक विशिष्ट रेंज रेंडर करें + +कभी‑कभी आपको केवल एक पैराग्राफ या टेबल चाहिए, पूरे पेज की नहीं। `DocumentVisitor` का उपयोग करके नोड निकालें और उसे अलग से रेंडर करें। यह एक अधिक उन्नत परिदृश्य है, लेकिन यह दिखाता है **how to render word** सामग्री को ग्रैन्युलर स्तर पर। + +### 3. DPI को डायनामिक रूप से समायोजित करें + +यदि आपको पेज‑दर‑पेज अलग DPI चाहिए (जैसे कवर पेज के लिए हाई‑रेज़ोल्यूशन), तो लूप के अंदर `Resolution` को बदलें: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. बैच प्रोसेसिंग + +जब दर्जनों दस्तावेज़ बदल रहे हों, तो पूरे फ्लो को एक मेथड में रैप करें और वही `ImageRenderingOptions` इंस्टेंस पुनः उपयोग करें। विकल्प ऑब्जेक्ट को पुनः उपयोग करने से अलोकेशन ओवरहेड कम होता है। + +## सामान्य समस्याएँ और उन्हें कैसे टालें + +| लक्षण | संभावित कारण | समाधान | +|---------|--------------|-----| +| उच्च DPI के बावजूद PNG धुंधला है | `UseAntialiasing` को `false` छोड़ दिया गया | `UseAntialiasing = true` सेट करें। | +| `Width`/`Height` के अनुसार आउटपुट आकार नहीं मिलता | DPI को ध्यान में नहीं रखा गया | इच्छित आकार को `Resolution / 96` से गुणा करें या `Resolution` को समायोजित करें। | +| बड़े दस्तावेज़ों पर Out‑of‑memory अपवाद | 300 DPI पर पूरे दस्तावेज़ को रेंडर करना | एक बार में एक पेज रेंडर करें, सहेजने के बाद प्रत्येक इमेज को डिस्पोज़ करें। | +| पारदर्शी इमेज पर PNG सफ़ेद बैकग्राउंड दिखाता है | `BackgroundColor` सेट नहीं है | `imageOptions.BackgroundColor = Color.Transparent` सेट करें। | + +## पूर्ण कार्यशील उदाहरण + +नीचे एक स्व-निहित प्रोग्राम है जिसे आप कॉपी‑पेस्ट करके कंसोल ऐप में उपयोग कर सकते हैं। यह **convert word to png**, **save docx as png**, और बेशक **set image width height** को दर्शाता है। + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**चलाएँ:** प्रोजेक्ट बनाएं, निर्दिष्ट पाथ पर एक वैध `input.docx` रखें, और चलाएँ। आपको एक `output.png` बिल्कुल **1024 × 768** पिक्सेल के साथ दिखना चाहिए, स्मूद किनारों के साथ रेंडर किया हुआ। + +## संबंधित ट्यूटोरियल्स + +- [DOCX को PNG/JPG में बदलते समय एंटीएलियासिंग कैसे सक्षम करें](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – zip आर्काइव बनाएं c# ट्यूटोरियल](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Aspose का उपयोग करके HTML को PNG में रेंडर कैसे करें – चरण‑दर‑चरण गाइड](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hindi/net/html-extensions-and-conversions/_index.md b/html/hindi/net/html-extensions-and-conversions/_index.md index 45408d5a1..25160ee10 100644 --- a/html/hindi/net/html-extensions-and-conversions/_index.md +++ b/html/hindi/net/html-extensions-and-conversions/_index.md @@ -30,7 +30,7 @@ HTML एक्सटेंशन डेवलपर्स के लिए ए ## Aspose.HTML के साथ आरंभ करें -क्या आप शुरू करने के लिए तैयार हैं? .NET के लिए Aspose.HTML ट्यूटोरियल शुरुआती और अनुभवी डेवलपर्स दोनों के लिए हैं। चाहे आप HTML एक्सटेंशन और रूपांतरणों के लिए नए हों या उन्नत युक्तियों की तलाश कर रहे हों, हमारे चरण-दर-चरण मार्गदर्शिकाएँ आपकी आवश्यकताओं के अनुरूप डिज़ाइन की गई हैं। +क्या आप शुरू करने के लिए तैयार हैं? .NET के लिए Aspose.HTML ट्यूटोरियल शुरुआती और अनुभवी डेवलपर्स दोनों के लिए हैं। चाहे आप HTML एक्सटेंशन और रूपांतरणों के लिए नए हों या उन्नत युक्तियों की तलाश कर रहे हों, हमारे चरण-दर-स्टेप मार्गदर्शिकाएँ आपकी आवश्यकताओं के अनुरूप डिज़ाइन की गई हैं। ## .NET के लिए Aspose.HTML क्यों? @@ -38,7 +38,13 @@ Aspose.HTML for .NET सिर्फ़ एक लाइब्रेरी न ## HTML एक्सटेंशन और रूपांतरण ट्यूटोरियल ### [Aspose.HTML के साथ .NET में HTML को PDF में बदलें](./convert-html-to-pdf/) -.NET के लिए Aspose.HTML के साथ HTML को PDF में आसानी से बदलें। हमारे चरण-दर-चरण गाइड का पालन करें और HTML-से-PDF रूपांतरण की शक्ति को प्राप्त करें। +.NET के लिए Aspose.HTML के साथ HTML को PDF में आसानी से बदलें। हमारे चरण-दर-स्टेप गाइड का पालन करें और HTML-से-PDF रूपांतरण की शक्ति को प्राप्त करें। + +### [C# में HTML को PDF के रूप में रेंडर करें – पूर्ण चरण‑दर‑चरण गाइड](./render-html-as-pdf-in-c-full-step-by-step-guide/) +C# में Aspose.HTML का उपयोग करके HTML को PDF में बदलने की पूरी प्रक्रिया सीखें। चरण‑दर‑चरण मार्गदर्शन। + +### [C# के साथ HTML को PDF में बदलें – पूर्ण गाइड](./convert-html-to-pdf-with-c-complete-guide/) +C# में Aspose.HTML का उपयोग करके HTML को PDF में बदलने की पूरी प्रक्रिया सीखें। चरण‑दर‑चरण मार्गदर्शन। ### [HTML से PDF बनाएं – C# चरण‑दर‑चरण गाइड](./create-pdf-from-html-c-step-by-step-guide/) C# में Aspose.HTML का उपयोग करके HTML को PDF में बदलने का चरण‑दर‑चरण मार्गदर्शन। @@ -77,9 +83,12 @@ Aspose.HTML के साथ .NET में HTML को MHTML में बद .NET के लिए Aspose.HTML के साथ HTML को TIFF में कैसे बदलें, यह जानें। कुशल वेब सामग्री अनुकूलन के लिए हमारे चरण-दर-चरण मार्गदर्शिका का पालन करें। ### [Aspose.HTML के साथ .NET में HTML को XPS में बदलें](./convert-html-to-xps/) -.NET के लिए Aspose.HTML की शक्ति का पता लगाएं: HTML को XPS में आसानी से बदलें। पूर्वापेक्षाएँ, चरण-दर-चरण मार्गदर्शिका और FAQ शामिल हैं। +.NET के लिए Aspose.HTML की शक्ति का पता लगाएं: HTML को XPS में आसानी से बदलें। पूर्वापेक्षाएँ, चरण-दर-स्टेप मार्गदर्शिका और FAQ शामिल हैं। ### [HTML को ZIP के रूप में सहेजें – पूर्ण C# ट्यूटोरियल](./save-html-as-zip-complete-c-tutorial/) -HTML को ZIP फ़ाइल में सहेजने के चरण-दर-चरण मार्गदर्शन, C# कोड उदाहरण और अनुकूलन विकल्प। +HTML को ZIP फ़ाइल में सहेजने के चरण-दर-स्टेप मार्गदर्शन, C# कोड उदाहरण और अनुकूलन विकल्प। + +### [HTML को ZIP में सहेजें – Aspose.HTML के लिए पूर्ण गाइड](./save-html-as-zip-complete-guide-for-aspose-html/) +Aspose.HTML का उपयोग करके C# में HTML को ZIP फ़ाइल में सहेजने के सभी चरणों का विस्तृत मार्गदर्शन। ### [C# में HTML को ज़िप कैसे करें – HTML को ज़िप में सहेजें](./how-to-zip-html-in-c-save-html-to-zip/) .NET के लिए Aspose.HTML का उपयोग करके C# में HTML को ज़िप फ़ाइल में सहेजने का तरीका सीखें। diff --git a/html/hindi/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/hindi/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..b92197902 --- /dev/null +++ b/html/hindi/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,259 @@ +--- +category: general +date: 2026-05-22 +description: Aspose.HTML का उपयोग करके C# में HTML को PDF में बदलें। चरण‑दर‑चरण कोड, + विकल्प और Linux संकेतों के साथ C# में HTML को PDF में रेंडर करना सीखें। +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: hi +og_description: Aspose.HTML के साथ C# में HTML को PDF में बदलें। यह गाइड स्पष्ट विकल्पों + और Linux‑अनुकूल संकेतों का उपयोग करके C# में HTML को PDF में रेंडर करने का तरीका + दिखाता है। +og_title: C# के साथ HTML को PDF में परिवर्तित करें – पूर्ण गाइड +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: C# के साथ HTML को PDF में बदलें – पूर्ण मार्गदर्शिका +url: /hi/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML को PDF में बदलें C# के साथ – पूर्ण गाइड + +यदि आपको **HTML को PDF में जल्दी बदलना** है, तो Aspose.HTML for .NET इसे बहुत आसान बना देता है। इस ट्यूटोरियल में हम **C# में HTML को PDF में रेंडर करने का तरीका** भी बताएँगे, जिसमें रेंडरिंग विकल्पों पर पूर्ण नियंत्रण होगा, ताकि आप अनुमान में न रहें। + +कल्पना करें कि आपके पास एक मार्केटिंग ईमेल टेम्पलेट, एक रसीद पेज, या आधुनिक CSS के साथ बना एक जटिल रिपोर्ट है, और आपको इसे क्लाइंट या प्रिंटर को PDF के रूप में देना है। इसे मैन्युअली करना कष्टदायक है, लेकिन कुछ पंक्तियों के C# कोड से पूरी पाइपलाइन को स्वचालित किया जा सकता है। इस गाइड के अंत तक आपके पास एक स्व-समाहित, प्रोडक्शन‑रेडी समाधान होगा जो Windows *और* Linux दोनों पर काम करता है। + +## आपको क्या चाहिए + +- **.NET 6.0 या बाद का** – Aspose.HTML .NET Standard 2.0+ को टारगेट करता है, इसलिए कोई भी हालिया SDK काम करेगा। +- **Aspose.HTML for .NET** NuGet पैकेज (`Aspose.Html`) – प्रोडक्शन के लिए वैध लाइसेंस चाहिए, लेकिन परीक्षण के लिए फ्री ट्रायल चलती है। +- एक **सादा HTML फ़ाइल** जिसे आप PDF में बदलना चाहते हैं (हम इसे `input.html` कहेंगे)। +- आपका पसंदीदा IDE (Visual Studio, Rider, या VS Code) – कोई विशेष टूलिंग नहीं चाहिए। + +बस इतना ही। कोई बाहरी PDF कन्वर्टर नहीं, कोई कमांड‑लाइन जिम्नास्टिक नहीं। सिर्फ शुद्ध C#। + +![Aspose.HTML का उपयोग करके HTML को PDF में बदलने की कार्यप्रवाह को दर्शाने वाला चित्र](/images/convert-html-to-pdf-workflow.png "HTML को PDF में बदलने की कार्यप्रवाह") + +## HTML को PDF में बदलें – पूर्ण इम्प्लीमेंटेशन + +नीचे पूरा, तैयार‑चलाने‑योग्य प्रोग्राम है। इसे नई कंसोल ऐप में कॉपी‑पेस्ट करें, NuGet पैकेज रीस्टोर करें, और **F5** दबाएँ। + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### यह क्यों काम करता है + +- **`Document`** Aspose.HTML का एंट्री पॉइंट है; यह HTML को पार्स करता है, CSS को रिजॉल्व करता है, और रेंडरिंग के लिए तैयार DOM बनाता है। +- **`PdfRenderingOptions`** आपको आउटपुट को ट्यून करने देता है। `UseHinting` फ़्लैग हेडलेस Linux कंटेनरों में जहाँ डिफ़ॉल्ट रास्टराइज़र धुंधला दिख सकता है, वहाँ स्पष्ट टेक्स्ट के लिए गुप्त मसाला है। +- **`Save`** भारी काम करता है: यह DOM को PDF पेजों पर रास्टराइज़ करता है, पेज ब्रेक का सम्मान करता है, और फ़ॉन्ट्स को स्वचालित रूप से एम्बेड करता है। + +प्रोग्राम चलाने से `output.pdf` आपके स्रोत फ़ाइल के बगल में बन जाएगा। इसे किसी भी PDF व्यूअर से खोलें और आपको मूल HTML का सटीक दृश्य मिलना चाहिए। + +## C# में HTML को PDF में रेंडर करने का तरीका – चरण‑दर‑चरण + +नीचे हम प्रक्रिया को छोटे‑छोटे हिस्सों में विभाजित करते हैं, **C# में HTML को PDF में रेंडर करने का तरीका** समझाते हुए सामान्य समस्याओं को भी कवर करते हैं। + +### चरण 1 – Aspose.HTML NuGet पैकेज स्थापित करें + +प्रोजेक्ट फ़ोल्डर में अपना टर्मिनल खोलें और चलाएँ: + +```bash +dotnet add package Aspose.Html +``` + +यदि आप Visual Studio UI पसंद करते हैं, तो प्रोजेक्ट पर राइट‑क्लिक → **Manage NuGet Packages** → **Aspose.Html** खोजें और नवीनतम स्थिर संस्करण इंस्टॉल करें। + +> **Pro tip:** इंस्टॉल करने के बाद, प्रोजेक्ट की रूट में एक लाइसेंस फ़ाइल (`Aspose.Total.lic`) जोड़ें ताकि इवैल्यूएशन वॉटरमार्क न दिखें। + +### चरण 2 – अपने HTML को सही ढंग से लोड करें + +Aspose.HTML इनको इनजेस्ट कर सकता है: + +- लोकल फ़ाइल पाथ (`new Document("file.html")`) +- URLs (`new Document("https://example.com")`) +- रॉ HTML स्ट्रिंग्स (`new Document("…", new HtmlLoadOptions())`) + +फ़ाइल सिस्टम से लोड करते समय पाथ एब्सोल्यूट रखें या वर्किंग डायरेक्टरी सही सेट करें, नहीं तो `FileNotFoundException` आएगा। Linux पर फ़ॉरवर्ड स्लैश (`/`) या `Path.Combine` का उपयोग करें। + +### चरण 3 – सही रेंडरिंग विकल्प चुनें + +`UseHinting` के अलावा, आप निम्नलिखित को समायोजित कर सकते हैं: + +| विकल्प | क्या करता है | कब उपयोग करें | +|--------|--------------|----------------| +| `PageSize` | PDF पेज के आयाम सेट करता है (A4, Letter, कस्टम) | लक्ष्य कागज़ के आकार से मेल करें | +| `Landscape` | पेज को लैंडस्केप में घुमाता है | विस्तृत तालिकाएँ या चार्ट | +| `RasterizeVectorGraphics` | वेक्टर ग्राफ़िक्स को रास्टर इमेज में बदलता है | जब PDF उपभोक्ता SVG को संभाल नहीं सकता | +| `CompressionLevel` | इमेज संपीड़न को नियंत्रित करता है (0‑9) | ईमेल अटैचमेंट के लिए फ़ाइल आकार कम करें | + +इन प्रॉपर्टीज़ को आप फ़्लुएंटली चेन कर सकते हैं: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### चरण 4 – PDF सहेजें + +पूरा उदाहरण में दिखाया गया `Save` मेथड ओवरलोड सीधे फ़ाइल पाथ पर लिखता है। आप PDF को मेमोरी में भी स्ट्रीम कर सकते हैं: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +यह तब उपयोगी होता है जब आपको वेब API से PDF को डाउनलोड के रूप में रिटर्न करना हो। + +### चरण 5 – आउटपुट की जाँच करें + +एक त्वरित sanity चेक के लिए PDF पेज काउंट को अपेक्षित HTML सेक्शन की संख्या से तुलना करें। आप इसे Aspose.PDF से पढ़ सकते हैं: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +यदि काउंट गलत दिखे, तो CSS `page-break` नियमों को फिर से देखें या `PdfRenderingOptions` को तदनुसार समायोजित करें। + +## किनारे के मामले और सामान्य गड़बड़ियाँ + +| स्थिति | क्या देखना चाहिए | समाधान | +|-----------|-------------------|-----| +| **बाहरी संसाधन (छवियां, फ़ॉन्ट) गायब** | रिलेटिव URLs HTML फ़ाइल के फ़ोल्डर के सापेक्ष रिजॉल्व होते हैं। | `HtmlLoadOptions.BaseUri` का उपयोग करके सही रूट सेट करें। | +| **Linux हेडलेस एनवायरनमेंट** | डिफ़ॉल्ट टेक्स्ट रेंडरिंग धुंधली हो सकती है। | `UseHinting = true` सेट करें (जैसा दिखाया) और यदि System.Drawing पर फॉल्बैक करते हैं तो `libgdiplus` इंस्टॉल रखें। | +| **बड़ी HTML (> 10 MB)** | रेंडरिंग के दौरान मेमोरी खपत तेज़ी से बढ़ती है। | `PdfRenderer` के साथ `PdfRenderingOptions` उपयोग करके पेज‑बाय‑पेज रेंडर करें और प्रत्येक पेज को सहेजने के बाद डिस्पोज़ करें। | +| **JavaScript‑भारी पेज** | Aspose.HTML JS नहीं चलाता; डायनामिक कंटेंट स्थैतिक रहता है। | Aspose.HTML को फीड करने से पहले सर्वर‑साइड (जैसे Puppeteer) से HTML प्री‑प्रोसेस करें। | +| **Unicode कैरेक्टर स्क्वायर दिखा रहे हैं** | रनटाइम एनवायरनमेंट में फ़ॉन्ट्स नहीं हैं। | `FontSettings` से कस्टम फ़ॉन्ट एम्बेड करें या OS में आवश्यक फ़ॉन्ट्स इंस्टॉल करें। | + +## पूर्ण कार्यशील उदाहरण सारांश + +पूरा प्रोग्राम फिर से यहाँ दिया गया है, टिप्पणी‑रहित उन लोगों के लिए जो संक्षिप्त दृश्य पसंद करते हैं: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +इसे चलाएँ, `output.pdf` खोलें, और आपको `input.html` की पिक्सेल‑परफेक्ट प्रतिलिपि दिखेगी। यही है **HTML को PDF में बदलने** का सार Aspose.HTML के साथ। + +## निष्कर्ष + +हमने वह सब कवर किया जो आपको **C# में HTML को PDF में बदलने** के लिए चाहिए: Aspose.HTML इंस्टॉल करना, HTML लोड करना, रेंडरिंग विकल्पों को ट्यून करना (विशेष रूप से `UseHinting` फ़्लैग), और अंतिम PDF सहेजना। अब आप **C# में HTML को PDF में रेंडर करने का तरीका** Windows और Linux दोनों वातावरण में समझते हैं, और सामान्य किनारे के मामलों जैसे गायब संसाधन और बड़ी फ़ाइलों को कैसे संभालें, यह भी जानते हैं। + +अब क्या करें? कोशिश करें: + +- **हेडर/फ़ूटर** `PdfPageTemplate` के साथ ब्रांडिंग के लिए जोड़ें। +- **पासवर्ड प्रोटेक्शन** `PdfSaveOptions` के माध्यम से लागू करें। +- **बैच कन्वर्ज़न** फ़ोल्डर के सभी फ़ाइलों पर लूप करके करें + + +## संबंधित ट्यूटोरियल + +- [Aspose.HTML के साथ .NET में HTML को PDF में बदलें](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Aspose.HTML के साथ .NET में EPUB को PDF में बदलें](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Aspose.HTML के साथ .NET में SVG को PDF में बदलें](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hindi/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/hindi/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..5b9c60bf9 --- /dev/null +++ b/html/hindi/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,309 @@ +--- +category: general +date: 2026-05-22 +description: C# का उपयोग करके HTML को PDF में रेंडर करें, एक संक्षिप्त उदाहरण के साथ। + जानिए कैसे HTML को PDF में तेज़ और भरोसेमंद तरीके से C# के माध्यम से बदलें। +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: hi +og_description: C# में स्पष्ट, चलाने योग्य उदाहरण के साथ HTML को PDF के रूप में रेंडर + करें। यह गाइड आपको दिखाता है कि HTML को PDF में C# के साथ कैसे बदलें और HTML फ़ाइल + से PDF कैसे जनरेट करें। +og_title: C# में HTML को PDF के रूप में रेंडर करें – पूर्ण प्रोग्रामिंग ट्यूटोरियल +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: C# में HTML को PDF के रूप में रेंडर करें – पूर्ण चरण‑दर‑चरण गाइड +url: /hi/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C# में HTML को PDF के रूप में रेंडर करना – पूर्ण चरण‑दर‑चरण गाइड + +क्या आपको कभी **HTML को PDF के रूप में रेंडर** करने की ज़रूरत पड़ी लेकिन .NET प्रोजेक्ट के लिए कौन‑सी लाइब्रेरी चुनें, यह नहीं पता चला? आप अकेले नहीं हैं। कई लाइन‑ऑफ़‑बिज़नेस एप्लिकेशन में आपको **HTML को PDF C# में बदलने** की ज़रूरत पड़ती है—इनवॉइस, रिपोर्ट या मार्केटिंग ब्रोशर के लिए—आधारतः जब भी आप वेब पेज का प्रिंटेबल वर्ज़न चाहते हैं। + +बात यह है कि आपको पहिया फिर से बनाने की ज़रूरत नहीं है। कुछ ही लाइनों के कोड से आप `input.html` फ़ाइल को ले सकते हैं, उसे एक भरोसेमंद रेंडरिंग इंजन में फीड कर सकते हैं, और एक साफ़ `output.pdf` प्राप्त कर सकते हैं। इस ट्यूटोरियल में हम पूरी प्रक्रिया को कवर करेंगे, सही NuGet पैकेज जोड़ने से लेकर बाहरी CSS जैसी एज‑केस को हैंडल करने तक। अंत तक आप **HTML फ़ाइल से PDF जेनरेट** करने में सक्षम हो जाएंगे, वह भी कुछ ही मिनटों में। + +## आप क्या सीखेंगे + +- कैसे एक .NET कंसोल ऐप सेट‑अप करें जो **HTML से PDF C# कोड** बनाता है। +- वह सटीक API कॉल्स जो आपको **HTML दस्तावेज़ को PDF के रूप में सेव** करने के लिए चाहिए। +- क्यों कुछ रेंडरिंग विकल्प (जैसे हिन्टिंग) टेक्स्ट क्वालिटी के लिए महत्वपूर्ण हैं। +- सामान्य समस्याओं जैसे गायब फ़ॉन्ट या रिलेटिव इमेज पाथ्स को ट्रबलशूट करने के टिप्स। + +**Prerequisites** – आपके पास .NET 6+ या .NET Framework 4.7 इंस्टॉल होना चाहिए, C# की बुनियादी समझ, और एक IDE (Visual Studio 2022, Rider, या VS Code)। पहले से PDF का कोई अनुभव आवश्यक नहीं है। + +--- + +## Render HTML as PDF – प्रोजेक्ट सेट‑अप + +कोड में डुबकी लगाने से पहले, सुनिश्चित करें कि डेवलपमेंट एनवायरनमेंट तैयार है। हम जो लाइब्रेरी इस्तेमाल करेंगे वह **Select.Pdf** है (गैर‑वाणिज्यिक उपयोग के लिए फ्री) क्योंकि यह एक सरल API और ठोस रेंडरिंग फ़िडेलिटी प्रदान करती है। + +### Install the PDF rendering library (convert html to pdf c#) + +अपने प्रोजेक्ट फ़ोल्डर में एक टर्मिनल खोलें और चलाएँ: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* यदि आप Visual Studio उपयोग कर रहे हैं, तो आप NuGet Package Manager UI से भी पैकेज जोड़ सकते हैं। संस्करण संख्या नई हो सकती है—बस नवीनतम स्थिर रिलीज़ ले लें। + +### Create a console skeleton + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +बस इतना ही बायलरप्लेट चाहिए। भारी काम `Main` के अंदर होता है। + +--- + +## Load the HTML Document (generate pdf from html file) + +पहला असली कदम है रेंडरर को डिस्क पर मौजूद HTML फ़ाइल की ओर इशारा करना। Select.Pdf दो सुविधाजनक तरीके देता है: कच्चा HTML स्ट्रिंग पास करना या फ़ाइल पाथ देना। फ़ाइल का उपयोग करने से चीज़ें व्यवस्थित रहती हैं, ख़ासकर जब आपके पास लिंक्ड CSS या इमेजेज हों। + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +यहाँ हम फ़ाइल के न मिलने की स्थिति को भी संभालते हैं—जो शुरुआती अक्सर तब भूल जाते हैं जब वे HTML को आउटपुट फ़ोल्डर में कॉपी नहीं करते। + +--- + +## Configure Rendering Options (create pdf from html c#) + +Select.Pdf एक समृद्ध `PdfDocumentOptions` ऑब्जेक्ट के साथ आता है। स्पष्ट टेक्स्ट के लिए हम हिन्टिंग सक्षम करते हैं, जो ग्लिफ़्स को स्मूद करता है, लेकिन थोड़ा प्रदर्शन ओवरहेड जोड़ता है। + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +आप यहाँ पेज साइज, मार्जिन, या यहाँ तक कि कस्टम फ़ॉन्ट एम्बेड भी कर सकते हैं। मुख्य बात यह है कि **render html as pdf** सिर्फ एक‑लाइनर नहीं है; आपके पास अंतिम दस्तावेज़ की लुक और फ़ील पर पूरा नियंत्रण है। + +--- + +## Save HTML Document as PDF (render html as pdf) + +अब जादू होता है। हम कन्वर्टर को हमारी HTML फ़ाइल का पाथ देते हैं और उसे डिस्क पर PDF लिखने के लिए कहते हैं। + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +`ConvertUrl` मेथड स्वचालित रूप से रिलेटिव URL (इमेज, CSS) को HTML फ़ाइल के स्थान के आधार पर रिजॉल्व करता है, इसलिए यह अधिकांश वास्तविक‑दुनिया परिदृश्यों के लिए मजबूत है। + +### Expected output + +प्रोग्राम चलाने के बाद आपको उसी फ़ोल्डर में `output.pdf` फ़ाइल दिखनी चाहिए। इसे खोलें—आप देखेंगे: + +- हिन्टिंग के कारण स्पष्ट एंटी‑एलियासिंग के साथ रेंडर किया गया टेक्स्ट। +- लिंक्ड CSS से सही ढंग से लागू स्टाइल्स। +- स्रोत HTML में परिभाषित सटीक आकार की इमेजेज़। + +यदि कुछ भी गड़बड़ दिखे, तो सुनिश्चित करें कि CSS और इमेज फ़ाइलें `input.html` के साथ रखी गई हैं या एब्सोल्यूट URL इस्तेमाल करें। + +--- + +## Handling Common Edge Cases + +### 1. External resources blocked by firewalls + +यदि आपका HTML CDN पर होस्ट किए फ़ॉन्ट्स को रेफ़र करता है जो आपका सर्वर नहीं पहुंच पा रहा, तो PDF एक जनरिक फ़ॉन्ट पर फ़ॉल्बैक हो सकता है। इसे रोकने के लिए, फ़ॉन्ट फ़ाइलें लोकली डाउनलोड करें या `@font-face` के साथ रिलेटिव पाथ का उपयोग करके एम्बेड करें। + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Very large HTML files + +बड़े दस्तावेज़ों को बदलते समय आप मेमोरी लिमिट तक पहुँच सकते हैं। Select.Pdf आपको स्ट्रीमिंग के ज़रिए कन्वर्ज़न करने देता है: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +स्ट्रीमिंग प्रक्रिया को हल्का रखती है लेकिन आपको HTML को स्ट्रिंग के रूप में सप्लाई करना पड़ता है, जिसे आप ज़रूरत पड़ने पर चंक्स में पढ़ सकते हैं। + +### 3. Custom headers or footers + +यदि आपको हर पेज पर पेज नंबर या कंपनी लोगो चाहिए, तो `ConvertUrl` कॉल करने से पहले `converter.Options` पर `Header` और `Footer` प्रॉपर्टीज़ सेट करें। + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Full Working Example (All Steps Combined) + +नीचे पूरा, कॉपी‑एंड‑पेस्ट‑रेडी प्रोग्राम दिया गया है। `YOUR_DIRECTORY` को उस एब्सोल्यूट पाथ से बदलें जहाँ आपका HTML स्थित है। + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** प्रोजेक्ट डायरेक्टरी से `dotnet run` चलाएँ। यदि सब कुछ सही सेट‑अप है तो आपको सफलता संदेश और एक चमकदार `output.pdf` दिखाई देगा। + +--- + +## Visual Summary + +![Render HTML as PDF example](render-html-as-pdf.png){alt="HTML को PDF के रूप में रेंडर करने का उदाहरण"} + +स्क्रीनशॉट में कंसोल आउटपुट और व्यूअर में खुला हुआ PDF दिखाया गया है। स्पष्ट हेडिंग्स और सही लोड हुई इमेजेज़ पर ध्यान दें—बिल्कुल वही जो आप **render html as pdf** से उम्मीद करते हैं। + +--- + +## निष्कर्ष + +आपने अभी अभी **HTML को PDF के रूप में रेंडर** करना C# एप्लिकेशन में सीख लिया है, लाइब्रेरी इंस्टॉल करने से लेकर रेंडरिंग विकल्पों को फाइन‑ट्यून करने तक। पूरा उदाहरण एक भरोसेमंद तरीका दर्शाता है जिससे आप **convert HTML to PDF C#**, **generate PDF from HTML file**, और **save HTML document as PDF** केवल कुछ लाइनों में कर सकते हैं। + +अब आगे क्या? इन चीज़ों के साथ प्रयोग करें: + +- ब्रांड कंसिस्टेंसी के लिए कस्टम फ़ॉन्ट जोड़ना। +- डायनामिक HTML स्ट्रिंग्स (जैसे Razor टेम्प्लेट) से PDF जेनरेट करना। +- `PdfDocument.AddPage` का उपयोग करके कई PDFs को एक सिंगल रिपोर्ट में मर्ज करना। + +इनमें से प्रत्येक एक्सटेंशन यहाँ कवर किए गए कोर कॉन्सेप्ट्स पर आधारित है, इसलिए आप बिना किसी कठिन सीखने की घड़ी के अधिक एडवांस्ड परिदृश्यों को संभालने के लिए तैयार होंगे। + +कोई सवाल या कोई समस्या आई? नीचे कमेंट करें, और मिलकर ट्रबलशूट करें। Happy coding! + +## संबंधित ट्यूटोरियल + +- [Aspose.HTML के साथ .NET में HTML को PDF में बदलें](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [स्टाइल्ड टेक्स्ट के साथ HTML डॉक्यूमेंट बनाएं और PDF में एक्सपोर्ट करें – पूर्ण गाइड](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Aspose.HTML के साथ HTML को PDF में बदलें – पूर्ण मैनीपुलेशन गाइड](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hindi/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/hindi/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..b60a87c1f --- /dev/null +++ b/html/hindi/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,225 @@ +--- +category: general +date: 2026-05-22 +description: Aspose.HTML का उपयोग करके HTML को जल्दी ZIP के रूप में सहेजें। जानें + कि HTML फ़ाइलों को ZIP कैसे करें, HTML को ZIP में कैसे रेंडर करें, और पूर्ण कोड + के साथ HTML को ZIP फ़ाइल में कैसे निर्यात करें। +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: hi +og_description: Aspose.HTML के साथ HTML को ZIP के रूप में सहेजें। यह गाइड दिखाता है + कि कैसे HTML को ZIP में रेंडर किया जाए, HTML को ZIP फ़ाइल में निर्यात किया जाए, + और प्रोग्रामेटिक रूप से HTML फ़ाइलों को ज़िप किया जाए। +og_title: HTML को ZIP के रूप में सहेजें – पूर्ण Aspose.HTML ट्यूटोरियल +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: HTML को ZIP के रूप में सहेजें – Aspose.HTML के लिए पूर्ण गाइड +url: /hi/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML को ZIP के रूप में सहेजें – Aspose.HTML के लिए पूर्ण गाइड + +क्या आपने कभी सोचा है कि **HTML को ZIP के रूप में कैसे सहेजें** बिना किसी अलग आर्काइविंग टूल को निकाले? आप अकेले नहीं हैं। कई डेवलपर्स को एक HTML पेज को उसकी इमेजेज, CSS, और स्क्रिप्ट्स के साथ आसान वितरण के लिए बंडल करने की जरूरत होती है, और इसे मैन्युअली करना जल्दी ही एक समस्या बन जाता है। + +इस ट्यूटोरियल में हम एक साफ़, एंड‑टू‑एंड समाधान के माध्यम से चलेंगे जो Aspose.HTML for .NET का उपयोग करके **HTML को ZIP में रेंडर** करता है। अंत तक आप बिल्कुल जान पाएँगे कि **HTML को ZIP फ़ाइल में कैसे एक्सपोर्ट करें**, और विभिन्न परिदृश्यों में **HTML फ़ाइलों को ZIP कैसे करें** के विभिन्न विकल्प भी देखेंगे। + +> *प्रो टिप:* दिखाया गया तरीका काम करता है चाहे आप एक सिंगल पेज पैकेज कर रहे हों या पूरी साइट फ़ोल्डर। + +## आपको क्या चाहिए + +- .NET 6 (या कोई भी हालिया .NET रनटाइम) स्थापित हो। +- आपके प्रोजेक्ट में Aspose.HTML for .NET NuGet पैकेज (`Aspose.Html`) रेफ़रेंस किया हुआ हो। +- एक साधारण `input.html` फ़ाइल जिसे आप नियंत्रित फ़ोल्डर में रखें। +- C# की थोड़ी समझ—कुछ भी जटिल नहीं, बस बुनियादी बातें। + +बस इतना ही। कोई बाहरी ज़िप यूटिलिटीज़ नहीं, कोई कमांड‑लाइन जिम्नास्टिक नहीं। चलिए शुरू करते हैं। + +![Aspose.HTML का उपयोग करके HTML को ZIP के रूप में सहेजने की प्रक्रिया दिखाने वाला आरेख](save-html-as-zip.png) + +*छवि वैकल्पिक पाठ: HTML को ZIP प्रक्रिया आरेख* + +## चरण 1: स्रोत HTML दस्तावेज़ लोड करें + +पहला काम यह है कि हम Aspose.HTML को बताएं कि हमारा स्रोत कहाँ स्थित है। `HTMLDocument` क्लास फ़ाइल को पढ़ती है और एक इन‑मेमोरी DOM बनाती है, जो रेंडरिंग के लिए तैयार है। + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +क्यों यह महत्वपूर्ण है: दस्तावेज़ को लोड करने से लाइब्रेरी को रिसोर्स रेज़ॉल्यूशन (इमेजेज, CSS, फ़ॉन्ट्स) पर पूर्ण नियंत्रण मिल जाता है। यदि HTML रिलेटिव पाथ्स रेफ़र करता है, तो Aspose.HTML स्वचालित रूप से उन्हें फ़ाइल के फ़ोल्डर के सापेक्ष हल कर देता है। + +## चरण 2: (वैकल्पिक) एक कस्टम रिसोर्स हैंडलर बनाएं + +यदि आपको प्रत्येक रिसोर्स को निरीक्षण या संशोधित करने की आवश्यकता है—जैसे आप इमेजेज को आर्काइव में डालने से पहले कंप्रेस करना चाहते हैं—तो आप एक `ResourceHandler` प्लग इन कर सकते हैं। यह चरण वैकल्पिक है, लेकिन यह कस्टम लॉजिक के साथ **HTML को ZIP आर्काइव में बदलने** का सबसे लचीला तरीका है। + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*यदि आपको कोई विशेष प्रोसेसिंग नहीं चाहिए?* बस इस क्लास को स्किप करें और डिफ़ॉल्ट हैंडलर का उपयोग करें—Aspose.HTML रिसोर्सेज़ को सीधे ZIP में लिख देगा। + +## चरण 3: हैंडलर का उपयोग करने के लिए सेव ऑप्शन्स कॉन्फ़िगर करें + +`HtmlSaveOptions` ऑब्जेक्ट रेंडरर को बताता है कि रिसोर्सेज़ के साथ क्या करना है। हमारे `MyResourceHandler` को असाइन करके, हमें आउटपुट पर पूर्ण नियंत्रण मिल जाता है। + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +ध्यान दें कि प्रॉपर्टी नाम `ResourceHandler` सीधे **HTML को ZIP में रेंडर** क्षमता को संदर्भित करता है। यहीं पर जादू होता है: हर लिंक्ड रिसोर्स को डिस्क पर लिखने के बजाय आर्काइव में स्ट्रीम किया जाता है। + +## चरण 4: रेंडर किए गए दस्तावेज़ को ZIP आर्काइव में सहेजें + +अब हम अंततः **HTML को ZIP फ़ाइल में एक्सपोर्ट** करते हैं। `Save` मेथड किसी भी `Stream` को स्वीकार करता है, इसलिए हम इसे एक `FileStream` की ओर इंगित कर सकते हैं जो `result.zip` बनाता है। + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +यही पूरा वर्कफ़्लो है। जब कोड समाप्त हो जाता है, `result.zip` में शामिल होते हैं: + +- `input.html` (मूल मार्कअप) +- सभी रेफ़रेंस्ड इमेजेज, CSS फ़ाइलें, और फ़ॉन्ट्स +- `MyResourceHandler` में यदि आपने बदलाव किए हों तो कोई भी ट्रांसफ़ॉर्म्ड रिसोर्सेज़ + +## Aspose.HTML के बिना HTML फ़ाइलों को ZIP कैसे करें (त्वरित विकल्प) + +कभी-कभी आपको सिर्फ एक साधारण **HTML फ़ाइलों को ZIP करने** का तरीका चाहिए, शायद क्योंकि आप पहले से ही किसी अलग HTML पार्सर का उपयोग कर रहे हैं। ऐसे में आप .NET के बिल्ट‑इन `System.IO.Compression` का उपयोग कर सकते हैं: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +यह विधि सरल है लेकिन रेंडरिंग स्टेप की कमी है; यह केवल डिस्क पर मौजूद चीज़ों को पैक करता है। यदि आपका HTML बाहरी URLs को रेफ़र करता है, तो वे रिसोर्सेज़ शामिल नहीं होंगे। इसलिए जब आपको एक भरोसेमंद **HTML को ZIP में रेंडर** समाधान चाहिए, तो Aspose.HTML रास्ता पसंद किया जाता है। + +## एज केस और सामान्य pitfalls + +| स्थिति | ध्यान रखने योग्य बात | सुझाया गया समाधान | +|-----------|-------------------|-----------------| +| **बड़ी इमेजेज** | मेमोरी उपयोग में स्पाइक आता है क्योंकि प्रत्येक इमेज `MemoryStream` में लोड होती है। | कस्टम हैंडलर का उपयोग करके स्रोत स्ट्रीम को पूरी तरह बफ़र किए बिना सीधे ज़िप में स्ट्रीम करें। | +| **बाहरी URLs** | इंटरनेट पर होस्टेड रिसोर्सेज़ स्वचालित रूप से डाउनलोड नहीं होते। | `HtmlLoadOptions` को `BaseUrl` के साथ सेट करें जो साइट रूट की ओर इशारा करता हो, या सेव करने से पहले रिसोर्सेज़ को मैन्युअली डाउनलोड करें। | +| **फ़ाइल नाम टकराव** | विभिन्न सबफ़ोल्डर्स में समान नाम वाली दो CSS फ़ाइलें एक-दूसरे को ओवरराइट कर सकती हैं। | जब ज़िप में लिखें तो `ResourceHandler` पूर्ण रिलेटिव पाथ को संरक्षित करे, यह सुनिश्चित करें। | +| **परमिशन त्रुटियाँ** | रीड‑ओनली फ़ोल्डर में लिखने की कोशिश करने पर `UnauthorizedAccessException` फेंका जाता है। | प्रक्रिया को उचित विशेषाधिकारों के साथ चलाएँ या लिखने योग्य आउटपुट डायरेक्टरी चुनें। | + +इन परिदृश्यों को संबोधित करने से आपका **HTML को ZIP आर्काइव में बदलने** रूटीन प्रोडक्शन उपयोग के लिए मजबूत बनता है। + +## पूर्ण कार्यशील उदाहरण (सभी हिस्से एक साथ) + +नीचे पूरा, तैयार‑चलाने योग्य प्रोग्राम दिया गया है। इसे एक नई कन्सोल ऐप में पेस्ट करें, पाथ्स अपडेट करें, और **F5** दबाएँ। + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**अपेक्षित आउटपुट:** कन्सोल एक सफलता संदेश प्रिंट करता है, और `result.zip` फ़ाइल में `input.html` के साथ सभी निर्भर एसेट्स होते हैं। ज़िप खोलें, `input.html` पर डबल‑क्लिक करें, और आप पेज को ठीक उसी तरह रेंडर होते देखेंगे जैसा ब्राउज़र में था—कोई इमेज गायब नहीं, कोई टूटे हुए CSS नहीं। + +## पुनरावलोकन – क्यों यह तरीका शानदार है + +- **सिंगल‑स्टेप रेंडरिंग:** आपको प्रत्येक रिसोर्स को मैन्युअली कॉपी करने की जरूरत नहीं; Aspose.HTML यह आपके लिए करता है। +- **कस्टमाइज़ेबल पाइपलाइन:** `ResourceHandler` आपको प्रत्येक फ़ाइल को कैसे स्टोर किया जाए, इस पर पूर्ण नियंत्रण देता है, जिससे कंप्रेशन, एन्क्रिप्शन, या ऑन‑द‑फ़्लाई ट्रांसफ़ॉर्मेशन संभव होते हैं। +- **क्रॉस‑प्लेटफ़ॉर्म:** Windows, Linux, और macOS पर काम करता है जब तक आपके पास .NET रनटाइम हो। +- **कोई बाहरी टूल नहीं:** पूरा **HTML को ZIP के रूप में सहेजें** प्रोसेस आपके C# कोडबेस के भीतर रहता है। + +## आगे क्या? + +अब जब आप **HTML को ZIP के रूप में सहेजना** में निपुण हो गए हैं, तो इन संबंधित विषयों को एक्सप्लोर करने पर विचार करें: + +- **HTML को PDF में एक्सपोर्ट** – प्रिंटेबल रिपोर्ट्स के लिए परफेक्ट (`export html to zip file` ज्ञान मदद करता है जब आपको दोनों फॉर्मेट चाहिए)। +- **ZIP को सीधे HTTP रिस्पॉन्स में स्ट्रीम करना** – वेब API के लिए शानदार जो उपयोगकर्ताओं को ऑन‑द‑फ़्लाई पैकेज्ड साइट डाउनलोड करने देता है। +- **ZIP आर्काइव एन्क्रिप्ट करना** – यदि आप संवेदनशील दस्तावेज़ों से निपट रहे हैं तो पासवर्ड लेयर जोड़ें। + +बिना झिझक प्रयोग करें: `MyResourceHandler` को एक ऐसे कंप्रेसर से बदलें जो इमेजेज़ को छोटा करे, या एक मैनिफेस्ट फ़ाइल जोड़ें जो सभी बंडल्ड रिसोर्सेज़ की सूची दे। जब आप रेंडरिंग पाइपलाइन को नियंत्रित करते हैं तो संभावनाएँ असीमित हैं। + +*हैप्पी कोडिंग! यदि आपको कोई समस्या आती है या सुधार के लिए विचार हैं, तो नीचे कमेंट करें। हम मिलकर इसे सुलझाएंगे।* + +## संबंधित ट्यूटोरियल्स + +- [C# में HTML को ZIP कैसे करें – HTML को ZIP में सहेजें](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [HTML को ZIP के रूप में सहेजें – पूर्ण C# ट्यूटोरियल](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [C# में HTML को ZIP में सहेजें – पूर्ण इन‑मेमोरी उदाहरण](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hongkong/net/generate-jpg-and-png-images/_index.md b/html/hongkong/net/generate-jpg-and-png-images/_index.md index 33103bd04..c144d0c91 100644 --- a/html/hongkong/net/generate-jpg-and-png-images/_index.md +++ b/html/hongkong/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aspose.HTML for .NET 提供了一種將 HTML 轉換為映像的簡單方法。 了解如何在使用 Aspose.HTML for .NET 將 DOCX 轉換為 PNG 或 JPG 時啟用抗鋸齒，以提升圖像品質。 ### [使用 Aspose.HTML 在 .NET 中將 docx 轉換為 png 並建立 zip 壓縮檔 C# 教學](./convert-docx-to-png-create-zip-archive-c-tutorial/) 學習如何使用 Aspose.HTML for .NET 將 docx 轉換為 png，並將圖像打包成 zip 壓縮檔的完整步驟。 +### [將 Word 轉換為 PNG 時設定圖像寬高 – 完整指南](./set-image-width-height-when-converting-word-to-png-full-guid/) +學習如何在使用 Aspose.HTML for .NET 將 Word 文件轉換為 PNG 時設定圖像的寬度與高度，以獲得最佳顯示效果。 ## 結論 diff --git a/html/hongkong/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/hongkong/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..d65d5ba52 --- /dev/null +++ b/html/hongkong/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,256 @@ +--- +category: general +date: 2026-05-22 +description: 在將 Word 文件轉換為 PNG 時設定圖像的寬度與高度。學習如何在一步一步的教學中將 docx 匯出為高畫質渲染的圖像。 +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: zh-hant +og_description: 在將 Word 文件轉換為 PNG 時設定圖像的寬度與高度。本教學示範如何以高畫質設定將 docx 匯出為圖像。 +og_title: 在將 Word 轉換為 PNG 時設定圖片寬度與高度 – 完整指南 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: 將 Word 轉換為 PNG 時設定圖片寬高 – 完整指南 +url: /zh-hant/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 在將 Word 轉換為 PNG 時設定影像寬度與高度 – 完整指南 + +有沒有想過在 **convert Word to PNG** 時如何 **set image width height**？你並不是唯一遇到這個問題的人。許多開發者在預設匯出產生模糊圖片或尺寸不正確時卡住，接著花了好幾個小時尋找真正可行的解決方案。 + +在本教學中，我們將一步步示範完整的解決方案，說明 **how to render word** 文件為 PNG 圖片，讓你能 **save docx as PNG**，並精確控制寬度與高度，同時使用高品質的抗鋸齒。完成後，你將擁有可直接執行的程式碼片段、對 API 選項的深入了解，以及避免常見陷阱的幾個專業提示。 + +## 你將學會 + +- 使用 Aspose.Words for .NET 載入 `.docx` 檔案。 +- 使用 `ImageRenderingOptions` **set image width height**。 +- 使用啟用抗鋸齒的方式 **Export docx as image**（PNG）。 +- 說明如何 **convert word to png** 單頁或整份文件。 +- 處理大型文件、DPI 考量與檔案系統路徑的技巧。 + +不需要外部工具，也不必使用繁雜的指令列操作——只要純粹的 C# 程式碼，直接放入任何 .NET 專案即可。 + +## 前置條件 + +在開始之前，請確保你已具備以下條件： + +| 需求 | 原因說明 | +|------|----------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words 兩者皆支援，但較新的執行環境可提供更佳效能。 | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | 提供 `Document` 類別與渲染引擎。 | +| 你想要轉換成 PNG 的 **Word 文件**（`.docx`）。 | 即將被轉換的來源檔案。 | +| 基本的 C# 知識——了解 `using` 陳述式與物件初始化。 | 讓學習曲線保持平緩。 | + +如果尚未安裝 NuGet 套件，請在套件管理員主控台執行以下指令： + +```powershell +Install-Package Aspose.Words +``` + +就這樣——套件安裝完成後，即可開始撰寫程式碼。 + +## 步驟 1：載入來源文件 + +首先，你需要將程式庫指向欲轉換的 Word 檔案。 + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**為什麼重要：** `Document` 類別會將整個 Word 套件讀入記憶體，讓你可以存取頁面、樣式以及其他所有內容。若路徑錯誤，會拋出 `FileNotFoundException`，因此請再次確認檔案是否存在，且路徑使用已跳脫的反斜線（`\\`）或逐字字串（`@`）。 + +> **專業提示：** 若預期執行時檔案可能不存在，請將載入呼叫包在 `try/catch` 區塊中。 + +## 步驟 2：設定影像渲染選項（Set Image Width Height） + +現在進入本教學的核心：**how to set image width height**，以避免產生的 PNG 被拉伸或像素化。`ImageRenderingOptions` 類別讓你能細緻控制尺寸、DPI 與平滑度。 + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**關鍵屬性的說明：** + +- `Width` 與 `Height` – 這是你想要的精確像素尺寸。設定後即可直接 **set image width height**，覆寫預設頁面大小。 +- `UseAntialiasing` – 為文字與向量圖形啟用高品質平滑，這在 **convert word to png** 且想要清晰邊緣時至關重要。 +- `Resolution` – 較高的 DPI 會提供更多細節，特別是對於複雜版面。需留意記憶體使用量；300 DPI 圖片可能相當龐大。 + +> **為什麼不直接使用預設大小？** 預設會使用頁面的實體尺寸（例如 A4 於 96 DPI）。這通常會產生 794 × 1123 像素的圖像——對某些情況尚可，但若需要特定 UI 縮圖或固定尺寸的預覽時就不適合。 + +## 步驟 3：渲染並儲存為 PNG（Export Docx as Image） + +在文件已載入且選項設定完成後，你終於可以 **export docx as image**。`RenderToImage` 方法負責執行主要的渲染工作。 + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +若想將 **the whole document**（所有頁面）分別渲染成 PNG 檔案，可遍歷頁面集合： + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**底層運作原理是什麼？** 渲染器會使用你提供的尺寸將每頁光柵化，套用抗鋸齒，並將 PNG 位元組流寫入磁碟。由於 PNG 為無損格式，能完整保留原始 Word 版面的細節。 + +**預期輸出：** 一個清晰的 PNG 檔案，尺寸正好為 1024 × 768 像素（或你設定的任意尺寸）。使用任何影像檢視器開啟，即可看到 Word 內容以位圖形式精確呈現在原始文件中的樣子。 + +## 進階技巧與變化 + +### 1. 保留透明背景 + +如果你的 Word 文件包含具有透明背景的圖形且想保留透明度，請將 `BackgroundColor` 設為 `Color.Transparent`： + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. 僅渲染特定範圍 + +有時只需要某段落或表格，而非整頁。可使用 `DocumentVisitor` 抽取節點並單獨渲染。這是較進階的情境，但它展示了 **how to render word** 內容的細部控制。 + +### 3. 動態調整 DPI + +若每頁需要不同的 DPI（例如封面頁需要高解析度），可在迴圈內調整 `Resolution`： + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. 批次處理 + +在轉換數十份文件時，將整個流程封裝成方法，並重複使用同一個 `ImageRenderingOptions` 實例。重複使用選項物件可減少分配開銷。 + +## 常見陷阱與避免方法 + +| 症狀 | 可能原因 | 解決方法 | +|------|----------|----------| +| 即使 DPI 較高 PNG 仍模糊 | `UseAntialiasing` 為 `false` | 設定 `UseAntialiasing = true`。 | +| 輸出尺寸未符合 `Width`/`Height` | 未考慮 DPI | 將期望尺寸乘以 `Resolution / 96` 或調整 `Resolution`。 | +| 大型文件導致記憶體不足例外 | 以 300 DPI 渲染整份文件 | 一次只渲染單頁，儲存後釋放每張影像。 | +| 透明圖像的 PNG 顯示白色背景 | `BackgroundColor` 未設定 | 設定 `imageOptions.BackgroundColor = Color.Transparent`。 | + +## 完整可執行範例 + +以下是一個獨立的程式，你可以直接複製貼上到 Console 應用程式中。它示範了 **convert word to png**、**save docx as png**，以及當然的 **set image width height**。 + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**執行方式：** 建置專案，於你指定的路徑放置有效的 `input.docx`，然後執行。你應該會看到一個尺寸正好為 **1024 × 768** 像素的 `output.png`，且邊緣平滑。 + +## 相關教學 + +- [如何在將 DOCX 轉換為 PNG/JPG 時啟用抗鋸齒](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – 建立 zip 壓縮檔的 C# 教學](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [如何使用 Aspose 將 HTML 渲染為 PNG – 步驟指南](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hongkong/net/html-extensions-and-conversions/_index.md b/html/hongkong/net/html-extensions-and-conversions/_index.md index 3d146ada2..999a75af6 100644 --- a/html/hongkong/net/html-extensions-and-conversions/_index.md +++ b/html/hongkong/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,10 @@ Aspose.HTML for .NET 不只是一個函式庫；它還是一個函式庫。它 ## HTML 擴充功能與轉換教學課程 ### [使用 Aspose.HTML 將 .NET 中的 HTML 轉換為 PDF](./convert-html-to-pdf/) 使用 Aspose.HTML for .NET 輕鬆將 HTML 轉換為 PDF。遵循我們的逐步指南，釋放 HTML 到 PDF 轉換的強大功能。 +### [使用 C# 將 HTML 轉換為 PDF – 完整指南](./convert-html-to-pdf-with-c-complete-guide/) +使用 Aspose.HTML for .NET 透過 C# 完整步驟將 HTML 轉換為 PDF，提供範例程式碼與最佳實踐。 +### [在 C# 中將 HTML 渲染為 PDF – 完整逐步指南](./render-html-as-pdf-in-c-full-step-by-step-guide/) +使用 Aspose.HTML for .NET，在 C# 中將 HTML 轉換為 PDF 的完整步驟說明與範例。 ### [使用 C# 從 HTML 建立 PDF – 完整步驟指南](./create-pdf-from-html-c-step-by-step-guide/) 使用 Aspose.HTML for .NET，透過 C# 將 HTML 轉換為 PDF 的完整步驟說明與範例。 ### [使用 Aspose.HTML 將 EPUB 轉換為 .NET 中的映像](./convert-epub-to-image/) @@ -73,6 +77,8 @@ Aspose.HTML for .NET 不只是一個函式庫；它還是一個函式庫。它 使用 Aspose.HTML for .NET 將 HTML 文件壓縮為 ZIP 檔案，提供完整的 C# 範例與步驟說明。 ### [在 C# 中將 HTML 儲存為 ZIP – 完整的記憶體內示例](./save-html-to-zip-in-c-complete-in-memory-example/) 示範如何在 C# 中使用 Aspose.HTML 將 HTML 內容直接壓縮成 ZIP 檔案，全部在記憶體中完成。 +### [使用 Aspose.HTML 將 HTML 儲存為 ZIP – 完整指南](./save-html-as-zip-complete-guide-for-aspose-html/) +使用 Aspose.HTML for .NET 完整步驟將 HTML 壓縮為 ZIP，提供範例程式碼與詳細說明。 ## 結論 diff --git a/html/hongkong/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/hongkong/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..a6f920dc0 --- /dev/null +++ b/html/hongkong/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,257 @@ +--- +category: general +date: 2026-05-22 +description: 使用 Aspose.HTML 在 C# 中將 HTML 轉換為 PDF。學習如何以逐步程式碼、選項及 Linux 提示在 C# 內渲染 HTML + 為 PDF。 +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: zh-hant +og_description: 使用 Aspose.HTML 在 C# 中將 HTML 轉換為 PDF。本指南說明如何在 C# 中透過清晰的選項與支援 Linux + 的提示將 HTML 轉換為 PDF。 +og_title: 使用 C# 將 HTML 轉換為 PDF – 完整指南 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: 使用 C# 將 HTML 轉換為 PDF – 完整指南 +url: /zh-hant/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 使用 C# 將 HTML 轉換為 PDF – 完整指南 + +如果你需要快速 **convert HTML to PDF**，Aspose.HTML for .NET 讓這變得輕而易舉。在本教學中，我們也會回答 **how to render HTML to PDF in C#**，並提供完整的渲染選項控制，讓你不再猜測。 + +想像一下，你有一個行銷電子郵件範本、收據頁面，或是使用現代 CSS 建立的複雜報告，必須將它以 PDF 形式交給客戶或印表機。手動處理非常麻煩，但只要幾行 C# 程式碼就能自動化整個流程。完成本指南後，你將擁有一個自包含、可投入生產的解決方案，能在 Windows *以及* Linux 上執行。 + +## 需要的條件 + +- **.NET 6.0 或更新版本** – Aspose.HTML 目標為 .NET Standard 2.0+，因此任何近期的 SDK 都可使用。 +- **Aspose.HTML for .NET** NuGet 套件 (`Aspose.Html`) – 於正式環境需使用有效授權，但免費試用版可用於測試。 +- 一個你想轉換成 PDF 的 **簡易 HTML 檔案**（我們稱之為 `input.html`）。 +- 你慣用的 IDE（Visual Studio、Rider 或 VS Code）– 無需特別工具。 + +就這樣。無需外部 PDF 轉換器，也不需要命令列技巧。純粹使用 C#。 + +![Diagram illustrating the convert html to pdf workflow using Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## Convert HTML to PDF – 完整實作 + +以下是完整、可直接執行的程式。將它複製貼上到新的 Console 應用程式，還原 NuGet 套件，然後按 **F5**。 + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### 為什麼這樣可行 + +- **`Document`** 是 Aspose.HTML 的入口點；它會解析 HTML、解析 CSS，並建立可供渲染的 DOM。 +- **`PdfRenderingOptions`** 讓你調整輸出。`UseHinting` 旗標是在無頭 Linux 容器中取得清晰文字的祕密，因為預設光柵化器可能會顯得模糊。 +- **`Save`** 承擔主要工作：將 DOM 光柵化至 PDF 頁面，遵守分頁斷點，並自動嵌入字型。 + +執行程式後會在你的來源檔案旁產生 `output.pdf`。使用任何 PDF 檢視器開啟，你應該會看到與原始 HTML 完全相符的視覺效果。 + +## 如何在 C# 中將 HTML 渲染為 PDF – 步驟說明 + +以下我們將整個流程拆解為易於理解的步驟，說明 **how to render HTML to PDF in C#**，並涵蓋常見的陷阱。 + +### 步驟 1 – 安裝 Aspose.HTML NuGet 套件 + +在專案資料夾的終端機中執行： + +```bash +dotnet add package Aspose.Html +``` + +如果你偏好使用 Visual Studio 介面，右鍵點擊專案 → **Manage NuGet Packages** → 搜尋 **Aspose.Html** 並安裝最新的穩定版。 + +> **小技巧：** 安裝完成後，將授權檔案 (`Aspose.Total.lic`) 放置於專案根目錄，以避免評估水印。 + +### 步驟 2 – 正確載入 HTML + +Aspose.HTML 可接受以下來源： + +- 本機檔案路徑 (`new Document("file.html")`) +- URL (`new Document("https://example.com")`) +- 原始 HTML 字串 (`new Document("…", new HtmlLoadOptions())`) + +從檔案系統載入時，請確保路徑為絕對路徑或已正確設定工作目錄，否則會拋出 `FileNotFoundException`。在 Linux 上，請使用正斜線 (`/`) 或 `Path.Combine`。 + +### 步驟 3 – 選擇正確的渲染選項 + +除了 `UseHinting`，你可能還想調整以下設定： + +| 選項 | 功能說明 | 使用時機 | +|------|----------|----------| +| `PageSize` | 設定 PDF 頁面尺寸（A4、Letter、或自訂） | 與目標紙張尺寸相符 | +| `Landscape` | 將頁面旋轉為橫向 | 寬表格或圖表 | +| `RasterizeVectorGraphics` | 強制將向量圖形轉為點陣圖 | 當 PDF 閱讀器無法處理 SVG 時 | +| `CompressionLevel` | 控制影像壓縮程度（0‑9） | 減少檔案大小以便於電郵附件 | + +你可以流暢地鏈接這些屬性： + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### 步驟 4 – 儲存 PDF + +`Save` 方法的多載在完整範例中會直接寫入檔案路徑。你也可以將 PDF 串流至記憶體： + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +當你需要從 Web API 下載 PDF 時，這非常方便。 + +### 步驟 5 – 驗證輸出 + +快速的合理性檢查是比較 PDF 的頁數與預期的 HTML 區段數。你可以使用 Aspose.PDF 讀回： + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +如果頁數不符，請檢查 CSS 的 `page-break` 規則或相應調整 `PdfRenderingOptions`。 + +## 邊緣情況與常見陷阱 + +| 情況 | 需注意的事項 | 解決方式 | +|------|--------------|----------| +| **外部資源（圖片、字型）遺失** | 相對 URL 會以 HTML 檔案所在資料夾為基礎解析。 | 使用 `HtmlLoadOptions.BaseUri` 指向正確的根目錄。 | +| **Linux 無頭環境** | 預設文字渲染可能模糊。 | 如範例所示設定 `UseHinting = true`，若回退至 System.Drawing，請確保已安裝 `libgdiplus`。 | +| **大型 HTML（> 10 MB）** | 渲染期間記憶體使用量激增。 | 使用 `PdfRenderer` 搭配 `PdfRenderingOptions` 逐頁渲染，並在儲存後釋放每頁資源。 | +| **大量 JavaScript 的頁面** | Aspose.HTML 不會執行 JS；動態內容會保持靜態。 | 在送入 Aspose.HTML 前，先於伺服器端預先處理 HTML（例如使用 Puppeteer）。 | +| **Unicode 字元顯示為方塊** | 執行環境缺少字型。 | 透過 `FontSettings` 嵌入自訂字型，或確保作業系統已安裝所需字型。 | + +## 完整範例回顧 + +以下再次提供完整程式碼，已移除註解，適合想要簡潔檢視的讀者： + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +執行後，開啟 `output.pdf`，即可看到 `input.html` 的像素完美複製。這就是使用 Aspose.HTML 進行 **convert html to pdf** 的精髓。 + +## 結論 + +我們已完整說明在 C# 中 **convert HTML to PDF** 所需的所有步驟：安裝 Aspose.HTML、載入 HTML、調整渲染選項（包括關鍵的 `UseHinting` 旗標），以及儲存最終 PDF。現在你已了解 **how to render HTML to PDF in C#**，適用於 Windows 與 Linux 環境，並掌握如何處理常見的邊緣情況，如資源遺失與大型檔案。 + +接下來可以嘗試加入： + +- **頁首/頁尾** 使用 `PdfPageTemplate` 以加入品牌資訊。 +- 透過 `PdfSaveOptions` 加入 **密碼保護**。 +- **批次轉換**：遍歷資料夾中的… + +## 相關教學 + +- [使用 Aspose.HTML 於 .NET 轉換 HTML 為 PDF](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [使用 Aspose.HTML 於 .NET 轉換 EPUB 為 PDF](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [使用 Aspose.HTML 於 .NET 轉換 SVG 為 PDF](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hongkong/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/hongkong/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..0f078098d --- /dev/null +++ b/html/hongkong/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,305 @@ +--- +category: general +date: 2026-05-22 +description: 使用 C# 渲染 HTML 為 PDF，示範簡潔範例。快速且可靠地學習如何將 HTML 轉換為 PDF（C#）。 +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: zh-hant +og_description: 在 C# 中將 HTML 轉換為 PDF，提供清晰可執行的範例。本指南示範如何在 C# 中將 HTML 轉為 PDF，並從 HTML + 檔案產生 PDF。 +og_title: 在 C# 中將 HTML 轉換為 PDF – 完整程式設計教學 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: 在 C# 中將 HTML 轉換為 PDF – 完整逐步指南 +url: /zh-hant/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 在 C# 中將 HTML 轉換為 PDF – 完整逐步指南 + +有沒有曾經需要 **render HTML as PDF**，卻不確定該為 .NET 專案挑選哪個函式庫？你並不孤單。在許多企業應用程式中，你會需要 **convert HTML to PDF C#** 來產生發票、報告或行銷手冊——基本上，只要想要將網頁製作成可列印的版本，都會用到它。 + +事實是，你不需要重新發明輪子。只要幾行程式碼，就能將 `input.html` 檔案交給成熟的渲染引擎，產出清晰的 `output.pdf`。在本教學中，我們將完整說明整個流程，從加入正確的 NuGet 套件到處理外部 CSS 等邊緣情況。完成後，你就能在幾分鐘內 **generate PDF from HTML file**。 + +## 你將學到的內容 + +- 如何設定一個 .NET 主控台應用程式，以 **creates PDF from HTML C#** 程式碼。 +- 你需要的 **save HTML document as PDF** 的精確 API 呼叫。 +- 為什麼某些渲染選項（例如 hinting）會影響文字品質。 +- 排除常見問題的技巧，例如缺少字型或相對圖像路徑。 + +**Prerequisites** – 你應該已安裝 .NET 6+ 或 .NET Framework 4.7，具備 C# 基礎知識，並有 IDE（Visual Studio 2022、Rider 或 VS Code）。不需要先前的 PDF 經驗。 + +--- + +## Render HTML as PDF – 設定專案 + +在深入程式碼之前，先確保開發環境已就緒。我們將使用的函式庫是 **Select.Pdf**（非商業用途免費），因為它提供簡單的 API 與穩定的渲染精度。 + +### Install the PDF rendering library (convert html to pdf c#) + +在專案資料夾中開啟終端機並執行： + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* 如果你使用 Visual Studio，也可以透過 NuGet 套件管理員 UI 加入套件。版本號可能較新——只要取得最新的穩定版即可。 + +### 建立主控台骨架 + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +這就是你所需的全部樣板程式碼。繁重的工作在 `Main` 內完成。 + +--- + +## Load the HTML Document (generate pdf from html file) + +第一個實際步驟是將渲染器指向磁碟上的 HTML 檔案。Select.Pdf 提供兩種便利方式：傳入原始 HTML 字串或檔案路徑。使用檔案能保持整潔，特別是當你有連結的 CSS 或圖片時。 + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +此處我們也會檢查檔案是否遺失——這是初學者常因忘記將 HTML 複製到輸出資料夾而卡住的問題。 + +--- + +## 設定渲染選項 (create pdf from html c#) + +Select.Pdf 內建豐富的 `PdfDocumentOptions` 物件。為了讓文字更清晰，我們啟用 hinting，這會在微小的效能損耗下平滑字形。 + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +你可以在此調整頁面尺寸、邊距，甚至嵌入自訂字型。重點是 **render html as pdf** 並非只需要一行程式碼；你可以掌控最終文件的外觀與感受。 + +--- + +## 將 HTML 文件儲存為 PDF (render html as pdf) + +現在魔法發生了。我們將 HTML 檔案路徑交給轉換器，請它寫入 PDF 到磁碟。 + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +`ConvertUrl` 方法會自動根據 HTML 檔案所在位置解析相對 URL（圖片、CSS），因此此方式在大多數實務情境下相當穩健。 + +### 預期輸出 + +執行程式後，你應該會在同一資料夾看到 `output.pdf` 檔案。打開它，你會注意到： + +- 文字以清晰的抗鋸齒渲染（感謝 hinting）。 +- 連結的 CSS 樣式正確套用。 +- 圖片以原始 HTML 定義的尺寸顯示。 + +如果有任何異常，請再次確認 CSS 與圖片檔案是否與 `input.html` 放在同一目錄，或改用絕對 URL。 + +--- + +## 處理常見邊緣案例 + +### 1. 防火牆阻擋的外部資源 + +如果你的 HTML 參考了 CDN 上的字型，而伺服器無法存取，PDF 可能會退回使用通用字型。為避免此情況，請將字型檔案下載至本機，或使用相對路徑的 `@font-face` 方式嵌入。 + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. 超大型 HTML 檔案 + +轉換大型文件時，可能會觸及記憶體上限。Select.Pdf 允許以串流方式進行轉換： + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +### 3. 自訂頁首或頁尾 + +如果需要在每頁加入頁碼或公司標誌，請在呼叫 `ConvertUrl` 前於 `converter.Options` 設定 `Header` 與 `Footer` 屬性。 + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## 完整可執行範例（結合所有步驟） + +以下是完整、可直接複製貼上的程式碼。將 `YOUR_DIRECTORY` 替換為你的 HTML 所在的絕對路徑。 + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** 在專案目錄執行 `dotnet run`。若設定正確，你會看到成功訊息以及一個閃亮的 `output.pdf`。 + +--- + +## 視覺摘要 + +![Render HTML as PDF example](render-html-as-pdf.png){alt="render html as pdf example"} + +此螢幕截圖顯示了主控台輸出以及在檢視器中開啟的 PDF。請注意清晰的標題與正確載入的圖片——這正是你在 **render html as pdf** 時所期待的效果。 + +--- + +## 結論 + +你剛剛學會了如何在 C# 應用程式中 **render HTML as PDF**，從安裝函式庫到微調渲染選項。完整範例示範了一種可靠的方式，僅用少量程式碼即可 **convert HTML to PDF C#**、**generate PDF from HTML file**，以及 **save HTML document as PDF**。 + +接下來可以嘗試： + +- 加入自訂字型以維持品牌一致性。 +- 從動態 HTML 字串（例如 Razor 模板）產生 PDF。 +- 使用 `PdfDocument.AddPage` 將多個 PDF 合併成單一報告。 + +上述每個延伸功能皆建立在本章的核心概念上，讓你能在不需陡峭學習曲線的情況下，應對更進階的情境。 + +有任何問題或遇到困難嗎？在下方留下評論，我們一起來排除問題。祝開發愉快！ + +## 相關教學 + +- [在 .NET 中使用 Aspose.HTML 轉換 HTML 為 PDF](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [建立帶樣式文字的 HTML 文件並匯出為 PDF – 完整指南](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [使用 Aspose.HTML 轉換 HTML 為 PDF – 完整操作指南](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hongkong/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/hongkong/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..eec0d0c7c --- /dev/null +++ b/html/hongkong/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-05-22 +description: 使用 Aspose.HTML 快速將 HTML 儲存為 ZIP。了解如何壓縮 HTML 檔案、將 HTML 渲染成 ZIP，並使用完整程式碼將 + HTML 匯出為 ZIP 檔案。 +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: zh-hant +og_description: 使用 Aspose.HTML 將 HTML 儲存為 ZIP。本指南說明如何將 HTML 轉換為 ZIP、將 HTML 匯出為 ZIP + 檔案，以及以程式方式壓縮 HTML 檔案。 +og_title: 將 HTML 儲存為 ZIP – 完整 Aspose.HTML 教程 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: 將 HTML 儲存為 ZIP – Aspose.HTML 完整指南 +url: /zh-hant/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# 將 HTML 儲存為 ZIP – Aspose.HTML 完整指南 + +有沒有想過在不使用額外壓縮工具的情況下 **將 HTML 儲存為 ZIP**？你並不是唯一有此需求的人。許多開發人員需要將 HTML 頁面與其圖片、CSS 及腳本一起打包，以便輕鬆分發，而手動操作很快就會變成痛點。 + +在本教學中，我們將一步步示範使用 Aspose.HTML for .NET **將 HTML 轉換為 ZIP** 的完整解決方案。完成後，你將清楚知道如何 **將 HTML 匯出為 ZIP 檔案**，同時也會看到在不同情境下 **如何壓縮 HTML 檔案** 的變化方式。 + +> *專業小技巧：* 無論是打包單一頁面或整個網站資料夾，以下方法皆適用。 + +## 需要的環境 + +在開始之前，請確保你已具備： + +- .NET 6（或任何較新的 .NET 執行環境）已安裝。 +- 在專案中參考 Aspose.HTML for .NET NuGet 套件 (`Aspose.Html`)。 +- 一個放在您可控制資料夾中的簡易 `input.html` 檔案。 +- 具備一點 C# 基礎——不需要高階技巧，只要會基本語法即可。 + +就這樣。無需外部 zip 工具，亦不需要命令列操作。讓我們開始吧。 + +![使用 Aspose.HTML 將 HTML 儲存為 ZIP 的流程圖](save-html-as-zip.png) + +*圖片說明：使用 Aspose.HTML 將 HTML 儲存為 ZIP 的流程圖* + +## Step 1: Load the Source HTML Document + +我們首先要告訴 Aspose.HTML 原始檔案的位置。`HTMLDocument` 類別會讀取檔案並在記憶體中建立 DOM，準備進行渲染。 + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +為什麼這很重要：載入文件讓函式庫能完整控制資源解析（圖片、CSS、字型）。若 HTML 使用相對路徑，Aspose.HTML 會自動以檔案所在資料夾為基準解析。 + +## Step 2: (Optional) Create a Custom Resource Handler + +如果需要檢查或處理每個資源——例如在寫入壓縮檔前先壓縮圖片——可以插入 `ResourceHandler`。此步驟為選用，但它是以自訂邏輯 **將 HTML 轉換為 ZIP 壓縮檔** 最彈性的方式。 + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*如果你不需要任何特殊處理呢？* 只要略過此類別，使用預設的 handler——Aspose.HTML 會直接將資源寫入 ZIP。 + +## Step 3: Configure Save Options to Use the Handler + +`HtmlSaveOptions` 物件告訴渲染器如何處理資源。將我們的 `MyResourceHandler` 指定給它，即可完全掌控輸出。 + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +請注意 `ResourceHandler` 屬性名稱直接對應 **渲染 HTML 為 ZIP** 的功能。這裡就是魔法發生的地方：所有連結的資源都會串流進壓縮檔，而不是寫入磁碟。 + +## Step 4: Save the Rendered Document into a ZIP Archive + +現在我們終於 **將 HTML 匯出為 ZIP 檔案**。`Save` 方法接受任何 `Stream`，因此我們可以指向會產生 `result.zip` 的 `FileStream`。 + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +整個流程就這樣。程式執行完畢後，`result.zip` 內會包含： + +- `input.html`（原始標記） +- 所有被引用的圖片、CSS 檔案與字型 +- 若在 `MyResourceHandler` 中對資源進行了變更，則會包含這些已轉換的資源 + +## How to Zip HTML Files Without Aspose.HTML (Quick Alternative) + +有時你只需要一個老派的 **如何壓縮 HTML 檔案** 方法，可能是因為已在使用其他 HTML 解析器。這種情況下可以使用 .NET 內建的 `System.IO.Compression`： + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +此方法簡單卻缺少渲染步驟；它只會把磁碟上的檔案打包。如果你的 HTML 參照外部 URL，這些資源不會被納入。因此在需要可靠 **渲染 HTML 為 ZIP** 解決方案時，仍建議使用 Aspose.HTML。 + +## Edge Cases & Common Pitfalls + +| 情境 | 需要留意的地方 | 推薦的解決方式 | +|-----------|-------------------|-----------------| +| **大型圖片** | 記憶體使用量激增，因為每張圖片都會載入至 `MemoryStream`。 | 使用自訂的 ResourceHandler 直接串流至 ZIP，複製來源串流而非完整緩衝。 | +| **外部 URL** | 位於網路上的資源不會自動下載。 | 將 `HtmlLoadOptions` 的 `BaseUrl` 設為網站根目錄，或在儲存前自行下載資源。 | +| **檔名衝突** | 不同子資料夾中同名的兩個 CSS 檔案可能會互相覆寫。 | 確保 `ResourceHandler` 在寫入 ZIP 時保留完整的相對路徑。 | +| **權限錯誤** | 嘗試寫入唯讀資料夾會拋出 `UnauthorizedAccessException`。 | 以適當的權限執行程序，或選擇可寫入的輸出目錄。 | + +妥善處理上述情況，可讓你的 **將 HTML 轉換為 ZIP 壓縮檔** 流程在正式環境中更加穩健。 + +## Full Working Example (All Pieces Together) + +以下是完整、可直接執行的程式範例。將它貼到新的 Console 應用程式中，更新路徑後按 **F5** 執行。 + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**預期輸出：** 主控台會印出成功訊息，`result.zip` 檔案內包含 `input.html` 以及所有相依資源。打開 ZIP，雙擊 `input.html`，即可看到與瀏覽器中完全相同的頁面——不會缺少圖片，也不會有 CSS 斷裂。 + +## Recap – Why This Approach Rocks + +- **單步渲染**：您不必手動複製每個資源，Aspose.HTML 會自動處理。 +- **可自訂流程**：`ResourceHandler` 讓您完全掌控每個檔案的儲存方式，可實現壓縮、加密或即時轉換。 +- **跨平台**：只要有 .NET 執行環境，即可在 Windows、Linux 與 macOS 上運行。 +- **無需外部工具**：完整的 **將 HTML 儲存為 ZIP** 流程全部在您的 C# 程式碼中完成。 + +## What’s Next? + +既然你已掌握 **將 HTML 儲存為 ZIP**，不妨進一步探索以下相關主題： + +- **將 HTML 匯出為 PDF** – 適合列印報告（掌握 `export html to zip file` 的知識在需要兩種格式時很有幫助）。 +- **直接將 ZIP 串流至 HTTP 回應** – 適用於讓使用者即時下載打包網站的 Web API。 +- **加密 ZIP 壓縮檔** – 若處理機密文件，可加入密碼保護層。 + +隨意實驗：將 `MyResourceHandler` 換成能壓縮圖片的壓縮器，或加入列出所有打包資源的清單檔案。只要掌握渲染管線，想像空間無限。 + +--- + +*快樂寫程式！如果遇到任何問題或有改進想法，歡迎在下方留言，我們一起解決。* + +## Related Tutorials + +- [如何在 C# 中壓縮 HTML – 儲存 HTML 為 Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [將 HTML 儲存為 ZIP – 完整 C# 教程](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [在 C# 中將 HTML 儲存為 ZIP – 完整記憶體內範例](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hungarian/net/generate-jpg-and-png-images/_index.md b/html/hungarian/net/generate-jpg-and-png-images/_index.md index dc2c2b0ac..bd092877c 100644 --- a/html/hungarian/net/generate-jpg-and-png-images/_index.md +++ b/html/hungarian/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Tanulja meg az Aspose.HTML for .NET használatát HTML-dokumentumok kezeléséhe Ismerje meg, hogyan állíthatja be az antialiasingot a DOCX dokumentumok PNG vagy JPG képekké konvertálásakor az Aspose.HTML for .NET használatával. ### [docx konvertálása png-re – zip archívum létrehozása C# oktatóanyag](./convert-docx-to-png-create-zip-archive-c-tutorial/) Ismerje meg, hogyan konvertálhat docx fájlokat png képekké, majd csomagolhatja őket zip archívumba C#-ban az Aspose.HTML segítségével. +### [Kép szélesség és magasság beállítása Word PNG konvertálásakor – Teljes útmutató](./set-image-width-height-when-converting-word-to-png-full-guid/) +Ismerje meg, hogyan állíthatja a kép méretét Word dokumentum PNG-re konvertálásakor az Aspose.HTML for .NET segítségével. ## Következtetés diff --git a/html/hungarian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/hungarian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..dfa50c121 --- /dev/null +++ b/html/hungarian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,262 @@ +--- +category: general +date: 2026-05-22 +description: Állítsa be a kép szélességét és magasságát a Word dokumentum PNG‑re konvertálása + során. Tanulja meg, hogyan exportálja a docx‑et képként magas minőségű rendereléssel + egy lépésről‑lépésre útmutatóban. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: hu +og_description: Állítsa be a kép szélességét és magasságát a Word dokumentum PNG-re + konvertálása közben. Ez az útmutató bemutatja, hogyan exportálhatja a docx-et képként + magas minőségű beállításokkal. +og_title: Kép szélességének és magasságának beállítása Word PNG-re konvertálásakor + – Teljes útmutató +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Kép szélességének és magasságának beállítása Wordből PNG-re konvertáláskor + – Teljes útmutató +url: /hu/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Állítsa be a kép szélességét és magasságát a Word PNG‑re konvertálásakor – Teljes útmutató + +Gondolkodtál már azon, hogyan **állítsd be a kép szélességét és magasságát** miközben **Word‑t PNG‑re konvertálsz**? Nem vagy egyedül. Sok fejlesztő akad el, amikor az alapértelmezett export elmosódott képet vagy helytelen méreteket ad, és órákat tölt el egy valóban működő megoldás keresésével. + +Ebben az útmutatóban egy tiszta, vég‑a‑végig megoldáson keresztül vezetünk, amely megmutatja, **hogyan rendereljük a word** dokumentumokat PNG képekké, lehetővé téve, hogy **docx‑et PNG‑ként mentsünk** pontos szélesség‑magasság vezérléssel és magas minőségű antialiasinggal. A végére egy azonnal futtatható kódrészletet, a API lehetőségeinek alapos megértését és néhány profi tippet kapsz a gyakori hibák elkerüléséhez. + +## Mit fogsz megtanulni + +- Tölts be egy `.docx` fájlt az Aspose.Words for .NET használatával. +- **Set image width height** beállítása `ImageRenderingOptions` segítségével. +- **Export docx as image** (PNG) antialiasing engedélyezésével. +- Hogyan **convert word to png** egyetlen oldalra vagy a teljes dokumentumra. +- Tippek nagy dokumentumok kezeléséhez, DPI szempontok és fájlrendszer‑útvonalak. + +Nincs külső eszköz, nincs rendetlen parancssori akrobátika—csak tiszta C# kód, amelyet bármely .NET projektbe beilleszthetsz. + +## Előfeltételek + +Mielőtt belevágnánk, győződj meg róla, hogy a következőkkel rendelkezel: + +| Követelmény | Miért fontos | +|-------------|----------------| +| **.NET 6.0+** (vagy .NET Framework 4.7.2) | Az Aspose.Words mindkettőt támogatja, de az újabb futtatókörnyezetek jobb teljesítményt nyújtanak. | +| **Aspose.Words for .NET** NuGet csomag (`Install-Package Aspose.Words`) | Biztosítja a `Document` osztályt és a renderelő motorját. | +| Egy **Word dokumentum** (`.docx`), amelyet PNG‑vé szeretnél alakítani. | A forrás, amelyet konvertálni fogsz. | +| Alap C# ismeretek – megérted a `using` utasításokat és az objektum inicializálást. | A tanulási görbét enyhén tartja. | + +Ha hiányzik a NuGet csomag, futtasd ezt a Package Manager Console‑ban: + +```powershell +Install-Package Aspose.Words +``` + +Ennyi—miután a csomag telepítve van, készen állsz a kódolásra. + +## 1. lépés: A forrásdokumentum betöltése + +Az első dolog, amit tenned kell, hogy a könyvtárat a kívánt Word fájlra irányítsd, amelyet át szeretnél alakítani. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Miért fontos:** A `Document` osztály beolvassa a teljes Word csomagot a memóriába, így hozzáférést kapsz az oldalakhoz, stílusokhoz és minden máshoz. Ha az útvonal hibás, `FileNotFoundException`-t kapsz, ezért ellenőrizd, hogy a fájl létezik-e, és az útvonal escape‑elt backslash‑eket (`\\`) vagy verbatim stringet (`@`) használ. + +> **Pro tipp:** Tedd a betöltési hívást `try/catch` blokkba, ha azt várod, hogy a fájl hiányozhat futás közben. + +## 2. lépés: Kép renderelési beállítások konfigurálása (Set Image Width Height) + +Most jön a tutorial szíve: **hogyan állítsuk be a kép szélességét és magasságát**, hogy a kapott PNG ne legyen nyújtott vagy pixeles. Az `ImageRenderingOptions` osztály finomhangolt vezérlést biztosít a méretek, DPI és simítás felett. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**A kulcsfontosságú tulajdonságok magyarázata:** + +- `Width` és `Height` – Ezek a kívánt pontos pixelméretek. Beállításukkal közvetlenül **set image width height**-t állítasz, felülbírálva az alapértelmezett oldalméretet. +- `UseAntialiasing` – Engedélyezi a magas minőségű simítást a szöveg és vektorgrafikák számára, ami kulcsfontosságú, amikor **convert word to png** és éles éleket szeretnél. +- `Resolution` – Magasabb DPI több részletet ad, különösen összetett elrendezéseknél. Figyelj a memóriahasználatra; egy 300 DPI kép nagy lehet. + +> **Miért ne csak az alapértelmezett méretet használnád?** Az alapértelmezett az oldal fizikai méreteit használja (pl. A4 96 DPI‑n). Ez gyakran 794 × 1123 pixel képet eredményez – bizonyos esetekben megfelelő, de nem, ha egy konkrét UI bélyegképre vagy fix méretű előnézetre van szükség. + +## 3. lépés: Renderelés és mentés PNG‑ként (Export Docx as Image) + +Miután a dokumentum betöltődött és a beállítások konfigurálva vannak, végre **export docx as image**-t hajthatod végre. A `RenderToImage` metódus végzi a nehéz munkát. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Ha **a teljes dokumentumot** (összes oldalt) külön PNG fájlokba szeretnéd renderelni, iterálj a page collection‑ön: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Mi történik a háttérben?** A renderelő rasterizálja az egyes oldalakat a megadott méretekkel, alkalmaz antialiasingot, és PNG bájtfolyamot ír a lemezre. Mivel a PNG veszteségmentes, megmarad az eredeti Word elrendezés teljes hűsége. + +**Várható kimenet:** Egy éles PNG fájl pontosan 1024 × 768 pixel (vagy a beállított méret). Nyisd meg bármely képnézőben, és látni fogod a Word tartalmat pontosan úgy, ahogy az eredeti dokumentumban megjelenik, de most bitmap képként. + +## Haladó tippek és variációk + +### 1. Átlátszó háttér megőrzése + +Ha a Word dokumentumod átlátszó háttérrel rendelkező alakzatokat tartalmaz, és meg akarod tartani ezt az átlátszóságot, állítsd a `BackgroundColor`‑t `Color.Transparent`‑re: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Csak egy adott tartomány renderelése + +Néha csak egy bekezdésre vagy táblázatra van szükség, nem az egész oldalra. Használd a `DocumentVisitor`‑t a csomópont kinyeréséhez és külön rendereld. Ez egy fejlettebb eset, de megmutatja, **how to render word** tartalmat részletes szinten. + +### 3. DPI dinamikus beállítása + +Ha oldalanként különböző DPI‑ra van szükséged (pl. magas felbontás a címlaphoz), módosítsd a `Resolution`‑t a cikluson belül: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Kötetes feldolgozás + +Több tucat dokumentum konvertálásakor csomagold az egész folyamatot egy metódusba, és használd újra ugyanazt az `ImageRenderingOptions` példányt. Az opciók újrahasználata csökkenti a memóriakiosztási terhelést. + +## Gyakori hibák és elkerülésük módja + +| Tünet | Valószínű ok | Megoldás | +|-------|--------------|----------| +| A PNG elmosódott magas DPI ellenére | `UseAntialiasing` `false` maradt | Állítsd `UseAntialiasing = true`-ra. | +| A kimeneti méret nem egyezik a `Width`/`Height`-val | DPI nem lett figyelembe véve | Szorozd meg a kívánt méretet `Resolution / 96`-tal vagy állítsd be a `Resolution`-t. | +| Memóriahiány hiba nagy dokumentumoknál | A teljes dokumentum renderelése 300 DPI‑n | Renderelj egy oldalt egyszerre, és a mentés után szabadítsd fel a képet. | +| A PNG fehér háttérrel jelenik meg átlátszó képeknél | `BackgroundColor` nincs beállítva | Állítsd `imageOptions.BackgroundColor = Color.Transparent`-re. | + +## Teljes működő példa + +Az alábbi önálló programot beillesztheted egy konzolos alkalmazásba. Bemutatja a **convert word to png**, **save docx as png**, és természetesen a **set image width height** folyamatát. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Futtasd:** Építsd fel a projektet, helyezz egy érvényes `input.docx`‑t a megadott útvonalra, és indítsd el. Egy `output.png` fájlt kell látnod, amely pontosan **1024 × 768** pixel, sima élekkel renderelve. + +## Kapcsolódó útmutatók + +- [How to Enable Antialiasing When Converting DOCX to PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – create zip archive c# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [How to Use Aspose to Render HTML to PNG – Step‑by‑Step Guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hungarian/net/html-extensions-and-conversions/_index.md b/html/hungarian/net/html-extensions-and-conversions/_index.md index 53dd8b575..025b9a725 100644 --- a/html/hungarian/net/html-extensions-and-conversions/_index.md +++ b/html/hungarian/net/html-extensions-and-conversions/_index.md @@ -38,6 +38,10 @@ Az Aspose.HTML for .NET nem csak egy könyvtár; ez egy változás a webfejleszt ## HTML-kiterjesztések és -konverziók oktatóanyagok ### [Konvertálja a HTML-t PDF-be .NET-ben az Aspose.HTML-lel](./convert-html-to-pdf/) +### [Konvertálja a HTML-t PDF-be C#-ban – Teljes útmutató](./convert-html-to-pdf-with-c-complete-guide/) +Lépésről‑lépésre útmutató a HTML PDF‑be konvertálásához C#‑ban az Aspose.HTML for .NET segítségével. +### [HTML renderelése PDF-be C#‑ban – Teljes lépésről‑lépésre útmutató](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Részletes útmutató a HTML PDF‑be konvertálásához C#‑ban az Aspose.HTML for .NET használatával. ### [Az Aspose.HTML segítségével EPUB-t konvertáljon képpé .NET-ben](./convert-epub-to-image/) ### [Konvertálja az EPUB-t PDF-be .NET-ben az Aspose.HTML segítségével](./convert-epub-to-pdf/) ### [Konvertálja az EPUB-t XPS-re .NET-ben az Aspose.HTML segítségével](./convert-epub-to-xps/) @@ -59,7 +63,8 @@ Hozzon létre HTML-dokumentumot formázott szöveggel, majd exportálja PDF-be a Ismerje meg, hogyan hozhat létre PDF-et HTML-ből C#‑ban az Aspose.HTML for .NET segítségével, részletes lépésről‑lépésre útmutatóval. ### [HTML mentése ZIP-ként – Teljes C# oktatóanyag](./save-html-as-zip-complete-c-tutorial/) ### [HTML mentése ZIP-be C#‑ban – Teljes memória‑beli példa](./save-html-to-zip-in-c-complete-in-memory-example/) -Mentse a HTML-t közvetlenül memóriában ZIP-archívumba az Aspose.HTML for .NET C#‑ban. +### [HTML mentése ZIP-be – Teljes útmutató az Aspose.HTML-hez](./save-html-as-zip-complete-guide-for-aspose-html/) +Ismerje meg, hogyan mentheti el a HTML-t ZIP-archívumba az Aspose.HTML for .NET segítségével, lépésről‑lépésre útmutatóval. ## Következtetés diff --git a/html/hungarian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/hungarian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..0bb7a2d3e --- /dev/null +++ b/html/hungarian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,261 @@ +--- +category: general +date: 2026-05-22 +description: HTML konvertálása PDF-re C#‑ban az Aspose.HTML használatával. Tanulja + meg, hogyan renderelhet HTML‑t PDF‑re C#‑ban lépésről‑lépésre kóddal, beállításokkal + és Linux‑tippel. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: hu +og_description: HTML konvertálása PDF-be C#-ban az Aspose.HTML segítségével. Ez az + útmutató bemutatja, hogyan lehet HTML-t PDF-be renderelni C#-ban, egyértelmű beállítások + és Linux‑barát tippek használatával. +og_title: HTML konvertálása PDF-be C#-vel – Teljes útmutató +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: HTML konvertálása PDF-be C#-vel – Teljes útmutató +url: /hu/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML konvertálása PDF‑be C#‑vel – Teljes útmutató + +Ha gyorsan **HTML‑t PDF‑be kell konvertálni**, az Aspose.HTML for .NET ezt egyszerűvé teszi. Ebben az útmutatóban megválaszoljuk azt is, hogy **hogyan lehet HTML‑t PDF‑be renderelni C#‑ban**, teljes kontrollal a renderelési beállítások felett, így nem maradsz tanácstalan. + +Képzeld el, hogy van egy marketing e‑mail sablonod, egy nyugtaoldalad, vagy egy összetett jelentésed, amely modern CSS‑t használ, és PDF‑ként kell átadnod egy ügyfélnek vagy nyomtatónak. Ennek manuális elvégzése fáradságos, de néhány C# sorral automatizálhatod az egész folyamatot. A végére egy önálló, termelésre kész megoldást kapsz, amely Windows **és** Linux rendszereken egyaránt működik. + +## Amire szükséged lesz + +Mielőtt belevágnánk, győződj meg róla, hogy a következőkkel rendelkezel: + +- **.NET 6.0 vagy újabb** – az Aspose.HTML a .NET Standard 2.0+‑ra céloz, így bármely friss SDK megfelelő. +- **Aspose.HTML for .NET** NuGet csomag (`Aspose.Html`) – a termeléshez érvényes licenc szükséges, de a ingyenes próba verzió tesztelésre elegendő. +- Egy **egyszerű HTML fájl**, amelyet PDF‑vé szeretnél alakítani (nevezzük `input.html`‑nek). +- Kedvenc IDE‑d (Visual Studio, Rider vagy VS Code) – különleges eszközök nem szükségesek. + +Ennyi. Nincs külső PDF konverter, nincs parancssori akrobátika. Csak tiszta C#. + +![Diagram illustrating the convert html to pdf workflow using Aspose.HTML](/images/convert-html-to-pdf-workflow.png "HTML‑t PDF‑be konvertáló munkafolyamat") + +## HTML konvertálása PDF‑be – Teljes megvalósítás + +Az alábbiakban a teljes, azonnal futtatható programot találod. Másold be egy új konzolos alkalmazásba, állítsd vissza a NuGet csomagokat, és nyomd meg az **F5**‑öt. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Miért működik ez + +- **`Document`** az Aspose.HTML belépési pontja; beolvassa a HTML‑t, feloldja a CSS‑t, és egy renderelésre kész DOM‑ot épít. +- **`PdfRenderingOptions`** lehetővé teszi a kimenet finomhangolását. A `UseHinting` jelző a titkos összetevő a tiszta szöveghez a fej nélküli Linux konténerekben, ahol az alapértelmezett rasterizáló elmosódott lehet. +- **`Save`** végzi a nehéz munkát: rasterizálja a DOM‑ot PDF oldalakon, tiszteletben tartja az oldaltöréseket, és automatikusan beágyazza a betűtípusokat. + +A program futtatása `output.pdf`‑t hoz létre a forrásfájlod mellé. Nyisd meg bármely PDF‑olvasóval, és egy hű vizuális másolatot kell látnod az eredeti HTML‑ről. + +## Hogyan renderelj HTML‑t PDF‑be C#‑ban – Lépésről‑lépésre + +Az alábbiakban a folyamatot kisebb egységekre bontjuk, elmagyarázva, **hogyan renderelj HTML‑t PDF‑be C#‑ban**, miközben a gyakori buktatókat is érintjük. + +### 1. lépés – Telepítsd az Aspose.HTML NuGet csomagot + +Nyisd meg a terminált a projekt mappájában, és futtasd: + +```bash +dotnet add package Aspose.Html +``` + +Ha a Visual Studio felületét részesíted előnyben, jobb‑klikk a projektre → **Manage NuGet Packages** → keresd meg a **Aspose.Html**‑t, és telepítsd a legújabb stabil verziót. + +> **Pro tipp:** A telepítés után helyezz el egy licencfájlt (`Aspose.Total.lic`) a projekt gyökerében, hogy elkerüld a kiértékelési vízjelek megjelenését. + +### 2. lépés – Töltsd be helyesen a HTML‑t + +Az Aspose.HTML a következő forrásokból képes beolvasni: + +- Helyi fájlútvonalak (`new Document("file.html")`) +- URL‑ek (`new Document("https://example.com")`) +- Nyers HTML stringek (`new Document("…", new HtmlLoadOptions())`) + +Fájlrendszerről történő betöltéskor ügyelj arra, hogy az útvonal abszolút legyen, vagy a munkakönyvtár megfelelően legyen beállítva, különben `FileNotFoundException` hibát kapsz. Linuxon használj előre‑döntött perjeleket (`/`) vagy a `Path.Combine`‑t. + +### 3. lépés – Válaszd ki a megfelelő renderelési beállításokat + +A `UseHinting` mellett érdemes lehet a következőket módosítani: + +| Beállítás | Mit csinál | Mikor érdemes használni | +|-----------|------------|------------------------| +| `PageSize` | A PDF oldal méretét állítja be (A4, Letter, egyedi) | Ha a célpapír méretéhez kell igazítani | +| `Landscape` | Az oldalt fekvő tájolásúra forgatja | Széles táblázatok vagy diagramok esetén | +| `RasterizeVectorGraphics` | A vektoros grafikákat raszteres képekké kényszeríti | Ha a PDF‑fogyasztó nem tudja kezelni az SVG‑t | +| `CompressionLevel` | Képtömörítést szabályoz (0‑9) | Fájlméret csökkentése e‑mail mellékletekhez | + +Ezeket a tulajdonságokat folyékonyan láncolhatod: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### 4. lépés – Mentsd el a PDF‑et + +A teljes példában látható `Save` metódus túlterhelése közvetlenül fájlútra ír. PDF‑t stream‑ként is kiírhatod a memóriába: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Ez akkor hasznos, ha a PDF‑et egy web API‑ból szeretnéd letöltésként visszaadni. + +### 5. lépés – Ellenőrizd a kimenetet + +Egy gyors ellenőrzésként hasonlítsd össze a PDF oldalainak számát a várt HTML szekciók számával. Visszaolvashatod a PDF‑et az Aspose.PDF‑vel: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Ha a szám nem egyezik, nézd át a CSS `page-break` szabályokat, vagy állítsd be a `PdfRenderingOptions`‑t ennek megfelelően. + +## Szélsőséges esetek és gyakori buktatók + +| Helyzet | Mire figyelj | Megoldás | +|---------|--------------|----------| +| **Külső erőforrások (képek, betűtípusok) hiányoznak** | A relatív URL‑k a HTML fájl mappájához képest kerülnek feloldásra. | Használd a `HtmlLoadOptions.BaseUri`‑t, hogy a megfelelő gyökérre mutass. | +| **Linux fej nélküli környezet** | Az alapértelmezett szövegmegjelenítés elmosódott lehet. | Állítsd `UseHinting = true`‑ra (ahogy a példában látható), és telepítsd a `libgdiplus`‑t, ha a System.Drawing‑ra támaszkodsz. | +| **Nagy HTML (> 10 MB)** | A renderelés során a memóriahasználat megugrik. | Oldal‑szerinti renderelés `PdfRenderer`‑rel és `PdfRenderingOptions`‑sal, minden oldal mentése után pedig a felszabadítás. | +| **JavaScript‑intenzív oldalak** | Az Aspose.HTML nem hajtja végre a JS‑t; a dinamikus tartalom statikus marad. | Előfeldolgozás szerveroldalon (pl. Puppeteer) a Aspose.HTML‑nek való átadás előtt. | +| **Unicode karakterek négyzetként jelennek meg** | Hiányzó betűtípusok a futtatókörnyezetben. | Egyedi betűtípusok beágyazása `FontSettings`‑en keresztül, vagy a szükséges betűtípusok telepítése az operációs rendszerre. | + +## Teljesen működő példa összefoglaló + +Az egész program újra, kommentek nélkül, azok számára, akik a lényegre vágynak: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Futtasd, nyisd meg az `output.pdf`‑t, és egy pixel‑pontos másolatot látsz majd a `input.html`‑ről. Ez a **HTML‑t PDF‑be konvertálás** lényege az Aspose.HTML‑el. + +## Összegzés + +Áttekintettük mindent, ami ahhoz kell, hogy **HTML‑t PDF‑be konvertálj** C#‑ban: az Aspose.HTML telepítése, a HTML betöltése, a renderelési beállítások finomhangolása (beleértve a kulcsfontosságú `UseHinting` jelzőt), és a végső PDF mentése. Most már tudod, **hogyan renderelj HTML‑t PDF‑be C#‑ban** Windows és Linux környezetben egyaránt, és megismerted a gyakori szélsőséges esetek kezelését, mint a hiányzó erőforrások vagy a nagy fájlok. + +Mi a következő? Próbáld ki: + +- **Fejléc/lábléc** hozzáadása `PdfPageTemplate`‑el a márkázáshoz. +- **Jelszóvédelem** `PdfSaveOptions`‑szal. +- **Kötegelt konvertálás** egy mappában lévő fájlok ciklusával. + +## Kapcsolódó oktatóanyagok + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Convert EPUB to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Convert SVG to PDF in .NET with Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hungarian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/hungarian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..bb987b1c5 --- /dev/null +++ b/html/hungarian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,309 @@ +--- +category: general +date: 2026-05-22 +description: HTML PDF-ként történő renderelése C#-ban egy tömör példával. Tanulja + meg, hogyan konvertálhatja gyorsan és megbízhatóan a HTML-t PDF-re C#-ban. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: hu +og_description: HTML renderelése PDF‑ként C#‑ban egy világos, futtatható példával. + Ez az útmutató megmutatja, hogyan konvertálhatod a HTML‑t PDF‑re C#‑ban, és hogyan + generálhatsz PDF‑et HTML‑fájlból. +og_title: HTML PDF-ként renderelése C#-ban – Teljes programozási útmutató +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: HTML PDF‑ként renderelése C#‑ban – Teljes lépésről‑lépésre útmutató +url: /hu/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML PDF‑ként renderelése C#‑ban – Teljes lépésről‑lépésre útmutató + +Valaha szükséged volt **HTML PDF‑ként renderelésére**, de nem tudtad, melyik könyvtárat válaszd egy .NET projekthez? Nem vagy egyedül. Sok üzleti alkalmazásban előfordul, hogy **HTML‑t PDF‑re konvertálni C#‑ban** kell számlákhoz, jelentésekhez vagy marketing anyagokhoz – lényegében bármikor, amikor egy weboldal nyomtatható változatát szeretnéd. + +A lényeg: nem kell újra feltalálni a kereket. Néhány kódsorral be tudod olvasni az `input.html` fájlt, átadni egy bevált renderelő motornak, és egy tiszta `output.pdf`-et kapsz. Ebben az útmutatóban végigvezetünk a teljes folyamaton, a megfelelő NuGet csomag hozzáadásától az olyan széljegyek kezeléséig, mint a külső CSS. A végére képes leszel **PDF‑t generálni HTML fájlból** percek alatt. + +## Mit fogsz megtanulni + +- Hogyan állítsunk be egy .NET konzolos alkalmazást, amely **PDF‑t hoz létre HTML‑ből C#‑ban**. +- A pontos API hívások, amelyekkel **HTML dokumentumot menthetsz PDF‑ként**. +- Miért fontosak bizonyos renderelési beállítások (például hinting) a szöveg minősége szempontjából. +- Tippek a gyakori hibák, például hiányzó betűkészletek vagy relatív képek útvonalainak hibaelhárításához. + +**Előfeltételek** – telepítve kell legyen .NET 6+ vagy .NET Framework 4.7, alapvető C# ismeretekkel és egy IDE‑vel (Visual Studio 2022, Rider vagy VS Code). Előzetes PDF tapasztalat nem szükséges. + +--- + +## HTML PDF‑ként renderelése – A projekt beállítása + +Mielőtt a kódba merülnénk, győződjünk meg róla, hogy a fejlesztői környezet készen áll. A használandó könyvtár a **Select.Pdf** (nem kereskedelmi felhasználásra ingyenes), mivel egyszerű API‑t és stabil renderelési pontosságot kínál. + +### A PDF renderelő könyvtár telepítése (convert html to pdf c#) + +Nyiss egy terminált a projekt mappádban, és futtasd: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tipp:* Ha Visual Studio‑t használsz, a csomagot a NuGet Package Manager UI‑n keresztül is hozzáadhatod. A verziószám lehet újabb – csak vedd a legújabb stabil kiadást. + +### Konzolos váz létrehozása + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Ez minden szükséges sablonkód. A nehéz munka a `Main` metódusban történik. + +--- + +## HTML dokumentum betöltése (generate pdf from html file) + +Az első tényleges lépés, hogy a renderelőt egy lemezen lévő HTML fájlra irányítsuk. A Select.Pdf két kényelmes módot kínál: nyers HTML szöveg átadása vagy egy fájl útvonal. A fájl használata rendezettséget biztosít, különösen, ha kapcsolt CSS‑t vagy képeket tartalmaz. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Itt ellenőrizzük a hiányzó fájlt is – ez gyakran akadályozza a kezdőket, amikor elfelejtik az HTML‑t az output mappába másolni. + +--- + +## Renderelési beállítások konfigurálása (create pdf from html c#) + +A Select.Pdf egy gazdag `PdfDocumentOptions` objektummal érkezik. A tiszta szöveg érdekében engedélyezzük a hintinget, amely a glifek simítását végzi egy apró teljesítménycsökkenés árán. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Itt módosíthatod az oldal méretét, margókat, vagy akár egy egyedi betűtípust is beágyazhatsz. A fő tanulság, hogy a **render html as pdf** nem csak egyetlen soros megoldás; te irányítod a végdokumentum megjelenését és érzetét. + +--- + +## HTML dokumentum mentése PDF‑ként (render html as pdf) + +Most jön a varázslat. Átadjuk a konvertálónak a HTML fájl útvonalát, és megkérjük, hogy PDF‑et írjon a lemezre. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +A `ConvertUrl` metódus automatikusan feloldja a relatív URL‑eket (képek, CSS) a HTML fájl helye alapján, ezért ez a megközelítés a legtöbb valós helyzetben megbízható. + +### Várt kimenet + +A program futtatása után a ugyanabban a mappában egy `output.pdf` fájlt kell látnod. Nyisd meg – észre fogod venni, hogy: + +- A szöveg tiszta anti‑aliasinggal renderelődik (köszönhetően a hintingnek). +- A kapcsolt CSS‑ből származó stílusok helyesen alkalmazva. +- A képek a forrás HTML‑ben meghatározott pontos méretben jelennek meg. + +Ha valami nem stimmel, ellenőrizd, hogy a CSS és képfájlok a `input.html` mellett vannak-e elhelyezve, vagy használj abszolút URL‑eket. + +--- + +## Gyakori széljegyek kezelése + +### 1. Külső erőforrások tűzfal által blokkolva + +Ha a HTML egy CDN‑en tárolt betűtípusra hivatkozik, amelyet a szervered nem ér el, a PDF egy általános betűtípust használhat. Ennek elkerülése érdekében töltsd le a betűtípus fájlokat helyileg, vagy ágyazd be őket `@font-face`‑el relatív útvonallal. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Nagyon nagy HTML fájlok + +Masszív dokumentumok konvertálása során memóriahatárokba ütközhetsz. A Select.Pdf lehetővé teszi a konverzió streamelését: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +A streamelés könnyűsúlyúvá teszi a folyamatot, de megköveteli, hogy a HTML‑t karakterláncként add meg, amelyet szükség esetén darabokban olvashatsz be. + +### 3. Egyedi fejléc vagy lábléc + +Ha minden oldalra oldalszámot vagy vállalati logót szeretnél, állítsd be a `Header` és `Footer` tulajdonságokat a `converter.Options`‑on, mielőtt meghívod a `ConvertUrl`‑t. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Teljes működő példa (minden lépés egyben) + +Az alábbiakban a teljes, másolás‑beillesztésre kész program látható. Cseréld le a `YOUR_DIRECTORY`‑t arra az abszolút útvonalra, ahol a HTML fájlod található. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Futtasd:** `dotnet run` a projekt könyvtárából. Ha minden helyesen van beállítva, láthatod a sikerüzenetet és egy csillogó `output.pdf`‑et. + +--- + +## Vizuális összefoglaló + +![HTML PDF‑ként renderelése példa](render-html-as-pdf.png){alt="render html as pdf példa"} + +A képernyőkép a konzol kimenetet és a megjelenítőben nyitott PDF‑et mutatja. Figyeld meg a tiszta címsorokat és a helyesen betöltött képeket – pontosan azt, amit a **render html as pdf** esetén vársz. + +--- + +## Következtetés + +Most megtanultad, hogyan **render HTML as PDF** egy C# alkalmazásban, a könyvtár telepítésétől a renderelési beállítások finomhangolásáig. A teljes példa egy megbízható módot mutat be a **convert HTML to PDF C#**, **generate PDF from HTML file**, és **save HTML document as PDF** végrehajtására néhány sor kóddal. + +Mi a következő? Kísérletezz a következőkkel: + +- Egyedi betűtípusok hozzáadása a márka konzisztenciájához. +- PDF‑k generálása dinamikus HTML szövegekből (pl. Razor sablonok). +- Több PDF egyesítése egy jelentésbe a `PdfDocument.AddPage` használatával. + +Ezek a kiegészítések az itt bemutatott alapfogalmakra épülnek, így készen állsz a bonyolultabb szcenáriók kezelésére anélkül, hogy meredek tanulási görbét kellene leküzdened. + +Van kérdésed vagy elakadtál? Írj egy megjegyzést alább, és közösen megoldjuk a problémát. Boldog kódolást! + +## Kapcsolódó oktatóanyagok + +- [HTML PDF‑re konvertálása .NET‑ben az Aspose.HTML‑el](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [HTML dokumentum létrehozása formázott szöveggel és exportálása PDF‑be – Teljes útmutató](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [HTML PDF‑re konvertálása az Aspose.HTML‑el – Teljes manipulációs útmutató](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/hungarian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/hungarian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..b545b746b --- /dev/null +++ b/html/hungarian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,230 @@ +--- +category: general +date: 2026-05-22 +description: Mentse el a HTML-t gyorsan ZIP-ként az Aspose.HTML segítségével. Tanulja + meg, hogyan lehet HTML-fájlokat ZIP-be csomagolni, HTML-t ZIP-be renderelni, és + HTML-t ZIP-fájlba exportálni teljes kóddal. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: hu +og_description: HTML mentése ZIP-ként az Aspose.HTML segítségével. Ez az útmutató + bemutatja, hogyan lehet HTML-t ZIP-be renderelni, HTML-t ZIP-fájlba exportálni, + és programozottan ZIP-olni a HTML-fájlokat. +og_title: HTML mentése ZIP-fájlba – Teljes Aspose.HTML útmutató +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: HTML mentése ZIP-be – Teljes útmutató az Aspose.HTML-hez +url: /hu/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML mentése ZIP‑ként – Teljes útmutató az Aspose.HTML‑hez + +Gondolkodtál már azon, hogyan **mentheted el a HTML‑t ZIP‑ként** anélkül, hogy külön archiváló eszközt kellene használnod? Nem vagy egyedül. Sok fejlesztőnek kell egy HTML‑oldalt a képekkel, CSS‑szel és szkriptekkel együtt csomagolni a könnyű terjesztés érdekében, és a manuális megoldás gyorsan fájdalmas ponttá válik. + +Ebben az útmutatóban egy tiszta, vég‑től‑végig megoldást mutatunk be, amely **HTML‑t ZIP‑be renderel** az Aspose.HTML for .NET segítségével. A végére pontosan tudni fogod, hogyan **exportálj HTML‑t ZIP‑fájlba**, és különböző **HTML fájlok zip‑elésének** változatait is megismerheted különböző szituációkban. + +> *Pro tipp:* A bemutatott megközelítés akkor is működik, ha egyetlen oldalt vagy egy teljes webhely mappát csomagolsz. + +## Amire szükséged lesz + +Mielőtt belemerülnénk, győződj meg róla, hogy a következők rendelkezésre állnak: + +- .NET 6 (vagy bármely friss .NET runtime) telepítve. +- Az Aspose.HTML for .NET NuGet csomag (`Aspose.Html`) hivatkozva a projektedben. +- Egy egyszerű `input.html` fájl egy általad irányított mappában. +- Egy kis C# ismeret – semmi bonyolult, csak az alapok. + +Ennyi. Nincs szükség külső zip‑eszközre, nincs parancssori akrobátika. Kezdjünk bele. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*Kép alt szöveg: HTML ZIP‑ként mentés folyamatának diagramja* + +## 1. lépés: A forrás HTML dokumentum betöltése + +Az első dolog, amit tennünk kell, hogy megmondjuk az Aspose.HTML‑nek, hol található a forrás. A `HTMLDocument` osztály beolvassa a fájlt és egy memóriában lévő DOM‑ot épít fel, amely készen áll a renderelésre. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Miért fontos: a dokumentum betöltése lehetővé teszi a könyvtár számára, hogy teljes kontrollt gyakoroljon az erőforrás‑feloldás felett (képek, CSS, betűkészletek). Ha a HTML relatív útvonalakat hivatkozik, az Aspose.HTML automatikusan a fájl mappájához relatívan oldja fel őket. + +## 2. lépés: (Opcionális) Egyedi erőforrás‑kezelő létrehozása + +Ha minden egyes erőforrást meg szeretnél vizsgálni vagy módosítani – például képeket szeretnél tömöríteni, mielőtt a archívumba kerülnek – akkor csatlakoztathatsz egy `ResourceHandler`‑t. Ez a lépés opcionális, de a legflexibilisebb módja annak, hogy **HTML‑t ZIP‑archívummá konvertálj** egyedi logikával. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Mi van, ha nincs szükséged különleges feldolgozásra?* Egyszerűen hagyd ki ezt az osztályt, és használd az alapértelmezett kezelőt – az Aspose.HTML közvetlenül a ZIP‑be írja az erőforrásokat. + +## 3. lépés: Mentési beállítások konfigurálása a kezelő használatához + +A `HtmlSaveOptions` objektum megmondja a renderelőnek, mit tegyen az erőforrásokkal. A `MyResourceHandler` hozzárendelésével teljes kontrollt nyerünk a kimenet felett. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Vedd észre, hogy a `ResourceHandler` tulajdonság neve közvetlenül a **render HTML to ZIP** képességre hivatkozik. Itt történik a varázslat: minden hivatkozott erőforrás az archívumba kerül stream‑ként, ahelyett, hogy lemezre íródna. + +## 4. lépés: A renderelt dokumentum mentése ZIP‑archívumba + +Most végre **exportáljuk a HTML‑t ZIP‑fájlba**. A `Save` metódus bármilyen `Stream`‑et elfogad, így rámutathatunk egy `FileStream`‑re, amely létrehozza a `result.zip`‑ot. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Ez a teljes munkafolyamat. Amikor a kód befejeződik, a `result.zip` tartalmazza: + +- `input.html` (az eredeti markup) +- Az összes hivatkozott kép, CSS‑fájl és betűkészlet +- Az esetleg módosított erőforrások, ha a `MyResourceHandler`‑ben átalakítottad őket + +## HTML fájlok zip‑elése Aspose.HTML nélkül (Gyors alternatíva) + +Néha egyszerűen csak egy hagyományos **HTML fájlok zip‑elése** megoldásra van szükség, például mert már egy másik HTML‑parsert használsz. Ebben az esetben a .NET beépített `System.IO.Compression`‑t veheted igénybe: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Ez a módszer egyszerű, de nem tartalmaz renderelési lépést; csak azt csomagolja, ami a lemezen van. Ha a HTML külső URL‑eket hivatkozik, azok az erőforrások nem kerülnek bele. Ezért az Aspose.HTML útvonal a megbízható **render HTML to ZIP** megoldás, ha teljes körű csomagolásra van szükség. + +## Szélsőséges esetek és gyakori buktatók + +| Szituáció | Mire figyelj | Javasolt megoldás | +|-----------|--------------|-------------------| +| **Nagy képek** | Memóriahasználat ugrásszerűen nő, mert minden kép egy `MemoryStream`‑be töltődik. | Közvetlenül stream‑eld a zip‑be egy egyedi kezelővel, amely a forrás‑streamet másolja, ahelyett, hogy teljesen bufferelne. | +| **Külső URL‑ek** | Az interneten tárolt erőforrások nem töltődnek le automatikusan. | Állítsd be a `HtmlLoadOptions`‑t a `BaseUrl`‑lel, amely a webhely gyökerére mutat, vagy töltsd le manuálisan az erőforrásokat a mentés előtt. | +| **Fájlnevek ütközése** | Két CSS‑fájl ugyanazzal a névvel különböző almappákban felülírhatja egymást. | Biztosítsd, hogy a `ResourceHandler` megőrizze a teljes relatív útvonalat a zip‑be íráskor. | +| **Jogosultsági hibák** | Írás egy csak‑olvasható mappába `UnauthorizedAccessException`‑t eredményez. | Futtasd a folyamatot megfelelő jogosultságokkal, vagy válassz egy írható kimeneti könyvtárat. | + +Ezeknek a szituációknak a kezelése robusztus **convert HTML to ZIP archive** rutinod lesz a termelésben. + +## Teljes működő példa (Minden rész együtt) + +Az alábbi kódrészlet egy komplett, azonnal futtatható program. Másold be egy új konzolos alkalmazásba, frissítsd az útvonalakat, és nyomd meg az **F5**‑öt. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Várható kimenet:** A konzol egy sikerüzenetet ír ki, a `result.zip` fájl pedig tartalmazza az `input.html`‑t és minden függőben lévő eszközt. Nyisd meg a ZIP‑et, duplán kattints az `input.html`‑re, és a böngészőben pontosan úgy fog megjelenni, mint korábban – hiányzó képek, törött CSS nélkül. + +## Összefoglalás – Miért nagyszerű ez a megközelítés + +- **Egylépéses renderelés:** Nem kell kézzel másolni minden erőforrást; az Aspose.HTML megteszi helyetted. +- **Testreszabható pipeline:** A `ResourceHandler` teljes kontrollt ad arról, hogyan tárolódik minden fájl, lehetővé téve tömörítést, titkosítást vagy helyben történő átalakítást. +- **Keresztplatformos:** Windows, Linux és macOS rendszereken működik, amíg van .NET runtime. +- **Külső eszközök nélkül:** A teljes **save HTML as ZIP** folyamat a C# kódbázisodban zajlik. + +## Mi a következő lépés? + +Miután elsajátítottad a **save HTML as ZIP** technikát, érdemes ezeket a kapcsolódó témákat is felfedezni: + +- **HTML exportálása PDF‑be** – tökéletes nyomtatható jelentésekhez (az `export html to zip file` tudás segít, ha mindkét formátumra szükséged van). +- **ZIP közvetlen stream‑elése HTTP‑válaszba** – nagyszerű web‑API‑k számára, amelyek lehetővé teszik a felhasználók számára, hogy egy csomagolt oldalt töltsenek le „on‑the‑fly”. +- **ZIP archívumok titkosítása** – adj hozzá jelszót, ha bizalmas dokumentumokról van szó. + +Nyugodtan kísérletezz: cseréld le a `MyResourceHandler`‑t egy képtömörítőre, vagy adj hozzá egy manifest fájlt, amely felsorolja az összes csomagolt erőforrást. A lehetőségek határtalanok, ha te irányítod a renderelési pipeline‑t. + +--- + +*Boldog kódolást! Ha elakadsz vagy van ötleted a fejlesztésre, írj egy megjegyzést alul. Közösen megoldjuk.* + + +## Kapcsolódó oktatóanyagok + +- [How to Zip HTML in C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Save HTML as ZIP – Complete C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Save HTML to ZIP in C# – Complete In‑Memory Example](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/indonesian/net/generate-jpg-and-png-images/_index.md b/html/indonesian/net/generate-jpg-and-png-images/_index.md index 4e885ce32..85ff9961d 100644 --- a/html/indonesian/net/generate-jpg-and-png-images/_index.md +++ b/html/indonesian/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Pelajari cara menggunakan Aspose.HTML untuk .NET guna memanipulasi dokumen HTML, Pelajari cara mengaktifkan antialiasing untuk meningkatkan kualitas gambar PNG atau JPG saat mengonversi dokumen DOCX menggunakan Aspose.HTML. ### [Konversi DOCX ke PNG – Membuat Arsip ZIP dengan C# Tutorial](./convert-docx-to-png-create-zip-archive-c-tutorial/) Pelajari cara mengonversi file DOCX menjadi PNG dan mengemasnya ke dalam arsip ZIP menggunakan C# dengan Aspose.HTML. +### [Atur Lebar dan Tinggi Gambar Saat Mengonversi Word ke PNG – Panduan Lengkap](./set-image-width-height-when-converting-word-to-png-full-guid/) +Pelajari cara mengatur lebar dan tinggi gambar secara tepat saat mengonversi dokumen Word ke format PNG menggunakan Aspose.HTML. ## Kesimpulan diff --git a/html/indonesian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/indonesian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..532180847 --- /dev/null +++ b/html/indonesian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,260 @@ +--- +category: general +date: 2026-05-22 +description: Atur lebar dan tinggi gambar saat mengonversi dokumen Word ke PNG. Pelajari + cara mengekspor docx sebagai gambar dengan rendering berkualitas tinggi dalam tutorial + langkah demi langkah. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: id +og_description: Atur lebar dan tinggi gambar saat mengonversi dokumen Word ke PNG. + Tutorial ini menunjukkan cara mengekspor docx sebagai gambar dengan pengaturan kualitas + tinggi. +og_title: Atur Lebar Tinggi Gambar Saat Mengonversi Word ke PNG – Panduan Lengkap +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Atur Lebar dan Tinggi Gambar Saat Mengonversi Word ke PNG – Panduan Lengkap +url: /id/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Atur Lebar Tinggi Gambar Saat Mengonversi Word ke PNG – Panduan Lengkap + +Pernah bertanya‑tanya bagaimana cara **set image width height** saat Anda **convert Word to PNG**? Anda bukan satu‑satunya. Banyak pengembang mengalami kebuntuan ketika ekspor default menghasilkan gambar yang buram atau dimensi yang salah, dan kemudian mereka menghabiskan berjam‑jam mencari solusi yang benar‑benar bekerja. + +Dalam tutorial ini kami akan membahas solusi bersih, end‑to‑end yang menunjukkan **how to render word** dokumen sebagai gambar PNG, memungkinkan Anda **save docx as PNG** dengan kontrol lebar‑tinggi yang tepat dan antialiasing berkualitas tinggi. Pada akhir tutorial Anda akan memiliki cuplikan kode siap‑jalankan, pemahaman yang kuat tentang opsi API, dan beberapa tips profesional untuk menghindari jebakan umum. + +## Apa yang Akan Anda Pelajari + +- Muat file `.docx` menggunakan Aspose.Words for .NET. +- **Set image width height** dengan `ImageRenderingOptions`. +- **Export docx as image** (PNG) dengan antialiasing diaktifkan. +- Cara **convert word to png** untuk satu halaman atau seluruh dokumen. +- Tips untuk menangani dokumen besar, pertimbangan DPI, dan jalur sistem‑file. + +Tanpa alat eksternal, tanpa kerumitan baris perintah—hanya kode C# murni yang dapat Anda sisipkan ke dalam proyek .NET apa pun. + +## Prerequisites + +Sebelum kita mulai, pastikan Anda memiliki hal‑hal berikut: + +| Persyaratan | Mengapa penting | +|-------------|-----------------| +| **.NET 6.0+** (atau .NET Framework 4.7.2) | Aspose.Words mendukung keduanya, tetapi runtime yang lebih baru memberikan kinerja yang lebih baik. | +| **Aspose.Words for .NET** paket NuGet (`Install-Package Aspose.Words`) | Menyediakan kelas `Document` dan mesin rendering. | +| Sebuah **Word document** (`.docx`) yang ingin Anda ubah menjadi PNG. | Sumber yang akan Anda konversi. | +| Pengetahuan dasar C# – Anda akan memahami pernyataan `using` dan inisialisasi objek. | Menjaga kurva pembelajaran tetap ringan. | + +Jika Anda belum memiliki paket NuGet, jalankan perintah berikut di Package Manager Console: + +```powershell +Install-Package Aspose.Words +``` + +Itu saja—setelah paket terpasang, Anda siap mulai menulis kode. + +## Step 1: Load the Source Document + +Hal pertama yang perlu Anda lakukan adalah menunjuk perpustakaan ke file Word yang ingin Anda transformasi. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Mengapa ini penting:** Kelas `Document` membaca seluruh paket Word ke memori, memberi Anda akses ke halaman, gaya, dan semua hal lainnya. Jika jalur salah, Anda akan mendapatkan `FileNotFoundException`, jadi periksa kembali bahwa file ada dan jalur menggunakan backslash yang di‑escape (`\\`) atau string verbatim (`@`). + +> **Pro tip:** Bungkus pemanggilan load dalam blok `try/catch` jika Anda mengharapkan file mungkin tidak ada saat runtime. + +## Step 2: Configure Image Rendering Options (Set Image Width Height) + +Sekarang masuk ke inti tutorial: **how to set image width height** agar PNG yang dihasilkan tidak terdistorsi atau berbintik. Kelas `ImageRenderingOptions` memberi Anda kontrol halus atas dimensi, DPI, dan smoothing. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Explanation of the key properties:** + +- `Width` dan `Height` – Ini adalah dimensi piksel tepat yang Anda inginkan. Dengan mengaturnya, Anda **set image width height** secara langsung, menggantikan ukuran halaman default. +- `UseAntialiasing` – Mengaktifkan smoothing berkualitas tinggi untuk teks dan grafik vektor, yang penting ketika Anda **convert word to png** dan menginginkan tepi yang tajam. +- `Resolution` – DPI yang lebih tinggi menghasilkan lebih banyak detail, terutama untuk tata letak kompleks. Perhatikan penggunaan memori; gambar 300 DPI dapat menjadi besar. + +> **Mengapa tidak hanya mengandalkan ukuran default?** Default menggunakan dimensi fisik halaman (mis., A4 pada 96 DPI). Itu sering menghasilkan gambar 794 × 1123 piksel—cukup untuk beberapa kasus tetapi tidak ketika Anda membutuhkan thumbnail UI tertentu atau pratinjau berukuran tetap. + +## Step 3: Render and Save as PNG (Export Docx as Image) + +Dengan dokumen dimuat dan opsi dikonfigurasi, Anda akhirnya dapat **export docx as image**. Metode `RenderToImage` melakukan pekerjaan berat. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Jika Anda ingin merender **the whole document** (semua halaman) ke dalam file PNG terpisah, lakukan perulangan atas koleksi halaman: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Apa yang terjadi di balik layar?** Renderer meraster setiap halaman menggunakan dimensi yang Anda berikan, menerapkan antialiasing, dan menulis aliran byte PNG ke disk. Karena PNG bersifat lossless, Anda mempertahankan fidelitas penuh tata letak Word asli. + +**Output yang diharapkan:** File PNG yang tajam dengan tepat 1024 × 768 piksel (atau ukuran apa pun yang Anda tetapkan). Buka di penampil gambar apa pun dan Anda akan melihat konten Word dirender persis seperti yang muncul di dokumen asli, tetapi kini sebagai gambar bitmap. + +## Advanced Tips & Variations + +### 1. Preserve Transparent Backgrounds + +Jika dokumen Word Anda berisi bentuk dengan latar belakang transparan dan Anda ingin mempertahankan transparansi tersebut, setel `BackgroundColor` ke `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Render Only a Specific Range + +Kadang‑kadang Anda hanya membutuhkan sebuah paragraf atau tabel, bukan seluruh halaman. Gunakan `DocumentVisitor` untuk mengekstrak node dan merendernya secara terpisah. Itu adalah skenario yang lebih maju, tetapi menunjukkan **how to render word** konten pada tingkat granular. + +### 3. Adjust DPI Dynamically + +Jika Anda memerlukan DPI yang berbeda per halaman (mis., resolusi tinggi untuk halaman sampul), ubah `Resolution` di dalam perulangan: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Batch Processing + +Saat mengonversi puluhan dokumen, bungkus seluruh alur dalam sebuah metode dan gunakan kembali instance `ImageRenderingOptions` yang sama. Menggunakan kembali objek opsi mengurangi beban alokasi. + +## Common Pitfalls & How to Avoid Them + +| Gejala | Penyebab Kemungkinan | Solusi | +|--------|----------------------|--------| +| PNG buram meskipun DPI tinggi | `UseAntialiasing` dibiarkan `false` | Set `UseAntialiasing = true`. | +| Ukuran output tidak cocok dengan `Width`/`Height` | DPI tidak dipertimbangkan | Kalikan ukuran yang diinginkan dengan `Resolution / 96` atau sesuaikan `Resolution`. | +| Exception out‑of‑memory pada dokumen besar | Merender seluruh dokumen pada 300 DPI | Render satu halaman pada satu waktu, buang setiap gambar setelah disimpan. | +| PNG menampilkan latar putih pada gambar transparan | `BackgroundColor` tidak diatur | Set `imageOptions.BackgroundColor = Color.Transparent`. | + +## Complete Working Example + +Berikut adalah program mandiri yang dapat Anda salin‑tempel ke aplikasi console. Program ini mendemonstrasikan **convert word to png**, **save docx as png**, dan tentu saja **set image width height**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Jalankan:** Bangun proyek, letakkan `input.docx` yang valid pada jalur yang Anda tentukan, dan jalankan. Anda akan melihat `output.png` tepat **1024 × 768** piksel, dirender dengan tepi yang halus. + +## Related Tutorials + +- [Cara Mengaktifkan Antialiasing Saat Mengonversi DOCX ke PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – buat arsip zip tutorial c#](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Cara Menggunakan Aspose untuk Merender HTML ke PNG – Panduan Langkah‑per‑Langkah](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/indonesian/net/html-extensions-and-conversions/_index.md b/html/indonesian/net/html-extensions-and-conversions/_index.md index 6ac5368ff..5e1be2ca4 100644 --- a/html/indonesian/net/html-extensions-and-conversions/_index.md +++ b/html/indonesian/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,10 @@ Aspose.HTML untuk .NET bukan sekadar pustaka; pustaka ini merupakan pengubah per ## Tutorial Ekstensi dan Konversi HTML ### [Konversi HTML ke PDF dalam .NET dengan Aspose.HTML](./convert-html-to-pdf/) Ubah HTML ke PDF dengan mudah menggunakan Aspose.HTML untuk .NET. Ikuti panduan langkah demi langkah kami dan manfaatkan kekuatan konversi HTML ke PDF. +### [Render HTML menjadi PDF di C# – Panduan Lengkap Langkah‑demi‑Langkah](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Render HTML ke PDF menggunakan C# dengan Aspose.HTML. Ikuti panduan langkah demi langkah lengkap kami. +### [Konversi HTML ke PDF dengan C# – Panduan Lengkap](./convert-html-to-pdf-with-c-complete-guide/) +Ubah HTML ke PDF menggunakan C# dengan Aspose.HTML. Ikuti panduan lengkap langkah demi langkah kami. ### [Buat PDF dari HTML – Panduan Langkah‑demi‑Langkah C#](./create-pdf-from-html-c-step-by-step-guide/) Pelajari cara membuat PDF dari HTML menggunakan C# dengan panduan langkah demi langkah menggunakan Aspose.HTML. ### [Konversi EPUB ke Gambar dalam .NET dengan Aspose.HTML](./convert-epub-to-image/) @@ -71,6 +75,8 @@ Pelajari cara mengompres file HTML menjadi arsip ZIP menggunakan C# dan Aspose.H Pelajari cara membuat dokumen HTML dengan teks berformat dan mengekspornya ke PDF menggunakan Aspose.HTML untuk .NET. ### [Simpan HTML sebagai ZIP – Tutorial Lengkap C#](./save-html-as-zip-complete-c-tutorial/) Pelajari cara menyimpan file HTML sebagai arsip ZIP menggunakan Aspose.HTML untuk .NET dengan contoh kode C# lengkap. +### [Simpan HTML sebagai ZIP – Panduan Lengkap untuk Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Panduan lengkap menyimpan HTML ke arsip ZIP menggunakan Aspose.HTML untuk .NET dengan contoh kode C#. ### [Simpan HTML ke ZIP di C# – Contoh In‑Memory Lengkap](./save-html-to-zip-in-c-complete-in-memory-example/) Pelajari cara menyimpan file HTML ke dalam arsip ZIP secara langsung di memori menggunakan C# dan Aspose.HTML. diff --git a/html/indonesian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/indonesian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..a63e42568 --- /dev/null +++ b/html/indonesian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,259 @@ +--- +category: general +date: 2026-05-22 +description: Konversi HTML ke PDF dalam C# menggunakan Aspose.HTML. Pelajari cara + merender HTML ke PDF dalam C# dengan kode langkah demi langkah, opsi, dan petunjuk + Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: id +og_description: Konversi HTML ke PDF dalam C# dengan Aspose.HTML. Panduan ini menunjukkan + cara merender HTML ke PDF dalam C# menggunakan opsi yang jelas dan petunjuk yang + ramah Linux. +og_title: Konversi HTML ke PDF dengan C# – Panduan Lengkap +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Mengonversi HTML ke PDF dengan C# – Panduan Lengkap +url: /id/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Mengonversi HTML ke PDF dengan C# – Panduan Lengkap + +Jika Anda perlu **mengonversi HTML ke PDF** dengan cepat, Aspose.HTML untuk .NET mempermudah prosesnya. Dalam tutorial ini kami juga akan menjawab **bagaimana cara merender HTML ke PDF dalam C#** dengan kontrol penuh atas opsi rendering, sehingga Anda tidak perlu menebak-nebak. + +Bayangkan Anda memiliki templat email pemasaran, halaman kwitansi, atau laporan kompleks yang dibangun dengan CSS modern, dan Anda harus menyerahkannya sebagai PDF kepada klien atau pencetak. Melakukan hal itu secara manual menyulitkan, tetapi beberapa baris kode C# dapat mengotomatisasi seluruh alur. Pada akhir panduan ini Anda akan memiliki solusi mandiri, siap produksi yang berfungsi di Windows *dan* Linux. + +## Apa yang Anda Butuhkan + +- **.NET 6.0 atau lebih baru** – Aspose.HTML menargetkan .NET Standard 2.0+, jadi SDK terbaru mana pun dapat digunakan. +- **Aspose.HTML for .NET** paket NuGet (`Aspose.Html`) – Anda memerlukan lisensi yang valid untuk produksi, tetapi versi percobaan gratis dapat digunakan untuk pengujian. +- Sebuah **file HTML sederhana** yang ingin Anda ubah menjadi PDF (kami akan menyebutnya `input.html`). +- IDE favorit Anda (Visual Studio, Rider, atau VS Code) – tidak memerlukan alat khusus. + +Itu saja. Tidak ada konverter PDF eksternal, tidak ada akrobatik baris perintah. Hanya C# murni. + +![Diagram yang menggambarkan alur kerja mengonversi html ke pdf menggunakan Aspose.HTML](/images/convert-html-to-pdf-workflow.png "alur kerja mengonversi html ke pdf") + +## Mengonversi HTML ke PDF – Implementasi Lengkap + +Berikut adalah program lengkap yang siap dijalankan. Salin‑tempel ke aplikasi konsol baru, pulihkan paket NuGet, dan tekan **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Mengapa Ini Berfungsi + +- **`Document`** adalah titik masuk Aspose.HTML; ia mem-parsing HTML, menyelesaikan CSS, dan membangun DOM yang siap untuk dirender. +- **`PdfRenderingOptions`** memungkinkan Anda menyesuaikan output. Flag `UseHinting` adalah rahasia untuk teks tajam pada kontainer Linux tanpa tampilan grafis di mana rasterizer default dapat terlihat buram. +- **`Save`** melakukan pekerjaan berat: ia merasterisasi DOM ke halaman PDF, menghormati pemisah halaman, dan secara otomatis menyematkan font. + +Menjalankan program akan menghasilkan `output.pdf` tepat di sebelah file sumber Anda. Buka dengan penampil PDF apa pun dan Anda akan melihat kecocokan visual yang setia dengan HTML asli. + +## Cara Merender HTML ke PDF dalam C# – Langkah demi Langkah + +Di bawah ini kami memecah proses menjadi potongan kecil, menjelaskan **bagaimana cara merender HTML ke PDF dalam C#** sambil membahas jebakan umum. + +### Langkah 1 – Instal Paket NuGet Aspose.HTML + +Buka terminal Anda di folder proyek dan jalankan: + +```bash +dotnet add package Aspose.Html +``` + +Jika Anda lebih suka UI Visual Studio, klik kanan proyek → **Manage NuGet Packages** → cari **Aspose.Html** dan instal versi stabil terbaru. + +> **Pro tip:** Setelah menginstal, tambahkan file lisensi (`Aspose.Total.lic`) ke root proyek Anda untuk menghindari watermark evaluasi. + +### Langkah 2 – Muat HTML Anda dengan Benar + +Aspose.HTML dapat mengonsumsi: + +- Jalur file lokal (`new Document("file.html")`) +- URL (`new Document("https://example.com")`) +- String HTML mentah (`new Document("…", new HtmlLoadOptions())`) + +Saat Anda memuat dari sistem file, pastikan path bersifat absolut atau direktori kerja diatur dengan tepat, jika tidak Anda akan mendapatkan `FileNotFoundException`. Di Linux, gunakan garis miring maju (`/`) atau `Path.Combine`. + +### Langkah 3 – Pilih Opsi Rendering yang Tepat + +Selain `UseHinting`, Anda mungkin ingin menyesuaikan: + +| Opsi | Apa fungsinya | Kapan digunakan | +|------|---------------|-----------------| +| `PageSize` | Menetapkan dimensi halaman PDF (A4, Letter, khusus) | Sesuaikan dengan ukuran kertas target | +| `Landscape` | Memutar halaman menjadi lanskap | Tabel atau diagram lebar | +| `RasterizeVectorGraphics` | Memaksa grafik vektor menjadi gambar raster | Ketika penerima PDF tidak dapat menangani SVG | +| `CompressionLevel` | Mengontrol kompresi gambar (0‑9) | Mengurangi ukuran file untuk lampiran email | + +Anda dapat menggabungkan properti ini secara berantai: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Langkah 4 – Simpan PDF + +Overload metode `Save` yang Anda lihat pada contoh lengkap menulis langsung ke jalur file. Anda juga dapat men‑stream PDF ke memori: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Itu berguna ketika Anda perlu mengembalikan PDF sebagai unduhan dari API web. + +### Langkah 5 – Verifikasi Output + +Pemeriksaan cepat adalah membandingkan jumlah halaman PDF dengan jumlah bagian HTML yang diharapkan. Anda dapat membacanya kembali dengan Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Jika jumlahnya tidak cocok, tinjau kembali aturan CSS `page-break` atau sesuaikan `PdfRenderingOptions` sesuai kebutuhan. + +## Kasus Pinggiran & Kesalahan Umum + +| Situasi | Hal yang perlu diwaspadai | Solusi | +|---------|---------------------------|--------| +| **Sumber daya eksternal (gambar, font) hilang** | URL relatif di‑resolve terhadap folder file HTML. | Gunakan `HtmlLoadOptions.BaseUri` untuk menunjuk ke root yang benar. | +| **Lingkungan Linux headless** | Rendering teks default mungkin buram. | Set `UseHinting = true` (seperti yang ditunjukkan) dan pastikan `libgdiplus` terinstal jika Anda kembali ke System.Drawing. | +| **HTML besar (> 10 MB)** | Konsumsi memori melonjak selama rendering. | Render per halaman menggunakan `PdfRenderer` dengan `PdfRenderingOptions` dan buang setiap halaman setelah disimpan. | +| **Halaman berat JavaScript** | Aspose.HTML tidak mengeksekusi JS; konten dinamis tetap statis. | Pra‑proses HTML di sisi server (misalnya, menggunakan Puppeteer) sebelum memberi ke Aspose.HTML. | +| **Karakter Unicode muncul sebagai kotak** | Font yang hilang di lingkungan runtime. | Sematkan font khusus melalui `FontSettings` atau pastikan OS memiliki font yang diperlukan. | + +## Ringkasan Contoh Kerja Penuh + +Berikut seluruh program lagi, tanpa komentar bagi yang lebih suka tampilan singkat: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Jalankan, buka `output.pdf`, dan Anda akan melihat replika pixel‑perfect dari `input.html`. Itulah esensi **convert html to pdf** dengan Aspose.HTML. + +## Kesimpulan + +Kami telah membahas semua yang Anda perlukan untuk **mengonversi HTML ke PDF** dalam C#: menginstal Aspose.HTML, memuat HTML, menyesuaikan opsi rendering (termasuk flag penting `UseHinting`), dan menyimpan PDF akhir. Sekarang Anda memahami **bagaimana cara merender HTML ke PDF dalam C#** untuk lingkungan Windows dan Linux, dan Anda telah melihat cara menangani kasus pinggiran umum seperti sumber daya yang hilang dan file besar. + +Apa selanjutnya? Coba tambahkan: + +- **Header/footer** dengan `PdfPageTemplate` untuk branding. +- **Proteksi password** melalui `PdfSaveOptions`. +- **Konversi batch** dengan mengulang folder berisi + +## Tutorial Terkait + +- [Mengonversi HTML ke PDF di .NET dengan Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Mengonversi EPUB ke PDF di .NET dengan Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Mengonversi SVG ke PDF di .NET dengan Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/indonesian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/indonesian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..7aa68c625 --- /dev/null +++ b/html/indonesian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,309 @@ +--- +category: general +date: 2026-05-22 +description: Render HTML menjadi PDF menggunakan C# dengan contoh singkat. Pelajari + cara mengonversi HTML ke PDF dengan C# secara cepat dan andal. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: id +og_description: Render HTML menjadi PDF di C# dengan contoh yang jelas dan dapat dijalankan. + Panduan ini menunjukkan cara mengonversi HTML ke PDF di C# dan menghasilkan PDF + dari file HTML. +og_title: Render HTML menjadi PDF di C# – Tutorial Pemrograman Lengkap +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Render HTML sebagai PDF di C# – Panduan Lengkap Langkah demi Langkah +url: /id/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Render HTML sebagai PDF di C# – Panduan Lengkap Langkah‑per‑Langkah + +Pernah membutuhkan **render HTML sebagai PDF** tetapi tidak yakin library mana yang harus dipilih untuk proyek .NET? Anda tidak sendirian. Dalam banyak aplikasi bisnis, Anda akan menemukan kebutuhan untuk **mengonversi HTML ke PDF C#** untuk faktur, laporan, atau brosur pemasaran—pada dasarnya kapan saja Anda menginginkan versi cetak dari sebuah halaman web. + +Intinya: Anda tidak perlu menciptakan kembali roda. Dengan beberapa baris kode Anda dapat mengambil file `input.html`, memberikannya ke mesin rendering yang terbukti, dan menghasilkan `output.pdf` yang tajam. Dalam tutorial ini kami akan membahas seluruh proses, mulai dari menambahkan paket NuGet yang tepat hingga menangani kasus tepi seperti CSS eksternal. Pada akhir tutorial Anda akan dapat **menghasilkan PDF dari file HTML** dalam hitungan menit. + +## Apa yang Akan Anda Pelajari + +- Cara menyiapkan aplikasi konsol .NET yang **membuat PDF dari HTML C#**. +- Panggilan API tepat yang Anda perlukan untuk **menyimpan dokumen HTML sebagai PDF**. +- Mengapa opsi rendering tertentu (seperti hinting) penting untuk kualitas teks. +- Tips untuk memecahkan masalah umum seperti font yang hilang atau jalur gambar relatif. + +**Prasyarat** – Anda harus memiliki .NET 6+ atau .NET Framework 4.7 terpasang, pemahaman dasar tentang C#, dan sebuah IDE (Visual Studio 2022, Rider, atau VS Code). Tidak diperlukan pengalaman PDF sebelumnya. + +--- + +## Render HTML sebagai PDF – Menyiapkan Proyek + +Sebelum masuk ke kode, pastikan lingkungan pengembangan sudah siap. Library yang akan kami gunakan adalah **Select.Pdf** (gratis untuk penggunaan non‑komersial) karena menawarkan API yang sederhana dan fidelitas rendering yang solid. + +### Instal library rendering PDF (convert html to pdf c#) + +Buka terminal di folder proyek Anda dan jalankan: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Jika Anda menggunakan Visual Studio, Anda juga dapat menambahkan paket melalui UI NuGet Package Manager. Nomor versi mungkin lebih baru—cukup ambil rilis stabil terbaru. + +### Buat kerangka konsol + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Itulah semua boilerplate yang Anda perlukan. Beban berat terjadi di dalam `Main`. + +--- + +## Muat Dokumen HTML (generate pdf from html file) + +Langkah nyata pertama adalah menunjuk renderer ke file HTML di disk. Select.Pdf menawarkan dua cara praktis: memberikan string HTML mentah atau jalur file. Menggunakan file membuat semuanya lebih rapi, terutama ketika Anda memiliki CSS atau gambar yang terhubung. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Di sini kami juga melindungi dari file yang tidak ada—sesuatu yang sering membuat pemula kebingungan ketika lupa menyalin HTML ke folder output. + +--- + +## Konfigurasi Opsi Rendering (create pdf from html c#) + +Select.Pdf dilengkapi dengan objek `PdfDocumentOptions` yang kaya. Untuk teks yang tajam kami mengaktifkan hinting, yang memperhalus glyph dengan sedikit penurunan performa. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Anda dapat menyesuaikan ukuran halaman, margin, atau bahkan menyematkan font khusus di sini. Inti pentingnya adalah bahwa **render html as pdf** bukan sekadar satu baris kode; Anda memiliki kontrol atas tampilan dan nuansa dokumen akhir. + +--- + +## Simpan Dokumen HTML sebagai PDF (render html as pdf) + +Sekarang keajaiban terjadi. Kami memberikan konverter jalur ke file HTML kami dan memintanya menulis PDF ke disk. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +Metode `ConvertUrl` secara otomatis menyelesaikan URL relatif (gambar, CSS) berdasarkan lokasi file HTML, itulah mengapa pendekatan ini kuat untuk kebanyakan skenario dunia nyata. + +### Output yang Diharapkan + +Setelah menjalankan program Anda akan melihat file `output.pdf` di folder yang sama. Buka file tersebut—Anda akan melihat: + +- Teks dirender dengan anti‑aliasing yang jelas (berkat hinting). +- Gaya dari CSS yang terhubung diterapkan dengan benar. +- Gambar ditampilkan dengan ukuran tepat seperti yang didefinisikan di HTML sumber. + +Jika ada yang tampak tidak tepat, periksa kembali bahwa file CSS dan gambar ditempatkan berdampingan dengan `input.html` atau gunakan URL absolut. + +--- + +## Menangani Kasus Tepi Umum + +### 1. Sumber daya eksternal diblokir oleh firewall + +Jika HTML Anda merujuk ke font yang di‑host di CDN yang tidak dapat dijangkau server Anda, PDF mungkin akan beralih ke font generik. Untuk menghindarinya, unduh file font secara lokal atau sematkan menggunakan `@font-face` dengan jalur relatif. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. File HTML sangat besar + +Saat mengonversi dokumen raksasa, Anda mungkin menemui batas memori. Select.Pdf memungkinkan Anda melakukan streaming konversi: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Streaming membuat proses lebih ringan tetapi mengharuskan Anda menyediakan HTML sebagai string, yang dapat Anda baca dalam potongan bila diperlukan. + +### 3. Header atau footer khusus + +Jika Anda memerlukan nomor halaman atau logo perusahaan di setiap halaman, atur properti `Header` dan `Footer` pada `converter.Options` sebelum memanggil `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Contoh Lengkap yang Berfungsi (Semua Langkah Digabung) + +Berikut adalah program lengkap yang siap disalin‑tempel. Ganti `YOUR_DIRECTORY` dengan jalur absolut tempat HTML Anda berada. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Jalankan:** `dotnet run` dari direktori proyek. Jika semuanya sudah disiapkan dengan benar Anda akan melihat pesan sukses dan `output.pdf` yang mengkilap. + +--- + +## Ringkasan Visual + +![Render HTML as PDF example](render-html-as-pdf.png){alt="render html as pdf example"} + +Tangkapan layar menunjukkan output konsol dan PDF yang dihasilkan dibuka di penampil. Perhatikan judul yang tajam dan gambar yang dimuat dengan benar—tepat seperti yang Anda harapkan ketika **render html as pdf**. + +--- + +## Kesimpulan + +Anda baru saja mempelajari cara **render HTML sebagai PDF** dalam aplikasi C#, mulai dari menginstal library hingga menyetel opsi rendering. Contoh lengkap menunjukkan cara andal untuk **mengonversi HTML ke PDF C#**, **menghasilkan PDF dari file HTML**, dan **menyimpan dokumen HTML sebagai PDF** hanya dengan beberapa baris kode. + +Apa selanjutnya? Cobalah bereksperimen dengan: + +- Menambahkan font khusus untuk konsistensi merek. +- Menghasilkan PDF dari string HTML dinamis (misalnya, template Razor). +- Menggabungkan beberapa PDF menjadi satu laporan menggunakan `PdfDocument.AddPage`. + +Setiap ekstensi tersebut dibangun di atas konsep inti yang dibahas di sini, sehingga Anda siap menangani skenario yang lebih maju tanpa kurva belajar yang curam. + +Punya pertanyaan atau mengalami kendala? Tinggalkan komentar di bawah, dan mari kita selesaikan bersama. Selamat coding! + +## Tutorial Terkait + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Create HTML Document with Styled Text and Export to PDF – Full Guide](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Convert HTML to PDF with Aspose.HTML – Full Manipulation Guide](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/indonesian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/indonesian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..e5285a9c9 --- /dev/null +++ b/html/indonesian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,229 @@ +--- +category: general +date: 2026-05-22 +description: Simpan HTML sebagai ZIP dengan cepat menggunakan Aspose.HTML. Pelajari + cara mengompres file HTML menjadi ZIP, merender HTML ke ZIP, dan mengekspor HTML + ke file ZIP dengan kode lengkap. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: id +og_description: Simpan HTML sebagai ZIP dengan Aspose.HTML. Panduan ini menunjukkan + cara merender HTML ke ZIP, mengekspor HTML ke file ZIP, dan mengompres file HTML + secara programatis. +og_title: Simpan HTML sebagai ZIP – Tutorial Lengkap Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Menyimpan HTML sebagai ZIP – Panduan Lengkap untuk Aspose.HTML +url: /id/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Simpan HTML sebagai ZIP – Panduan Lengkap untuk Aspose.HTML + +Pernah bertanya-tanya bagaimana cara **menyimpan HTML sebagai ZIP** tanpa harus menggunakan alat arsip terpisah? Anda tidak sendirian. Banyak pengembang perlu mengemas halaman HTML bersama gambar, CSS, dan skripnya untuk distribusi yang mudah, dan melakukannya secara manual dengan cepat menjadi titik masalah. + +Dalam tutorial ini kami akan membimbing Anda melalui solusi bersih, end‑to‑end yang **menghasilkan HTML ke ZIP** menggunakan Aspose.HTML untuk .NET. Pada akhir tutorial Anda akan tahu persis cara **mengekspor HTML ke file ZIP**, dan Anda juga akan melihat variasi **cara meng-zip file HTML** dalam berbagai skenario. + +> *Tips profesional:* Pendekatan yang ditunjukkan berfungsi baik Anda mengemas satu halaman maupun seluruh folder situs. + +## Apa yang Anda Butuhkan + +Sebelum kita mulai, pastikan Anda memiliki: + +- .NET 6 (atau runtime .NET terbaru) terpasang. +- Paket NuGet Aspose.HTML untuk .NET (`Aspose.Html`) yang direferensikan dalam proyek Anda. +- File `input.html` sederhana yang ditempatkan di folder yang Anda kontrol. +- Sedikit kenyamanan dengan C#—tidak perlu hal yang rumit, hanya dasar-dasarnya. + +Itu saja. Tanpa utilitas zip eksternal, tanpa akrobatik baris perintah. Mari kita mulai. + +![Diagram yang menunjukkan proses menyimpan HTML sebagai ZIP menggunakan Aspose.HTML](save-html-as-zip.png) + +*Teks alt gambar: diagram proses menyimpan html sebagai zip* + +## Langkah 1: Muat Dokumen HTML Sumber + +Hal pertama yang harus kita lakukan adalah memberi tahu Aspose.HTML di mana sumber kita berada. Kelas `HTMLDocument` membaca file dan membangun DOM di memori, siap untuk dirender. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Mengapa ini penting: memuat dokumen memberi pustaka kontrol penuh atas resolusi sumber daya (gambar, CSS, font). Jika HTML merujuk ke jalur relatif, Aspose.HTML secara otomatis menyelesaikannya relatif terhadap folder file. + +## Langkah 2: (Opsional) Buat Penangan Sumber Daya Kustom + +Jika Anda perlu memeriksa atau memanipulasi setiap sumber daya—misalnya Anda ingin mengompres gambar sebelum masuk ke arsip—Anda dapat menyambungkan `ResourceHandler`. Langkah ini opsional, tetapi merupakan cara paling fleksibel untuk **mengonversi HTML ke arsip ZIP** dengan logika kustom. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Bagaimana jika Anda tidak memerlukan pemrosesan khusus?* Lewati kelas ini dan gunakan penangan default—Aspose.HTML akan menulis sumber daya langsung ke dalam ZIP. + +## Langkah 3: Konfigurasikan Opsi Penyimpanan untuk Menggunakan Penangan + +Objek `HtmlSaveOptions` memberi tahu renderer apa yang harus dilakukan dengan sumber daya. Dengan menetapkan `MyResourceHandler` kami, kami memperoleh kontrol penuh atas output. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Perhatikan bagaimana properti `ResourceHandler` secara langsung merujuk pada kemampuan **render HTML ke ZIP**. Di sinilah keajaiban terjadi: setiap sumber daya yang terhubung disalurkan ke dalam arsip alih-alih ditulis ke disk. + +## Langkah 4: Simpan Dokumen yang Dirender ke dalam Arsip ZIP + +Sekarang kita akhirnya **mengekspor HTML ke file ZIP**. Metode `Save` menerima `Stream` apa pun, sehingga kita dapat menunjukkannya ke `FileStream` yang membuat `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Itulah seluruh alur kerja. Ketika kode selesai, `result.zip` berisi: + +- `input.html` (markup asli) +- Semua gambar, file CSS, dan font yang direferensikan +- Setiap sumber daya yang telah diubah jika Anda memodifikasinya di `MyResourceHandler` + +## Cara Meng‑zip File HTML Tanpa Aspose.HTML (Alternatif Cepat) + +Terkadang Anda hanya membutuhkan pendekatan **cara meng-zip file HTML** yang sederhana, mungkin karena Anda sudah menggunakan parser HTML lain. Dalam kasus itu Anda dapat menggunakan `System.IO.Compression` bawaan .NET: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Metode ini sederhana tetapi tidak memiliki langkah rendering; ia hanya mengemas apa yang ada di disk. Jika HTML Anda merujuk ke URL eksternal, sumber daya tersebut tidak akan disertakan. Itulah mengapa jalur Aspose.HTML lebih disukai ketika Anda memerlukan solusi **render HTML ke ZIP** yang dapat diandalkan. + +## Kasus Tepi & Kesalahan Umum + +| Situasi | Hal yang Perlu Diperhatikan | Perbaikan yang Disarankan | +|-----------|-------------------|-----------------| +| **Gambar besar** | Lonjakan penggunaan memori karena setiap gambar dimuat ke dalam `MemoryStream`. | Salurkan langsung ke zip menggunakan penangan kustom yang menyalin aliran sumber alih-alih menampung sepenuhnya. | +| **URL eksternal** | Sumber daya yang dihosting di internet tidak diunduh secara otomatis. | Atur `HtmlLoadOptions` dengan `BaseUrl` yang mengarah ke akar situs, atau unduh sumber daya secara manual sebelum menyimpan. | +| **Tabrakan nama file** | Dua file CSS dengan nama sama di subfolder berbeda dapat menimpa satu sama lain. | Pastikan `ResourceHandler` mempertahankan jalur relatif lengkap saat menulis ke zip. | +| **Kesalahan izin** | Mencoba menulis ke folder read‑only menghasilkan `UnauthorizedAccessException`. | Jalankan proses dengan hak yang tepat atau pilih direktori output yang dapat ditulisi. | + +Menangani skenario ini membuat rutinitas **mengonversi HTML ke arsip ZIP** Anda menjadi kuat untuk penggunaan produksi. + +## Contoh Lengkap yang Berfungsi (Semua Bagian Bersatu) + +Berikut adalah program lengkap yang siap dijalankan. Tempelkan ke aplikasi konsol baru, perbarui jalur, dan tekan **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Output yang diharapkan:** Konsol mencetak pesan sukses, dan file `result.zip` berisi `input.html` plus semua aset yang bergantung. Buka ZIP, klik dua kali `input.html`, dan Anda akan melihat halaman dirender persis seperti di browser—tanpa gambar yang hilang, tanpa CSS yang rusak. + +## Ringkasan – Mengapa Pendekatan Ini Hebat + +- **Rendering satu langkah:** Anda tidak perlu menyalin setiap sumber daya secara manual; Aspose.HTML melakukannya untuk Anda. +- **Pipeline dapat disesuaikan:** `ResourceHandler` memberi Anda kontrol penuh atas cara setiap file disimpan, memungkinkan kompresi, enkripsi, atau transformasi langsung. +- **Lintas‑platform:** Berfungsi di Windows, Linux, dan macOS selama runtime .NET tersedia. +- **Tanpa alat eksternal:** Seluruh proses **menyimpan HTML sebagai ZIP** berada di dalam basis kode C# Anda. + +## Apa Selanjutnya? + +Setelah Anda menguasai **menyimpan HTML sebagai ZIP**, pertimbangkan untuk menjelajahi topik terkait berikut: + +- **Ekspor HTML ke PDF** – sempurna untuk laporan yang dapat dicetak (pengetahuan `export html to zip file` membantu ketika Anda membutuhkan kedua format). +- **Streaming ZIP langsung ke respons HTTP** – ideal untuk API web yang memungkinkan pengguna mengunduh situs yang dikemas secara langsung. +- **Mengenkripsi arsip ZIP** – tambahkan lapisan password jika Anda menangani dokumentasi rahasia. + +Silakan bereksperimen: ganti `MyResourceHandler` dengan kompresor yang memperkecil gambar, atau tambahkan file manifest yang mencantumkan semua sumber daya yang dibundel. Langit adalah batasnya ketika Anda mengendalikan pipeline rendering. + +--- + +*Selamat coding! Jika Anda menemui kendala atau memiliki ide untuk perbaikan, tinggalkan komentar di bawah. Kita akan menyelesaikannya bersama.* + +## Tutorial Terkait + +- [Cara Meng‑zip HTML di C# – Simpan HTML ke Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Simpan HTML sebagai ZIP – Tutorial Lengkap C#](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Simpan HTML ke ZIP di C# – Contoh In‑Memory Lengkap](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/italian/net/generate-jpg-and-png-images/_index.md b/html/italian/net/generate-jpg-and-png-images/_index.md index f6e8b2d8a..ff33f8e7b 100644 --- a/html/italian/net/generate-jpg-and-png-images/_index.md +++ b/html/italian/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Impara a usare Aspose.HTML per .NET per manipolare documenti HTML, convertire HT Scopri come abilitare l'antialiasing durante la conversione di documenti DOCX in immagini PNG o JPG con Aspose.HTML per .NET. ### [Converti docx in PNG – crea archivio zip C# tutorial](./convert-docx-to-png-create-zip-archive-c-tutorial/) Impara a convertire documenti DOCX in PNG e a comprimerli in un archivio ZIP usando C# e Aspose.HTML. +### [Imposta larghezza e altezza dell'immagine durante la conversione da Word a PNG – Guida completa](./set-image-width-height-when-converting-word-to-png-full-guid/) +Scopri come specificare larghezza e altezza dell'immagine PNG durante la conversione di documenti Word con Aspose.HTML per .NET. ## Conclusione diff --git a/html/italian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/italian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..17fed6471 --- /dev/null +++ b/html/italian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,262 @@ +--- +category: general +date: 2026-05-22 +description: Imposta larghezza e altezza dell'immagine durante la conversione di un + documento Word in PNG. Scopri come esportare un file docx come immagine con rendering + ad alta qualità in un tutorial passo‑passo. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: it +og_description: Imposta larghezza e altezza dell'immagine durante la conversione di + un documento Word in PNG. Questo tutorial mostra come esportare un file docx come + immagine con impostazioni ad alta qualità. +og_title: Imposta larghezza e altezza dell’immagine durante la conversione da Word + a PNG – Guida completa +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Imposta Larghezza e Altezza dell'Immagine durante la Conversione da Word a + PNG – Guida Completa +url: /it/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Imposta Larghezza e Altezza dell'Immagine Durante la Conversione da Word a PNG – Guida Completa + +Ti sei mai chiesto come **impostare larghezza e altezza dell'immagine** mentre **converti Word in PNG**? Non sei l'unico. Molti sviluppatori si trovano in difficoltà quando l'esportazione predefinita produce un'immagine sfocata o con dimensioni errate, e poi passano ore a cercare una soluzione che funzioni davvero. + +In questo tutorial ti guideremo attraverso una soluzione pulita, end‑to‑end, che mostra **come renderizzare word** documenti come immagini PNG, permettendoti di **salvare docx come PNG** con un controllo preciso di larghezza‑altezza e antialiasing di alta qualità. Alla fine avrai uno snippet di codice pronto all'uso, una solida comprensione delle opzioni API e alcuni consigli professionali per evitare gli errori più comuni. + +## Cosa Imparerai + +- Caricare un file `.docx` usando Aspose.Words per .NET. +- **Impostare larghezza e altezza dell'immagine** con `ImageRenderingOptions`. +- **Esportare docx come immagine** (PNG) con antialiasing abilitato. +- Come **convertire word in png** per una singola pagina o per l'intero documento. +- Suggerimenti per gestire documenti di grandi dimensioni, considerazioni DPI e percorsi del file‑system. + +Nessuno strumento esterno, nessuna complicata manipolazione da riga di comando—solo puro codice C# che puoi inserire in qualsiasi progetto .NET. + +## Prerequisiti + +Prima di immergerci, assicurati di avere quanto segue: + +| Requisito | Perché è importante | +|-------------|----------------| +| **.NET 6.0+** (o .NET Framework 4.7.2) | Aspose.Words supporta entrambi, ma i runtime più recenti offrono migliori prestazioni. | +| **Pacchetto NuGet Aspose.Words per .NET** (`Install-Package Aspose.Words`) | Fornisce la classe `Document` e il motore di rendering. | +| Un **documento Word** (`.docx`) che desideri trasformare in PNG. | La sorgente che convertirai. | +| Conoscenza di base di C# – comprenderai le istruzioni `using` e l'inizializzazione degli oggetti. | Mantiene la curva di apprendimento dolce. | + +Se ti manca il pacchetto NuGet, esegui questo nella Console del Package Manager: + +```powershell +Install-Package Aspose.Words +``` + +Tutto qui—una volta che il pacchetto è installato, sei pronto per iniziare a programmare. + +## Passo 1: Carica il Documento Sorgente + +La prima cosa da fare è indicare alla libreria il file Word che vuoi trasformare. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Perché è importante:** La classe `Document` legge l'intero pacchetto Word in memoria, fornendoti accesso a pagine, stili e a tutto il resto. Se il percorso è errato, otterrai una `FileNotFoundException`, quindi verifica che il file esista e che il percorso utilizzi le barre inverse escape (`\\`) o una stringa verbatim (`@`). + +> **Consiglio professionale:** Avvolgi la chiamata di caricamento in un blocco `try/catch` se ti aspetti che il file possa mancare a runtime. + +## Passo 2: Configura le Opzioni di Rendering dell'Immagine (Imposta Larghezza e Altezza dell'Immagine) + +Ora arriva il cuore del tutorial: **come impostare larghezza e altezza dell'immagine** affinché il PNG risultante non sia distorto o pixelato. La classe `ImageRenderingOptions` ti offre un controllo dettagliato su dimensioni, DPI e smoothing. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Spiegazione delle proprietà chiave:** + +- `Width` e `Height` – Queste sono le dimensioni esatte in pixel che desideri. Impostandole, **imposti larghezza e altezza dell'immagine** direttamente, sovrascrivendo la dimensione predefinita della pagina. +- `UseAntialiasing` – Abilita lo smoothing di alta qualità per testo e grafica vettoriale, fondamentale quando **converti word in png** e desideri bordi nitidi. +- `Resolution` – DPI più alto produce più dettagli, specialmente per layout complessi. Tieni d'occhio l'uso della memoria; un'immagine a 300 DPI può essere grande. + +> **Perché non affidarsi semplicemente alla dimensione predefinita?** Il valore predefinito utilizza le dimensioni fisiche della pagina (ad esempio, A4 a 96 DPI). Questo spesso produce un'immagine di 794 × 1123 pixel—va bene in alcuni casi ma non quando ti serve una miniatura UI specifica o un'anteprima a dimensione fissa. + +## Passo 3: Renderizza e Salva come PNG (Esporta Docx come Immagine) + +Con il documento caricato e le opzioni configurate, puoi finalmente **esportare docx come immagine**. Il metodo `RenderToImage` fa il lavoro pesante. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Se vuoi renderizzare **l'intero documento** (tutte le pagine) in file PNG separati, itera sulla collezione delle pagine: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Cosa succede dietro le quinte?** Il renderer rasterizza ogni pagina usando le dimensioni fornite, applica l'antialiasing e scrive un flusso di byte PNG su disco. Poiché PNG è lossless, mantieni la piena fedeltà del layout originale di Word. + +**Output previsto:** Un file PNG nitido esattamente di 1024 × 768 pixel (o della dimensione che hai impostato). Aprilo in qualsiasi visualizzatore di immagini e vedrai il contenuto Word renderizzato esattamente come appare nel documento originale, ma ora come immagine bitmap. + +## Suggerimenti Avanzati e Varianti + +### 1. Conserva gli Sfondi Trasparenti + +Se il tuo documento Word contiene forme con sfondi trasparenti e vuoi mantenere quella trasparenza, imposta `BackgroundColor` su `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Renderizza Solo un Intervallo Specifico + +A volte ti serve solo un paragrafo o una tabella, non l'intera pagina. Usa `DocumentVisitor` per estrarre il nodo e renderizzarlo separatamente. È uno scenario più avanzato, ma mostra **come renderizzare word** a livello granulare. + +### 3. Regola DPI Dinamicamente + +Se ti servono DPI diversi per pagina (ad esempio, alta risoluzione per la copertina), modifica `Resolution` all'interno del ciclo: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Elaborazione in Batch + +Quando converti decine di documenti, avvolgi l'intero flusso in un metodo e riutilizza la stessa istanza di `ImageRenderingOptions`. Riutilizzare l'oggetto delle opzioni riduce l'overhead di allocazione. + +## Problemi Comuni e Come Evitarli + +| Sintomo | Probabile Causa | Soluzione | +|---------|----------------|-----------| +| PNG è sfocato nonostante DPI alto | `UseAntialiasing` lasciato `false` | Imposta `UseAntialiasing = true`. | +| La dimensione dell'output non corrisponde a `Width`/`Height` | DPI non considerato | Moltiplica la dimensione desiderata per `Resolution / 96` o regola `Resolution`. | +| Eccezione Out‑of‑memory su documenti grandi | Rendering dell'intero documento a 300 DPI | Renderizza una pagina alla volta, elimina ogni immagine dopo il salvataggio. | +| PNG mostra uno sfondo bianco su immagini trasparenti | `BackgroundColor` non impostato | Imposta `imageOptions.BackgroundColor = Color.Transparent`. | + +## Esempio Completo Funzionante + +Di seguito trovi un programma autonomo che puoi copiare‑incollare in un'app console. Dimostra **convertire word in png**, **salvare docx come png**, e naturalmente **impostare larghezza e altezza dell'immagine**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Eseguilo:** Compila il progetto, posiziona un `input.docx` valido nel percorso specificato e avvia. Dovresti vedere un `output.png` esattamente **1024 × 768** pixel, renderizzato con bordi lisci. + +## Tutorial Correlati + +- [Come Abilitare l'Antialiasing Quando si Converte DOCX in PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [converti docx in png – crea archivio zip tutorial c#](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Come Usare Aspose per Renderizzare HTML in PNG – Guida Passo‑Passo](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/italian/net/html-extensions-and-conversions/_index.md b/html/italian/net/html-extensions-and-conversions/_index.md index fcf4daa30..5d2225c4c 100644 --- a/html/italian/net/html-extensions-and-conversions/_index.md +++ b/html/italian/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,10 @@ Aspose.HTML per .NET non è solo una libreria; è un punto di svolta nel mondo d ## Tutorial sulle estensioni e conversioni HTML ### [Convertire HTML in PDF in .NET con Aspose.HTML](./convert-html-to-pdf/) Converti HTML in PDF senza sforzo con Aspose.HTML per .NET. Segui la nostra guida passo dopo passo e libera la potenza della conversione da HTML a PDF. +### [Convertire HTML in PDF con C# – Guida completa](./convert-html-to-pdf-with-c-complete-guide/) +Scopri come convertire HTML in PDF usando C# con Aspose.HTML, passo dopo passo, con esempi pratici e opzioni avanzate. +### [Renderizzare HTML in PDF in C# – Guida completa passo‑a‑passo](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Scopri come renderizzare HTML in PDF usando C# con Aspose.HTML, passo dopo passo, con esempi pratici e opzioni avanzate. ### [Crea documento HTML con testo formattato ed esporta in PDF – Guida completa](./create-html-document-with-styled-text-and-export-to-pdf-full/) Impara a creare un documento HTML con testo stilizzato e a convertirlo in PDF usando Aspose.HTML per .NET, passo dopo passo. ### [Convertire EPUB in immagine in .NET con Aspose.HTML](./convert-epub-to-image/) @@ -71,6 +75,8 @@ Scopri come comprimere un documento HTML in un file ZIP usando Aspose.HTML per . Crea un PDF da HTML in C# con Aspose.HTML per .NET. Segui la nostra guida passo passo per una conversione semplice ed efficace. ### [Salva HTML come ZIP – Tutorial completo C#](./save-html-as-zip-complete-c-tutorial/) Salva HTML come archivio ZIP con Aspose.HTML per .NET. Guida passo passo per creare file ZIP contenenti HTML in C#. +### [Salva HTML come ZIP – Guida completa per Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Scopri come salvare un documento HTML in un archivio ZIP usando Aspose.HTML per .NET. Guida passo passo completa. ### [Salva HTML in ZIP in C# – Esempio completo in memoria](./save-html-to-zip-in-c-complete-in-memory-example/) Scopri come salvare un documento HTML in un archivio ZIP interamente in memoria usando Aspose.HTML per .NET. diff --git a/html/italian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/italian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..a469a8911 --- /dev/null +++ b/html/italian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,258 @@ +--- +category: general +date: 2026-05-22 +description: Converti HTML in PDF in C# usando Aspose.HTML. Scopri come rendere HTML + in PDF in C# con codice passo‑passo, opzioni e suggerimenti per Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: it +og_description: Converti HTML in PDF in C# con Aspose.HTML. Questa guida mostra come + rendere HTML in PDF in C# utilizzando opzioni chiare e suggerimenti compatibili + con Linux. +og_title: Converti HTML in PDF con C# – Guida completa +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Converti HTML in PDF con C# – Guida completa +url: /it/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Converti HTML in PDF con C# – Guida Completa + +Se hai bisogno di **convertire HTML in PDF** rapidamente, Aspose.HTML per .NET lo rende un gioco da ragazzi. In questo tutorial risponderemo anche a **come renderizzare HTML in PDF in C#** con pieno controllo sulle opzioni di rendering, così non dovrai più indovinare. + +Immagina di avere un modello di email marketing, una pagina di ricevuta o un report complesso costruito con CSS moderno, e di doverlo consegnare come PDF a un cliente o a una stampante. Farlo manualmente è una seccatura, ma poche righe di codice C# possono automatizzare l'intero flusso. Alla fine di questa guida avrai una soluzione autonoma, pronta per la produzione, che funziona su Windows *e* Linux. + +## Cosa Ti Serve + +- **.NET 6.0 o successivo** – Aspose.HTML mira a .NET Standard 2.0+, quindi qualsiasi SDK recente funziona. +- Pacchetto NuGet **Aspose.HTML for .NET** (`Aspose.Html`) – avrai bisogno di una licenza valida per la produzione, ma la versione di prova gratuita è sufficiente per i test. +- Un **semplice file HTML** che desideri trasformare in PDF (lo chiameremo `input.html`). +- Il tuo IDE preferito (Visual Studio, Rider o VS Code) – non è necessario alcuno strumento speciale. + +Tutto qui. Nessun convertitore PDF esterno, nessuna acrobazia da riga di comando. Solo puro C#. + +![Diagram illustrating the convert html to pdf workflow using Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## Converti HTML in PDF – Implementazione Completa + +Di seguito trovi il programma completo, pronto per l'esecuzione. Copialo e incollalo in una nuova applicazione console, ripristina i pacchetti NuGet e premi **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Perché Funziona + +- `Document` è il punto di ingresso di Aspose.HTML; analizza l'HTML, risolve il CSS e costruisce un DOM pronto per il rendering. +- `PdfRenderingOptions` ti permette di regolare l'output. Il flag `UseHinting` è il segreto per ottenere testo nitido nei container Linux headless, dove il rasterizzatore predefinito può apparire sfocato. +- `Save` fa il lavoro pesante: rasterizza il DOM sulle pagine PDF, rispetta le interruzioni di pagina e incorpora i font automaticamente. + +Eseguendo il programma verrà generato `output.pdf` proprio accanto al tuo file sorgente. Aprilo con qualsiasi visualizzatore PDF e dovresti vedere una corrispondenza visiva fedele all'HTML originale. + +## Come Renderizzare HTML in PDF in C# – Passo‑per‑Passo + +Di seguito suddividiamo il processo in parti più piccole, spiegando **come renderizzare HTML in PDF in C#** e coprendo le insidie più comuni. + +### Passo 1 – Installa il Pacchetto NuGet Aspose.HTML + +Apri il terminale nella cartella del progetto ed esegui: + +```bash +dotnet add package Aspose.Html +``` + +Se preferisci l'interfaccia di Visual Studio, fai clic destro sul progetto → **Manage NuGet Packages** → cerca **Aspose.Html** e installa l'ultima versione stabile. + +> **Consiglio Pro:** Dopo l'installazione, aggiungi un file di licenza (`Aspose.Total.lic`) nella radice del tuo progetto per evitare filigrane di valutazione. + +### Passo 2 – Carica Correttamente il Tuo HTML + +Aspose.HTML può ingerire: + +- Percorsi di file locali (`new Document("file.html")`) +- URL (`new Document("https://example.com")`) +- Stringhe HTML grezze (`new Document("…", new HtmlLoadOptions())`) + +Quando carichi dal file system, assicurati che il percorso sia assoluto o che la directory di lavoro sia impostata correttamente, altrimenti otterrai una `FileNotFoundException`. Su Linux, usa le barre oblique (`/`) o `Path.Combine`. + +### Passo 3 – Scegli le Opzioni di Rendering Giuste + +Oltre a `UseHinting`, potresti voler regolare: + +| Option | What it does | When to use it | +|--------|--------------|----------------| +| `PageSize` | Imposta le dimensioni della pagina PDF (A4, Letter, personalizzate) | Per corrispondere alle dimensioni della carta di destinazione | +| `Landscape` | Ruota la pagina in orizzontale | Tabelle o grafici larghi | +| `RasterizeVectorGraphics` | Forza le grafiche vettoriali a rasterizzarle in immagini | Quando il lettore PDF non supporta SVG | +| `CompressionLevel` | Controlla la compressione delle immagini (0‑9) | Per ridurre la dimensione del file negli allegati email | + +Puoi concatenare queste proprietà in modo fluido: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Passo 4 – Salva il PDF + +Il sovraccarico del metodo `Save` mostrato nell'esempio completo scrive direttamente su un percorso file. Puoi anche inviare il PDF in memoria: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +È utile quando devi restituire il PDF come download da un'API web. + +### Passo 5 – Verifica l'Output + +Un rapido controllo di coerenza è confrontare il conteggio delle pagine PDF con il numero previsto di sezioni HTML. Puoi leggerlo nuovamente con Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Se il conteggio sembra errato, rivedi le regole CSS `page-break` o regola `PdfRenderingOptions` di conseguenza. + +## Casi Limite & Problemi Comuni + +| Situation | What to watch for | Fix | +|-----------|-------------------|-----| +| **Risorse esterne (immagini, font) mancanti** | Gli URL relativi vengono risolti rispetto alla cartella del file HTML. | Usa `HtmlLoadOptions.BaseUri` per puntare alla radice corretta. | +| **Ambiente Linux headless** | Il rendering di testo predefinito può risultare sfocato. | Imposta `UseHinting = true` (come mostrato) e assicurati che `libgdiplus` sia installato se ricorri a System.Drawing. | +| **HTML di grandi dimensioni (> 10 MB)** | Il consumo di memoria aumenta durante il rendering. | Esegui il rendering pagina per pagina usando `PdfRenderer` con `PdfRenderingOptions` e rilascia ogni pagina dopo il salvataggio. | +| **Pagine con molto JavaScript** | Aspose.HTML non esegue JS; il contenuto dinamico rimane statico. | Pre‑processa l'HTML lato server (ad esempio, usando Puppeteer) prima di passarlo ad Aspose.HTML. | +| **Caratteri Unicode visualizzati come quadrati** | Font mancanti nell'ambiente di runtime. | Incorpora font personalizzati tramite `FontSettings` o assicurati che il sistema operativo abbia i font richiesti installati. | + +## Riepilogo dell'Esempio Completo Funzionante + +Ecco di nuovo l'intero programma, privo di commenti per chi preferisce una visuale concisa: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Eseguilo, apri `output.pdf` e vedrai una replica pixel‑perfect di `input.html`. Questa è l'essenza di **convertire html in pdf** con Aspose.HTML. + +## Conclusione + +Abbiamo illustrato tutto ciò di cui hai bisogno per **convertire HTML in PDF** in C#: installare Aspose.HTML, caricare l'HTML, regolare le opzioni di rendering (incluso il cruciale flag `UseHinting`) e salvare il PDF finale. Ora comprendi **come renderizzare HTML in PDF in C#** sia su ambienti Windows che Linux, e hai visto come gestire i casi limite comuni come risorse mancanti e file di grandi dimensioni. + +Cosa fare dopo? Prova ad aggiungere: + +- **Intestazioni/piedi pagina** con `PdfPageTemplate` per il branding. +- **Protezione con password** tramite `PdfSaveOptions`. +- **Conversione batch** iterando su una cartella di + +## Tutorial Correlati + +- [Converti HTML in PDF in .NET con Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Converti EPUB in PDF in .NET con Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Converti SVG in PDF in .NET con Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/italian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/italian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..11499cdcf --- /dev/null +++ b/html/italian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,311 @@ +--- +category: general +date: 2026-05-22 +description: Genera PDF da HTML con C# usando un esempio conciso. Scopri come convertire + HTML in PDF con C# in modo rapido e affidabile. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: it +og_description: Genera PDF da HTML in C# con un esempio chiaro e funzionante. Questa + guida ti mostra come convertire HTML in PDF con C# e generare un PDF da un file + HTML. +og_title: Converti HTML in PDF con C# – Tutorial completo di programmazione +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Converti HTML in PDF in C# – Guida completa passo passo +url: /it/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Generare HTML come PDF in C# – Guida completa passo‑passo + +Ti è mai capitato di dover **render HTML as PDF** ma non eri sicuro quale libreria scegliere per un progetto .NET? Non sei solo. In molte applicazioni line‑of‑business ti troverai a dover **convert HTML to PDF C#** per fatture, report o brochure di marketing—insomma ogni volta che vuoi una versione stampabile di una pagina web. + +Ecco la questione: non devi reinventare la ruota. Con poche righe di codice puoi prendere un file `input.html`, passarne il contenuto a un motore di rendering collaudato e ottenere un nitido `output.pdf`. In questo tutorial percorreremo l'intero processo, dall'aggiunta del pacchetto NuGet corretto alla gestione dei casi limite come i CSS esterni. Alla fine sarai in grado di **generate PDF from HTML file** in pochi minuti. + +## Cosa imparerai + +- Come configurare un'app console .NET che **creates PDF from HTML C#**. +- Le chiamate API esatte di cui hai bisogno per **save HTML document as PDF**. +- Perché alcune opzioni di rendering (come il hinting) influenzano la qualità del testo. +- Suggerimenti per risolvere problemi comuni come font mancanti o percorsi di immagini relativi. + +**Prerequisites** – dovresti avere .NET 6+ o .NET Framework 4.7 installati, una conoscenza di base di C# e un IDE (Visual Studio 2022, Rider o VS Code). Non è necessaria esperienza pregressa con i PDF. + +--- + +## Render HTML as PDF – Configurazione del progetto + +Prima di immergerci nel codice, assicuriamoci che l'ambiente di sviluppo sia pronto. La libreria che useremo è **Select.Pdf** (gratuita per uso non commerciale) perché offre un'API semplice e una fedeltà di rendering solida. + +### Installa la libreria di rendering PDF (convert html to pdf c#) + +Apri un terminale nella cartella del tuo progetto ed esegui: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Se stai usando Visual Studio, puoi anche aggiungere il pacchetto tramite l'interfaccia UI del NuGet Package Manager. Il numero di versione potrebbe essere più recente—prendi semplicemente l'ultima release stabile. + +### Crea uno scheletro console + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Questo è tutto il boilerplate di cui hai bisogno. Il lavoro pesante avviene all'interno di `Main`. + +--- + +## Carica il documento HTML (generate pdf from html file) + +Il primo vero passo è indicare al renderer un file HTML sul disco. Select.Pdf offre due modalità comode: passare una stringa HTML grezza o un percorso file. Usare un file mantiene le cose ordinate, soprattutto quando hai CSS o immagini collegate. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Qui controlliamo anche l'eventualità di un file mancante—qualcosa che blocca i principianti quando dimenticano di copiare l'HTML nella cartella di output. + +--- + +## Configura le opzioni di rendering (create pdf from html c#) + +Select.Pdf fornisce un ricco oggetto `PdfDocumentOptions`. Per ottenere testo nitido abilitiamo il hinting, che leviga i glifi a costo di un piccolo impatto sulle prestazioni. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Puoi modificare la dimensione della pagina, i margini o persino incorporare un font personalizzato qui. Il punto chiave è che **render html as pdf** non è solo una riga di codice; hai il controllo sull'aspetto e la sensazione del documento finale. + +--- + +## Salva il documento HTML come PDF (render html as pdf) + +Ora avviene la magia. Passiamo al convertitore il percorso del nostro file HTML e gli chiediamo di scrivere un PDF sul disco. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +Il metodo `ConvertUrl` risolve automaticamente gli URL relativi (immagini, CSS) in base alla posizione del file HTML, motivo per cui questo approccio è robusto per la maggior parte degli scenari reali. + +### Output previsto + +Dopo aver eseguito il programma dovresti vedere un file `output.pdf` nella stessa cartella. Aprilo—noterai: + +- Testo renderizzato con anti‑aliasing chiaro (grazie al hinting). +- Stili dal CSS collegato applicati correttamente. +- Immagini visualizzate alla dimensione esatta definita nell'HTML di origine. + +Se qualcosa appare sbagliato, verifica che i file CSS e le immagini siano posizionati accanto a `input.html` o usa URL assoluti. + +--- + +## Gestione dei casi limite comuni + +### 1. Risorse esterne bloccate da firewall + +Se il tuo HTML fa riferimento a font ospitati su un CDN a cui il tuo server non può accedere, il PDF potrebbe ricorrere a un font generico. Per evitarlo, scarica i file dei font localmente o incorporali usando `@font-face` con un percorso relativo. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. File HTML molto grandi + +Durante la conversione di documenti massivi, potresti raggiungere i limiti di memoria. Select.Pdf ti permette di eseguire lo streaming della conversione: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Lo streaming mantiene il processo leggero ma richiede di fornire l'HTML come stringa, che puoi leggere a blocchi se necessario. + +### 3. Header o footer personalizzati + +Se ti serve un numero di pagina o il logo aziendale su ogni pagina, imposta le proprietà `Header` e `Footer` su `converter.Options` prima di chiamare `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Esempio completo funzionante (Tutti i passaggi combinati) + +Di seguito trovi il programma completo, pronto per il copia‑incolla. Sostituisci `YOUR_DIRECTORY` con il percorso assoluto dove si trova il tuo HTML. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** `dotnet run` dalla directory del progetto. Se tutto è configurato correttamente vedrai il messaggio di successo e un brillante `output.pdf`. + +--- + +## Riepilogo visivo + +![Render HTML as PDF example](render-html-as-pdf.png){alt="esempio di render html as pdf"} + +Lo screenshot mostra l'output della console e il PDF risultante aperto in un visualizzatore. Nota le intestazioni nitide e le immagini caricate correttamente—esattamente ciò che ti aspetti quando **render html as pdf**. + +--- + +## Conclusione + +Hai appena imparato come **render HTML as PDF** in un'applicazione C#, dall'installazione della libreria alla messa a punto delle opzioni di rendering. L'esempio completo dimostra un modo affidabile per **convert HTML to PDF C#**, **generate PDF from HTML file**, e **save HTML document as PDF** con poche righe di codice. + +Cosa fare dopo? Prova a sperimentare con: + +- Aggiungere font personalizzati per coerenza del brand. +- Generare PDF da stringhe HTML dinamiche (ad esempio, template Razor). +- Unire più PDF in un unico report usando `PdfDocument.AddPage`. + +Ciascuna di queste estensioni si basa sui concetti fondamentali trattati qui, così sarai pronto ad affrontare scenari più avanzati senza una curva di apprendimento ripida. + +Hai domande o hai incontrato un problema? Lascia un commento qui sotto e risolviamo insieme. Buon coding! + +--- + +## Tutorial correlati + +- [Converti HTML in PDF in .NET con Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Crea documento HTML con testo formattato ed esporta in PDF – Guida completa](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Converti HTML in PDF con Aspose.HTML – Guida completa alla manipolazione](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/italian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/italian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..ea4192c9c --- /dev/null +++ b/html/italian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-05-22 +description: Salva HTML come ZIP rapidamente usando Aspose.HTML. Scopri come comprimere + file HTML in ZIP, renderizzare HTML in ZIP e esportare HTML in un file ZIP con il + codice completo. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: it +og_description: Salva HTML come ZIP con Aspose.HTML. Questa guida mostra come convertire + HTML in ZIP, esportare HTML in un file ZIP e comprimere file HTML programmaticamente. +og_title: Salva HTML come ZIP – Tutorial completo di Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Salva HTML come ZIP – Guida completa per Aspose.HTML +url: /it/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Salva HTML come ZIP – Guida Completa per Aspose.HTML + +Ti sei mai chiesto come **salvare HTML come ZIP** senza ricorrere a uno strumento di archiviazione separato? Non sei l’unico. Molti sviluppatori hanno bisogno di raggruppare una pagina HTML insieme alle sue immagini, CSS e script per una distribuzione semplice, e farlo manualmente diventa rapidamente un problema. + +In questo tutorial percorreremo una soluzione pulita, end‑to‑end, che **renderizza HTML in ZIP** usando Aspose.HTML per .NET. Alla fine saprai esattamente come **esportare HTML in un file ZIP**, e vedrai anche variazioni su **come comprimere file HTML** in diversi scenari. + +> *Pro tip:* L’approccio mostrato funziona sia che tu stia impacchettando una singola pagina sia un intero sito. + +## Cosa Ti Serve + +Prima di immergerci, assicurati di avere: + +- .NET 6 (o qualsiasi runtime .NET recente) installato. +- Il pacchetto NuGet Aspose.HTML per .NET (`Aspose.Html`) referenziato nel tuo progetto. +- Un semplice file `input.html` posizionato in una cartella di tua scelta. +- Un po’ di dimestichezza con C#—nulla di complesso, solo le basi. + +Tutto qui. Nessun utility zip esterno, nessuna acrobazia da riga di comando. Iniziamo. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*Image alt text: save html as zip process diagram* + +## Passo 1: Carica il Documento HTML di Origine + +La prima cosa da fare è indicare ad Aspose.HTML dove si trova la nostra sorgente. La classe `HTMLDocument` legge il file e costruisce un DOM in memoria, pronto per il rendering. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Perché è importante: il caricamento del documento dà alla libreria il pieno controllo sulla risoluzione delle risorse (immagini, CSS, font). Se l’HTML fa riferimento a percorsi relativi, Aspose.HTML li risolve automaticamente rispetto alla cartella del file. + +## Passo 2: (Facoltativo) Crea un Gestore di Risorse Personalizzato + +Se hai bisogno di ispezionare o manipolare ogni risorsa—ad esempio vuoi comprimere le immagini prima che vengano inserite nell’archivio—puoi collegare un `ResourceHandler`. Questo passo è opzionale, ma è il modo più flessibile per **convertire HTML in archivio ZIP** con logica personalizzata. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*E se non ti serve alcuna elaborazione speciale?* Salta semplicemente questa classe e usa il gestore predefinito—Aspose.HTML scriverà le risorse direttamente nel ZIP. + +## Passo 3: Configura le Opzioni di Salvataggio per Usare il Gestore + +L’oggetto `HtmlSaveOptions` indica al renderer cosa fare con le risorse. Assegnando il nostro `MyResourceHandler`, otteniamo il pieno controllo sull’output. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Nota come la proprietà `ResourceHandler` faccia riferimento direttamente alla capacità di **render HTML to ZIP**. È qui che avviene la magia: ogni risorsa collegata viene trasmessa nell’archivio invece di essere scritta su disco. + +## Passo 4: Salva il Documento Renderizzato in un Archivio ZIP + +Ora finalmente **esportiamo HTML in un file ZIP**. Il metodo `Save` accetta qualsiasi `Stream`, quindi possiamo puntarlo a un `FileStream` che crea `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Questo è l’intero flusso di lavoro. Quando il codice termina, `result.zip` contiene: + +- `input.html` (il markup originale) +- Tutte le immagini, i file CSS e i font referenziati +- Eventuali risorse trasformate se le hai modificati in `MyResourceHandler` + +## Come Comprimere File HTML senza Aspose.HTML (Alternativa Rapida) + +A volte ti basta un semplice **come comprimere file HTML** tradizionale, magari perché stai già usando un parser HTML diverso. In tal caso puoi utilizzare `System.IO.Compression` integrato in .NET: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Questo metodo è semplice ma non prevede la fase di rendering; impacchetta semplicemente ciò che è su disco. Se il tuo HTML fa riferimento a URL esterni, quelle risorse non verranno incluse. Per questo il percorso Aspose.HTML è preferito quando ti serve una soluzione affidabile di **render HTML to ZIP**. + +## Casi Limite & Problemi Comuni + +| Situazione | Cosa Controllare | Correzione Consigliata | +|-----------|-------------------|------------------------| +| **Immagini di grandi dimensioni** | Picchi di utilizzo della memoria perché ogni immagine è caricata in un `MemoryStream`. | Trasmetti direttamente nello zip usando un gestore personalizzato che copia lo stream di origine invece di bufferizzarlo completamente. | +| **URL esterni** | Le risorse ospitate su internet non vengono scaricate automaticamente. | Imposta `HtmlLoadOptions` con `BaseUrl` che punta alla radice del sito, o scarica manualmente le risorse prima del salvataggio. | +| **Collisioni di nomi file** | Due file CSS con lo stesso nome in cartelle diverse possono sovrascriversi. | Assicurati che il `ResourceHandler` preservi il percorso relativo completo quando scrive nello zip. | +| **Errori di permesso** | Tentare di scrivere in una cartella di sola lettura genera `UnauthorizedAccessException`. | Esegui il processo con i privilegi appropriati o scegli una directory di output scrivibile. | + +Affrontare questi scenari rende la tua routine di **convert HTML to ZIP archive** robusta per l’uso in produzione. + +## Esempio Completo (Tutto Insieme) + +Di seguito trovi il programma completo, pronto per l’esecuzione. Incollalo in una nuova console app, aggiorna i percorsi e premi **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Output previsto:** la console stampa un messaggio di successo, e il file `result.zip` contiene `input.html` più ogni asset dipendente. Apri lo ZIP, fai doppio clic su `input.html` e vedrai la pagina renderizzata esattamente come nel browser—senza immagini mancanti, senza CSS rotto. + +## Riepilogo – Perché Questo Approccio è Fantastico + +- **Rendering in un unico passo:** non devi copiare manualmente ogni risorsa; Aspose.HTML lo fa per te. +- **Pipeline personalizzabile:** il `ResourceHandler` ti dà il pieno controllo su come ogni file viene memorizzato, consentendo compressione, crittografia o trasformazioni on‑the‑fly. +- **Cross‑platform:** funziona su Windows, Linux e macOS purché sia presente il runtime .NET. +- **Nessuno strumento esterno:** l’intero processo di **save HTML as ZIP** vive all’interno del tuo codice C#. + +## Cosa Viene Dopo? + +Ora che hai padroneggiato **save HTML as ZIP**, esplora questi argomenti correlati: + +- **Export HTML to PDF** – perfetto per report stampabili (la conoscenza di `export html to zip file` è utile quando ti servono entrambi i formati). +- **Streaming ZIP direttamente alla risposta HTTP** – ideale per API web che consentono agli utenti di scaricare un sito impacchettato al volo. +- **Crittografia di archivi ZIP** – aggiungi una password se gestisci documentazione confidenziale. + +Sentiti libero di sperimentare: sostituisci `MyResourceHandler` con un compressore che riduce le immagini, o aggiungi un file manifesto che elenca tutte le risorse incluse. Il cielo è il limite quando controlli la pipeline di rendering. + +--- + +*Buon coding! Se incontri difficoltà o hai idee per miglioramenti, lascia un commento qui sotto. Risolveremo tutto insieme.* + +## Tutorial Correlati + +- [Come comprimere HTML in C# – Salva HTML in Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Salva HTML come ZIP – Tutorial Completo C#](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Salva HTML in ZIP in C# – Esempio Completo In‑Memory](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/japanese/net/generate-jpg-and-png-images/_index.md b/html/japanese/net/generate-jpg-and-png-images/_index.md index 57de57175..5133bd867 100644 --- a/html/japanese/net/generate-jpg-and-png-images/_index.md +++ b/html/japanese/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aspose.HTML for .NET を使用して HTML ドキュメントを操作したり DOCX 文書を PNG または JPG 画像に変換する際に、アンチエイリアシングを有効にして高品質な出力を得る手順を解説します。 ### [DOCX を PNG に変換 – ZIP アーカイブを作成する C# チュートリアル](./convert-docx-to-png-create-zip-archive-c-tutorial/) C# で DOCX を PNG に変換し、ZIP アーカイブを作成する方法を学びます。 +### [Word を PNG に変換する際の画像幅と高さの設定 – 完全ガイド](./set-image-width-height-when-converting-word-to-png-full-guid/) +Word 文書を PNG に変換する際に、画像の幅と高さを指定する方法をステップバイステップで解説します。 ## 結論 diff --git a/html/japanese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/japanese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..02262084a --- /dev/null +++ b/html/japanese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,343 @@ +--- +category: general +date: 2026-05-22 +description: Word文書をPNGに変換する際に画像の幅と高さを設定します。ステップバイステップのチュートリアルで、docxを高品質にレンダリングして画像としてエクスポートする方法を学びましょう。 +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: ja +og_description: Word文書をPNGに変換する際に画像の幅と高さを設定します。このチュートリアルでは、高品質設定でdocxを画像としてエクスポートする方法を示します。 +og_title: Word を PNG に変換する際の画像幅・高さの設定 – 完全ガイド +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Word を PNG に変換する際の画像幅と高さの設定 – 完全ガイド +url: /ja/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word を PNG に変換するときに画像の幅と高さを設定する – 完全ガイド + +Ever wondered how to **set image width height** while you **convert Word to PNG**? You're not the only one. Many developers hit a wall when the default export gives a blurry picture or the wrong dimensions, and then they spend hours hunting for a fix that actually works. + +Word を PNG に変換するときに **画像の幅と高さを設定** したいと思ったことはありませんか？ あなただけではありません。デフォルトのエクスポートがぼやけた画像やサイズが合わないと、壁にぶつかる開発者は多く、実際に機能する解決策を探すのに何時間も費やすことになります。 + +In this tutorial we’ll walk through a clean, end‑to‑end solution that shows **how to render word** documents as PNG images, letting you **save docx as PNG** with precise width‑height control and high‑quality antialiasing. By the end you’ll have a ready‑to‑run code snippet, a solid understanding of the API options, and a few pro tips to avoid common pitfalls. + +このチュートリアルでは、**Word をレンダリング**して PNG 画像に変換するクリーンなエンドツーエンドのソリューションを解説します。これにより、**docx を PNG として保存**でき、幅と高さを正確に制御し、高品質なアンチエイリアスが適用されます。最後まで読むと、すぐに実行できるコードスニペット、API オプションの確かな理解、そして一般的な落とし穴を回避するためのプロのヒントが得られます。 + +No external tools, no messy command‑line gymnastics—just pure C# code that you can drop into any .NET project. + +外部ツールや面倒なコマンドライン操作は不要です—任意の .NET プロジェクトに貼り付けられる純粋な C# コードだけです。 + +## What You’ll Learn + +## 学習内容 + +- Load a `.docx` file using Aspose.Words for .NET. +- **Set image width height** with `ImageRenderingOptions`. +- **Export docx as image** (PNG) with antialiasing enabled. +- How to **convert word to png** for a single page or the whole document. +- Tips for handling large documents, DPI considerations, and file‑system paths. + +- Aspose.Words for .NET を使用して `.docx` ファイルを読み込む。 +- `ImageRenderingOptions` で **画像の幅と高さを設定**。 +- アンチエイリアスを有効にした **docx を画像 (PNG) としてエクスポート**。 +- **Word を PNG に変換**する方法（単一ページまたは文書全体）。 +- 大きな文書の処理、DPI の考慮、ファイルシステムパスに関するヒント。 + +## Prerequisites + +## 前提条件 + +Before we dive in, make sure you have the following: + +始める前に、以下が揃っていることを確認してください： + +| Requirement | Why it matters | +|-------------|----------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words は両方をサポートしていますが、最新のランタイムの方がパフォーマンスが向上します。 | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | `Document` クラスとレンダリングエンジンを提供します。 | +| A **Word document** (`.docx`) you want to turn into a PNG. | 変換対象となるソースです。 | +| Basic C# knowledge – you’ll understand `using` statements and object initialization. | 学習コストを低く抑えられます。 | + +If you’re missing the NuGet package, run this in the Package Manager Console: + +NuGet パッケージが不足している場合は、パッケージ マネージャ コンソールで以下を実行してください： + +```powershell +Install-Package Aspose.Words +``` + +That’s it—once the package is in place, you’re ready to start coding. + +以上です—パッケージがインストールされたら、すぐにコーディングを開始できます。 + +## Step 1: Load the Source Document + +## 手順 1: ソース ドキュメントの読み込み + +The very first thing you need to do is point the library at the Word file you want to transform. + +最初に行うべきことは、変換したい Word ファイルをライブラリに指定することです。 + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Why this matters:** The `Document` class reads the entire Word package into memory, giving you access to pages, styles, and everything else. If the path is wrong, you’ll get a `FileNotFoundException`, so double‑check that the file exists and the path uses escaped backslashes (`\\`) or a verbatim string (`@`). + +> **Pro tip:** Wrap the load call in a `try/catch` block if you expect the file might be missing at runtime. + +**なぜ重要か:** `Document` クラスは Word パッケージ全体をメモリに読み込み、ページやスタイルなどすべてにアクセスできるようにします。パスが間違っていると `FileNotFoundException` がスローされるので、ファイルが存在するか、パスがエスケープされたバックスラッシュ (`\\`) または逐語的文字列 (`@`) を使用しているかを必ず確認してください。 + +> **プロのヒント:** 実行時にファイルが存在しない可能性がある場合は、`try/catch` ブロックでロード呼び出しをラップしてください。 + +## Step 2: Configure Image Rendering Options (Set Image Width Height) + +## 手順 2: 画像レンダリング オプションの設定（画像の幅と高さを設定） + +Now comes the heart of the tutorial: **how to set image width height** so the resulting PNG isn’t stretched or pixelated. The `ImageRenderingOptions` class gives you fine‑grained control over dimensions, DPI, and smoothing. + +ここからがチュートリアルの核心です：**画像の幅と高さを設定** して、生成された PNG が伸びたりピクセル化したりしないようにします。`ImageRenderingOptions` クラスは、サイズ、DPI、スムージングを細かく制御できます。 + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Explanation of the key properties:** + +**主要プロパティの説明:** + +- `Width` and `Height` – These are the exact pixel dimensions you want. By setting them, you **set image width height** directly, overriding the default page size. +- `UseAntialiasing` – Enables high‑quality smoothing for text and vector graphics, which is crucial when you **convert word to png** and want crisp edges. +- `Resolution` – Higher DPI yields more detail, especially for complex layouts. Keep an eye on memory usage; a 300 DPI image can be large. + +- `Width` と `Height` – 目的の正確なピクセルサイズです。これらを設定することで、デフォルトのページサイズを上書きし、**画像の幅と高さを直接設定** できます。 +- `UseAntialiasing` – テキストやベクターグラフィックの高品質なスムージングを有効にし、**Word を PNG に変換**して鮮明なエッジを得る際に重要です。 +- `Resolution` – DPI が高いほど詳細が増え、特に複雑なレイアウトで効果的です。メモリ使用量に注意してください。300 DPI の画像は大きくなる可能性があります。 + +> **Why not just rely on the default size?** The default uses the page’s physical dimensions (e.g., A4 at 96 DPI). That often produces a 794 × 1123 pixel image—fine for some cases but not when you need a specific UI thumbnail or a fixed‑size preview. + +> **なぜデフォルトサイズに任せないのか？** デフォルトはページの実寸（例: A4、96 DPI）を使用します。その結果、794 × 1123 ピクセルの画像になることが多く、あるケースでは問題ありませんが、特定の UI サムネイルや固定サイズのプレビューが必要な場合には適しません。 + +## Step 3: Render and Save as PNG (Export Docx as Image) + +## 手順 3: PNG としてレンダリングおよび保存（Docx を画像としてエクスポート） + +With the document loaded and options configured, you can finally **export docx as image**. The `RenderToImage` method does the heavy lifting. + +ドキュメントが読み込まれ、オプションが設定されたら、ついに **docx を画像としてエクスポート** できます。`RenderToImage` メソッドがその重い処理を行います。 + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +If you want to render **the whole document** (all pages) into separate PNG files, loop over the page collection: + +**文書全体**（すべてのページ）を個別の PNG ファイルにレンダリングしたい場合は、ページコレクションをループします： + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**What’s happening under the hood?** The renderer rasterizes each page using the dimensions you supplied, applies antialiasing, and writes a PNG byte stream to disk. Because PNG is lossless, you retain the full fidelity of the original Word layout. + +**内部で何が起きているか？** レンダラは指定したサイズで各ページをラスタライズし、アンチエイリアスを適用して PNG バイトストリームをディスクに書き込みます。PNG はロスレス形式なので、元の Word レイアウトの完全な忠実度が保たれます。 + +**Expected output:** A crisp PNG file exactly 1024 × 768 pixels (or whatever size you set). Open it in any image viewer and you’ll see the Word content rendered exactly as it appears in the original document, but now as a bitmap image. + +**期待される出力:** 設定した通りの 1024 × 768 ピクセルの鮮明な PNG ファイルです（設定したサイズに応じます）。任意の画像ビューアで開くと、元の文書に表示される Word コンテンツがビットマップ画像として正確にレンダリングされていることが確認できます。 + +## Advanced Tips & Variations + +## 上級ヒントとバリエーション + +### 1. Preserve Transparent Backgrounds + +### 1. 透明背景を保持する + +If your Word document contains shapes with transparent backgrounds and you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`: + +Word 文書に透明背景のシェイプが含まれていて、その透明性を保持したい場合は、`BackgroundColor` を `Color.Transparent` に設定します： + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Render Only a Specific Range + +### 2. 特定の範囲のみをレンダリング + +Sometimes you only need a paragraph or a table, not the whole page. Use `DocumentVisitor` to extract the node and render it separately. That’s a more advanced scenario, but it shows **how to render word** content at a granular level. + +場合によっては、ページ全体ではなく段落やテーブルだけが必要なことがあります。`DocumentVisitor` を使用してノードを抽出し、個別にレンダリングします。これはやや高度なシナリオですが、**Word をレンダリング**する方法を細かく制御できることを示しています。 + +### 3. Adjust DPI Dynamically + +### 3. DPI を動的に調整 + +If you need different DPI per page (e.g., high‑resolution for the cover page), modify `Resolution` inside the loop: + +ページごとに異なる DPI が必要な場合（例: カバーページを高解像度にしたい）には、ループ内で `Resolution` を変更します： + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Batch Processing + +### 4. バッチ処理 + +When converting dozens of documents, wrap the whole flow in a method and reuse the same `ImageRenderingOptions` instance. Re‑using the options object reduces allocation overhead. + +数十件の文書を変換する場合は、フロー全体をメソッドにまとめ、同じ `ImageRenderingOptions` インスタンスを再利用します。オプションオブジェクトを再利用することで、割り当てオーバーヘッドが削減されます。 + +## Common Pitfalls & How to Avoid Them + +## よくある落とし穴と回避方法 + +| Symptom | Likely Cause | Fix | +|---------|--------------|-----| +| PNG is blurry despite high DPI | `UseAntialiasing` left `false` | Set `UseAntialiasing = true`. | +| Output size doesn’t match `Width`/`Height` | DPI not considered | Multiply desired size by `Resolution / 96` or adjust `Resolution`. | +| Out‑of‑memory exception on large docs | Rendering whole document at 300 DPI | Render one page at a time, dispose of each image after saving. | +| PNG shows a white background on transparent images | `BackgroundColor` not set | Set `imageOptions.BackgroundColor = Color.Transparent`. | + +| Symptom | Likely Cause | Fix | +|---------|--------------|-----| +| PNG が高 DPI でもぼやけている | `UseAntialiasing` が `false` のまま | `UseAntialiasing = true` を設定する。 | +| 出力サイズが `Width`/`Height` と一致しない | DPI が考慮されていない | 目的サイズに `Resolution / 96` を掛けるか、`Resolution` を調整する。 | +| 大きな文書でメモリ不足例外が発生する | 300 DPI で文書全体をレンダリングしている | ページごとにレンダリングし、保存後に各画像を破棄する。 | +| 透明画像で PNG が白背景になる | `BackgroundColor` が設定されていない | `imageOptions.BackgroundColor = Color.Transparent` を設定する。 | + +## Complete Working Example + +## 完全動作サンプル + +Below is a self‑contained program you can copy‑paste into a console app. It demonstrates **convert word to png**, **save docx as png**, and of course **set image width height**. + +以下は、コンソール アプリにコピー＆ペーストできる自己完結型プログラムです。**Word を PNG に変換**、**docx を PNG として保存**、そしてもちろん **画像の幅と高さを設定** する方法を示しています。 + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Run it:** Build the project, place a valid `input.docx` at the path you specified, and execute. You should see a `output.png` exactly **1024 × 768** pixels, rendered with smooth edges. + +**実行方法:** プロジェクトをビルドし、指定したパスに有効な `input.docx` を配置して実行してください。**1024 × 768** ピクセルの `output.png` が生成され、滑らかなエッジでレンダリングされているはずです。 + +## Related Tutorials + +## 関連チュートリアル + +- [DOCX を PNG/JPG に変換する際のアンチエイリアス有効化方法](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [docx を png に変換 – zip アーカイブ作成 C# チュートリアル](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Aspose を使用して HTML を PNG にレンダリングする方法 – ステップバイステップガイド](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/japanese/net/html-extensions-and-conversions/_index.md b/html/japanese/net/html-extensions-and-conversions/_index.md index 4110fd8e8..ffaf13526 100644 --- a/html/japanese/net/html-extensions-and-conversions/_index.md +++ b/html/japanese/net/html-extensions-and-conversions/_index.md @@ -40,6 +40,9 @@ Aspose.HTML for .NET は単なるライブラリではありません。Web 開 ### [Aspose.HTML を使用して .NET で HTML を PDF に変換する](./convert-html-to-pdf/) Aspose.HTML for .NET を使用すると、HTML を PDF に簡単に変換できます。ステップ バイ ステップ ガイドに従って、HTML から PDF への変換のパワーを解放しましょう。 +### [C# で HTML を PDF に変換する – 完全ガイド](./convert-html-to-pdf-with-c-complete-guide/) +Aspose.HTML for .NET を使用し、C# で HTML を PDF に変換する完全ガイドです。ステップバイステップで解説します。 + ### [HTML から PDF を作成する – C# ステップバイステップ ガイド](./create-pdf-from-html-c-step-by-step-guide/) Aspose.HTML for .NET を使用して、C# で HTML から PDF を作成する手順をステップバイステップで解説します。 @@ -75,9 +78,16 @@ Aspose.HTML for .NET を使用して、HTML コンテンツを ZIP アーカイ ### [C# で HTML を Zip に圧縮する方法 – HTML を Zip に保存](./how-to-zip-html-in-c-save-html-to-zip/) C# と Aspose.HTML を使用して、HTML コンテンツを Zip アーカイブに保存する手順をステップバイステップで解説します。 + ### [C# で HTML を ZIP に保存 – 完全インメモリ例](./save-html-to-zip-in-c-complete-in-memory-example/) Aspose.HTML for .NET を使用して、HTML をメモリ内で ZIP アーカイブに保存する手順をステップバイステップで解説します。 +### [Aspose.HTML を使用して HTML を ZIP に保存する – 完全ガイド](./save-html-as-zip-complete-guide-for-aspose-html/) +Aspose.HTML for .NET を使用し、HTML コンテンツを ZIP アーカイブとして保存する完全ガイドです。ステップバイステップで解説します。 + +### [C# で HTML を PDF にレンダリングする – 完全ステップバイステップガイド](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Aspose.HTML for .NET を使用し、C# で HTML を PDF にレンダリングする完全ガイドです。ステップバイステップで解説します。 + ## 結論 結論として、HTML の拡張と変換は、現代の Web 開発に不可欠な要素です。Aspose.HTML for .NET はプロセスを簡素化し、あらゆるレベルの開発者が利用できるようにします。当社のチュートリアルに従うことで、幅広いスキルを備えた熟練した Web 開発者になるための道を順調に進むことができます。 diff --git a/html/japanese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/japanese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..e233f4f93 --- /dev/null +++ b/html/japanese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,257 @@ +--- +category: general +date: 2026-05-22 +description: Aspose.HTML を使用して C# で HTML を PDF に変換します。ステップバイステップのコード、オプション、Linux に関するヒントとともに、C# + で HTML を PDF にレンダリングする方法を学びましょう。 +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: ja +og_description: Aspose.HTML を使用して C# で HTML を PDF に変換します。このガイドでは、明確なオプションと Linux フレンドリーなヒントを用いて + C# で HTML を PDF にレンダリングする方法を示します。 +og_title: C#でHTMLをPDFに変換する – 完全ガイド +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: C#でHTMLをPDFに変換する – 完全ガイド +url: /ja/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C# で HTML を PDF に変換する – 完全ガイド + +HTML を **変換** する必要がある場合、Aspose.HTML for .NET を使えば簡単です。このチュートリアルでは、**C# で HTML を PDF にレンダリングする方法** を、レンダリングオプションを完全に制御できる形で解説するので、推測に頼ることはありません。 + +マーケティング用メールテンプレートや領収書ページ、あるいは最新の CSS で構築された複雑なレポートがあり、それをクライアントやプリンター向けに PDF として渡す必要があると想像してください。手作業で行うのは面倒ですが、数行の C# コードで全工程を自動化できます。このガイドの最後までに、Windows と Linux の両方で動作する、自己完結型の本番環境向けソリューションが手に入ります。 + +## 必要なもの + +- **.NET 6.0 以降** – Aspose.HTML は .NET Standard 2.0+ を対象としているため、最新の SDK ならどれでも動作します。 +- **Aspose.HTML for .NET** NuGet パッケージ (`Aspose.Html`) – 本番環境では有効なライセンスが必要ですが、テスト用には無料トライアルで動作します。 +- PDF に変換したい **シンプルな HTML ファイル**（ここでは `input.html` と呼びます）。 +- お好みの IDE（Visual Studio、Rider、または VS Code） – 特別なツールは不要です。 + +以上です。外部の PDF コンバータやコマンドラインでの手間は不要です。純粋に C# だけです。 + +![Aspose.HTML を使用した HTML から PDF への変換ワークフローを示す図](/images/convert-html-to-pdf-workflow.png "HTML から PDF への変換ワークフロー") + +## HTML を PDF に変換する – 完全実装 + +以下は完全な、すぐに実行できるプログラムです。新しいコンソールアプリにコピー＆ペーストし、NuGet パッケージを復元して **F5** を押してください。 + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### これが機能する理由 + +- **`Document`** は Aspose.HTML のエントリーポイントです。HTML を解析し、CSS を解決し、レンダリング可能な DOM を構築します。 +- **`PdfRenderingOptions`** で出力を調整できます。`UseHinting` フラグは、デフォルトのラスタライザがぼやけがちになるヘッドレス Linux コンテナで、鮮明なテキストを実現する秘訣です。 +- **`Save`** が本格的な処理を行います。DOM を PDF ページにラスタライズし、改ページを尊重し、フォントを自動的に埋め込みます。 + +プログラムを実行すると、ソースファイルと同じディレクトリに `output.pdf` が生成されます。任意の PDF ビューアで開くと、元の HTML と忠実に一致したビジュアルが確認できるはずです。 + +## C# で HTML を PDF にレンダリングする方法 – ステップバイステップ + +以下では、プロセスを小さなステップに分解し、**C# で HTML を PDF にレンダリングする方法** を解説しながら、一般的な落とし穴についても説明します。 + +### ステップ 1 – Aspose.HTML NuGet パッケージのインストール + +プロジェクトフォルダーでターミナルを開き、次のコマンドを実行します。 + +```bash +dotnet add package Aspose.Html +``` + +Visual Studio の UI が好みの場合は、プロジェクトを右クリック → **Manage NuGet Packages** → **Aspose.Html** を検索し、最新の安定版をインストールしてください。 + +> **プロのコツ:** インストール後、プロジェクトのルートにライセンスファイル (`Aspose.Total.lic`) を追加すると、評価版の透かしを回避できます。 + +### ステップ 2 – HTML を正しく読み込む + +Aspose.HTML は以下を受け取れます： + +- ローカルファイルパス (`new Document("file.html")`) +- URL (`new Document("https://example.com")`) +- 生の HTML 文字列 (`new Document("…", new HtmlLoadOptions())`) + +ファイルシステムから読み込む場合、パスが絶対パスであるか、作業ディレクトリが適切に設定されていることを確認してください。そうでないと `FileNotFoundException` が発生します。Linux ではスラッシュ (`/`) を使用するか、`Path.Combine` を利用してください。 + +### ステップ 3 – 適切なレンダリングオプションを選択する + +`UseHinting` に加えて、以下を調整したいかもしれません： + +| オプション | 機能 | 使用するタイミング | +|------------|------|-------------------| +| `PageSize` | PDF ページのサイズを設定します（A4、Letter、カスタム） | 対象の用紙サイズに合わせる | +| `Landscape` | ページを横向きに回転させます | 幅の広いテーブルやチャートの場合 | +| `RasterizeVectorGraphics` | ベクターグラフィックをラスタ画像に変換します | PDF ビューアが SVG に対応していない場合 | +| `CompressionLevel` | 画像圧縮レベルを制御します（0‑9） | メール添付用にファイルサイズを削減したいとき | + +これらのプロパティは流暢にチェーンできます： + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### ステップ 4 – PDF を保存する + +`Save` メソッドのオーバーロードは、完全な例で示したようにファイルパスへ直接書き込みます。また、PDF をメモリにストリームすることも可能です。 + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Web API から PDF をダウンロードとして返す必要がある場合に便利です。 + +### ステップ 5 – 出力を検証する + +簡易的なチェックとして、PDF のページ数を期待される HTML のセクション数と比較します。Aspose.PDF を使って読み取ることができます。 + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +ページ数が合わない場合は、CSS の `page-break` ルールを見直すか、`PdfRenderingOptions` を適切に調整してください。 + +## エッジケースとよくある落とし穴 + +| 状況 | 注意点 | 対策 | +|------|--------|------| +| **外部リソース（画像、フォント）の欠如** | 相対 URL は HTML ファイルのフォルダーを基準に解決されます。 | `HtmlLoadOptions.BaseUri` を使用して正しいルートを指定します。 | +| **Linux ヘッドレス環境** | デフォルトのテキストレンダリングがぼやけることがあります。 | `UseHinting = true` を設定し（上記参照）、System.Drawing にフォールバックする場合は `libgdiplus` がインストールされていることを確認してください。 | +| **大きな HTML（> 10 MB）** | レンダリング中にメモリ使用量が急増します。 | `PdfRenderer` と `PdfRenderingOptions` を使用してページ単位でレンダリングし、保存後に各ページを破棄します。 | +| **JavaScript が多用されたページ** | Aspose.HTML は JavaScript を実行せず、動的コンテンツは静的なままです。 | Aspose.HTML に渡す前に、サーバー側で HTML を事前処理（例: Puppeteer を使用）してください。 | +| **Unicode 文字が四角で表示される** | 実行環境にフォントが欠如している。 | `FontSettings` でカスタムフォントを埋め込むか、OS に必要なフォントがインストールされていることを確認してください。 | + +## 完全動作例のまとめ + +コメントを除いた、簡潔な形の全プログラムを再掲します。 + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +実行して `output.pdf` を開くと、`input.html` とピクセル単位で一致するコピーが確認できます。これが Aspose.HTML を使った **HTML を PDF に変換** の本質です。 + +## 結論 + +C# で **HTML を PDF に変換** するために必要なすべての手順を解説しました：Aspose.HTML のインストール、HTML の読み込み、レンダリングオプションの調整（重要な `UseHinting` フラグを含む）、最終的な PDF の保存です。これで Windows と Linux の両環境で **C# で HTML を PDF にレンダリングする方法** が理解でき、リソース欠如や大容量ファイルといった一般的なエッジケースへの対処方法も把握できました。 + +次は何をしますか？以下を試してみてください： + +- **Headers/footers** を `PdfPageTemplate` で追加し、ブランディングに活用する。 +- `PdfSaveOptions` を使用した **パスワード保護**。 +- フォルダー内のファイルをループして **バッチ変換** を行う。 + +## 関連チュートリアル + +- [Aspose.HTML を使用した .NET での HTML から PDF への変換](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Aspose.HTML を使用した .NET での EPUB から PDF への変換](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Aspose.HTML を使用した .NET での SVG から PDF への変換](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/japanese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/japanese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..200c246f9 --- /dev/null +++ b/html/japanese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,296 @@ +--- +category: general +date: 2026-05-22 +description: C# を使用して HTML を PDF にレンダリングする簡潔な例。HTML を PDF に迅速かつ確実に変換する方法を学びましょう。 +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: ja +og_description: C#でHTMLをPDFに変換する、分かりやすく実行可能なサンプル付き。このガイドでは、HTMLをC#でPDFに変換し、HTMLファイルからPDFを生成する方法を示します。 +og_title: C#でHTMLをPDFに変換 – 完全プログラミングチュートリアル +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: C#でHTMLをPDFとしてレンダリングする – 完全ステップバイステップガイド +url: /ja/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#でHTMLをPDFにレンダリングする – 完全ステップバイステップガイド + +Ever needed to **render HTML as PDF** but weren’t sure which library to pick for a .NET project? You’re not alone. In many line‑of‑business apps you’ll find yourself needing to **convert HTML to PDF C#** for invoices, reports, or marketing brochures—basically any time you want a printable version of a web page. + +HTMLをPDFとして**render HTML as PDF**したいと思ったことはありますか、でも.NETプロジェクトでどのライブラリを選べば良いか分からなかったことはありませんか？ あなたは一人ではありません。多くの業務アプリケーションでは、請求書、レポート、マーケティングパンフレットなど、**convert HTML to PDF C#** を変換する必要があります—要するにウェブページの印刷可能なバージョンが欲しい時です。 + +Here’s the thing: you don’t have to reinvent the wheel. With a few lines of code you can take an `input.html` file, feed it to a proven rendering engine, and end up with a crisp `output.pdf`. In this tutorial we’ll walk through the entire process, from adding the right NuGet package to handling edge‑cases like external CSS. By the end you’ll be able to **generate PDF from HTML file** in a matter of minutes. + +ポイントは、車輪の再発明をする必要はないということです。数行のコードで `input.html` ファイルを取得し、実績のあるレンダリングエンジンに渡すだけで、鮮明な `output.pdf` が得られます。このチュートリアルでは、適切な NuGet パッケージの追加から外部 CSS のようなエッジケースの処理まで、全工程を解説します。最後まで読めば、数分で **generate PDF from HTML file** ができるようになります。 + +## 学べること + +- **creates PDF from HTML C#** コードを使用した .NET コンソールアプリのセットアップ方法。 +- **save HTML document as PDF** に必要な正確な API 呼び出し。 +- テキスト品質に影響する特定のレンダリングオプション（ヒンティングなど）が重要な理由。 +- フォントが見つからない、画像パスが相対的など、一般的な落とし穴のトラブルシューティングのヒント。 + +**Prerequisites** – .NET 6+ または .NET Framework 4.7 がインストールされており、C# の基本的な知識と IDE（Visual Studio 2022、Rider、または VS Code）を持っていることが必要です。PDF の経験は不要です。 + +--- + +## HTMLをPDFとしてレンダリング – プロジェクトのセットアップ + +コードに入る前に、開発環境が整っていることを確認しましょう。使用するライブラリは **Select.Pdf**（非商用利用は無料）で、シンプルな API と高いレンダリング忠実度を提供します。 + +### PDFレンダリングライブラリのインストール（convert html to pdf c#） + +プロジェクトフォルダーでターミナルを開き、以下を実行します： + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Visual Studio を使用している場合、NuGet パッケージ マネージャ UI からもパッケージを追加できます。バージョン番号は新しい可能性がありますので、最新の安定版を取得してください。 + +### コンソールの雛形作成 + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +これで必要なボイラープレートは完了です。実際の処理は `Main` 内で行われます。 + +## HTMLドキュメントのロード（generate pdf from html file） + +最初の実際のステップは、レンダラにディスク上の HTML ファイルを指定することです。Select.Pdf は、生の HTML 文字列を渡す方法とファイルパスを渡す方法の二つを提供します。CSS や画像がリンクされている場合、ファイルを使用する方が整理しやすいです。 + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +ここでは、ファイルが存在しない場合に備えてチェックも行っています。これは、初心者が HTML を出力フォルダーにコピーし忘れるとよく起こる問題です。 + +## レンダリングオプションの設定（create pdf from html c#） + +Select.Pdf には豊富な `PdfDocumentOptions` オブジェクトが用意されています。鮮明なテキストを得るためにヒンティングを有効にしますが、これによりわずかなパフォーマンス低下が発生します。 + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +ここでページサイズ、余白、あるいはカスタムフォントの埋め込みなどを調整できます。重要なポイントは、**render html as pdf** が単なるワンライナーではなく、最終ドキュメントの外観や感触を制御できるということです。 + +## HTMLドキュメントをPDFとして保存（render html as pdf） + +さあ、ここで魔法が起きます。コンバータに HTML ファイルへのパスを渡し、PDF をディスクに書き出すよう指示します。 + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +`ConvertUrl` メソッドは、HTML ファイルの場所を基準に相対 URL（画像、CSS）を自動的に解決します。そのため、このアプローチは実際のシナリオで堅牢です。 + +### 期待される出力 + +プログラムを実行すると、同じフォルダーに `output.pdf` が生成されます。開いてみると、以下が確認できます： + +- ヒンティングのおかげで、クリアなアンチエイリアスが適用されたテキスト。 +- リンクされた CSS のスタイルが正しく適用されている。 +- ソース HTML で定義されたサイズ通りに画像が表示されている。 + +何かが期待通りでない場合は、CSS と画像ファイルが `input.html` と同じ場所に配置されているか、絶対 URL を使用しているかを再確認してください。 + +## 一般的なエッジケースの処理 + +### 1. ファイアウォールによってブロックされた外部リソース + +HTML がサーバーからアクセスできない CDN 上のフォントを参照している場合、PDF は汎用フォントにフォールバックすることがあります。これを防ぐには、フォントファイルをローカルにダウンロードするか、相対パスで `@font-face` を使用して埋め込んでください。 + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. 非常に大きな HTML ファイル + +大容量のドキュメントを変換する際、メモリ制限に達することがあります。Select.Pdf は変換をストリーミングする機能を提供します： + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +ストリーミングはプロセスを軽量に保ちますが、HTML を文字列として提供する必要があります。必要に応じてチャンク単位で読み込むことが可能です。 + +### 3. カスタムヘッダーまたはフッター + +各ページにページ番号や会社ロゴを入れたい場合は、`ConvertUrl` を呼び出す前に `converter.Options` の `Header` と `Footer` プロパティを設定してください。 + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +## 完全動作例（全ステップ統合） + +以下は完全なコピー＆ペースト可能なプログラムです。`YOUR_DIRECTORY` を HTML が存在する絶対パスに置き換えてください。 + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** プロジェクトディレクトリで `dotnet run` を実行します。設定が正しければ、成功メッセージと光るような `output.pdf` が表示されます。 + +## ビジュアルサマリー + +![Render HTML as PDF example](render-html-as-pdf.png){alt="render html as pdf example"} + +このスクリーンショットはコンソール出力と、ビューアで開いた結果の PDF を示しています。鮮明な見出しと正しく読み込まれた画像に注目してください—**render html as pdf** で期待される通りです。 + +## 結論 + +これで、C# アプリケーションで **render HTML as PDF** を行う方法、ライブラリのインストールからレンダリングオプションの微調整までを学びました。完全な例は、**convert HTML to PDF C#**、**generate PDF from HTML file**、そして **save HTML document as PDF** を数行のコードで実現する信頼できる手法を示しています。 + +What’s next? Try experimenting with: + +- ブランドの一貫性のためにカスタムフォントを追加する。 +- 動的な HTML 文字列（例：Razor テンプレート）から PDF を生成する。 +- `PdfDocument.AddPage` を使用して複数の PDF を単一のレポートに結合する。 + +これらの拡張はここで扱った基本概念に基づいているため、急な学習曲線なしで高度なシナリオに取り組む準備が整います。 + +質問や問題があれば、下にコメントを残してください。一緒にトラブルシューティングしましょう。コーディングを楽しんで！ + +## 関連チュートリアル + +- [Aspose.HTML を使用した .NET での HTML から PDF への変換](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [スタイル付きテキストで HTML ドキュメントを作成し、PDF にエクスポートする – 完全ガイド](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Aspose.HTML を使用した HTML から PDF への変換 – 完全操作ガイド](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/japanese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/japanese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..196a5f244 --- /dev/null +++ b/html/japanese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,222 @@ +--- +category: general +date: 2026-05-22 +description: Aspose.HTML を使用して HTML を ZIP にすばやく保存します。HTML ファイルを ZIP に圧縮する方法、HTML を + ZIP にレンダリングする方法、完全なコードで HTML を ZIP ファイルにエクスポートする方法を学びましょう。 +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: ja +og_description: Aspose.HTMLでHTMLをZIPとして保存します。このガイドでは、HTMLをZIPにレンダリングする方法、HTMLをZIPファイルにエクスポートする方法、そしてHTMLファイルをプログラムでZIPに圧縮する方法を示します。 +og_title: HTMLをZIPとして保存 – 完全なAspose.HTMLチュートリアル +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: HTML を ZIP に保存 – Aspose.HTML 完全ガイド +url: /ja/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML を ZIP として保存 – Aspose.HTML 完全ガイド + +別のアーカイブツールを使わずに **HTML を ZIP として保存** できるか、考えたことはありませんか？ あなただけではありません。多くの開発者が、HTML ページとその画像、CSS、スクリプトを一緒にパッケージ化して配布しやすくする必要があり、手作業で行うとすぐに面倒になります。 + +このチュートリアルでは、Aspose.HTML for .NET を使用して **HTML を ZIP にレンダリング** するクリーンなエンドツーエンドのソリューションを順を追って解説します。最後まで読むと、**HTML を ZIP ファイルにエクスポート** する方法が正確に分かり、さまざまなシナリオでの **HTML ファイルを ZIP にする方法** のバリエーションも確認できます。 + +> *プロのコツ:* このアプローチは、単一ページでもサイト全体のフォルダーでもパッケージ化に機能します。 + +## 必要なもの + +- .NET 6（または最近の .NET ランタイム）をインストール済み。 +- プロジェクトで参照されている Aspose.HTML for .NET NuGet パッケージ（`Aspose.Html`）。 +- 任意のフォルダーに配置したシンプルな `input.html` ファイル。 +- 基本的な C# の知識—特別なことは不要です。 + +それだけです。外部の zip ユーティリティやコマンドライン操作は不要です。さっそく始めましょう。 + +![Aspose.HTML を使用した HTML を ZIP として保存するプロセスの図](save-html-as-zip.png) + +*画像の代替テキスト: save html as zip process diagram* + +## 手順 1: ソース HTML ドキュメントの読み込み + +最初に行うべきことは、Aspose.HTML にソースの場所を伝えることです。`HTMLDocument` クラスはファイルを読み取り、メモリ内 DOM を構築し、レンダリングの準備をします。 + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +なぜ重要かというと、ドキュメントをロードすることでライブラリはリソース解決（画像、CSS、フォント）を完全にコントロールできるようになるからです。HTML が相対パスを参照している場合、Aspose.HTML は自動的にファイルのフォルダーを基準に解決します。 + +## 手順 2: (オプション) カスタム リソース ハンドラの作成 + +各リソースを検査または操作したい場合—たとえばアーカイブに入れる前に画像を圧縮したい場合—`ResourceHandler` を差し込むことができます。このステップはオプションですが、カスタムロジックで **HTML を ZIP アーカイブに変換** する最も柔軟な方法です。 + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*特別な処理が不要な場合は?* このクラスを省略し、デフォルトハンドラを使用してください。Aspose.HTML がリソースを直接 ZIP に書き込みます。 + +## 手順 3: ハンドラを使用するように保存オプションを設定 + +`HtmlSaveOptions` オブジェクトは、レンダラに対してリソースの取り扱い方法を指示します。`MyResourceHandler` を割り当てることで、出力を完全にコントロールできます。 + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +`ResourceHandler` というプロパティ名が **HTML を ZIP にレンダリング** 機能を直接参照していることに注目してください。ここが魔法の場所で、すべてのリンクリソースがディスクに書き込まれる代わりにアーカイブへストリームされます。 + +## 手順 4: レンダリングされたドキュメントを ZIP アーカイブに保存 + +いよいよ **HTML を ZIP ファイルにエクスポート** です。`Save` メソッドは任意の `Stream` を受け取るので、`result.zip` を作成する `FileStream` を指定できます。 + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +これでワークフローは完了です。コードが終了すると、`result.zip` には以下が含まれます： + +- `input.html`（元のマークアップ） +- 参照されているすべての画像、CSS ファイル、フォント +- `MyResourceHandler` で加工したリソース（あれば） + +## Aspose.HTML を使用せずに HTML ファイルを ZIP にする方法 (簡易代替手段) + +場合によっては、別の HTML パーサーをすでに使用しているため、シンプルな **HTML ファイルを ZIP にする方法** が必要になることがあります。その場合は .NET 標準の `System.IO.Compression` を利用できます： + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +この方法はシンプルですが、レンダリングステップが欠如しています。ディスク上にあるものだけをパックするだけです。HTML が外部 URL を参照している場合、これらのリソースは含まれません。そのため、信頼性の高い **HTML を ZIP にレンダリング** ソリューションが必要なときは Aspose.HTML のルートが推奨されます。 + +## エッジケースと一般的な落とし穴 + +| シチュエーション | 注意点 | 推奨対策 | +|-----------|-------------------|-----------------| +| **大きな画像** | 各画像が `MemoryStream` に読み込まれるためメモリ使用量が急増する。 | カスタムハンドラでソースストリームを直接 zip にコピーし、完全バッファリングを回避する。 | +| **外部 URL** | インターネット上にホストされたリソースは自動的にダウンロードされない。 | `HtmlLoadOptions` の `BaseUrl` をサイトルートに設定するか、保存前にリソースを手動でダウンロードする。 | +| **ファイル名の衝突** | 異なるサブフォルダーに同名の CSS ファイルがあると上書きされる可能性がある。 | `ResourceHandler` が zip に書き込む際にフル相対パスを保持するようにする。 | +| **権限エラー** | 読み取り専用フォルダーに書き込もうとすると `UnauthorizedAccessException` がスローされる。 | 適切な権限でプロセスを実行するか、書き込み可能な出力ディレクトリを選択する。 | + +これらのシナリオに対処することで、**HTML を ZIP アーカイブに変換** するルーチンを本番環境でも頑丈に運用できます。 + +## 完全動作サンプル (すべてのパーツを統合) + +以下は完成した、すぐに実行できるプログラムです。新しいコンソール アプリに貼り付け、パスを更新して **F5** を押してください。 + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**期待される出力:** コンソールに成功メッセージが表示され、`result.zip` には `input.html` とすべての依存アセットが含まれます。ZIP を開き、`input.html` をダブルクリックすれば、ブラウザで表示されたのと同じページが欠損画像や壊れた CSS なしでレンダリングされます。 + +## まとめ – このアプローチが優れている理由 + +- **シングルステップレンダリング:** 各リソースを手動でコピーする必要はなく、Aspose.HTML が自動で処理します。 +- **カスタマイズ可能なパイプライン:** `ResourceHandler` により、各ファイルの保存方法を完全に制御でき、圧縮・暗号化・オンザフライ変換が可能です。 +- **クロスプラットフォーム:** .NET ランタイムさえあれば、Windows、Linux、macOS で動作します。 +- **外部ツール不要:** **HTML を ZIP として保存** の全プロセスが C# コードベース内に完結します。 + +## 次は何をすべきか？ + +**HTML を ZIP として保存** をマスターした今、以下の関連トピックもぜひ探求してください： + +- **HTML を PDF にエクスポート** – 印刷レポートに最適（`export html to zip file` の知識が両方のフォーマットで役立ちます）。 +- **ZIP を HTTP 応答に直接ストリーミング** – ユーザーがオンザフライでパッケージ化されたサイトをダウンロードできる Web API に最適。 +- **ZIP アーカイブの暗号化** – 機密文書を扱う場合にパスワード保護を追加。 + +自由に実験してみてください。`MyResourceHandler` を画像圧縮コンプレッサに差し替えたり、すべてのバンドルリソースを列挙するマニフェスト ファイルを追加したり。レンダリング パイプラインを制御すれば、可能性は無限です。 + +*ハッピーコーディング！問題が発生したり改善アイデアがあれば、下のコメントで教えてください。一緒に解決しましょう。* + +## 関連チュートリアル + +- [C# で HTML を ZIP にする方法 – HTML を ZIP に保存](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [HTML を ZIP として保存 – 完全 C# チュートリアル](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [C# で HTML を ZIP に保存 – 完全インメモリ例](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/korean/net/generate-jpg-and-png-images/_index.md b/html/korean/net/generate-jpg-and-png-images/_index.md index 2f2fd11d0..199f586ef 100644 --- a/html/korean/net/generate-jpg-and-png-images/_index.md +++ b/html/korean/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aspose.HTML for .NET을 .NET 프로젝트에 통합하는 것은 번거롭지 DOCX 문서를 PNG 또는 JPG 이미지로 변환할 때 안티앨리어싱을 적용하는 방법을 단계별로 안내합니다. ### [DOCX를 PNG로 변환하고 ZIP 아카이브 만들기 C# 튜토리얼](./convert-docx-to-png-create-zip-archive-c-tutorial/) C#을 사용해 DOCX 파일을 PNG 이미지로 변환하고, 결과를 ZIP 파일로 압축하는 방법을 단계별로 안내합니다. +### [Word를 PNG로 변환할 때 이미지 너비와 높이 설정 – 전체 가이드](./set-image-width-height-when-converting-word-to-png-full-guid/) +Word 문서를 PNG 이미지로 변환하면서 원하는 너비와 높이를 지정하는 방법을 단계별로 안내합니다. ## 결론 diff --git a/html/korean/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/korean/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..d8f89fd7e --- /dev/null +++ b/html/korean/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,272 @@ +--- +category: general +date: 2026-05-22 +description: Word 문서를 PNG로 변환할 때 이미지의 가로·세로 크기를 설정하세요. 단계별 튜토리얼을 통해 고품질 렌더링으로 docx를 + 이미지로 내보내는 방법을 배워보세요. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: ko +og_description: Word 문서를 PNG로 변환할 때 이미지의 너비와 높이를 설정합니다. 이 튜토리얼에서는 고품질 설정으로 docx를 이미지로 + 내보내는 방법을 보여줍니다. +og_title: 워드를 PNG로 변환할 때 이미지 가로·세로 크기 설정 – 완전 가이드 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: 워드에서 PNG로 변환할 때 이미지 가로·세로 크기 설정 – 전체 가이드 +url: /ko/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word를 PNG로 변환할 때 이미지 너비와 높이 설정 – 완전 가이드 + +Word를 PNG로 **변환**하면서 **이미지 너비와 높이 설정** 방법이 궁금하셨나요? 당신만 그런 것이 아닙니다. 기본 내보내기가 흐릿한 이미지나 잘못된 크기를 제공할 때 많은 개발자들이 난관에 부딪히고, 실제로 작동하는 해결책을 찾기 위해 몇 시간을 소비합니다. + +이 튜토리얼에서는 **Word 문서를 PNG 이미지로 렌더링하는 방법**을 보여주는 깔끔한 엔드‑투‑엔드 솔루션을 단계별로 안내합니다. 이를 통해 **docx를 PNG로 저장**하면서 정확한 너비‑높이 제어와 고품질 안티앨리어싱을 적용할 수 있습니다. 마지막까지 진행하면 바로 실행 가능한 코드 스니펫, API 옵션에 대한 확실한 이해, 그리고 일반적인 함정을 피할 수 있는 몇 가지 팁을 얻을 수 있습니다. + +## 배울 내용 + +- Aspose.Words for .NET를 사용하여 `.docx` 파일을 로드합니다. +- `ImageRenderingOptions`를 사용하여 **이미지 너비와 높이 설정**. +- 안티앨리어싱이 활성화된 **docx를 이미지(PNG)로 내보내기**. +- 단일 페이지 또는 전체 문서에 대해 **Word를 PNG로 변환**하는 방법. +- 대용량 문서 처리, DPI 고려 사항 및 파일 시스템 경로에 대한 팁. + +외부 도구 없이, 복잡한 명령줄 작업 없이—그냥 순수 C# 코드만 있으면 어느 .NET 프로젝트에든 바로 넣어 사용할 수 있습니다. + +--- + +## 사전 요구 사항 + +Before we dive in, make sure you have the following: + +| Requirement | Why it matters | +|-------------|----------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words가 두 환경을 모두 지원하지만, 최신 런타임이 더 나은 성능을 제공합니다. | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | `Document` 클래스와 렌더링 엔진을 제공합니다. | +| A **Word document** (`.docx`) you want to turn into a PNG. | 변환할 원본 파일입니다. | +| Basic C# knowledge – you’ll understand `using` statements and object initialization. | 학습 난이도를 낮춰줍니다. | + +If you’re missing the NuGet package, run this in the Package Manager Console: + +```powershell +Install-Package Aspose.Words +``` + +That’s it—once the package is in place, you’re ready to start coding. + +--- + +## 1단계: 소스 문서 로드 + +The very first thing you need to do is point the library at the Word file you want to transform. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**왜 중요한가:** The `Document` class reads the entire Word package into memory, giving you access to pages, styles, and everything else. If the path is wrong, you’ll get a `FileNotFoundException`, so double‑check that the file exists and the path uses escaped backslashes (`\\`) or a verbatim string (`@`). + +> **팁:** 런타임에 파일이 없을 수 있다고 예상된다면 `try/catch` 블록으로 로드 호출을 감싸세요. + +--- + +## 2단계: 이미지 렌더링 옵션 구성 (이미지 너비와 높이 설정) + +Now comes the heart of the tutorial: **how to set image width height** so the resulting PNG isn’t stretched or pixelated. The `ImageRenderingOptions` class gives you fine‑grained control over dimensions, DPI, and smoothing. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**주요 속성 설명:** + +- `Width` 및 `Height` – 원하는 정확한 픽셀 크기입니다. 이를 설정하면 기본 페이지 크기를 무시하고 **이미지 너비와 높이 직접 설정**이 가능합니다. +- `UseAntialiasing` – 텍스트와 벡터 그래픽에 고품질 스무딩을 활성화합니다. 이는 **Word를 PNG로 변환**하면서 선명한 가장자리를 원할 때 필수적입니다. +- `Resolution` – DPI가 높을수록 세부 사항이 늘어나며, 특히 복잡한 레이아웃에서 유용합니다. 메모리 사용량을 주시하세요; 300 DPI 이미지는 크기가 클 수 있습니다. + +> **왜 기본 크기에만 의존하지 않나요?** 기본값은 페이지의 물리적 크기(예: A4, 96 DPI)를 사용합니다. 이는 종종 794 × 1123 픽셀 이미지를 생성하는데, 일부 경우에는 괜찮지만 특정 UI 썸네일이나 고정 크기 미리보기가 필요할 때는 적합하지 않습니다. + +--- + +## 3단계: 렌더링 및 PNG 저장 (Docx를 이미지로 내보내기) + +With the document loaded and options configured, you can finally **export docx as image**. The `RenderToImage` method does the heavy lifting. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +If you want to render **the whole document** (all pages) into separate PNG files, loop over the page collection: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**내부 동작은?** The renderer rasterizes each page using the dimensions you supplied, applies antialiasing, and writes a PNG byte stream to disk. Because PNG is lossless, you retain the full fidelity of the original Word layout. + +**예상 출력:** 정확히 1024 × 768 픽셀(또는 설정한 크기)의 선명한 PNG 파일입니다. 이미지 뷰어에서 열면 원본 문서에 표시된 Word 내용이 그대로 비트맵 이미지로 렌더링된 것을 확인할 수 있습니다. + +--- + +## 고급 팁 및 변형 + +### 1. 투명 배경 유지 + +If your Word document contains shapes with transparent backgrounds and you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. 특정 범위만 렌더링 + +Sometimes you only need a paragraph or a table, not the whole page. Use `DocumentVisitor` to extract the node and render it separately. That’s a more advanced scenario, but it shows **how to render word** content at a granular level. + +### 3. DPI 동적 조정 + +If you need different DPI per page (e.g., high‑resolution for the cover page), modify `Resolution` inside the loop: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. 배치 처리 + +When converting dozens of documents, wrap the whole flow in a method and reuse the same `ImageRenderingOptions` instance. Re‑using the options object reduces allocation overhead. + +--- + +## 흔히 발생하는 문제와 해결 방법 + +| Symptom | Likely Cause | Fix | +|---------|--------------|-----| +| 고 DPI에도 PNG가 흐릿함 | `UseAntialiasing` left `false` | Set `UseAntialiasing = true`. | +| `Width`/`Height`와 출력 크기가 일치하지 않음 | DPI가 고려되지 않음 | Multiply desired size by `Resolution / 96` or adjust `Resolution`. | +| 대용량 문서에서 메모리 부족 예외 발생 | 전체 문서를 300 DPI로 렌더링 | 한 번에 한 페이지씩 렌더링하고, 저장 후 각 이미지를 해제하세요. | +| 투명 이미지에서 PNG가 흰색 배경으로 표시됨 | `BackgroundColor` not set | Set `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## 완전 작동 예제 + +Below is a self‑contained program you can copy‑paste into a console app. It demonstrates **convert word to png**, **save docx as png**, and of course **set image width height**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**실행 방법:** 프로젝트를 빌드하고, 지정한 경로에 유효한 `input.docx`를 배치한 뒤 실행하세요. 그러면 정확히 **1024 × 768** 픽셀인 `output.png`가 부드러운 가장자리와 함께 생성됩니다. + +## 관련 튜토리얼 + +- [DOCX를 PNG/JPG로 변환할 때 안티앨리어싱 활성화 방법](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [docx를 png로 변환 – zip 아카이브 생성 C# 튜토리얼](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Aspose를 사용해 HTML을 PNG로 렌더링하는 방법 – 단계별 가이드](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/korean/net/html-extensions-and-conversions/_index.md b/html/korean/net/html-extensions-and-conversions/_index.md index 38fc3bd7e..f0413ee97 100644 --- a/html/korean/net/html-extensions-and-conversions/_index.md +++ b/html/korean/net/html-extensions-and-conversions/_index.md @@ -39,8 +39,12 @@ Aspose.HTML for .NET은 단순한 라이브러리가 아니라 웹 개발의 세 ## HTML 확장 및 변환 튜토리얼 ### [Aspose.HTML을 사용하여 .NET에서 HTML을 PDF로 변환](./convert-html-to-pdf/) Aspose.HTML for .NET으로 HTML을 PDF로 손쉽게 변환하세요. 단계별 가이드를 따라 HTML-PDF 변환의 힘을 활용하세요. +### [C#를 사용하여 HTML을 PDF로 변환 – 완전 가이드](./convert-html-to-pdf-with-c-complete-guide/) +C#와 Aspose.HTML을 활용해 HTML을 PDF로 변환하는 전체 단계별 가이드입니다. ### [HTML에서 PDF 만들기 – C# 단계별 가이드](./create-pdf-from-html-c-step-by-step-guide/) Aspose.HTML for .NET을 사용하여 C#에서 HTML을 PDF로 변환하는 단계별 가이드입니다. +### [C#에서 HTML을 PDF로 렌더링 – 전체 단계별 가이드](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Aspose.HTML for .NET을 사용하여 C#에서 HTML을 PDF로 렌더링하는 전체 단계별 가이드를 확인하세요. ### [Aspose.HTML을 사용하여 .NET에서 EPUB를 이미지로 변환](./convert-epub-to-image/) Aspose.HTML for .NET을 사용하여 EPUB를 이미지로 변환하는 방법을 알아보세요. 코드 예제와 사용자 정의 가능한 옵션이 있는 단계별 튜토리얼. ### [Aspose.HTML을 사용하여 .NET에서 EPUB를 PDF로 변환](./convert-epub-to-pdf/) @@ -66,13 +70,15 @@ Aspose.HTML for .NET을 사용하여 HTML을 TIFF로 변환하는 방법을 알 ### [Aspose.HTML을 사용하여 .NET에서 HTML을 XPS로 변환](./convert-html-to-xps/) .NET용 Aspose.HTML의 힘을 알아보세요: HTML을 XPS로 손쉽게 변환하세요. 필수 조건, 단계별 가이드, FAQ가 포함되어 있습니다. ### [C#에서 HTML을 Zip으로 압축하는 방법 – HTML을 Zip으로 저장](./how-to-zip-html-in-c-save-html-to-zip/) -C#과 Aspose.HTML을 사용해 HTML 파일을 ZIP 압축 파일로 저장하는 단계별 가이드를 제공합니다. +C#와 Aspose.HTML을 사용해 HTML 파일을 ZIP 압축 파일로 저장하는 단계별 가이드를 제공합니다. ### [스타일이 적용된 텍스트로 HTML 문서 만들기 및 PDF로 내보내기 – 전체 가이드](./create-html-document-with-styled-text-and-export-to-pdf-full/) Aspose.HTML for .NET을 사용하여 스타일이 적용된 텍스트가 포함된 HTML 문서를 만들고 PDF로 내보내는 전체 가이드를 확인하세요. ### [HTML을 ZIP으로 저장 – 전체 C# 튜토리얼](./save-html-as-zip-complete-c-tutorial/) Aspose.HTML for .NET을 사용해 HTML을 ZIP 파일로 저장하는 전체 C# 단계별 튜토리얼. ### [C#에서 HTML을 ZIP으로 저장 – 완전 인메모리 예제](./save-html-to-zip-in-c-complete-in-memory-example/) Aspose.HTML for .NET을 사용하여 메모리 내에서 HTML을 ZIP 파일로 저장하는 방법을 단계별로 안내합니다. +### [Aspose.HTML을 사용하여 HTML을 ZIP으로 저장 – 전체 가이드](./save-html-as-zip-complete-guide-for-aspose-html/) +Aspose.HTML for .NET을 활용해 HTML 파일을 ZIP 압축 파일로 저장하는 전체 단계별 가이드를 제공합니다. ## 결론 diff --git a/html/korean/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/korean/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..35d07268c --- /dev/null +++ b/html/korean/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,259 @@ +--- +category: general +date: 2026-05-22 +description: Aspose.HTML을 사용하여 C#에서 HTML을 PDF로 변환합니다. 단계별 코드, 옵션 및 Linux 힌트를 통해 C#에서 + HTML을 PDF로 렌더링하는 방법을 배워보세요. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: ko +og_description: Aspose.HTML를 사용하여 C#에서 HTML을 PDF로 변환합니다. 이 가이드는 명확한 옵션과 Linux 친화적인 + 힌트를 활용하여 C#에서 HTML을 PDF로 렌더링하는 방법을 보여줍니다. +og_title: C#로 HTML을 PDF로 변환하기 – 완전 가이드 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: C#로 HTML을 PDF로 변환하기 – 완전 가이드 +url: /ko/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#로 HTML을 PDF로 변환하기 – 완전 가이드 + +HTML을 **PDF로 빠르게 변환**해야 한다면 Aspose.HTML for .NET이 손쉽게 해결해 줍니다. 이 튜토리얼에서는 **C#에서 HTML을 PDF로 렌더링하는 방법**을 전체 렌더링 옵션을 제어하면서 답변하고, 추측에 의존하지 않도록 합니다. + +마케팅 이메일 템플릿, 영수증 페이지, 혹은 최신 CSS로 만든 복잡한 보고서가 있다고 가정해 보세요. 이를 PDF로 클라이언트나 프린터에 전달해야 합니다. 수작업은 번거롭지만, 몇 줄의 C# 코드만으로 전체 파이프라인을 자동화할 수 있습니다. 이 가이드를 끝까지 따라하면 Windows *및* Linux에서 동작하는 자체 포함형, 프로덕션 준비 솔루션을 얻게 됩니다. + +## 준비 사항 + +시작하기 전에 다음이 준비되어 있는지 확인하세요. + +- **.NET 6.0 이상** – Aspose.HTML은 .NET Standard 2.0+을 대상으로 하므로 최신 SDK이면 모두 사용 가능합니다. +- **Aspose.HTML for .NET** NuGet 패키지 (`Aspose.Html`) – 프로덕션에서는 유효한 라이선스가 필요하지만, 무료 체험판으로 테스트할 수 있습니다. +- 변환하려는 **간단한 HTML 파일** (`input.html`이라고 부르겠습니다). +- 선호하는 IDE (Visual Studio, Rider, VS Code) – 별도의 도구는 필요 없습니다. + +이것만 있으면 됩니다. 외부 PDF 변환기나 명령줄 트릭은 필요 없습니다. 순수 C#만 있으면 됩니다. + +![Aspose.HTML을 사용한 HTML을 PDF로 변환 워크플로우를 보여주는 다이어그램](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## HTML을 PDF로 변환 – 전체 구현 + +아래는 완전하게 실행 가능한 프로그램 전체입니다. 새 콘솔 앱에 복사‑붙여넣기하고, NuGet 패키지를 복원한 뒤 **F5**를 누르세요. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### 왜 이렇게 동작하나요 + +- **`Document`** 는 Aspose.HTML의 진입점으로, HTML을 파싱하고 CSS를 해석해 렌더링 준비가 된 DOM을 구축합니다. +- **`PdfRenderingOptions`** 로 출력 옵션을 조정할 수 있습니다. `UseHinting` 플래그는 기본 래스터라이저가 흐릿해 보일 수 있는 무인 Linux 컨테이너에서 선명한 텍스트를 얻기 위한 비법입니다. +- **`Save`** 가 핵심 작업을 수행합니다: DOM을 PDF 페이지에 래스터화하고, 페이지 구분을 준수하며, 폰트를 자동으로 임베드합니다. + +프로그램을 실행하면 소스 파일 옆에 `output.pdf` 가 생성됩니다. PDF 뷰어로 열면 원본 HTML과 시각적으로 일치하는 것을 확인할 수 있습니다. + +## C#에서 HTML을 PDF로 렌더링하는 방법 – 단계별 가이드 + +아래에서는 **C#에서 HTML을 PDF로 렌더링하는 방법**을 작은 조각으로 나누어 설명하면서 흔히 마주치는 함정도 함께 다룹니다. + +### 단계 1 – Aspose.HTML NuGet 패키지 설치 + +프로젝트 폴더에서 터미널을 열고 다음을 실행하세요: + +```bash +dotnet add package Aspose.Html +``` + +Visual Studio UI를 선호한다면 프로젝트를 오른쪽 클릭 → **Manage NuGet Packages** → **Aspose.Html** 검색 후 최신 안정 버전을 설치합니다. + +> **팁:** 설치 후 프로젝트 루트에 라이선스 파일 (`Aspose.Total.lic`)을 추가하면 평가용 워터마크를 피할 수 있습니다. + +### 단계 2 – HTML을 올바르게 로드하기 + +Aspose.HTML은 다음과 같은 입력을 지원합니다. + +- 로컬 파일 경로 (`new Document("file.html")`) +- URL (`new Document("https://example.com")`) +- 원시 HTML 문자열 (`new Document("…", new HtmlLoadOptions())`) + +파일 시스템에서 로드할 경우 경로가 절대 경로이거나 작업 디렉터리가 올바르게 설정되어 있어야 `FileNotFoundException` 오류를 피할 수 있습니다. Linux에서는 슬래시(`/`) 또는 `Path.Combine`을 사용하세요. + +### 단계 3 – 적절한 렌더링 옵션 선택하기 + +`UseHinting` 외에도 다음 옵션을 조정할 수 있습니다. + +| 옵션 | 동작 설명 | 사용 시기 | +|------|-----------|-----------| +| `PageSize` | PDF 페이지 크기 설정 (A4, Letter, 사용자 지정) | 대상 용지 크기에 맞출 때 | +| `Landscape` | 페이지를 가로 방향으로 회전 | 넓은 표나 차트가 있을 때 | +| `RasterizeVectorGraphics` | 벡터 그래픽을 래스터 이미지로 강제 변환 | PDF 뷰어가 SVG를 지원하지 않을 때 | +| `CompressionLevel` | 이미지 압축 수준 제어 (0‑9) | 이메일 첨부 파일 용량을 줄이고 싶을 때 | + +다음과 같이 체인 형태로 속성을 설정할 수 있습니다: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### 단계 4 – PDF 저장하기 + +전체 예제에서 보이는 `Save` 메서드 오버로드는 파일 경로에 직접 저장합니다. 메모리 스트림으로 PDF를 반환할 수도 있습니다: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +웹 API에서 다운로드용 PDF를 반환해야 할 때 유용합니다. + +### 단계 5 – 출력 검증하기 + +간단한 검증 방법은 PDF 페이지 수를 예상되는 HTML 섹션 수와 비교하는 것입니다. Aspose.PDF를 사용해 다시 읽어올 수 있습니다: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +페이지 수가 맞지 않으면 CSS `page-break` 규칙을 다시 확인하거나 `PdfRenderingOptions` 를 조정하세요. + +## 엣지 케이스 및 흔히 발생하는 문제 + +| 상황 | 주의할 점 | 해결 방법 | +|------|----------|-----------| +| **외부 리소스(이미지, 폰트) 누락** | 상대 URL은 HTML 파일 폴더를 기준으로 해석됩니다. | `HtmlLoadOptions.BaseUri` 로 올바른 루트를 지정합니다. | +| **Linux 무인 환경** | 기본 텍스트 렌더링이 흐릿해질 수 있습니다. | `UseHinting = true` 를 설정하고, System.Drawing을 사용할 경우 `libgdiplus` 를 설치합니다. | +| **대용량 HTML(> 10 MB)** | 렌더링 중 메모리 사용량이 급증합니다. | `PdfRenderer` 와 `PdfRenderingOptions` 로 페이지별로 렌더링하고, 저장 후 각 페이지를 해제합니다. | +| **JavaScript‑무거운 페이지** | Aspose.HTML은 JS를 실행하지 않으며, 동적 콘텐츠는 정적 그대로 남습니다. | Puppeteer 등으로 서버‑사이드 사전 처리 후 Aspose.HTML에 전달합니다. | +| **Unicode 문자 표시가 사각형** | 런타임 환경에 폰트가 없습니다. | `FontSettings` 로 사용자 정의 폰트를 임베드하거나 OS에 필요한 폰트를 설치합니다. | + +## 전체 작업 예제 요약 + +주석을 제거한 간결 버전을 원한다면 아래 전체 프로그램을 다시 확인하세요: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +실행하고 `output.pdf` 를 열면 `input.html` 의 픽셀‑정밀 복제본을 확인할 수 있습니다. 이것이 Aspose.HTML을 사용한 **HTML을 PDF로 변환**의 핵심입니다. + +## 결론 + +우리는 C#에서 **HTML을 PDF로 변환**하는 데 필요한 모든 과정을 살펴보았습니다: Aspose.HTML 설치, HTML 로드, 렌더링 옵션 조정(`UseHinting` 플래그 포함), 최종 PDF 저장까지. 이제 Windows와 Linux 모두에서 **C#으로 HTML을 PDF로 렌더링하는 방법**을 이해했으며, 리소스 누락, 대용량 파일 등 일반적인 엣지 케이스도 처리할 수 있습니다. + +다음 단계는 다음과 같은 기능을 추가해 보는 것입니다. + +- **헤더/푸터** 를 `PdfPageTemplate` 로 삽입해 브랜드화 +- **비밀번호 보호** 를 `PdfSaveOptions` 로 적용 +- **배치 변환** 을 폴더 전체를 순회하면서 수행 + +## 관련 튜토리얼 + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Convert EPUB to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Convert SVG to PDF in .NET with Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/korean/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/korean/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..2edee2473 --- /dev/null +++ b/html/korean/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,311 @@ +--- +category: general +date: 2026-05-22 +description: C#를 사용하여 HTML을 PDF로 렌더링하는 간결한 예제. HTML을 PDF로 빠르고 안정적으로 변환하는 방법을 배우세요. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: ko +og_description: C#에서 HTML을 PDF로 렌더링하기 – 명확하고 실행 가능한 예제와 함께. 이 가이드는 HTML을 C#에서 PDF로 + 변환하고 HTML 파일에서 PDF를 생성하는 방법을 보여줍니다. +og_title: C#에서 HTML을 PDF로 렌더링하기 – 완전한 프로그래밍 튜토리얼 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: C#에서 HTML을 PDF로 변환하기 – 전체 단계별 가이드 +url: /ko/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#에서 HTML을 PDF로 렌더링 – 전체 단계별 가이드 + +Ever needed to **render HTML as PDF** but weren’t sure which library to pick for a .NET project? You’re not alone. In many line‑of‑business apps you’ll find yourself needing to **convert HTML to PDF C#** for invoices, reports, or marketing brochures—basically any time you want a printable version of a web page. + +HTML을 PDF로 **render HTML as PDF**해야 할 때가 있었지만 .NET 프로젝트에 어떤 라이브러리를 선택해야 할지 몰랐던 적이 있나요? 당신만 그런 것이 아닙니다. 많은 라인‑오브‑비즈니스 애플리케이션에서 인보이스, 보고서, 마케팅 브로셔 등—즉 웹 페이지의 인쇄 가능한 버전이 필요할 때마다 **convert HTML to PDF C#**해야 합니다. + +Here’s the thing: you don’t have to reinvent the wheel. With a few lines of code you can take an `input.html` file, feed it to a proven rendering engine, and end up with a crisp `output.pdf`. In this tutorial we’ll walk through the entire process, from adding the right NuGet package to handling edge‑cases like external CSS. By the end you’ll be able to **generate PDF from HTML file** in a matter of minutes. + +사실, 휠을 다시 만들 필요는 없습니다. 몇 줄의 코드만으로 `input.html` 파일을 가져와 검증된 렌더링 엔진에 전달하면 선명한 `output.pdf`를 얻을 수 있습니다. 이 튜토리얼에서는 올바른 NuGet 패키지를 추가하는 것부터 외부 CSS와 같은 엣지 케이스를 처리하는 것까지 전체 과정을 단계별로 안내합니다. 끝까지 따라오면 몇 분 안에 **generate PDF from HTML file**을 할 수 있게 됩니다. + +## 배울 내용 + +- .NET 콘솔 앱을 설정하여 **creates PDF from HTML C#** 코드를 작성하는 방법. +- 필요한 정확한 API 호출을 사용해 **save HTML document as PDF** 하는 방법. +- 텍스트 품질을 위해 특정 렌더링 옵션(예: 힌팅)이 왜 중요한지. +- 누락된 폰트나 상대 이미지 경로와 같은 일반적인 문제를 해결하기 위한 팁. + +**Prerequisites** – .NET 6+ 또는 .NET Framework 4.7이 설치되어 있고, C#에 대한 기본적인 이해와 IDE(Visual Studio 2022, Rider, 또는 VS Code)가 있으면 됩니다. 사전 PDF 경험은 필요하지 않습니다. + +--- + +## HTML을 PDF로 렌더링 – 프로젝트 설정 + +코드에 들어가기 전에 개발 환경이 준비됐는지 확인합시다. 우리가 사용할 라이브러리는 **Select.Pdf**(비상업적 사용에 무료)이며, 간단한 API와 견고한 렌더링 정확성을 제공합니다. + +### PDF 렌더링 라이브러리 설치 (convert html to pdf c#) + +프로젝트 폴더에서 터미널을 열고 다음을 실행하세요: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Visual Studio를 사용 중이라면 NuGet 패키지 관리자 UI를 통해 패키지를 추가할 수도 있습니다. 버전 번호가 더 최신일 수 있으니 최신 안정 버전을 가져오세요. + +### 콘솔 스켈레톤 만들기 + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +필요한 기본 코드는 여기까지입니다. 실제 작업은 `Main` 내부에서 이루어집니다. + +--- + +## HTML 문서 로드 (generate pdf from html file) + +첫 번째 실제 단계는 렌더러가 디스크에 있는 HTML 파일을 가리키도록 하는 것입니다. Select.Pdf는 원시 HTML 문자열을 전달하거나 파일 경로를 지정하는 두 가지 편리한 방법을 제공합니다. 파일을 사용하면 특히 연결된 CSS나 이미지가 있을 때 정리가 깔끔합니다. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +여기서는 파일이 없을 경우를 대비해 방어 코드를 추가했습니다—초보자들이 HTML을 출력 폴더에 복사하는 것을 잊어버릴 때 흔히 발생하는 문제입니다. + +--- + +## 렌더링 옵션 구성 (create pdf from html c#) + +Select.Pdf는 풍부한 `PdfDocumentOptions` 객체를 제공합니다. 선명한 텍스트를 위해 힌팅을 활성화하는데, 이는 글리프를 부드럽게 하지만 약간의 성능 저하가 발생합니다. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +여기서 페이지 크기, 여백, 혹은 사용자 정의 폰트를 삽입할 수 있습니다. 핵심 포인트는 **render html as pdf**가 단순한 한 줄 코드가 아니라 최종 문서의 모양과 느낌을 제어할 수 있다는 것입니다. + +--- + +## HTML 문서를 PDF로 저장 (render html as pdf) + +이제 마법이 일어납니다. 변환기에 HTML 파일 경로를 전달하고 PDF를 디스크에 쓰도록 요청합니다. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +`ConvertUrl` 메서드는 HTML 파일 위치를 기준으로 상대 URL(이미지, CSS)을 자동으로 해결하므로 대부분의 실제 시나리오에서 이 접근 방식이 견고합니다. + +### 예상 출력 + +프로그램을 실행하면 같은 폴더에 `output.pdf` 파일이 생성됩니다. 열어보면 다음을 확인할 수 있습니다: + +- 힌팅 덕분에 선명한 안티앨리어싱으로 텍스트가 렌더링됩니다. +- 연결된 CSS의 스타일이 올바르게 적용됩니다. +- 이미지가 원본 HTML에 정의된 정확한 크기로 표시됩니다. + +무언가 이상하다면 CSS와 이미지 파일이 `input.html`과 동일한 위치에 있는지, 혹은 절대 URL을 사용했는지 다시 확인하세요. + +--- + +## 일반적인 엣지 케이스 처리 + +### 1. 방화벽에 의해 차단된 외부 리소스 + +HTML이 서버에서 접근할 수 없는 CDN에 호스팅된 폰트를 참조하면 PDF가 일반 폰트로 대체될 수 있습니다. 이를 방지하려면 폰트 파일을 로컬에 다운로드하거나 상대 경로를 사용해 `@font-face`로 임베드하세요. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. 매우 큰 HTML 파일 + +대용량 문서를 변환할 때 메모리 제한에 걸릴 수 있습니다. Select.Pdf는 변환을 스트리밍할 수 있게 해줍니다: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +스트리밍은 프로세스를 가볍게 유지하지만 HTML을 문자열로 제공해야 하며, 필요에 따라 청크 단위로 읽을 수 있습니다. + +### 3. 사용자 정의 헤더 또는 푸터 + +각 페이지에 페이지 번호나 회사 로고가 필요하면 `ConvertUrl`을 호출하기 전에 `converter.Options`의 `Header`와 `Footer` 속성을 설정하세요. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## 전체 작업 예제 (모든 단계 결합) + +아래는 완전한 복사‑붙여넣기 가능한 프로그램입니다. `YOUR_DIRECTORY`를 HTML 파일이 위치한 절대 경로로 교체하세요. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** 프로젝트 디렉터리에서 `dotnet run`을 실행하세요. 모든 설정이 올바르면 성공 메시지와 깔끔한 `output.pdf`가 표시됩니다. + +--- + +## 시각적 요약 + +![Render HTML as PDF example](render-html-as-pdf.png){alt="HTML을 PDF로 렌더링 예시"} + +스크린샷은 콘솔 출력과 뷰어에서 열린 결과 PDF를 보여줍니다. 선명한 헤딩과 올바르게 로드된 이미지를 확인하세요—이는 **render html as pdf**를 기대할 때 정확히 기대하는 모습입니다. + +--- + +## 결론 + +이제 C# 애플리케이션에서 **render HTML as PDF**하는 방법을 배웠습니다—라이브러리 설치부터 렌더링 옵션 미세 조정까지. 전체 예제는 몇 줄의 코드만으로 **convert HTML to PDF C#**, **generate PDF from HTML file**, **save HTML document as PDF**를 신뢰성 있게 수행하는 방법을 보여줍니다. + +다음은 무엇을 할까요? 다음을 시도해 보세요: + +- 브랜드 일관성을 위한 사용자 정의 폰트 추가. +- 동적 HTML 문자열(예: Razor 템플릿)에서 PDF 생성. +- `PdfDocument.AddPage`를 사용해 여러 PDF를 하나의 보고서로 병합. + +이러한 확장은 여기서 다룬 핵심 개념을 기반으로 하므로, 급격한 학습 곡선 없이도 더 고급 시나리오에 도전할 준비가 됩니다. + +질문이 있거나 문제가 발생했나요? 아래에 댓글을 남겨 주세요. 함께 문제를 해결해 봅시다. 즐거운 코딩 되세요! + +## 관련 튜토리얼 + +- [Aspose.HTML을 사용한 .NET에서 HTML을 PDF로 변환](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [스타일이 적용된 텍스트로 HTML 문서 만들고 PDF로 내보내기 – 전체 가이드](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Aspose.HTML을 사용한 HTML을 PDF로 변환 – 전체 조작 가이드](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/korean/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/korean/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..383508bb0 --- /dev/null +++ b/html/korean/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-05-22 +description: Aspose.HTML를 사용하여 HTML을 빠르게 ZIP으로 저장하세요. HTML 파일을 ZIP으로 압축하고, HTML을 ZIP으로 + 렌더링하며, 전체 코드를 포함한 HTML을 ZIP 파일로 내보내는 방법을 배워보세요. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: ko +og_description: Aspose.HTML를 사용하여 HTML을 ZIP으로 저장합니다. 이 가이드는 HTML을 ZIP으로 렌더링하고, HTML을 + ZIP 파일로 내보내며, HTML 파일을 프로그래밍 방식으로 압축하는 방법을 보여줍니다. +og_title: HTML을 ZIP으로 저장 – 완전한 Aspose.HTML 튜토리얼 +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: HTML을 ZIP으로 저장 – Aspose.HTML 완전 가이드 +url: /ko/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Save HTML as ZIP – Complete Guide for Aspose.HTML + +HTML을 별도의 압축 도구 없이 **ZIP 파일로 저장**하는 방법이 궁금하셨나요? 당신만 그런 것이 아닙니다. 많은 개발자들이 HTML 페이지와 이미지, CSS, 스크립트를 한 번에 묶어 배포하기를 원하지만, 수동으로 진행하면 금방 번거로워집니다. + +이 튜토리얼에서는 Aspose.HTML for .NET을 사용해 **HTML을 ZIP으로 렌더링**하는 깔끔한 엔드‑투‑엔드 솔루션을 단계별로 살펴봅니다. 튜토리얼을 마치면 **HTML을 ZIP 파일로 내보내는** 방법을 정확히 알게 되고, 다양한 상황에서 **HTML 파일을 ZIP으로 압축하는** 변형 방법도 확인할 수 있습니다. + +> *Pro tip:* 아래 방법은 단일 페이지든 전체 사이트 폴더든 상관없이 적용됩니다. + +## What You’ll Need + +시작하기 전에 다음을 준비하세요: + +- .NET 6(또는 최신 .NET 런타임) 설치 +- 프로젝트에 `Aspose.Html` NuGet 패키지( Aspose.HTML for .NET ) 추가 +- 직접 관리하는 폴더에 간단한 `input.html` 파일 배치 +- 기본적인 C# 사용 능력 – 복잡할 필요는 없습니다 + +이것만 있으면 됩니다. 외부 zip 유틸리티나 커맨드라인 트릭은 필요 없습니다. 바로 시작해 보죠. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*이미지 대체 텍스트: Aspose.HTML을 사용한 HTML을 ZIP으로 저장하는 과정 다이어그램* + +## Step 1: Load the Source HTML Document + +먼저 Aspose.HTML에 소스 파일 위치를 알려야 합니다. `HTMLDocument` 클래스가 파일을 읽어 메모리 내 DOM을 구성하고 렌더링 준비를 합니다. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +왜 중요한가요: 문서를 로드하면 라이브러리가 이미지, CSS, 폰트 등 리소스 해석을 완전하게 제어할 수 있습니다. HTML에 상대 경로가 있으면 Aspose.HTML이 파일 폴더를 기준으로 자동 해결합니다. + +## Step 2: (Optional) Create a Custom Resource Handler + +각 리소스를 검사하거나 조작해야 할 경우—예를 들어 압축하기 전에 이미지를 처리하고 싶다면—`ResourceHandler`를 연결할 수 있습니다. 이 단계는 선택 사항이지만, **HTML을 ZIP 아카이브로 변환**할 때 가장 유연한 방법입니다. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*특별한 처리가 필요 없나요?* 이 클래스를 건너뛰고 기본 핸들러를 사용하면 Aspose.HTML이 리소스를 바로 ZIP에 기록합니다. + +## Step 3: Configure Save Options to Use the Handler + +`HtmlSaveOptions` 객체는 렌더러에게 리소스를 어떻게 처리할지 알려줍니다. `MyResourceHandler`를 지정하면 출력 전체를 제어할 수 있습니다. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +`ResourceHandler` 속성 이름이 **HTML을 ZIP으로 렌더링** 기능과 직접 연결된 것을 확인하세요. 여기서 마법이 일어납니다: 모든 연결된 리소스가 디스크에 쓰이는 대신 아카이브 스트림으로 전달됩니다. + +## Step 4: Save the Rendered Document into a ZIP Archive + +이제 **HTML을 ZIP 파일로 내보내는** 작업을 수행합니다. `Save` 메서드는 어떤 `Stream`도 받을 수 있으므로 `FileStream`을 지정해 `result.zip`을 생성하면 됩니다. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +전체 흐름은 여기까지입니다. 코드 실행이 끝나면 `result.zip` 안에 다음이 들어 있습니다: + +- `input.html` (원본 마크업) +- 참조된 모든 이미지, CSS 파일, 폰트 +- `MyResourceHandler`에서 변형한 리소스가 있다면 그 내용도 포함 + +## How to Zip HTML Files Without Aspose.HTML (Quick Alternative) + +때때로 다른 HTML 파서를 이미 사용하고 있어 **HTML 파일을 ZIP으로 압축하는** 간단한 방법만 필요할 수 있습니다. 그럴 땐 .NET 내장 `System.IO.Compression`을 활용하면 됩니다: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +이 방법은 간단하지만 렌더링 단계가 없으므로 디스크에 있는 파일만 포장합니다. HTML이 외부 URL을 참조한다면 해당 리소스는 포함되지 않죠. 따라서 신뢰할 수 있는 **HTML을 ZIP으로 렌더링** 솔루션이 필요할 때는 Aspose.HTML 방식을 권장합니다. + +## Edge Cases & Common Pitfalls + +| Situation | What to Watch For | Recommended Fix | +|-----------|-------------------|-----------------| +| **Large images** | 메모리 사용량이 급증합니다. 각 이미지가 `MemoryStream`에 로드되기 때문입니다. | 전체 버퍼링 대신 원본 스트림을 복사하는 커스텀 핸들러로 직접 zip에 스트리밍하세요. | +| **External URLs** | 인터넷에 호스팅된 리소스는 자동으로 다운로드되지 않습니다. | `HtmlLoadOptions`의 `BaseUrl`을 사이트 루트로 지정하거나, 저장 전에 리소스를 수동으로 다운로드하세요. | +| **File name collisions** | 서로 다른 하위 폴더에 같은 이름의 CSS 파일이 있으면 덮어쓰기 위험이 있습니다. | `ResourceHandler`가 zip에 쓸 때 전체 상대 경로를 보존하도록 구현하세요. | +| **Permission errors** | 읽기 전용 폴더에 쓰려 하면 `UnauthorizedAccessException`이 발생합니다. | 적절한 권한으로 실행하거나 쓰기 가능한 출력 디렉터리를 선택하세요. | + +위 상황들을 대비하면 **HTML을 ZIP 아카이브로 변환**하는 루틴을 프로덕션에서도 안정적으로 사용할 수 있습니다. + +## Full Working Example (All Pieces Together) + +아래는 완전한 실행 가능한 프로그램 예시입니다. 새 콘솔 앱에 붙여넣고 경로만 수정한 뒤 **F5**를 눌러 실행하세요. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**예상 출력:** 콘솔에 성공 메시지가 표시되고 `result.zip` 파일에 `input.html`과 모든 종속 자산이 들어 있습니다. ZIP을 열어 `input.html`을 더블클릭하면 브라우저에서 보던 그대로 페이지가 렌더링됩니다—이미지 누락이나 CSS 깨짐이 없습니다. + +## Recap – Why This Approach Rocks + +- **Single‑step rendering:** 각 리소스를 수동으로 복사할 필요 없이 Aspose.HTML이 자동으로 처리합니다. +- **Customizable pipeline:** `ResourceHandler`를 통해 파일 저장 방식을 완전히 제어할 수 있어 압축, 암호화, 실시간 변환이 가능합니다. +- **Cross‑platform:** Windows, Linux, macOS 어디서든 .NET 런타임만 있으면 동작합니다. +- **No external tools:** 전체 **HTML을 ZIP으로 저장** 과정이 C# 코드 안에 모두 포함됩니다. + +## What’s Next? + +이제 **HTML을 ZIP으로 저장**하는 방법을 익혔으니, 다음 주제들도 살펴보세요: + +- **Export HTML to PDF** – 인쇄용 보고서에 최적 (`export html to zip file` 지식이 두 포맷 모두 필요할 때 유용) +- **Streaming ZIP directly to HTTP response** – 웹 API에서 사용자가 즉시 패키지된 사이트를 다운로드하도록 제공 +- **Encrypting ZIP archives** – 기밀 문서에 비밀번호 보호 레이어 추가 + +실험해 보세요: `MyResourceHandler`를 이미지 압축 전용 핸들러로 교체하거나, 모든 번들 리소스를 나열한 매니페스트 파일을 추가하는 등 자유롭게 확장할 수 있습니다. 렌더링 파이프라인을 직접 제어하면 가능성은 무한합니다. + +--- + +*Happy coding! If you hit any snags or have ideas for improvement, drop a comment below. We’ll figure it out together.* + +## Related Tutorials + +- [How to Zip HTML in C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Save HTML as ZIP – Complete C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Save HTML to ZIP in C# – Complete In‑Memory Example](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/polish/net/generate-jpg-and-png-images/_index.md b/html/polish/net/generate-jpg-and-png-images/_index.md index fff5f7a92..ab228352d 100644 --- a/html/polish/net/generate-jpg-and-png-images/_index.md +++ b/html/polish/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Naucz się używać Aspose.HTML dla .NET do manipulowania dokumentami HTML, konw Dowiedz się, jak włączyć antyaliasing przy konwersji dokumentów DOCX do formatów PNG i JPG przy użyciu Aspose.HTML. ### [Konwertuj docx do png – utwórz archiwum zip w C# – samouczek](./convert-docx-to-png-create-zip-archive-c-tutorial/) Dowiedz się, jak konwertować pliki DOCX na obrazy PNG i spakować je do archiwum ZIP przy użyciu C# i Aspose.HTML. +### [Ustaw szerokość i wysokość obrazu przy konwertowaniu Word do PNG – pełny przewodnik](./set-image-width-height-when-converting-word-to-png-full-guid/) +Dowiedz się, jak określić wymiary obrazu przy konwersji dokumentów Word do formatu PNG przy użyciu Aspose.HTML. ## Wniosek diff --git a/html/polish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/polish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..9ba613101 --- /dev/null +++ b/html/polish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,275 @@ +--- +category: general +date: 2026-05-22 +description: Ustaw szerokość i wysokość obrazu podczas konwertowania dokumentu Word + na PNG. Dowiedz się, jak wyeksportować plik docx jako obraz z wysokiej jakości renderowaniem + w poradniku krok po kroku. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: pl +og_description: Ustaw szerokość i wysokość obrazu podczas konwertowania dokumentu + Word na PNG. Ten poradnik pokazuje, jak wyeksportować plik docx jako obraz z ustawieniami + wysokiej jakości. +og_title: Ustaw szerokość i wysokość obrazu przy konwertowaniu Worda na PNG – Kompletny + przewodnik +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Ustaw szerokość i wysokość obrazu przy konwertowaniu Worda na PNG – pełny przewodnik +url: /pl/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Ustaw szerokość i wysokość obrazu przy konwertowaniu Word na PNG – Kompletny przewodnik + +Zastanawiałeś się kiedyś, jak **set image width height** podczas **convert Word to PNG**? Nie jesteś jedyny. Wielu programistów napotyka problem, gdy domyślny eksport daje rozmyty obraz lub nieprawidłowe wymiary, a potem spędzają godziny na poszukiwaniu rozwiązania, które naprawdę działa. + +W tym samouczku przeprowadzimy Cię przez czyste, kompleksowe rozwiązanie, które pokazuje **how to render word** dokumenty jako obrazy PNG, umożliwiając **save docx as PNG** z precyzyjną kontrolą szerokości‑wysokości i wysokiej jakości antyaliasingiem. Po zakończeniu będziesz mieć gotowy fragment kodu, solidne zrozumienie opcji API oraz kilka profesjonalnych wskazówek, jak uniknąć typowych pułapek. + +## Co się nauczysz + +- Ładowanie pliku `.docx` przy użyciu Aspose.Words for .NET. +- **Set image width height** przy pomocy `ImageRenderingOptions`. +- **Export docx as image** (PNG) z włączonym antyaliasingiem. +- Jak **convert word to png** dla jednej strony lub całego dokumentu. +- Wskazówki dotyczące obsługi dużych dokumentów, rozważania DPI oraz ścieżki systemu plików. + +Bez zewnętrznych narzędzi, bez skomplikowanych poleceń wiersza – tylko czysty kod C#, który możesz wkleić do dowolnego projektu .NET. + +--- + +## Wymagania wstępne + +Zanim zaczniemy, upewnij się, że masz następujące elementy: + +| Wymaganie | Dlaczego jest ważny | +|-------------|----------------| +| **.NET 6.0+** (lub .NET Framework 4.7.2) | Aspose.Words obsługuje oba, ale nowsze środowiska zapewniają lepszą wydajność. | +| **Aspose.Words for .NET** pakiet NuGet (`Install-Package Aspose.Words`) | Dostarcza klasę `Document` i silnik renderujący. | +| Dokument **Word** (`.docx`), który chcesz zamienić na PNG. | Źródło, które będziesz konwertować. | +| Podstawowa znajomość C# – zrozumiesz instrukcje `using` i inicjalizację obiektów. | Ułatwia przyswajanie materiału. | + +Jeśli brakuje Ci pakietu NuGet, uruchom poniższe polecenie w konsoli Menedżera Pakietów: + +```powershell +Install-Package Aspose.Words +``` + +To wszystko – po zainstalowaniu pakietu możesz przystąpić do kodowania. + +--- + +## Krok 1: Załaduj dokument źródłowy + +Pierwszą rzeczą, którą musisz zrobić, jest wskazanie bibliotece pliku Word, który chcesz przekształcić. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Dlaczego to ważne:** Klasa `Document` wczytuje cały pakiet Word do pamięci, dając dostęp do stron, stylów i wszystkiego, co jest w dokumencie. Jeśli ścieżka jest niepoprawna, otrzymasz `FileNotFoundException`, więc sprawdź, czy plik istnieje i czy ścieżka używa podwójnych backslashy (`\\`) lub łańcucha dosłownego (`@`). + +> **Pro tip:** Owiń wywołanie ładowania w blok `try/catch`, jeśli istnieje ryzyko, że plik może nie być dostępny w czasie wykonywania. + +--- + +## Krok 2: Skonfiguruj opcje renderowania obrazu (Set Image Width Height) + +Teraz przechodzimy do sedna samouczka: **how to set image width height**, aby wynikowy PNG nie był rozciągnięty ani pikselowany. Klasa `ImageRenderingOptions` daje precyzyjną kontrolę nad wymiarami, DPI i wygładzaniem. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Wyjaśnienie kluczowych właściwości:** + +- `Width` i `Height` – To dokładne wymiary w pikselach, które chcesz uzyskać. Ustawiając je, **set image width height** bezpośrednio, nadpisujesz domyślny rozmiar strony. +- `UseAntialiasing` – Włącza wysokiej jakości wygładzanie tekstu i grafiki wektorowej, co jest kluczowe przy **convert word to png**, aby krawędzie były ostre. +- `Resolution` – Wyższe DPI daje więcej szczegółów, szczególnie w złożonych układach. Pamiętaj o zużyciu pamięci; obraz 300 DPI może być duży. + +> **Dlaczego nie polegać na domyślnym rozmiarze?** Domyślnie używane są fizyczne wymiary strony (np. A4 przy 96 DPI). To często daje obraz 794 × 1123 pikseli – w porządku w niektórych przypadkach, ale nie wtedy, gdy potrzebujesz konkretnej miniaturki UI lub stałego podglądu. + +--- + +## Krok 3: Renderuj i zapisz jako PNG (Export Docx as Image) + +Po załadowaniu dokumentu i skonfigurowaniu opcji możesz w końcu **export docx as image**. Metoda `RenderToImage` wykonuje ciężką pracę. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Jeśli chcesz renderować **the whole document** (wszystkie strony) do oddzielnych plików PNG, użyj pętli po kolekcji stron: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Co się dzieje w tle?** Renderer rasteryzuje każdą stronę przy użyciu podanych wymiarów, stosuje antyaliasing i zapisuje strumień bajtów PNG na dysku. Ponieważ PNG jest bezstratny, zachowujesz pełną wierność oryginalnemu układowi Worda. + +**Oczekiwany wynik:** Wyraźny plik PNG dokładnie 1024 × 768 pikseli (lub dowolny rozmiar, który ustawiłeś). Otwórz go w dowolnym przeglądarce obrazów, a zobaczysz zawartość Worda renderowaną dokładnie tak, jak w oryginalnym dokumencie, ale jako bitmapa. + +--- + +## Zaawansowane wskazówki i warianty + +### 1. Zachowanie przezroczystego tła + +Jeśli dokument Word zawiera kształty z przezroczystym tłem i chcesz zachować tę przezroczystość, ustaw `BackgroundColor` na `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Renderowanie tylko określonego zakresu + +Czasami potrzebujesz tylko akapitu lub tabeli, nie całej strony. Użyj `DocumentVisitor`, aby wyodrębnić węzeł i renderować go osobno. To bardziej zaawansowany scenariusz, ale pokazuje **how to render word** na poziomie szczegółowym. + +### 3. Dynamiczna zmiana DPI + +Jeśli potrzebujesz innego DPI dla poszczególnych stron (np. wysokiej rozdzielczości dla okładki), zmodyfikuj `Resolution` wewnątrz pętli: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Przetwarzanie wsadowe + +Podczas konwertowania dziesiątek dokumentów, opakuj cały przepływ w metodę i ponownie używaj tego samego obiektu `ImageRenderingOptions`. Ponowne użycie obiektu opcji zmniejsza narzut alokacji. + +--- + +## Typowe problemy i jak ich uniknąć + +| Objaw | Prawdopodobna przyczyna | Rozwiązanie | +|---------|--------------|-----| +| PNG jest rozmyty mimo wysokiego DPI | `UseAntialiasing` pozostawiono `false` | Ustaw `UseAntialiasing = true`. | +| Rozmiar wyjściowy nie zgadza się z `Width`/`Height` | DPI nie uwzględniono | Pomnóż żądany rozmiar przez `Resolution / 96` lub dostosuj `Resolution`. | +| Wyjątek Out‑of‑memory przy dużych dokumentach | Renderowanie całego dokumentu przy 300 DPI | Renderuj jedną stronę na raz, zwalniaj każdy obraz po zapisaniu. | +| PNG ma białe tło przy przezroczystych obrazach | `BackgroundColor` nie ustawiono | Ustaw `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Kompletny działający przykład + +Poniżej znajduje się samodzielny program, który możesz skopiować do aplikacji konsolowej. Demonstracja **convert word to png**, **save docx as png** oraz oczywiście **set image width height**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Uruchomienie:** Zbuduj projekt, umieść prawidłowy `input.docx` w podanej ścieżce i uruchom aplikację. Powinieneś otrzymać `output.png` dokładnie **1024 × 768** pikseli, wyrenderowany z gładkimi krawędziami. + +## Powiązane samouczki + +- [How to Enable Antialiasing When Converting DOCX to PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – create zip archive c# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [How to Use Aspose to Render HTML to PNG – Step‑by‑Step Guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/polish/net/html-extensions-and-conversions/_index.md b/html/polish/net/html-extensions-and-conversions/_index.md index 5b553b002..2eb3007d0 100644 --- a/html/polish/net/html-extensions-and-conversions/_index.md +++ b/html/polish/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,10 @@ Aspose.HTML dla .NET to nie tylko biblioteka; to przełom w świecie tworzenia s ## Samouczki dotyczące rozszerzeń i konwersji HTML ### [Konwertuj HTML do PDF w .NET za pomocą Aspose.HTML](./convert-html-to-pdf/) Konwertuj HTML do PDF bez wysiłku dzięki Aspose.HTML dla .NET. Postępuj zgodnie z naszym przewodnikiem krok po kroku i uwolnij moc konwersji HTML do PDF. +### [Renderowanie HTML jako PDF w C# – Pełny przewodnik krok po kroku](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Dowiedz się, jak w C# renderować HTML do PDF przy użyciu Aspose.HTML, krok po kroku, z przykładami kodu. +### [Konwertuj HTML do PDF w C# – Kompletny przewodnik](./convert-html-to-pdf-with-c-complete-guide/) +Pełny przewodnik, jak w C# konwertować HTML do PDF przy użyciu Aspose.HTML, z przykładami kodu i wskazówkami. ### [Utwórz PDF z HTML – przewodnik krok po kroku w C#](./create-pdf-from-html-c-step-by-step-guide/) Dowiedz się, jak w C# wygenerować plik PDF z kodu HTML, korzystając z Aspose.HTML – kompletny przewodnik krok po kroku. ### [Konwersja EPUB do obrazu w .NET za pomocą Aspose.HTML](./convert-epub-to-image/) @@ -73,6 +77,8 @@ Dowiedz się, jak stworzyć dokument HTML z formatowanym tekstem i wyeksportowa Zapisz dokument HTML jako archiwum ZIP w C# przy użyciu Aspose.HTML – kompletny przewodnik krok po kroku. ### [Zapisz HTML do ZIP w C# – Kompletny przykład w pamięci](./save-html-to-zip-in-c-complete-in-memory-example/) Zapisz dokument HTML do archiwum ZIP w pamięci przy użyciu Aspose.HTML w C#. +### [Zapisz HTML jako ZIP – Kompletny przewodnik dla Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Zapisz HTML jako archiwum ZIP w C# przy użyciu Aspose.HTML – pełny przewodnik krok po kroku. ## Wniosek diff --git a/html/polish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/polish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..8e27edae9 --- /dev/null +++ b/html/polish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,259 @@ +--- +category: general +date: 2026-05-22 +description: Konwertuj HTML na PDF w C# przy użyciu Aspose.HTML. Dowiedz się, jak + renderować HTML do PDF w C# za pomocą kodu krok po kroku, opcji i wskazówek dotyczących + Linuksa. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: pl +og_description: Konwertuj HTML na PDF w C# przy użyciu Aspose.HTML. Ten przewodnik + pokazuje, jak renderować HTML do PDF w C# przy użyciu przejrzystych opcji i przyjaznych + dla Linuksa wskazówek. +og_title: Konwertuj HTML do PDF w C# – Kompletny przewodnik +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Konwertuj HTML do PDF w C# – Kompletny przewodnik +url: /pl/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Konwertowanie HTML do PDF w C# – Kompletny przewodnik + +Jeśli potrzebujesz szybko **konwertować HTML do PDF**, Aspose.HTML for .NET robi to z łatwością. W tym tutorialu odpowiemy również na pytanie **jak renderować HTML do PDF w C#** z pełną kontrolą nad opcjami renderowania, więc nie będziesz zgadywać. + +Wyobraź sobie, że masz szablon e‑maila marketingowego, stronę z paragonem lub złożony raport zbudowany przy użyciu nowoczesnego CSS i musisz go przekazać jako PDF klientowi lub drukarce. Ręczne wykonywanie tego jest uciążliwe, ale kilka linii kodu C# może zautomatyzować cały proces. Po zakończeniu tego przewodnika będziesz mieć samodzielne, gotowe do produkcji rozwiązanie działające na Windows *i* Linux. + +## Czego będziesz potrzebować + +- **.NET 6.0 lub nowszy** – Aspose.HTML celuje w .NET Standard 2.0+, więc każdy nowoczesny SDK zadziała. +- **Aspose.HTML for .NET** pakiet NuGet (`Aspose.Html`) – będziesz potrzebować ważnej licencji do produkcji, ale darmowa wersja próbna działa do testów. +- Prosty **plik HTML**, który chcesz przekształcić w PDF (nazwijmy go `input.html`). +- Twoje ulubione IDE (Visual Studio, Rider lub VS Code) – nie wymaga specjalnych narzędzi. + +To wszystko. Brak zewnętrznych konwerterów PDF, brak skomplikowanych poleceń wiersza. Po prostu czysty C#. + +![Diagram przedstawiający przepływ konwersji html do pdf przy użyciu Aspose.HTML](/images/convert-html-to-pdf-workflow.png "przepływ konwersji html do pdf") + +## Konwertowanie HTML do PDF – Pełna implementacja + +Poniżej znajduje się kompletny, gotowy do uruchomienia program. Skopiuj‑wklej go do nowej aplikacji konsolowej, przywróć pakiety NuGet i naciśnij **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Dlaczego to działa + +- **`Document`** jest punktem wejścia Aspose.HTML; parsuje HTML, rozwiązuje CSS i buduje DOM gotowy do renderowania. +- **`PdfRenderingOptions`** pozwala dostosować wyjście. Flaga `UseHinting` jest sekretnym składnikiem zapewniającym wyraźny tekst w kontenerach Linux bez interfejsu graficznego, gdzie domyślny rasterizer może być rozmyty. +- **`Save`** wykonuje ciężką pracę: rasteryzuje DOM na stronach PDF, respektuje podziały stron i automatycznie osadza czcionki. + +Uruchomienie programu wygeneruje `output.pdf` tuż obok pliku źródłowego. Otwórz go dowolnym przeglądarką PDF i powinieneś zobaczyć wierne odwzorowanie oryginalnego HTML. + +## Jak renderować HTML do PDF w C# – Krok po kroku + +Poniżej rozkładamy proces na małe kawałki, wyjaśniając **jak renderować HTML do PDF w C#**, jednocześnie omawiając typowe pułapki. + +### Krok 1 – Zainstaluj pakiet NuGet Aspose.HTML + +Otwórz terminal w folderze projektu i wykonaj: + +```bash +dotnet add package Aspose.Html +``` + +Jeśli wolisz interfejs Visual Studio, kliknij prawym przyciskiem projektu → **Manage NuGet Packages** → wyszukaj **Aspose.Html** i zainstaluj najnowszą stabilną wersję. + +> **Pro tip:** Po instalacji dodaj plik licencyjny (`Aspose.Total.lic`) do katalogu głównego projektu, aby uniknąć znaków wodnych wersji ewaluacyjnej. + +### Krok 2 – Załaduj swój HTML poprawnie + +Aspose.HTML może przyjmować: + +- Ścieżki do plików lokalnych (`new Document("file.html")`) +- Adresy URL (`new Document("https://example.com")`) +- Surowe ciągi HTML (`new Document("…", new HtmlLoadOptions())`) + +Ładując z systemu plików, upewnij się, że ścieżka jest bezwzględna lub że katalog roboczy jest ustawiony prawidłowo, w przeciwnym razie napotkasz `FileNotFoundException`. Na Linuxie używaj ukośników (`/`) lub `Path.Combine`. + +### Krok 3 – Wybierz odpowiednie opcje renderowania + +Oprócz `UseHinting` możesz chcieć dostosować: + +| Opcja | Co robi | Kiedy używać | +|-------|---------|--------------| +| `PageSize` | Ustawia wymiary strony PDF (A4, Letter, własne) | Dopasuj do docelowego rozmiaru papieru | +| `Landscape` | Obraca stronę w tryb poziomy | Szerokie tabele lub wykresy | +| `RasterizeVectorGraphics` | Wymusza rasteryzację grafiki wektorowej na obrazy | Gdy odbiorca PDF nie obsługuje SVG | +| `CompressionLevel` | Kontroluje kompresję obrazów (0‑9) | Zmniejsz rozmiar pliku przy załączaniu do e‑maila | + +Możesz łączyć te właściwości płynnie: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Krok 4 – Zapisz PDF + +Przeciążenie metody `Save`, które widzisz w pełnym przykładzie, zapisuje bezpośrednio do ścieżki pliku. Możesz także przesłać PDF do pamięci: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +To przydatne, gdy musisz zwrócić PDF jako pobranie z API webowego. + +### Krok 5 – Zweryfikuj wynik + +Szybka kontrola to porównanie liczby stron PDF z oczekiwaną liczbą sekcji HTML. Możesz odczytać ją ponownie przy użyciu Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Jeśli liczba się nie zgadza, sprawdź reguły CSS `page-break` lub odpowiednio dostosuj `PdfRenderingOptions`. + +## Przypadki brzegowe i typowe pułapki + +| Sytuacja | Na co zwrócić uwagę | Rozwiązanie | +|----------|---------------------|-------------| +| **Brak zewnętrznych zasobów (obrazów, czcionek)** | Względne adresy URL są rozwiązywane względem folderu pliku HTML. | Użyj `HtmlLoadOptions.BaseUri`, aby wskazać właściwy katalog główny. | +| **Środowisko Linux bez interfejsu graficznego** | Domyślne renderowanie tekstu może być rozmyte. | Ustaw `UseHinting = true` (jak pokazano) i upewnij się, że zainstalowano `libgdiplus`, jeśli korzystasz z System.Drawing. | +| **Duży HTML (> 10 MB)** | Wzrost zużycia pamięci podczas renderowania. | Renderuj stronę po stronie przy użyciu `PdfRenderer` z `PdfRenderingOptions` i zwalniaj każdą stronę po zapisaniu. | +| **Strony intensywnie używające JavaScript** | Aspose.HTML nie wykonuje JS; dynamiczna zawartość pozostaje statyczna. | Wstępnie przetwórz HTML po stronie serwera (np. przy użyciu Puppeteer) przed przekazaniem go do Aspose.HTML. | +| **Znaki Unicode wyświetlane jako kwadraty** | Brak czcionek w środowisku uruchomieniowym. | Osadź własne czcionki poprzez `FontSettings` lub zapewnij, że system operacyjny ma wymagane czcionki. | + +## Pełny działający przykład – podsumowanie + +Oto cały program ponownie, bez komentarzy, dla tych, którzy wolą zwięzły widok: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Uruchom go, otwórz `output.pdf` i zobaczysz wierną kopię `input.html`. To istota **konwersji html do pdf** z Aspose.HTML. + +## Zakończenie + +Przeszliśmy przez wszystko, co potrzebne, aby **konwertować HTML do PDF** w C#: instalację Aspose.HTML, ładowanie HTML, dostosowywanie opcji renderowania (w tym kluczowej flagi `UseHinting`) oraz zapis końcowego PDF. Teraz rozumiesz **jak renderować HTML do PDF w C#** zarówno w środowiskach Windows, jak i Linux oraz wiesz, jak radzić sobie z typowymi przypadkami brzegowymi, takimi jak brakujące zasoby czy duże pliki. + +Co dalej? Spróbuj dodać: + +- **Nagłówki/stopki** z `PdfPageTemplate` dla brandingu. +- **Ochronę hasłem** za pomocą `PdfSaveOptions`. +- **Konwersję wsadową** przez iterację po folderze zawierającym ... + +## Powiązane tutoriale + +- [Konwertowanie HTML do PDF w .NET z Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Konwertowanie EPUB do PDF w .NET z Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Konwertowanie SVG do PDF w .NET z Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/polish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/polish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..738dcc377 --- /dev/null +++ b/html/polish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,295 @@ +--- +category: general +date: 2026-05-22 +description: Renderuj HTML jako PDF przy użyciu C# w krótkim przykładzie. Dowiedz + się, jak szybko i niezawodnie konwertować HTML do PDF w C#. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: pl +og_description: Renderuj HTML jako PDF w C# z przejrzystym, gotowym do uruchomienia + przykładem. Ten przewodnik pokazuje, jak konwertować HTML na PDF w C# i generować + PDF z pliku HTML. +og_title: Renderowanie HTML jako PDF w C# – Kompletny poradnik programistyczny +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Renderowanie HTML jako PDF w C# – Kompletny przewodnik krok po kroku +url: /pl/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Renderowanie HTML jako PDF w C# – Pełny przewodnik krok po kroku + +Kiedykolwiek potrzebowałeś **renderować HTML jako PDF**, ale nie byłeś pewien, którą bibliotekę wybrać do projektu .NET? Nie jesteś sam. W wielu aplikacjach biznesowych znajdziesz się w sytuacji, w której musisz **konwertować HTML do PDF C#** dla faktur, raportów lub broszur marketingowych — w zasadzie za każdym razem, gdy potrzebujesz wersji do druku strony internetowej. + +Oto prawda: nie musisz wynajdywać koła na nowo. Kilkoma liniami kodu możesz wziąć plik `input.html`, przekazać go do sprawdzonego silnika renderującego i otrzymać wyraźny `output.pdf`. W tym samouczku przeprowadzimy Cię przez cały proces, od dodania odpowiedniego pakietu NuGet po obsługę przypadków brzegowych, takich jak zewnętrzny CSS. Po zakończeniu będziesz w stanie **generować PDF z pliku HTML** w ciągu kilku minut. + +## Co się nauczysz + +- Jak skonfigurować aplikację konsolową .NET, która **tworzy PDF z HTML C#**. +- Dokładne wywołania API, które są potrzebne do **zapisania dokumentu HTML jako PDF**. +- Dlaczego niektóre opcje renderowania (np. hinting) mają znaczenie dla jakości tekstu. +- Wskazówki dotyczące rozwiązywania typowych problemów, takich jak brakujące czcionki lub względne ścieżki do obrazów. + +**Wymagania wstępne** – powinieneś mieć zainstalowany .NET 6+ lub .NET Framework 4.7, podstawową znajomość C# oraz IDE (Visual Studio 2022, Rider lub VS Code). Wcześniejsze doświadczenie z PDF nie jest wymagane. + +--- + +## Renderowanie HTML jako PDF – Konfiguracja projektu + +Zanim zanurkujemy w kod, upewnijmy się, że środowisko programistyczne jest gotowe. Biblioteką, której użyjemy, jest **Select.Pdf** (darmowa do użytku niekomercyjnego), ponieważ oferuje prostą API i solidną jakość renderowania. + +### Zainstaluj bibliotekę renderującą PDF (convert html to pdf c#) + +Otwórz terminal w folderze projektu i uruchom: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Jeśli używasz Visual Studio, możesz również dodać pakiet za pomocą interfejsu NuGet Package Manager. Numer wersji może być nowszy — po prostu pobierz najnowsze stabilne wydanie. + +### Utwórz szkielet aplikacji konsolowej + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +To wszystko, czego potrzebujesz jako szkielet. Ciężka praca odbywa się wewnątrz `Main`. + +## Ładowanie dokumentu HTML (generate pdf from html file) + +Pierwszym prawdziwym krokiem jest skierowanie renderera na plik HTML znajdujący się na dysku. Select.Pdf oferuje dwa wygodne sposoby: przekazanie surowego ciągu HTML lub ścieżki do pliku. Użycie pliku utrzymuje porządek, szczególnie gdy masz powiązany CSS lub obrazy. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Tutaj również zabezpieczamy się przed brakującym plikiem — coś, co potrafi zaskoczyć początkujących, gdy zapomną skopiować HTML do folderu wyjściowego. + +## Konfiguracja opcji renderowania (create pdf from html c#) + +Select.Pdf dostarcza rozbudowany obiekt `PdfDocumentOptions`. Aby uzyskać wyraźny tekst, włączamy hinting, który wygładza glify kosztem niewielkiego spadku wydajności. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Możesz tutaj dostosować rozmiar strony, marginesy lub nawet osadzić własną czcionkę. Najważniejsze, że **render html as pdf** nie jest jedynie jedną linią kodu; masz kontrolę nad wyglądem i odczuciem końcowego dokumentu. + +## Zapisz dokument HTML jako PDF (render html as pdf) + +Teraz dzieje się magia. Przekazujemy konwerterowi ścieżkę do naszego pliku HTML i prosimy go o zapisanie PDF na dysku. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +Metoda `ConvertUrl` automatycznie rozwiązuje względne adresy URL (obrazy, CSS) na podstawie lokalizacji pliku HTML, co sprawia, że to podejście jest solidne w większości rzeczywistych scenariuszy. + +### Oczekiwany wynik + +Po uruchomieniu programu powinieneś zobaczyć plik `output.pdf` w tym samym folderze. Otwórz go — zauważysz: + +- Tekst renderowany z wyraźnym antyaliasingiem (dzięki hintingowi). +- Style z powiązanego CSS zastosowane poprawnie. +- Obrazy wyświetlane w dokładnym rozmiarze określonym w źródłowym HTML. + +Jeśli coś wygląda nieprawidłowo, sprawdź ponownie, czy pliki CSS i obrazy znajdują się obok `input.html` lub użyj bezwzględnych adresów URL. + +## Obsługa typowych przypadków brzegowych + +### 1. Zewnętrzne zasoby blokowane przez zapory sieciowe + +Jeśli Twój HTML odwołuje się do czcionek hostowanych na CDN, do którego serwer nie ma dostępu, PDF może przejść na czcionkę domyślną. Aby tego uniknąć, pobierz pliki czcionek lokalnie lub osadź je przy użyciu `@font-face` ze względną ścieżką. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Bardzo duże pliki HTML + +Podczas konwersji ogromnych dokumentów możesz natrafić na limity pamięci. Select.Pdf umożliwia strumieniowanie konwersji: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Strumieniowanie utrzymuje proces lekki, ale wymaga dostarczenia HTML jako ciągu znaków, który możesz odczytywać w kawałkach w razie potrzeby. + +### 3. Niestandardowe nagłówki lub stopki + +Jeśli potrzebujesz numeru strony lub logo firmy na każdej stronie, ustaw właściwości `Header` i `Footer` w `converter.Options` przed wywołaniem `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +## Pełny działający przykład (wszystkie kroki połączone) + +Poniżej znajduje się kompletny, gotowy do skopiowania i wklejenia program. Zastąp `YOUR_DIRECTORY` absolutną ścieżką, w której znajduje się Twój HTML. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Uruchom:** `dotnet run` z katalogu projektu. Jeśli wszystko jest poprawnie skonfigurowane, zobaczysz komunikat o sukcesie i błyszczący `output.pdf`. + +## Podsumowanie wizualne + +![Render HTML as PDF example](render-html-as-pdf.png){alt="przykład renderowania html jako pdf"} + +Zrzut ekranu pokazuje wyjście konsoli oraz wynikowy PDF otwarty w przeglądarce. Zauważ wyraźne nagłówki i prawidłowo załadowane obrazy — dokładnie to, czego oczekujesz, gdy **render html as pdf**. + +## Zakończenie + +Właśnie nauczyłeś się, jak **renderować HTML jako PDF** w aplikacji C#, od instalacji biblioteki po precyzyjne dostosowanie opcji renderowania. Pełny przykład pokazuje niezawodny sposób na **konwersję HTML do PDF C#**, **generowanie PDF z pliku HTML** oraz **zapisanie dokumentu HTML jako PDF** przy użyciu zaledwie kilku linii kodu. + +Co dalej? Spróbuj poeksperymentować z: + +- Dodawanie własnych czcionek dla spójności marki. +- Generowanie PDF z dynamicznych ciągów HTML (np. szablony Razor). +- Scalanie wielu PDF-ów w jeden raport przy użyciu `PdfDocument.AddPage`. + +Każde z tych rozszerzeń opiera się na podstawowych koncepcjach omówionych tutaj, więc będziesz gotowy, aby podjąć się bardziej zaawansowanych scenariuszy bez stromej krzywej uczenia się. + +Masz pytania lub napotkałeś problem? Dodaj komentarz poniżej, a wspólnie rozwiążemy problem. Szczęśliwego kodowania! + +## Powiązane samouczki + +- [Konwertuj HTML do PDF w .NET przy użyciu Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Utwórz dokument HTML ze stylowanym tekstem i wyeksportuj do PDF – Pełny przewodnik](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Konwertuj HTML do PDF przy użyciu Aspose.HTML – Pełny przewodnik manipulacji](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/polish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/polish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..a434f5c19 --- /dev/null +++ b/html/polish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-05-22 +description: Szybko zapisz HTML jako ZIP przy użyciu Aspose.HTML. Dowiedz się, jak + spakować pliki HTML, renderować HTML do ZIP oraz eksportować HTML do pliku ZIP z + pełnym kodem. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: pl +og_description: Zapisz HTML jako ZIP przy użyciu Aspose.HTML. Ten przewodnik pokazuje, + jak renderować HTML do ZIP, eksportować HTML do pliku ZIP oraz programowo kompresować + pliki HTML. +og_title: Zapisz HTML jako ZIP – Kompletny samouczek Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Zapisz HTML jako ZIP – Kompletny przewodnik dla Aspose.HTML +url: /pl/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Zapisz HTML jako ZIP – Kompletny przewodnik dla Aspose.HTML + +Zastanawiałeś się kiedyś, jak **save HTML as ZIP** bez wyciągania oddzielnego narzędzia do archiwizacji? Nie jesteś jedyny. Wielu programistów musi spakować stronę HTML razem z jej obrazami, CSS i skryptami, aby łatwo ją dystrybuować, a ręczne robienie tego szybko staje się problematyczne. + +W tym samouczku przeprowadzimy Cię przez czyste, kompleksowe rozwiązanie, które **renders HTML to ZIP** przy użyciu Aspose.HTML dla .NET. Po zakończeniu dokładnie będziesz wiedział, jak **export HTML to a ZIP file**, a także zobaczysz warianty **how to zip HTML files** w różnych scenariuszach. + +> *Pro tip:* Podejście pokazane działa zarówno przy pakowaniu pojedynczej strony, jak i całego folderu witryny. + +## Czego będziesz potrzebował + +- .NET 6 (lub dowolny nowszy runtime .NET) zainstalowany. +- Pakiet NuGet Aspose.HTML for .NET (`Aspose.Html`) dodany do Twojego projektu. +- Prosty plik `input.html` umieszczony w folderze, którym zarządzasz. +- Trochę znajomości C# — nic skomplikowanego, tylko podstawy. + +To wszystko. Bez zewnętrznych narzędzi zip, bez gimnastyki w wierszu poleceń. Zaczynajmy. + +![Diagram przedstawiający proces zapisywania HTML jako ZIP przy użyciu Aspose.HTML](save-html-as-zip.png) + +*Tekst alternatywny obrazu: diagram procesu zapisywania html jako zip* + +## Krok 1: Załaduj źródłowy dokument HTML + +Pierwszą rzeczą, którą musimy zrobić, jest poinformowanie Aspose.HTML, gdzie znajduje się nasze źródło. Klasa `HTMLDocument` odczytuje plik i buduje DOM w pamięci, gotowy do renderowania. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Dlaczego to ważne: załadowanie dokumentu daje bibliotece pełną kontrolę nad rozwiązywaniem zasobów (obrazy, CSS, czcionki). Jeśli HTML odwołuje się do ścieżek względnych, Aspose.HTML automatycznie rozwiązuje je względem folderu pliku. + +## Krok 2: (Opcjonalnie) Utwórz własny Resource Handler + +Jeśli potrzebujesz sprawdzić lub zmodyfikować każdy zasób — na przykład chcesz skompresować obrazy przed umieszczeniem ich w archiwum — możesz podłączyć `ResourceHandler`. Ten krok jest opcjonalny, ale jest najbardziej elastycznym sposobem na **convert HTML to ZIP archive** przy użyciu własnej logiki. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Co jeśli nie potrzebujesz żadnego specjalnego przetwarzania?* Po prostu pomiń tę klasę i użyj domyślnego handlera — Aspose.HTML zapisze zasoby bezpośrednio do ZIP. + +## Krok 3: Skonfiguruj opcje zapisu, aby używać handlera + +Obiekt `HtmlSaveOptions` informuje renderer, co zrobić z zasobami. Przypisując nasz `MyResourceHandler`, uzyskujemy pełną kontrolę nad wyjściem. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Zauważ, że nazwa właściwości `ResourceHandler` bezpośrednio odnosi się do możliwości **render HTML to ZIP**. To właśnie tutaj dzieje się magia: każdy powiązany zasób jest strumieniowany do archiwum zamiast zapisywany na dysku. + +## Krok 4: Zapisz wyrenderowany dokument do archiwum ZIP + +Teraz w końcu **export HTML to a ZIP file**. Metoda `Save` przyjmuje dowolny `Stream`, więc możemy skierować ją na `FileStream`, który tworzy `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +To cały przepływ pracy. Po zakończeniu kodu, `result.zip` zawiera: + +- `input.html` (oryginalny markup) +- Wszystkie odwołane obrazy, pliki CSS i czcionki +- Wszelkie przekształcone zasoby, jeśli zmodyfikowałeś je w `MyResourceHandler` + +## Jak spakować pliki HTML bez Aspose.HTML (szybka alternatywa) + +Czasami potrzebujesz po prostu tradycyjnego podejścia **how to zip HTML files**, być może dlatego, że już używasz innego parsera HTML. W takim przypadku możesz użyć wbudowanego w .NET `System.IO.Compression`: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Ta metoda jest prosta, ale brakuje w niej kroku renderowania; po prostu pakuje to, co znajduje się na dysku. Jeśli Twój HTML odwołuje się do zewnętrznych URL‑i, te zasoby nie zostaną uwzględnione. Dlatego droga Aspose.HTML jest preferowana, gdy potrzebujesz niezawodnego rozwiązania **render HTML to ZIP**. + +## Przypadki brzegowe i typowe pułapki + +| Sytuacja | Na co zwrócić uwagę | Zalecane rozwiązanie | +|-----------|-------------------|-----------------| +| **Duże obrazy** | Wzrost zużycia pamięci, ponieważ każdy obraz jest ładowany do `MemoryStream`. | Strumieniuj bezpośrednio do zip przy użyciu własnego handlera, który kopiuje źródłowy strumień zamiast pełnego buforowania. | +| **Zewnętrzne URL‑e** | Zasoby hostowane w internecie nie są pobierane automatycznie. | Ustaw `HtmlLoadOptions` z `BaseUrl` wskazującym na korzeń witryny lub ręcznie pobierz zasoby przed zapisem. | +| **Kolizje nazw plików** | Dwa pliki CSS o tej samej nazwie w różnych podfolderach mogą nadpisywać się nawzajem. | Upewnij się, że `ResourceHandler` zachowuje pełną względną ścieżkę przy zapisie do zip. | +| **Błędy uprawnień** | Próba zapisu do folderu tylko do odczytu powoduje wyrzucenie `UnauthorizedAccessException`. | Uruchom proces z odpowiednimi uprawnieniami lub wybierz zapisywalny katalog wyjściowy. | + +Rozwiązanie tych scenariuszy sprawia, że Twoja rutyna **convert HTML to ZIP archive** jest solidna w środowisku produkcyjnym. + +## Pełny działający przykład (wszystkie elementy razem) + +Poniżej znajduje się kompletny, gotowy do uruchomienia program. Wklej go do nowej aplikacji konsolowej, zaktualizuj ścieżki i naciśnij **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Oczekiwany wynik:** Konsola wyświetla komunikat o sukcesie, a plik `result.zip` zawiera `input.html` oraz wszystkie zależne zasoby. Otwórz ZIP, dwukrotnie kliknij `input.html` i zobaczysz stronę wyrenderowaną dokładnie tak, jak w przeglądarce — bez brakujących obrazów, bez zepsutego CSS. + +## Podsumowanie – Dlaczego to podejście jest świetne + +- **Renderowanie jednoczesne:** Nie musisz ręcznie kopiować każdego zasobu; Aspose.HTML robi to za Ciebie. +- **Konfigurowalny pipeline:** `ResourceHandler` daje pełną kontrolę nad tym, jak każdy plik jest przechowywany, umożliwiając kompresję, szyfrowanie lub transformację w locie. +- **Cross‑platform:** Działa na Windows, Linux i macOS, o ile masz runtime .NET. +- **Brak zewnętrznych narzędzi:** Cały proces **save HTML as ZIP** odbywa się wewnątrz Twojej bazy kodu C#. + +## Co dalej? + +Teraz, gdy opanowałeś **save HTML as ZIP**, rozważ zgłębienie następujących powiązanych tematów: + +- **Export HTML to PDF** – idealny do raportów do druku (wiedza o `export html to zip file` pomaga, gdy potrzebujesz obu formatów). +- **Streaming ZIP directly to HTTP response** – świetny dla API webowych, które pozwalają użytkownikom pobrać spakowaną witrynę w locie. +- **Encrypting ZIP archives** – dodaj warstwę hasła, jeśli pracujesz z poufną dokumentacją. + +Śmiało eksperymentuj: zamień `MyResourceHandler` na kompresor, który zmniejsza obrazy, lub dodaj plik manifestu wymieniający wszystkie spakowane zasoby. Nie ma granic, gdy kontrolujesz pipeline renderowania. + +--- + +*Szczęśliwego kodowania! Jeśli napotkasz problemy lub masz pomysły na ulepszenia, zostaw komentarz poniżej. Rozwiążemy to razem.* + +## Powiązane samouczki + +- [Jak spakować HTML w C# – Zapisz HTML do Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Zapisz HTML jako ZIP – Kompletny samouczek C#](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Zapisz HTML do ZIP w C# – Kompletny przykład w pamięci](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/portuguese/net/generate-jpg-and-png-images/_index.md b/html/portuguese/net/generate-jpg-and-png-images/_index.md index 25a4d8da7..204d6127e 100644 --- a/html/portuguese/net/generate-jpg-and-png-images/_index.md +++ b/html/portuguese/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aprenda a usar Aspose.HTML para .NET para manipular documentos HTML, converter H Aprenda a ativar antialiasing ao converter documentos DOCX em imagens PNG ou JPG usando Aspose.HTML para .NET. ### [Converter docx para png – criar arquivo zip em C# tutorial](./convert-docx-to-png-create-zip-archive-c-tutorial/) Aprenda a converter documentos DOCX em imagens PNG e compactá-los em um arquivo ZIP usando C# e Aspose.HTML. +### [Definir Largura e Altura da Imagem ao Converter Word para PNG – Guia Completo](./set-image-width-height-when-converting-word-to-png-full-guid/) +Aprenda a definir largura e altura ao converter documentos Word em imagens PNG usando Aspose.HTML para .NET. ## Conclusão diff --git a/html/portuguese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/portuguese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..07f67963d --- /dev/null +++ b/html/portuguese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,276 @@ +--- +category: general +date: 2026-05-22 +description: Defina a largura e a altura da imagem ao converter um documento Word + para PNG. Aprenda a exportar docx como imagem com renderização de alta qualidade + em um tutorial passo a passo. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: pt +og_description: Defina a largura e a altura da imagem ao converter um documento Word + para PNG. Este tutorial mostra como exportar um docx como imagem com configurações + de alta qualidade. +og_title: Defina Largura e Altura da Imagem ao Converter Word para PNG – Guia Completo +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Defina a Largura e Altura da Imagem ao Converter Word para PNG – Guia Completo +url: /pt/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Definir Largura e Altura da Imagem ao Converter Word para PNG – Guia Completo + +Já se perguntou como **definir largura e altura da imagem** enquanto **converte Word para PNG**? Você não está sozinho. Muitos desenvolvedores se deparam com um obstáculo quando a exportação padrão gera uma imagem borrada ou com dimensões erradas, e então passam horas procurando uma solução que realmente funcione. + +Neste tutorial, percorreremos uma solução limpa e de ponta a ponta que mostra **como renderizar documentos Word** como imagens PNG, permitindo que você **salve docx como PNG** com controle preciso de largura‑altura e antialiasing de alta qualidade. Ao final, você terá um trecho de código pronto para usar, uma compreensão sólida das opções da API e algumas dicas avançadas para evitar armadilhas comuns. + +## O que você aprenderá + +- Carregar um arquivo `.docx` usando Aspose.Words for .NET. +- **Definir largura e altura da imagem** com `ImageRenderingOptions`. +- **Exportar docx como imagem** (PNG) com antialiasing habilitado. +- Como **converter word para png** para uma única página ou todo o documento. +- Dicas para lidar com documentos grandes, considerações de DPI e caminhos de sistema de arquivos. + +Sem ferramentas externas, sem complicações de linha de comando — apenas código C# puro que você pode inserir em qualquer projeto .NET. + +--- + +## Pré-requisitos + +Antes de mergulharmos, certifique‑se de que você tem o seguinte: + +| Requirement | Why it matters | +|-------------|----------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words suporta ambos, mas runtimes mais recentes oferecem melhor desempenho. | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | Fornece a classe `Document` e o motor de renderização. | +| A **Word document** (`.docx`) you want to turn into a PNG. | A fonte que você irá converter. | +| Basic C# knowledge – you’ll understand `using` statements and object initialization. | Mantém a curva de aprendizado suave. | + +Se você não tem o pacote NuGet, execute isto no Console do Gerenciador de Pacotes: + +```powershell +Install-Package Aspose.Words +``` + +É isso — uma vez que o pacote esteja instalado, você está pronto para começar a codificar. + +--- + +## Etapa 1: Carregar o Documento Fonte + +A primeira coisa que você precisa fazer é apontar a biblioteca para o arquivo Word que deseja transformar. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Por que isso importa:** A classe `Document` lê todo o pacote Word na memória, dando acesso a páginas, estilos e tudo mais. Se o caminho estiver errado, você receberá uma `FileNotFoundException`, então verifique se o arquivo existe e se o caminho usa barras invertidas escapadas (`\\`) ou uma string literal (`@`). + +> **Dica profissional:** Envolva a chamada de carregamento em um bloco `try/catch` se você esperar que o arquivo possa estar ausente em tempo de execução. + +--- + +## Etapa 2: Configurar Opções de Renderização de Imagem (Definir Largura e Altura da Imagem) + +Agora vem o coração do tutorial: **como definir largura e altura da imagem** para que o PNG resultante não fique esticado ou pixelado. A classe `ImageRenderingOptions` oferece controle detalhado sobre dimensões, DPI e suavização. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Explicação das propriedades principais:** + +- `Width` e `Height` – Estas são as dimensões exatas em pixels que você deseja. Ao defini-las, você **define largura e altura da imagem** diretamente, sobrescrevendo o tamanho padrão da página. +- `UseAntialiasing` – Habilita suavização de alta qualidade para texto e gráficos vetoriais, o que é crucial quando você **converte word para png** e deseja bordas nítidas. +- `Resolution` – DPI mais alto gera mais detalhes, especialmente em layouts complexos. Fique atento ao uso de memória; uma imagem de 300 DPI pode ser grande. + +> **Por que não confiar apenas no tamanho padrão?** O padrão usa as dimensões físicas da página (por exemplo, A4 a 96 DPI). Isso frequentemente produz uma imagem de 794 × 1123 pixels — adequado para alguns casos, mas não quando você precisa de uma miniatura de UI específica ou de uma pré‑visualização de tamanho fixo. + +--- + +## Etapa 3: Renderizar e Salvar como PNG (Exportar Docx como Imagem) + +Com o documento carregado e as opções configuradas, você pode finalmente **exportar docx como imagem**. O método `RenderToImage` faz o trabalho pesado. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Se você quiser renderizar **todo o documento** (todas as páginas) em arquivos PNG separados, faça um loop sobre a coleção de páginas: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**O que está acontecendo nos bastidores?** O renderizador rasteriza cada página usando as dimensões que você forneceu, aplica antialiasing e grava um fluxo de bytes PNG no disco. Como o PNG é sem perdas, você mantém a fidelidade total do layout original do Word. + +**Saída esperada:** Um arquivo PNG nítido exatamente de 1024 × 768 pixels (ou o tamanho que você definiu). Abra‑o em qualquer visualizador de imagens e você verá o conteúdo do Word renderizado exatamente como aparece no documento original, mas agora como uma imagem bitmap. + +--- + +## Dicas Avançadas e Variações + +### 1. Preservar Fundos Transparentes + +Se o seu documento Word contém formas com fundos transparentes e você deseja manter essa transparência, defina `BackgroundColor` como `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Renderizar Apenas um Intervalo Específico + +Às vezes você precisa apenas de um parágrafo ou de uma tabela, não da página inteira. Use `DocumentVisitor` para extrair o nó e renderiz‑lo separadamente. Esse é um cenário mais avançado, mas demonstra **como renderizar word** em nível granular. + +### 3. Ajustar DPI Dinamicamente + +Se você precisar de DPI diferente por página (por exemplo, alta resolução para a capa), modifique `Resolution` dentro do loop: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Processamento em Lote + +Ao converter dezenas de documentos, envolva todo o fluxo em um método e reutilize a mesma instância de `ImageRenderingOptions`. Reutilizar o objeto de opções reduz a sobrecarga de alocação. + +--- + +## Armadilhas Comuns e Como Evitá‑las + +| Symptom | Likely Cause | Fix | +|---------|--------------|-----| +| PNG está borrado apesar de DPI alto | `UseAntialiasing` deixado como `false` | Defina `UseAntialiasing = true`. | +| Tamanho de saída não corresponde a `Width`/`Height` | DPI não considerado | Multiplique o tamanho desejado por `Resolution / 96` ou ajuste `Resolution`. | +| Exceção Out‑of‑memory em documentos grandes | Renderizando todo o documento a 300 DPI | Renderize uma página por vez, descarte cada imagem após salvar. | +| PNG mostra fundo branco em imagens transparentes | `BackgroundColor` não definido | Defina `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Exemplo Completo Funcionando + +Abaixo está um programa autônomo que você pode copiar e colar em um aplicativo console. Ele demonstra **converter word para png**, **salvar docx como png**, e claro **definir largura e altura da imagem**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Execute:** Compile o projeto, coloque um `input.docx` válido no caminho que você especificou e execute. Você deverá ver um `output.png` exatamente **1024 × 768** pixels, renderizado com bordas suaves. + +--- + +## Tutoriais Relacionados + +- [Como Habilitar Antialiasing ao Converter DOCX para PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [converter docx para png – tutorial de criação de arquivo zip em C#](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Como Usar Aspose para Renderizar HTML em PNG – Guia Passo a Passo](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/portuguese/net/html-extensions-and-conversions/_index.md b/html/portuguese/net/html-extensions-and-conversions/_index.md index 8971d46a5..bd52876b7 100644 --- a/html/portuguese/net/html-extensions-and-conversions/_index.md +++ b/html/portuguese/net/html-extensions-and-conversions/_index.md @@ -40,6 +40,12 @@ Aspose.HTML para .NET não é apenas uma biblioteca; é um divisor de águas no ### [Converter HTML para PDF no .NET com Aspose.HTML](./convert-html-to-pdf/) Converta HTML para PDF sem esforço com Aspose.HTML para .NET. Siga nosso guia passo a passo e libere o poder da conversão de HTML para PDF. +### [Converter HTML para PDF com C# – Guia Completo](./convert-html-to-pdf-with-c-complete-guide/) +Aprenda a converter HTML para PDF usando C# com Aspose.HTML, seguindo um guia passo a passo completo. + +### [Renderizar HTML como PDF em C# – Guia Completo Passo a Passo](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Aprenda a renderizar HTML como PDF usando C# com Aspose.HTML, seguindo um guia passo a passo completo. + ### [Criar PDF a partir de HTML – Guia passo a passo em C#](./create-pdf-from-html-c-step-by-step-guide/) Aprenda a criar um PDF a partir de HTML usando C# com Aspose.HTML, seguindo um guia passo a passo. @@ -78,6 +84,9 @@ Aprenda a criar um arquivo ZIP contendo arquivos HTML usando Aspose.HTML para .N ### [Salvar HTML em ZIP em C# – Exemplo Completo em Memória](./save-html-to-zip-in-c-complete-in-memory-example/) Aprenda a salvar arquivos HTML em um arquivo ZIP usando C# com um exemplo completo totalmente em memória. +### [Salvar HTML como ZIP – Guia Completo para Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Aprenda a salvar documentos HTML como arquivos ZIP usando Aspose.HTML, com um guia passo a passo completo. + ## Conclusão Concluindo, extensões e conversões HTML são elementos essenciais do desenvolvimento web moderno. O Aspose.HTML para .NET simplifica o processo e o torna acessível a desenvolvedores de todos os níveis. Ao seguir nossos tutoriais, você estará no caminho certo para se tornar um desenvolvedor web proficiente com um amplo conjunto de habilidades. diff --git a/html/portuguese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/portuguese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..d77d64969 --- /dev/null +++ b/html/portuguese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,257 @@ +--- +category: general +date: 2026-05-22 +description: Converta HTML para PDF em C# usando Aspose.HTML. Aprenda como renderizar + HTML para PDF em C# com código passo a passo, opções e dicas para Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: pt +og_description: Converta HTML para PDF em C# com Aspose.HTML. Este guia mostra como + renderizar HTML para PDF em C# usando opções claras e dicas compatíveis com Linux. +og_title: Converter HTML para PDF com C# – Guia Completo +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Converter HTML para PDF com C# – Guia Completo +url: /pt/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Converter HTML para PDF com C# – Guia Completo + +Se você precisa **converter HTML para PDF** rapidamente, o Aspose.HTML para .NET facilita muito. Neste tutorial também responderemos **como renderizar HTML para PDF em C#** com controle total sobre as opções de renderização, para que você não fique no escuro. + +Imagine que você tem um modelo de e‑mail de marketing, uma página de recibo ou um relatório complexo construído com CSS moderno, e precisa entregá‑lo como PDF a um cliente ou a uma impressora. Fazer isso manualmente é um incômodo, mas algumas linhas de código C# podem automatizar todo o fluxo. Ao final deste guia você terá uma solução autônoma, pronta para produção, que funciona no Windows *e* Linux. + +## O que você precisará + +- **.NET 6.0 ou posterior** – Aspose.HTML tem como alvo .NET Standard 2.0+, então qualquer SDK recente funciona. +- **Aspose.HTML for .NET** pacote NuGet (`Aspose.Html`) – você precisará de uma licença válida para produção, mas o trial gratuito serve para testes. +- Um **arquivo HTML simples** que você deseja transformar em PDF (vamos chamá‑lo de `input.html`). +- Seu IDE favorito (Visual Studio, Rider ou VS Code) – nenhuma ferramenta especial é necessária. + +É só isso. Sem conversores externos de PDF, sem acrobacias de linha de comando. Apenas C# puro. + +![Diagrama ilustrando o fluxo de conversão de html para pdf usando Aspose.HTML](/images/convert-html-to-pdf-workflow.png "fluxo de conversão de html para pdf") + +## Converter HTML para PDF – Implementação Completa + +Abaixo está o programa completo, pronto‑para‑executar. Copie‑e‑cole em um novo aplicativo console, restaure os pacotes NuGet e pressione **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Por que isso funciona + +- **`Document`** é o ponto de entrada do Aspose.HTML; ele analisa o HTML, resolve o CSS e constrói um DOM pronto para renderização. +- **`PdfRenderingOptions`** permite ajustar a saída. O sinalizador `UseHinting` é o ingrediente secreto para texto nítido em contêineres Linux sem interface gráfica, onde o rasterizador padrão pode ficar borrado. +- **`Save`** faz o trabalho pesado: rasteriza o DOM nas páginas PDF, respeita quebras de página e incorpora fontes automaticamente. + +Executar o programa gerará `output.pdf` ao lado do seu arquivo fonte. Abra-o em qualquer visualizador de PDF e você verá uma correspondência visual fiel ao HTML original. + +## Como renderizar HTML para PDF em C# – Passo a passo + +A seguir dividimos o processo em partes menores, explicando **como renderizar HTML para PDF em C#** enquanto abordamos armadilhas comuns. + +### Etapa 1 – Instalar o pacote NuGet Aspose.HTML + +Abra o terminal na pasta do projeto e execute: + +```bash +dotnet add package Aspose.Html +``` + +Se preferir a interface do Visual Studio, clique com o botão direito no projeto → **Manage NuGet Packages** → procure por **Aspose.Html** e instale a versão estável mais recente. + +> **Pro tip:** Após a instalação, adicione um arquivo de licença (`Aspose.Total.lic`) na raiz do seu projeto para evitar marcas d'água de avaliação. + +### Etapa 2 – Carregar seu HTML corretamente + +Aspose.HTML pode ingerir: + +- Caminhos de arquivos locais (`new Document("file.html")`) +- URLs (`new Document("https://example.com")`) +- Strings HTML brutas (`new Document("…", new HtmlLoadOptions())`) + +Ao carregar a partir do sistema de arquivos, certifique‑se de que o caminho seja absoluto ou que o diretório de trabalho esteja configurado corretamente, caso contrário você encontrará uma `FileNotFoundException`. No Linux, use barras (`/`) ou `Path.Combine`. + +### Etapa 3 – Escolher as opções de renderização corretas + +Além de `UseHinting`, você pode querer ajustar: + +| Opção | O que faz | Quando usar | +|--------|--------------|----------------| +| `PageSize` | Define as dimensões da página PDF (A4, Letter, personalizado) | Para corresponder ao tamanho de papel alvo | +| `Landscape` | Rotaciona a página para paisagem | Tabelas ou gráficos largos | +| `RasterizeVectorGraphics` | Força gráficos vetoriais a imagens rasterizadas | Quando o consumidor do PDF não consegue lidar com SVG | +| `CompressionLevel` | Controla a compressão de imagens (0‑9) | Reduzir o tamanho do arquivo para anexos de e‑mail | + +Você pode encadear essas propriedades de forma fluente: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Etapa 4 – Salvar o PDF + +A sobrecarga do método `Save` que você vê no exemplo completo grava diretamente em um caminho de arquivo. Você também pode transmitir o PDF para a memória: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Isso é útil quando você precisa devolver o PDF como download de uma API web. + +### Etapa 5 – Verificar a saída + +Um rápido teste de sanidade é comparar a contagem de páginas do PDF com o número esperado de seções HTML. Você pode ler de volta com Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Se a contagem parecer errada, revise as regras CSS `page-break` ou ajuste `PdfRenderingOptions` conforme necessário. + +## Casos de borda e armadilhas comuns + +| Situação | O que observar | Correção | +|-----------|-------------------|-----| +| **Recursos externos (imagens, fontes) ausentes** | URLs relativas são resolvidas em relação à pasta do arquivo HTML. | Use `HtmlLoadOptions.BaseUri` para apontar para a raiz correta. | +| **Ambiente Linux sem interface gráfica** | A renderização padrão de texto pode ficar borrada. | Defina `UseHinting = true` (como mostrado) e garanta que `libgdiplus` esteja instalado se você recair para System.Drawing. | +| **HTML grande (> 10 MB)** | O consumo de memória dispara durante a renderização. | Renderize página a página usando `PdfRenderer` com `PdfRenderingOptions` e descarte cada página após salvar. | +| **Páginas pesadas em JavaScript** | Aspose.HTML não executa JS; conteúdo dinâmico permanece estático. | Pré‑procese o HTML no servidor (por exemplo, usando Puppeteer) antes de enviá‑lo ao Aspose.HTML. | +| **Caracteres Unicode aparecendo como quadrados** | Falta de fontes no ambiente de execução. | Incorpore fontes personalizadas via `FontSettings` ou assegure que o SO tenha as fontes necessárias instaladas. | + +## Recapitulação do exemplo completo em funcionamento + +Aqui está o programa inteiro novamente, sem comentários para quem prefere uma visão concisa: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Execute-o, abra `output.pdf` e você verá uma réplica pixel‑perfect de `input.html`. Essa é a essência de **converter html para pdf** com Aspose.HTML. + +## Conclusão + +Percorremos tudo o que você precisa para **converter HTML para PDF** em C#: instalar o Aspose.HTML, carregar HTML, ajustar opções de renderização (incluindo o crucial sinalizador `UseHinting`) e salvar o PDF final. Agora você entende **como renderizar HTML para PDF em C#** tanto em ambientes Windows quanto Linux, e viu como lidar com casos de borda comuns como recursos ausentes e arquivos grandes. + +O que vem a seguir? Experimente adicionar: + +- **Cabeçalhos/rodapés** com `PdfPageTemplate` para branding. +- **Proteção por senha** via `PdfSaveOptions`. +- **Conversão em lote** percorrendo uma pasta de + +## Tutoriais relacionados + +- [Converter HTML para PDF no .NET com Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Converter EPUB para PDF no .NET com Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Converter SVG para PDF no .NET com Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/portuguese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/portuguese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..9c5d766d4 --- /dev/null +++ b/html/portuguese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,295 @@ +--- +category: general +date: 2026-05-22 +description: Renderize HTML como PDF usando C# com um exemplo conciso. Aprenda como + converter HTML para PDF em C# de forma rápida e confiável. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: pt +og_description: Renderizar HTML como PDF em C# com um exemplo claro e executável. + Este guia mostra como converter HTML para PDF em C# e gerar PDF a partir de um arquivo + HTML. +og_title: Renderizar HTML como PDF em C# – Tutorial Completo de Programação +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Renderizar HTML como PDF em C# – Guia Completo Passo a Passo +url: /pt/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Renderizar HTML como PDF em C# – Guia Completo Passo a Passo + +Já precisou **renderizar HTML como PDF** mas não tinha certeza de qual biblioteca escolher para um projeto .NET? Você não está sozinho. Em muitos aplicativos corporativos você vai se deparar com a necessidade de **converter HTML para PDF C#** para faturas, relatórios ou folhetos de marketing — basicamente sempre que quiser uma versão imprimível de uma página web. + +Aqui está a questão: você não precisa reinventar a roda. Com algumas linhas de código você pode pegar um arquivo `input.html`, enviá‑lo para um motor de renderização comprovado e obter um `output.pdf` nítido. Neste tutorial vamos percorrer todo o processo, desde a adição do pacote NuGet correto até o tratamento de casos extremos como CSS externo. Ao final, você será capaz de **gerar PDF a partir de um arquivo HTML** em poucos minutos. + +## O que você aprenderá + +- Como configurar um aplicativo console .NET que **cria PDF a partir de HTML C#**. +- As chamadas de API exatas que você precisa para **salvar documento HTML como PDF**. +- Por que certas opções de renderização (como hinting) são importantes para a qualidade do texto. +- Dicas para solucionar armadilhas comuns, como fontes ausentes ou caminhos relativos de imagens. + +**Pré‑requisitos** – você deve ter .NET 6+ ou .NET Framework 4.7 instalado, familiaridade básica com C# e uma IDE (Visual Studio 2022, Rider ou VS Code). Não é necessária experiência prévia com PDF. + +--- + +## Renderizar HTML como PDF – Configurando o Projeto + +Antes de mergulharmos no código, vamos garantir que o ambiente de desenvolvimento está pronto. A biblioteca que usaremos é **Select.Pdf** (gratuita para uso não comercial) porque oferece uma API simples e fidelidade de renderização sólida. + +### Instalar a biblioteca de renderização de PDF (convert html to pdf c#) + +Abra um terminal na pasta do seu projeto e execute: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Dica de especialista:* Se você estiver usando o Visual Studio, também pode adicionar o pacote via a UI do NuGet Package Manager. O número da versão pode ser mais recente — basta pegar a última versão estável. + +### Criar um esqueleto de console + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Isso é tudo o que o boilerplate precisa. O trabalho pesado acontece dentro do `Main`. + +## Carregar o Documento HTML (generate pdf from html file) + +O primeiro passo real é apontar o renderizador para um arquivo HTML no disco. O Select.Pdf oferece duas maneiras convenientes: passar a string HTML bruta ou um caminho de arquivo. Usar um arquivo mantém as coisas organizadas, especialmente quando há CSS ou imagens vinculadas. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Aqui também protegemos contra a falta do arquivo — algo que costuma atrapalhar iniciantes que esquecem de copiar o HTML para a pasta de saída. + +## Configurar Opções de Renderização (create pdf from html c#) + +O Select.Pdf vem com um rico objeto `PdfDocumentOptions`. Para texto nítido habilitamos o hinting, que suaviza os glifos ao custo de um pequeno impacto de desempenho. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Você pode ajustar tamanho da página, margens ou até incorporar uma fonte personalizada aqui. O ponto principal é que **render html as pdf** não é apenas uma linha única; você tem controle sobre a aparência final do documento. + +## Salvar Documento HTML como PDF (render html as pdf) + +Agora a mágica acontece. Passamos ao conversor o caminho do nosso arquivo HTML e pedimos que ele escreva um PDF no disco. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +O método `ConvertUrl` resolve automaticamente URLs relativas (imagens, CSS) com base na localização do arquivo HTML, por isso essa abordagem é robusta para a maioria dos cenários reais. + +### Saída esperada + +Após executar o programa você deverá ver um arquivo `output.pdf` na mesma pasta. Abra‑o — você notará: + +- Texto renderizado com anti‑aliasing claro (graças ao hinting). +- Estilos do CSS vinculado aplicados corretamente. +- Imagens exibidas exatamente no tamanho definido no HTML de origem. + +Se algo parecer errado, verifique se os arquivos CSS e de imagem estão ao lado de `input.html` ou use URLs absolutas. + +## Tratamento de Casos Extremamente Comuns + +### 1. Recursos externos bloqueados por firewalls + +Se o seu HTML referencia fontes hospedadas em um CDN que seu servidor não consegue alcançar, o PDF pode recair para uma fonte genérica. Para evitar isso, faça o download dos arquivos de fonte localmente ou incorpore‑os usando `@font-face` com um caminho relativo. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Arquivos HTML muito grandes + +Ao converter documentos massivos, você pode atingir limites de memória. O Select.Pdf permite que você faça a conversão em streaming: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +O streaming mantém o processo leve, mas requer que você forneça o HTML como string, o que pode ser lido em blocos, se necessário. + +### 3. Cabeçalhos ou rodapés personalizados + +Se precisar de número de página ou logotipo da empresa em cada página, defina as propriedades `Header` e `Footer` em `converter.Options` antes de chamar `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +## Exemplo Completo Funcionando (Todas as Etapas Combinadas) + +Abaixo está o programa completo, pronto para copiar e colar. Substitua `YOUR_DIRECTORY` pelo caminho absoluto onde seu HTML está localizado. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Execute:** `dotnet run` a partir do diretório do projeto. Se tudo estiver configurado corretamente, você verá a mensagem de sucesso e um reluzente `output.pdf`. + +## Resumo Visual + +![Render HTML as PDF example](render-html-as-pdf.png){alt="exemplo de renderizar html como pdf"} + +A captura de tela mostra a saída do console e o PDF resultante aberto em um visualizador. Observe os títulos nítidos e as imagens carregadas corretamente — exatamente o que se espera ao **render html as pdf**. + +## Conclusão + +Você acabou de aprender como **renderizar HTML como PDF** em uma aplicação C#, desde a instalação da biblioteca até o ajuste fino das opções de renderização. O exemplo completo demonstra uma forma confiável de **converter HTML para PDF C#**, **gerar PDF a partir de arquivo HTML** e **salvar documento HTML como PDF** com apenas algumas linhas de código. + +Qual o próximo passo? Experimente: + +- Adicionar fontes personalizadas para consistência de marca. +- Gerar PDFs a partir de strings HTML dinâmicas (por exemplo, templates Razor). +- Mesclar vários PDFs em um único relatório usando `PdfDocument.AddPage`. + +Cada uma dessas extensões se baseia nos conceitos centrais abordados aqui, preparando você para enfrentar cenários mais avançados sem uma curva de aprendizado íngreme. + +Tem dúvidas ou encontrou algum problema? Deixe um comentário abaixo e vamos solucionar juntos. Feliz codificação! + +## Tutoriais Relacionados + +- [Converter HTML para PDF em .NET com Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Criar Documento HTML com Texto Estilizado e Exportar para PDF – Guia Completo](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Converter HTML para PDF com Aspose.HTML – Guia Completo de Manipulação](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/portuguese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/portuguese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..835bfbcd2 --- /dev/null +++ b/html/portuguese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-05-22 +description: Salve HTML como ZIP rapidamente usando Aspose.HTML. Aprenda como compactar + arquivos HTML, renderizar HTML para ZIP e exportar HTML para um arquivo ZIP com + código completo. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: pt +og_description: Salve HTML como ZIP com Aspose.HTML. Este guia mostra como renderizar + HTML para ZIP, exportar HTML para um arquivo ZIP e compactar arquivos HTML programaticamente. +og_title: Salvar HTML como ZIP – Tutorial Completo do Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Salvar HTML como ZIP – Guia Completo para Aspose.HTML +url: /pt/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Salvar HTML como ZIP – Guia Completo para Aspose.HTML + +Já se perguntou como **salvar HTML como ZIP** sem precisar de uma ferramenta de arquivamento separada? Você não está sozinho. Muitos desenvolvedores precisam agrupar uma página HTML junto com suas imagens, CSS e scripts para distribuição fácil, e fazer isso manualmente rapidamente se torna um ponto problemático. + +Neste tutorial vamos percorrer uma solução limpa, de ponta a ponta, que **renderiza HTML para ZIP** usando Aspose.HTML para .NET. Ao final, você saberá exatamente como **exportar HTML para um arquivo ZIP**, e também verá variações de **como compactar arquivos HTML** em diferentes cenários. + +> *Dica profissional:* A abordagem mostrada funciona tanto para empacotar uma única página quanto uma pasta inteira de site. + +## O que você vai precisar + +Antes de mergulharmos, certifique‑se de que você tem: + +- .NET 6 (ou qualquer runtime .NET recente) instalado. +- O pacote NuGet **Aspose.HTML for .NET** (`Aspose.Html`) referenciado no seu projeto. +- Um arquivo simples `input.html` colocado em uma pasta que você controla. +- Um pouco de familiaridade com C# — nada sofisticado, apenas o básico. + +É só isso. Sem utilitários externos de zip, sem acrobacias de linha de comando. Vamos começar. + +![Diagrama mostrando o processo de salvar HTML como ZIP usando Aspose.HTML](save-html-as-zip.png) + +*Texto alternativo da imagem: diagrama do processo de salvar html como zip* + +## Etapa 1: Carregar o Documento HTML de Origem + +A primeira coisa que precisamos fazer é dizer ao Aspose.HTML onde está nossa fonte. A classe `HTMLDocument` lê o arquivo e constrói um DOM em memória, pronto para renderização. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Por que isso importa: carregar o documento dá à biblioteca controle total sobre a resolução de recursos (imagens, CSS, fontes). Se o HTML referencia caminhos relativos, o Aspose.HTML os resolve automaticamente em relação à pasta do arquivo. + +## Etapa 2: (Opcional) Criar um Manipulador de Recursos Personalizado + +Se você precisar inspecionar ou manipular cada recurso — por exemplo, comprimir imagens antes que elas entrem no arquivo — pode conectar um `ResourceHandler`. Esta etapa é opcional, mas é a forma mais flexível de **converter HTML para arquivo ZIP** com lógica personalizada. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*E se você não precisar de nenhum processamento especial?* Basta pular esta classe e usar o manipulador padrão — o Aspose.HTML gravará os recursos diretamente no ZIP. + +## Etapa 3: Configurar Opções de Salvamento para Usar o Manipulador + +O objeto `HtmlSaveOptions` indica ao renderizador o que fazer com os recursos. Ao atribuir nosso `MyResourceHandler`, ganhamos controle total sobre a saída. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Observe como a propriedade `ResourceHandler` faz referência direta à capacidade de **renderizar HTML para ZIP**. É aqui que a mágica acontece: cada recurso vinculado é transmitido para o arquivo em vez de ser gravado no disco. + +## Etapa 4: Salvar o Documento Renderizado em um Arquivo ZIP + +Agora finalmente **exportamos HTML para um arquivo ZIP**. O método `Save` aceita qualquer `Stream`, então podemos apontá‑lo para um `FileStream` que cria `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Esse é todo o fluxo de trabalho. Quando o código terminar, `result.zip` conterá: + +- `input.html` (o markup original) +- Todas as imagens, arquivos CSS e fontes referenciados +- Qualquer recurso transformado se você os ajustou em `MyResourceHandler` + +## Como Compactar Arquivos HTML sem Aspose.HTML (Alternativa Rápida) + +Às vezes você só precisa de uma abordagem tradicional de **como compactar arquivos HTML**, talvez porque já esteja usando um parser HTML diferente. Nesse caso, pode usar o `System.IO.Compression` nativo do .NET: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Esse método é simples, mas não inclui a etapa de renderização; ele apenas empacota o que está no disco. Se seu HTML referencia URLs externos, esses recursos não serão incluídos. Por isso a rota Aspose.HTML é preferida quando você precisa de uma solução confiável de **renderizar HTML para ZIP**. + +## Casos Limite & Armadilhas Comuns + +| Situação | O que observar | Correção recomendada | +|-----------|-------------------|-----------------| +| **Imagens grandes** | Picos de uso de memória porque cada imagem é carregada em um `MemoryStream`. | Transmita diretamente para o zip usando um manipulador personalizado que copie o stream de origem em vez de armazená‑lo totalmente em buffer. | +| **URLs externas** | Recursos hospedados na internet não são baixados automaticamente. | Defina `HtmlLoadOptions` com `BaseUrl` apontando para a raiz do site, ou baixe manualmente os recursos antes de salvar. | +| **Colisões de nomes de arquivo** | Dois arquivos CSS com o mesmo nome em subpastas diferentes podem sobrescrever um ao outro. | Garanta que o `ResourceHandler` preserve o caminho relativo completo ao gravar no zip. | +| **Erros de permissão** | Tentar gravar em uma pasta somente‑leitura lança `UnauthorizedAccessException`. | Execute o processo com privilégios adequados ou escolha um diretório de saída gravável. | + +Tratar esses cenários torna sua rotina de **converter HTML para arquivo ZIP** robusta para uso em produção. + +## Exemplo Completo (Todas as Partes Juntas) + +Abaixo está o programa completo, pronto para ser executado. Cole-o em um novo aplicativo console, atualize os caminhos e pressione **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Saída esperada:** O console exibe uma mensagem de sucesso, e o arquivo `result.zip` contém `input.html` mais todos os ativos dependentes. Abra o ZIP, dê um duplo‑clique em `input.html` e você verá a página renderizada exatamente como no navegador — sem imagens faltando, sem CSS quebrado. + +## Recapitulando – Por que Essa Abordagem é Excelente + +- **Renderização em um único passo:** Você não precisa copiar cada recurso manualmente; o Aspose.HTML faz isso por você. +- **Pipeline personalizável:** O `ResourceHandler` dá controle total sobre como cada arquivo é armazenado, permitindo compressão, criptografia ou transformação em tempo real. +- **Multiplataforma:** Funciona no Windows, Linux e macOS, contanto que você tenha o runtime .NET. +- **Sem ferramentas externas:** Todo o processo de **salvar HTML como ZIP** vive dentro do seu código C#. + +## O que vem a seguir? + +Agora que você dominou **salvar HTML como ZIP**, considere explorar os tópicos relacionados: + +- **Exportar HTML para PDF** – perfeito para relatórios imprimíveis (o conhecimento de `export html to zip file` ajuda quando você precisa de ambos os formatos). +- **Transmitir ZIP diretamente na resposta HTTP** – ideal para APIs web que permitem ao usuário baixar um site empacotado sob demanda. +- **Criptografar arquivos ZIP** – adicione uma camada de senha se estiver lidando com documentação confidencial. + +Sinta‑se à vontade para experimentar: troque o `MyResourceHandler` por um compressor que diminua imagens, ou adicione um arquivo de manifesto que liste todos os recursos empacotados. O céu é o limite quando você controla o pipeline de renderização. + +--- + +*Feliz codificação! Se encontrar algum obstáculo ou tiver ideias de melhoria, deixe um comentário abaixo. Vamos descobrir juntos.* + +## Tutoriais Relacionados + +- [How to Zip HTML in C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Save HTML as ZIP – Complete C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Save HTML to ZIP in C# – Complete In‑Memory Example](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/russian/net/generate-jpg-and-png-images/_index.md b/html/russian/net/generate-jpg-and-png-images/_index.md index 74f005949..b95d67ea8 100644 --- a/html/russian/net/generate-jpg-and-png-images/_index.md +++ b/html/russian/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aspose.HTML для .NET предлагает простой метод прео Узнайте, как включить сглаживание при преобразовании DOCX в PNG или JPG с помощью Aspose.HTML для .NET. ### [Конвертация DOCX в PNG – создание ZIP-архива на C#](./convert-docx-to-png-create-zip-archive-c-tutorial/) Узнайте, как преобразовать файлы DOCX в PNG и упаковать их в ZIP-архив с помощью C# и Aspose.HTML. +### [Установка ширины и высоты изображения при конвертации Word в PNG – Полное руководство](./set-image-width-height-when-converting-word-to-png-full-guid/) +Подробное руководство по задаванию размеров изображения при преобразовании документов Word в PNG с помощью Aspose.HTML для .NET. ## Заключение diff --git a/html/russian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/russian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..3c4fdc01b --- /dev/null +++ b/html/russian/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,263 @@ +--- +category: general +date: 2026-05-22 +description: Установите ширину и высоту изображения при конвертации документа Word + в PNG. Узнайте, как экспортировать docx в изображение с высококачественной отрисовкой + в пошаговом руководстве. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: ru +og_description: Установите ширину и высоту изображения при конвертации документа Word + в PNG. Этот учебник показывает, как экспортировать docx в изображение с настройками + высокого качества. +og_title: Установка ширины и высоты изображения при конвертации Word в PNG – Полное + руководство +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Установка ширины и высоты изображения при конвертации Word в PNG – Полное руководство +url: /ru/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Установить ширину и высоту изображения при конвертации Word в PNG – Полное руководство + +Задумывались ли вы когда‑нибудь, как **установить ширину и высоту изображения** при **конвертации Word в PNG**? Вы не одиноки. Многие разработчики сталкиваются с проблемой, когда экспорт по умолчанию дает размытое изображение или неправильные размеры, и затем тратят часы в поисках действительно работающего решения. + +В этом руководстве мы пройдем чистое, сквозное решение, показывающее **как отрисовать word** документы в виде PNG‑изображений, позволяющее вам **сохранить docx как PNG** с точным контролем ширины‑высоты и высококачественным сглаживанием. К концу вы получите готовый фрагмент кода, твердое понимание параметров API и несколько профессиональных советов, как избежать распространённых подводных камней. + +## Что вы узнаете + +- Загрузить файл `.docx` с помощью Aspose.Words for .NET. +- **Установить ширину и высоту изображения** с помощью `ImageRenderingOptions`. +- **Экспортировать docx как изображение** (PNG) с включённым сглаживанием. +- Как **конвертировать word в png** для одной страницы или всего документа. +- Советы по работе с большими документами, учёту DPI и путям файловой системы. + +Никаких внешних инструментов, без лишних командных строк — только чистый C#‑код, который можно вставить в любой .NET‑проект. + +--- + +## Необходимые условия + +Прежде чем мы начнём, убедитесь, что у вас есть следующее: + +| Требование | Почему это важно | +|------------|-------------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words поддерживает оба, но более новые среды обеспечивают лучшую производительность. | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | Предоставляет класс `Document` и движок рендеринга. | +| A **Word document** (`.docx`) you want to turn into a PNG. | Исходный документ, который вы будете конвертировать. | +| Basic C# knowledge – you’ll understand `using` statements and object initialization. | Делает процесс обучения более плавным. | + +Если вам не хватает NuGet‑пакета, выполните это в консоли диспетчера пакетов: + +```powershell +Install-Package Aspose.Words +``` + +Вот и всё — как только пакет установлен, вы готовы начинать кодировать. + +## Шаг 1: Загрузить исходный документ + +Самое первое, что нужно сделать, — указать библиотеке путь к файлу Word, который вы хотите преобразовать. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Почему это важно:** Класс `Document` читает весь пакет Word в память, предоставляя доступ к страницам, стилям и всему остальному. Если путь неверен, вы получите `FileNotFoundException`, поэтому дважды проверьте, что файл существует и путь использует экранированные обратные слеши (`\\`) или дословную строку (`@`). + +> **Pro tip:** Оберните вызов загрузки в блок `try/catch`, если ожидаете, что файл может отсутствовать во время выполнения. + +## Шаг 2: Настроить параметры рендеринга изображения (Установить ширину и высоту изображения) + +Теперь начинается сердце руководства: **как установить ширину и высоту изображения**, чтобы полученный PNG не был растянутым или пикселизированным. Класс `ImageRenderingOptions` даёт тонкую настройку размеров, DPI и сглаживания. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +Объяснение ключевых свойств: + +- `Width` и `Height` — Точные пиксельные размеры, которые вам нужны. Устанавливая их, вы **устанавливаете ширину и высоту изображения** напрямую, переопределяя размер страницы по умолчанию. +- `UseAntialiasing` — Включает высококачественное сглаживание текста и векторной графики, что критично, когда вы **конвертируете word в png** и хотите чёткие края. +- `Resolution` — Более высокий DPI даёт больше деталей, особенно для сложных макетов. Следите за использованием памяти; изображение с 300 DPI может быть большим. + +> **Почему не полагаться просто на размер по умолчанию?** По умолчанию используется физический размер страницы (например, A4 при 96 DPI). Это часто даёт изображение 794 × 1123 пикселя — подходит в некоторых случаях, но не когда нужен конкретный UI‑миниатюра или фиксированный превью. + +## Шаг 3: Рендеринг и сохранение в PNG (Экспорт Docx как изображения) + +С загруженным документом и настроенными параметрами вы наконец можете **экспортировать docx как изображение**. Метод `RenderToImage` делает всю тяжёлую работу. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Если хотите отрендерить **весь документ** (все страницы) в отдельные PNG‑файлы, пройдитесь по коллекции страниц: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Что происходит под капотом?** Рендерер растеризует каждую страницу, используя заданные вами размеры, применяет сглаживание и записывает поток PNG‑байтов на диск. Поскольку PNG — без потерь, вы сохраняете полную точность оригинального макета Word. + +**Ожидаемый результат:** Чёткий PNG‑файл точно 1024 × 768 пикселей (или любой размер, который вы указали). Откройте его в любой программе‑просмотрщике, и вы увидите содержимое Word, отрисованное точно так же, как в оригинальном документе, но теперь в виде растрового изображения. + +## Расширенные советы и варианты + +### 1. Сохранить прозрачный фон + +Если ваш документ Word содержит фигуры с прозрачным фоном и вы хотите сохранить эту прозрачность, задайте `BackgroundColor` как `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Рендерить только определённый диапазон + +Иногда нужен лишь абзац или таблица, а не вся страница. Используйте `DocumentVisitor`, чтобы извлечь узел и отрендерить его отдельно. Это более продвинутый сценарий, но он показывает **как отрисовать word** контент на более гранулярном уровне. + +### 3. Динамически регулировать DPI + +Если нужен разный DPI для разных страниц (например, высокое разрешение для обложки), измените `Resolution` внутри цикла: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Пакетная обработка + +При конвертации десятков документов оберните весь процесс в метод и переиспользуйте один экземпляр `ImageRenderingOptions`. Переиспользование объекта параметров уменьшает накладные расходы на выделение памяти. + +## Распространённые ошибки и как их избежать + +| Признак | Вероятная причина | Решение | +|---------|-------------------|---------| +| PNG размытый, несмотря на высокий DPI | `UseAntialiasing` left `false` | Set `UseAntialiasing = true`. | +| Размер вывода не соответствует `Width`/`Height` | DPI not considered | Multiply desired size by `Resolution / 96` or adjust `Resolution`. | +| Исключение Out‑of‑memory при больших документах | Rendering whole document at 300 DPI | Render one page at a time, dispose of each image after saving. | +| PNG показывает белый фон на прозрачных изображениях | `BackgroundColor` not set | Set `imageOptions.BackgroundColor = Color.Transparent`. | + +## Полный рабочий пример + +Ниже приведена автономная программа, которую можно скопировать и вставить в консольное приложение. Она демонстрирует **конвертировать word в png**, **сохранить docx как png** и, конечно, **установить ширину и высоту изображения**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Запустите:** Скомпилируйте проект, разместите корректный `input.docx` по указанному пути и выполните. Вы должны увидеть `output.png` точно **1024 × 768** пикселей, отрисованный с плавными краями. + +## Похожие руководства + +- [Как включить сглаживание при конвертации DOCX в PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [конвертировать docx в png – создание zip-архива c# руководство](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Как использовать Aspose для рендеринга HTML в PNG – пошаговое руководство](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/russian/net/html-extensions-and-conversions/_index.md b/html/russian/net/html-extensions-and-conversions/_index.md index 00354e673..84cff0189 100644 --- a/html/russian/net/html-extensions-and-conversions/_index.md +++ b/html/russian/net/html-extensions-and-conversions/_index.md @@ -39,8 +39,12 @@ Aspose.HTML для .NET — это не просто библиотека; эт ## Учебники по расширениям и преобразованиям HTML ### [Конвертируйте HTML в PDF в .NET с помощью Aspose.HTML](./convert-html-to-pdf/) Конвертируйте HTML в PDF без усилий с Aspose.HTML для .NET. Следуйте нашему пошаговому руководству и раскройте всю мощь преобразования HTML в PDF. +### [Конвертировать HTML в PDF с C# – Полное руководство](./convert-html-to-pdf-with-c-complete-guide/) +Полное пошаговое руководство по конвертации HTML в PDF с использованием C# и Aspose.HTML для .NET. ### [Создайте PDF из HTML – пошаговое руководство C#](./create-pdf-from-html-c-step-by-step-guide/) Пошаговое руководство по созданию PDF из HTML с помощью Aspose.HTML в C#. +### [Отобразите HTML в PDF в C# – Полное пошаговое руководство](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Пошаговое руководство по рендерингу HTML в PDF с помощью C# и Aspose.HTML. ### [Конвертируйте EPUB в изображение в .NET с помощью Aspose.HTML](./convert-epub-to-image/) Узнайте, как конвертировать EPUB в изображения с помощью Aspose.HTML для .NET. Пошаговое руководство с примерами кода и настраиваемыми параметрами. ### [Конвертируйте EPUB в PDF в .NET с помощью Aspose.HTML](./convert-epub-to-pdf/) @@ -73,6 +77,8 @@ Aspose.HTML для .NET — это не просто библиотека; эт Узнайте, как сохранить HTML‑страницу в архив ZIP с помощью Aspose.HTML для .NET, используя C# в полном пошаговом руководстве. ### [Сохраните HTML в ZIP в C# – Полный пример в памяти](./save-html-to-zip-in-c-complete-in-memory-example/) Сохраните HTML в архив ZIP полностью в памяти с помощью Aspose.HTML для .NET, используя C#. +### [Сохраните HTML в ZIP – Полное руководство по Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Подробное пошаговое руководство по сохранению HTML‑страницы в архив ZIP с использованием Aspose.HTML. ## Заключение diff --git a/html/russian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/russian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..3aea42d87 --- /dev/null +++ b/html/russian/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,258 @@ +--- +category: general +date: 2026-05-22 +description: Конвертировать HTML в PDF на C# с помощью Aspose.HTML. Узнайте, как преобразовать + HTML в PDF на C# с пошаговым кодом, параметрами и подсказками для Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: ru +og_description: Конвертируйте HTML в PDF на C# с помощью Aspose.HTML. Это руководство + показывает, как преобразовать HTML в PDF на C#, используя понятные параметры и подсказки, + удобные для Linux. +og_title: Конвертировать HTML в PDF с помощью C# – Полное руководство +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Конвертировать HTML в PDF с C# – Полное руководство +url: /ru/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Преобразование HTML в PDF с помощью C# – Полное руководство + +Если вам нужно быстро **convert HTML to PDF**, Aspose.HTML for .NET делает это проще простого. В этом руководстве мы также ответим на вопрос **how to render HTML to PDF in C#** с полным контролем над параметрами рендеринга, чтобы вам не пришлось гадать. + +Представьте, что у вас есть шаблон маркетингового письма, страница чека или сложный отчёт, построенный с современным CSS, и вам нужно передать его клиенту или принтеру в виде PDF. Делать это вручную — боль, но несколько строк кода на C# могут автоматизировать весь процесс. К концу этого руководства у вас будет автономное, готовое к продакшну решение, работающее как в Windows, так и в Linux. + +![Диаграмма, иллюстрирующая процесс преобразования html в pdf с помощью Aspose.HTML](/images/convert-html-to-pdf-workflow.png "процесс преобразования html в pdf") + +## Что понадобится + +- **.NET 6.0 или новее** – Aspose.HTML нацелен на .NET Standard 2.0+, поэтому любой современный SDK подходит. +- **Aspose.HTML for .NET** пакет NuGet (`Aspose.Html`) – для продакшна понадобится действующая лицензия, но бесплатная пробная версия подходит для тестирования. +- **Простой HTML‑файл**, который вы хотите преобразовать в PDF (будем называть его `input.html`). +- Ваш любимый IDE (Visual Studio, Rider или VS Code) – никаких специальных инструментов не требуется. + +Вот и всё. Никаких внешних конвертеров PDF, никаких командных трюков. Просто чистый C#. + +## Преобразование HTML в PDF – Полная реализация + +Ниже представлена полная, готовая к запуску программа. Скопируйте её в новое консольное приложение, восстановите пакеты NuGet и нажмите **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Почему это работает + +- **`Document`** — точка входа Aspose.HTML; она парсит HTML, обрабатывает CSS и формирует DOM, готовый к рендерингу. +- **`PdfRenderingOptions`** позволяет настроить вывод. Флаг `UseHinting` — секретный ингредиент для чёткого текста в безголовых Linux‑контейнерах, где стандартный растеризатор может выглядеть размыто. +- **`Save`** выполняет основную работу: растеризует DOM на страницы PDF, учитывает разрывы страниц и автоматически встраивает шрифты. + +Запуск программы создаст `output.pdf` рядом с вашим исходным файлом. Откройте его в любом PDF‑просмотрщике, и вы увидите точное визуальное соответствие оригинальному HTML. + +## Как преобразовать HTML в PDF в C# – Пошагово + +Ниже мы разбиваем процесс на небольшие части, объясняя **how to render HTML to PDF in C#**, одновременно рассматривая распространённые подводные камни. + +### Шаг 1 – Установите пакет Aspose.HTML NuGet + +Откройте терминал в папке проекта и выполните: + +```bash +dotnet add package Aspose.Html +``` + +Если вы предпочитаете UI Visual Studio, щёлкните правой кнопкой по проекту → **Manage NuGet Packages** → найдите **Aspose.Html** и установите последнюю стабильную версию. + +> **Pro tip:** После установки добавьте файл лицензии (`Aspose.Total.lic`) в корень вашего проекта, чтобы избавиться от водяных знаков оценки. + +### Шаг 2 – Корректно загрузите ваш HTML + +Aspose.HTML может принимать: + +- Локальные пути к файлам (`new Document("file.html")`) +- URL‑адреса (`new Document("https://example.com")`) +- Строки с сырым HTML (`new Document("…", new HtmlLoadOptions())`) + +При загрузке из файловой системы убедитесь, что путь абсолютный или рабочая директория установлена правильно, иначе вы получите `FileNotFoundException`. В Linux используйте прямые слеши (`/`) или `Path.Combine`. + +### Шаг 3 – Выберите правильные параметры рендеринга + +Помимо `UseHinting`, вы можете настроить следующее: + +| Параметр | Что делает | Когда использовать | +|----------|------------|--------------------| +| `PageSize` | Устанавливает размеры страницы PDF (A4, Letter, пользовательский) | Соответствует целевому размеру бумаги | +| `Landscape` | Поворачивает страницу в альбомную ориентацию | Широкие таблицы или графики | +| `RasterizeVectorGraphics` | Принудительно преобразует векторную графику в растровые изображения | Когда получатель PDF не поддерживает SVG | +| `CompressionLevel` | Управляет сжатием изображений (0‑9) | Уменьшить размер файла для вложений в email | + +Вы можете цепочкой задавать эти свойства: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Шаг 4 – Сохраните PDF + +Перегрузка метода `Save`, показанная в полном примере, записывает напрямую в путь файла. Вы также можете вывести PDF в поток памяти: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Это удобно, когда нужно вернуть PDF как загрузку из веб‑API. + +### Шаг 5 – Проверьте результат + +Быстрая проверка — сравнить количество страниц PDF с ожидаемым числом секций HTML. Вы можете прочитать его обратно с помощью Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Если количество не совпадает, проверьте правила CSS `page-break` или скорректируйте `PdfRenderingOptions`. + +## Краевые случаи и распространённые подводные камни + +| Ситуация | На что обратить внимание | Решение | +|----------|--------------------------|----------| +| **Отсутствуют внешние ресурсы (изображения, шрифты)** | Относительные URL‑адреса разрешаются относительно папки HTML‑файла. | Используйте `HtmlLoadOptions.BaseUri`, чтобы указать правильный корень. | +| **Безголовая Linux‑среда** | По умолчанию рендеринг текста может быть размытым. | Установите `UseHinting = true` (как показано) и убедитесь, что установлен `libgdiplus`, если вы используете System.Drawing. | +| **Большой HTML (> 10 МБ)** | Потребление памяти резко возрастает во время рендеринга. | Рендерите постранично с помощью `PdfRenderer` и `PdfRenderingOptions`, освобождая каждую страницу после сохранения. | +| **Страницы с большим количеством JavaScript** | Aspose.HTML не выполняет JS; динамический контент остаётся статичным. | Предобработайте HTML на сервере (например, с помощью Puppeteer) перед передачей в Aspose.HTML. | +| **Unicode‑символы отображаются как квадраты** | В среде выполнения отсутствуют шрифты. | Встраивайте пользовательские шрифты через `FontSettings` или убедитесь, что ОС имеет необходимые шрифты. | + +## Полный рабочий пример – резюме + +Вот весь код программы ещё раз, без комментариев, для тех, кто предпочитает лаконичный вид: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Запустите его, откройте `output.pdf`, и вы увидите пиксель‑точную копию `input.html`. Это суть **convert html to pdf** с Aspose.HTML. + +## Заключение + +Мы прошли всё, что нужно для **convert HTML to PDF** в C#: установка Aspose.HTML, загрузка HTML, настройка параметров рендеринга (включая критический флаг `UseHinting`) и сохранение финального PDF. Теперь вы знаете **how to render HTML to PDF in C#** как в Windows, так и в Linux, и видели, как решать типичные проблемы, такие как отсутствие ресурсов и большие файлы. + +Что дальше? Попробуйте добавить: + +- **Заголовки/нижние колонтитулы** с помощью `PdfPageTemplate` для брендинга. +- **Защита паролем** через `PdfSaveOptions`. +- **Пакетное преобразование** путем перебора папки с + +## Похожие руководства + +- [Преобразовать HTML в PDF в .NET с помощью Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Преобразовать EPUB в PDF в .NET с помощью Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Преобразовать SVG в PDF в .NET с помощью Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/russian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/russian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..6eaf6e972 --- /dev/null +++ b/html/russian/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,293 @@ +--- +category: general +date: 2026-05-22 +description: Отображайте HTML в PDF с помощью C# с кратким примером. Узнайте, как + быстро и надёжно преобразовать HTML в PDF на C#. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: ru +og_description: Отображайте HTML в PDF на C# с понятным, готовым к запуску примером. + Это руководство покажет, как конвертировать HTML в PDF на C# и генерировать PDF + из HTML‑файла. +og_title: Преобразование HTML в PDF на C# – Полный учебник по программированию +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Преобразование HTML в PDF на C# – полное пошаговое руководство +url: /ru/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Отображение HTML в PDF в C# – Полное пошаговое руководство + +Когда‑нибудь вам нужно было **render HTML as PDF**, но вы не были уверены, какую библиотеку выбрать для проекта .NET? Вы не одиноки. Во многих бизнес‑приложениях вам понадобится **convert HTML to PDF C#** для счетов, отчетов или маркетинговых брошюр — по сути каждый раз, когда нужен печатный вариант веб‑страницы. + +Вот в чем дело: вам не нужно изобретать велосипед. С несколькими строками кода вы можете взять файл `input.html`, передать его проверенному движку рендеринга и получить чёткий `output.pdf`. В этом руководстве мы пройдём весь процесс, от добавления нужного пакета NuGet до обработки особых случаев, таких как внешние CSS. К концу вы сможете **generate PDF from HTML file** за считанные минуты. + +## Что вы узнаете + +- Как настроить консольное приложение .NET, которое **creates PDF from HTML C#**. +- Точные вызовы API, необходимые для **save HTML document as PDF**. +- Почему некоторые параметры рендеринга (например, hinting) важны для качества текста. +- Советы по устранению распространённых проблем, таких как отсутствие шрифтов или относительные пути к изображениям. + +**Prerequisites** – у вас должен быть установлен .NET 6+ или .NET Framework 4.7, базовое знакомство с C# и IDE (Visual Studio 2022, Rider или VS Code). Предыдущий опыт работы с PDF не требуется. + +--- + +## Отображение HTML в PDF – Настройка проекта + +Прежде чем погрузиться в код, убедимся, что среда разработки готова. Библиотека, которую мы будем использовать, — **Select.Pdf** (бесплатна для некоммерческого использования), потому что она предлагает простой API и надёжную точность рендеринга. + +### Установка библиотеки рендеринга PDF (convert html to pdf c#) + +Откройте терминал в папке проекта и выполните: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Если вы используете Visual Studio, вы также можете добавить пакет через UI NuGet Package Manager. Номер версии может быть новее — просто возьмите последнюю стабильную версию. + +### Создание консольного скелета + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Это всё, что нужно для шаблона. Основная работа происходит внутри `Main`. + +## Загрузка HTML‑документа (generate pdf from html file) + +Первый реальный шаг — указать рендереру HTML‑файл на диске. Select.Pdf предлагает два удобных способа: передать необработанную строку HTML или путь к файлу. Использование файла упрощает работу, особенно когда есть подключённые CSS или изображения. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Здесь мы также проверяем отсутствие файла — это часто сбивает новичков, когда они забывают скопировать HTML в папку вывода. + +## Настройка параметров рендеринга (create pdf from html c#) + +Select.Pdf поставляется с богатым объектом `PdfDocumentOptions`. Для чёткого текста мы включаем hinting, который сглаживает глифы ценой небольшого снижения производительности. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Здесь можно настроить размер страницы, отступы или даже встроить пользовательский шрифт. Главное, что **render html as pdf** — это не просто однострочник; у вас есть контроль над внешним видом конечного документа. + +## Сохранение HTML‑документа в PDF (render html as pdf) + +Теперь происходит магия. Мы передаём конвертеру путь к нашему HTML‑файлу и просим его записать PDF на диск. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +Метод `ConvertUrl` автоматически разрешает относительные URL (изображения, CSS) на основе местоположения HTML‑файла, поэтому такой подход надёжен для большинства реальных сценариев. + +### Ожидаемый результат + +После запуска программы вы должны увидеть файл `output.pdf` в той же папке. Откройте его — вы заметите: + +- Текст отрисован с чётким сглаживанием (благодаря hinting). +- Стили из подключённого CSS применены корректно. +- Изображения отображаются в точном размере, определённом в исходном HTML. + +Если что‑то выглядит неверно, дважды проверьте, что файлы CSS и изображения находятся рядом с `input.html`, либо используйте абсолютные URL. + +## Обработка распространённых граничных случаев + +### 1. Внешние ресурсы, блокируемые брандмауэрами + +Если ваш HTML ссылается на шрифты, размещённые на CDN, недоступном вашему серверу, PDF может переключиться на общий шрифт. Чтобы этого избежать, скачайте файлы шрифтов локально или встроите их с помощью `@font-face` с относительным путём. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Очень большие HTML‑файлы + +При конвертации огромных документов вы можете столкнуться с ограничениями памяти. Select.Pdf позволяет потоково выполнять конвертацию: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +### 3. Пользовательские заголовки или колонтитулы + +Если вам нужен номер страницы или логотип компании на каждой странице, установите свойства `Header` и `Footer` в `converter.Options` перед вызовом `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +## Полный рабочий пример (все шаги вместе) + +Ниже представлен полный готовый к копированию и вставке код программы. Замените `YOUR_DIRECTORY` абсолютным путём к месту, где находится ваш HTML. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** `dotnet run` из каталога проекта. Если всё настроено правильно, вы увидите сообщение об успехе и блестящий `output.pdf`. + +## Визуальное резюме + +![Render HTML as PDF example](render-html-as-pdf.png){alt="пример render html as pdf"} + +Скриншот показывает вывод консоли и полученный PDF, открытый в просмотрщике. Обратите внимание на чёткие заголовки и правильно загруженные изображения — именно то, что вы ожидаете при **render html as pdf**. + +## Заключение + +Вы только что узнали, как **render HTML as PDF** в приложении C#, от установки библиотеки до тонкой настройки параметров рендеринга. Полный пример демонстрирует надёжный способ **convert HTML to PDF C#**, **generate PDF from HTML file** и **save HTML document as PDF** всего несколькими строками кода. + +Что дальше? Попробуйте поэкспериментировать с: + +- Добавление пользовательских шрифтов для согласованности бренда. +- Генерация PDF из динамических HTML‑строк (например, Razor‑шаблоны). +- Объединение нескольких PDF в один отчёт с помощью `PdfDocument.AddPage`. + +Каждое из этих расширений опирается на основные концепции, рассмотренные здесь, поэтому вы будете готовы решать более сложные сценарии без крутого порога обучения. + +Есть вопросы или возникли проблемы? Оставьте комментарий ниже, и мы разберём их вместе. Счастливого кодинга! + +## Связанные руководства + +- [Конвертировать HTML в PDF в .NET с Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Создать HTML‑документ со стилизованным текстом и экспортировать в PDF – Полное руководство](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Конвертировать HTML в PDF с Aspose.HTML – Полное руководство по манипуляциям](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/russian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/russian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..7562d0f4f --- /dev/null +++ b/html/russian/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,229 @@ +--- +category: general +date: 2026-05-22 +description: Сохраняйте HTML в ZIP быстро с помощью Aspose.HTML. Узнайте, как упаковать + HTML‑файлы в ZIP, преобразовать HTML в ZIP и экспортировать HTML в ZIP‑файл с полным + кодом. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: ru +og_description: Сохраните HTML в виде ZIP с помощью Aspose.HTML. Это руководство показывает, + как преобразовать HTML в ZIP, экспортировать HTML в ZIP‑файл и программно упаковывать + HTML‑файлы в архив. +og_title: Сохранить HTML в ZIP – Полный учебник Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Сохранение HTML в ZIP – Полное руководство по Aspose.HTML +url: /ru/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Сохранить HTML в ZIP – Полное руководство по Aspose.HTML + +Когда‑то задавались вопросом, как **сохранить HTML в ZIP**, не прибегая к отдельному архиватору? Вы не одиноки. Многие разработчики хотят упаковать HTML‑страницу вместе с её изображениями, CSS и скриптами для удобного распространения, а делать это вручную быстро становится проблемой. + +В этом руководстве мы пройдём чистое, сквозное решение, которое **преобразует HTML в ZIP** с помощью Aspose.HTML для .NET. К концу вы точно будете знать, как **экспортировать HTML в ZIP‑файл**, а также увидите варианты **как заархивировать HTML‑файлы** в разных сценариях. + +> *Pro tip:* Представленный подход работает как при упаковке одной страницы, так и при упаковке целой папки сайта. + +## Что понадобится + +Прежде чем погрузиться, убедитесь, что у вас есть: + +- .NET 6 (или любой современный .NET‑runtime) установлен. +- NuGet‑пакет Aspose.HTML для .NET (`Aspose.Html`) подключён к вашему проекту. +- Простой файл `input.html`, размещённый в папке, которой вы управляете. +- Немного уверенности в C# — ничего сложного, только базовые вещи. + +Вот и всё. Никаких внешних zip‑утилит, никаких командных трюков. Поехали. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*Текст alt изображения: диаграмма процесса сохранения HTML в ZIP* + +## Шаг 1: Загрузить исходный HTML‑документ + +Первое, что нам нужно сделать, — указать Aspose.HTML, где находится наш источник. Класс `HTMLDocument` читает файл и строит DOM в памяти, готовый к рендерингу. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Почему это важно: загрузка документа даёт библиотеке полный контроль над разрешением ресурсов (изображения, CSS, шрифты). Если HTML ссылается на относительные пути, Aspose.HTML автоматически разрешает их относительно папки файла. + +## Шаг 2: (Опционально) Создать пользовательский обработчик ресурсов + +Если нужно проанализировать или изменить каждый ресурс — скажем, сжать изображения перед тем, как они попадут в архив — можно подключить `ResourceHandler`. Этот шаг необязателен, но это самый гибкий способ **преобразовать HTML в ZIP‑архив** с пользовательской логикой. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Что если вам не требуется специальная обработка?* Просто пропустите этот класс и используйте обработчик по умолчанию — Aspose.HTML запишет ресурсы напрямую в ZIP. + +## Шаг 3: Настроить параметры сохранения для использования обработчика + +Объект `HtmlSaveOptions` сообщает рендереру, что делать с ресурсами. Присвоив наш `MyResourceHandler`, мы получаем полный контроль над выводом. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Обратите внимание, как свойство `ResourceHandler` напрямую относится к возможности **render HTML to ZIP**. Здесь происходит магия: каждый связанный ресурс потокируется в архив вместо записи на диск. + +## Шаг 4: Сохранить отрендеренный документ в ZIP‑архив + +Теперь мы наконец **экспортируем HTML в ZIP‑файл**. Метод `Save` принимает любой `Stream`, поэтому мы можем передать ему `FileStream`, создающий `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Это весь рабочий процесс. Когда код завершится, `result.zip` будет содержать: + +- `input.html` (исходная разметка) +- Все связанные изображения, CSS‑файлы и шрифты +- Любые преобразованные ресурсы, если вы изменяли их в `MyResourceHandler` + +## Как заархивировать HTML‑файлы без Aspose.HTML (быстрая альтернатива) + +Иногда нужен простой **how to zip HTML files** подход, возможно потому, что вы уже используете другой HTML‑парсер. В этом случае можно воспользоваться встроенным в .NET `System.IO.Compression`: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Этот метод прост, но не включает шаг рендеринга; он просто упаковывает то, что находится на диске. Если ваш HTML ссылается на внешние URL, эти ресурсы не будут включены. Поэтому путь через Aspose.HTML предпочтительнее, когда нужен надёжный **render HTML to ZIP**. + +## Пограничные случаи и распространённые подводные камни + +| Ситуация | На что обратить внимание | Рекомендованное решение | +|-----------|--------------------------|--------------------------| +| **Большие изображения** | Пиковое потребление памяти, так как каждое изображение загружается в `MemoryStream`. | Потокировать напрямую в zip, используя пользовательский обработчик, который копирует исходный поток вместо полного буферизования. | +| **Внешние URL** | Ресурсы, размещённые в интернете, не скачиваются автоматически. | Установить `HtmlLoadOptions` с `BaseUrl`, указывающим на корень сайта, или вручную загрузить ресурсы перед сохранением. | +| **Коллизии имён файлов** | Два CSS‑файла с одинаковым именем в разных подпапках могут перезаписать друг друга. | Убедиться, что `ResourceHandler` сохраняет полный относительный путь при записи в zip. | +| **Ошибки доступа** | Попытка записи в папку только для чтения вызывает `UnauthorizedAccessException`. | Запускать процесс с нужными привилегиями или выбрать записываемый каталог вывода. | + +Учёт этих сценариев делает ваш процесс **convert HTML to ZIP archive** надёжным для продакшна. + +## Полный рабочий пример (все части вместе) + +Ниже представлена полностью готовая к запуску программа. Вставьте её в новое консольное приложение, обновите пути и нажмите **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Ожидаемый вывод:** Консоль печатает сообщение об успехе, а файл `result.zip` содержит `input.html` и все зависимые ресурсы. Откройте ZIP, дважды щёлкните `input.html`, и вы увидите страницу, отрендеренную точно так же, как в браузере — без пропавших изображений и сломанного CSS. + +## Итоги – Почему этот подход крут + +- **Одношаговое рендеринг:** Не нужно вручную копировать каждый ресурс; Aspose.HTML делает это за вас. +- **Настраиваемый конвейер:** `ResourceHandler` даёт полный контроль над тем, как каждый файл сохраняется, позволяя сжимать, шифровать или трансформировать «на лету». +- **Кроссплатформенность:** Работает на Windows, Linux и macOS при наличии .NET‑runtime. +- **Без внешних инструментов:** Весь процесс **save HTML as ZIP** происходит внутри вашего C#‑кода. + +## Что дальше? + +Теперь, когда вы освоили **save HTML as ZIP**, можете изучить связанные темы: + +- **Export HTML to PDF** — идеально для печатных отчётов (знание `export html to zip file` помогает, когда нужны оба формата). +- **Streaming ZIP directly to HTTP response** — удобно для веб‑API, позволяющих пользователям скачивать упакованный сайт «на лету». +- **Encrypting ZIP archives** — добавьте пароль, если работаете с конфиденциальной документацией. + +Экспериментируйте: замените `MyResourceHandler` на компрессор, уменьшающий изображения, или добавьте файл‑манифест со списком всех включённых ресурсов. Возможности безграничны, когда вы контролируете конвейер рендеринга. + +--- + +*Счастливого кодинга! Если возникнут проблемы или идеи по улучшению, оставляйте комментарий ниже. Разберёмся вместе.* + +## Похожие руководства + +- [How to Zip HTML in C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Save HTML as ZIP – Complete C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Save HTML to ZIP in C# – Complete In‑Memory Example](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/spanish/net/generate-jpg-and-png-images/_index.md b/html/spanish/net/generate-jpg-and-png-images/_index.md index 4323c4591..d9118bd34 100644 --- a/html/spanish/net/generate-jpg-and-png-images/_index.md +++ b/html/spanish/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aprenda a utilizar Aspose.HTML para .NET para manipular documentos HTML, convert Aprenda a activar el antialiasing al convertir documentos DOCX a imágenes PNG o JPG usando Aspose.HTML para .NET. ### [Convertir docx a PNG – crear archivo ZIP con C# tutorial](./convert-docx-to-png-create-zip-archive-c-tutorial/) Aprenda a convertir documentos DOCX a imágenes PNG y empaquetarlos en un archivo ZIP usando C#. +### [Establecer ancho y alto de la imagen al convertir Word a PNG – Guía completa](./set-image-width-height-when-converting-word-to-png-full-guid/) +Aprenda a definir el ancho y alto de la imagen al convertir documentos Word a PNG usando Aspose.HTML para .NET. ## Conclusión diff --git a/html/spanish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/spanish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..c82b89f26 --- /dev/null +++ b/html/spanish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,274 @@ +--- +category: general +date: 2026-05-22 +description: Establece el ancho y la altura de la imagen al convertir un documento + Word a PNG. Aprende a exportar un docx como imagen con renderizado de alta calidad + en un tutorial paso a paso. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: es +og_description: Establece el ancho y la altura de la imagen al convertir un documento + de Word a PNG. Este tutorial muestra cómo exportar un docx como imagen con configuraciones + de alta calidad. +og_title: Establecer ancho y alto de la imagen al convertir Word a PNG – Guía completa +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Establecer ancho y alto de la imagen al convertir Word a PNG – Guía completa +url: /es/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Establecer Ancho y Altura de Imagen al Convertir Word a PNG – Guía Completa + +¿Alguna vez te has preguntado cómo **establecer el ancho y la altura de la imagen** mientras **conviertes Word a PNG**? No eres el único. Muchos desarrolladores se topan con un obstáculo cuando la exportación predeterminada produce una imagen borrosa o con dimensiones incorrectas, y luego pasan horas buscando una solución que realmente funcione. + +En este tutorial recorreremos una solución limpia, de extremo a extremo, que muestra **cómo renderizar Word** documentos como imágenes PNG, permitiéndote **guardar docx como PNG** con control preciso de ancho‑alto y antialiasing de alta calidad. Al final tendrás un fragmento de código listo para ejecutar, una comprensión sólida de las opciones de la API y algunos consejos profesionales para evitar errores comunes. + +## Lo que aprenderás + +- Cargar un archivo `.docx` usando Aspose.Words for .NET. +- **Establecer ancho y altura de la imagen** con `ImageRenderingOptions`. +- **Exportar docx como imagen** (PNG) con antialiasing habilitado. +- Cómo **convertir word a png** para una sola página o todo el documento. +- Consejos para manejar documentos grandes, consideraciones de DPI y rutas del sistema de archivos. + +Sin herramientas externas, sin complicados comandos de línea—solo código C# puro que puedes insertar en cualquier proyecto .NET. + +--- + +## Requisitos previos + +Antes de comenzar, asegúrate de tener lo siguiente: + +| Requirement | Why it matters | +|-------------|----------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words es compatible con ambos, pero los entornos de ejecución más recientes ofrecen mejor rendimiento. | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | Proporciona la clase `Document` y el motor de renderizado. | +| Un **documento Word** (`.docx`) que deseas convertir a PNG. | La fuente que vas a convertir. | +| Conocimientos básicos de C# – comprenderás las sentencias `using` y la inicialización de objetos. | Mantiene la curva de aprendizaje suave. | + +Si te falta el paquete NuGet, ejecuta lo siguiente en la consola del Administrador de paquetes: + +```powershell +Install-Package Aspose.Words +``` + +Eso es todo—una vez que el paquete esté instalado, estarás listo para comenzar a programar. + +--- + +## Paso 1: Cargar el Documento Fuente + +Lo primero que debes hacer es indicar a la biblioteca el archivo Word que deseas transformar. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Por qué es importante:** La clase `Document` lee todo el paquete Word en memoria, dándote acceso a páginas, estilos y todo lo demás. Si la ruta es incorrecta, obtendrás una `FileNotFoundException`, así que verifica que el archivo exista y que la ruta use barras invertidas escapadas (`\\`) o una cadena literal (`@`). + +> **Consejo profesional:** Envuelve la llamada de carga en un bloque `try/catch` si esperas que el archivo pueda faltar en tiempo de ejecución. + +--- + +## Paso 2: Configurar Opciones de Renderizado de Imagen (Establecer Ancho y Altura de Imagen) + +Ahora llega el corazón del tutorial: **cómo establecer el ancho y la altura de la imagen** para que el PNG resultante no se vea estirado o pixelado. La clase `ImageRenderingOptions` te brinda un control detallado sobre dimensiones, DPI y suavizado. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Explicación de las propiedades clave:** + +- `Width` y `Height` – Estas son las dimensiones exactas en píxeles que deseas. Al configurarlas, **estableces el ancho y la altura de la imagen** directamente, sobrescribiendo el tamaño de página predeterminado. +- `UseAntialiasing` – Habilita un suavizado de alta calidad para texto y gráficos vectoriales, lo cual es crucial cuando **conviertes word a png** y deseas bordes nítidos. +- `Resolution` – Un DPI más alto brinda más detalle, especialmente en diseños complejos. Vigila el uso de memoria; una imagen de 300 DPI puede ser grande. + +> **¿Por qué no confiar solo en el tamaño predeterminado?** El predeterminado usa las dimensiones físicas de la página (p.ej., A4 a 96 DPI). Eso a menudo produce una imagen de 794 × 1123 píxeles—útil en algunos casos pero no cuando necesitas una miniatura de UI específica o una vista previa de tamaño fijo. + +--- + +## Paso 3: Renderizar y Guardar como PNG (Exportar Docx como Imagen) + +Con el documento cargado y las opciones configuradas, finalmente puedes **exportar docx como imagen**. El método `RenderToImage` realiza el trabajo pesado. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Si deseas renderizar **todo el documento** (todas las páginas) en archivos PNG separados, recorre la colección de páginas: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**¿Qué ocurre internamente?** El renderizador rasteriza cada página usando las dimensiones que proporcionaste, aplica antialiasing y escribe un flujo de bytes PNG en el disco. Como PNG es sin pérdida, mantienes la fidelidad completa del diseño original de Word. + +**Salida esperada:** Un archivo PNG nítido de exactamente 1024 × 768 píxeles (o el tamaño que hayas configurado). Ábrelo en cualquier visor de imágenes y verás el contenido de Word renderizado exactamente como aparece en el documento original, pero ahora como una imagen bitmap. + +--- + +## Consejos Avanzados y Variaciones + +### 1. Conservar Fondos Transparentes + +Si tu documento Word contiene formas con fondos transparentes y deseas conservar esa transparencia, establece `BackgroundColor` a `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Renderizar Solo un Rango Específico + +A veces solo necesitas un párrafo o una tabla, no toda la página. Usa `DocumentVisitor` para extraer el nodo y renderizarlo por separado. Es un escenario más avanzado, pero muestra **cómo renderizar word** a nivel granular. + +### 3. Ajustar DPI Dinámicamente + +Si necesitas diferentes DPI por página (p.ej., alta resolución para la portada), modifica `Resolution` dentro del bucle: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Procesamiento por Lotes + +Al convertir docenas de documentos, envuelve todo el flujo en un método y reutiliza la misma instancia de `ImageRenderingOptions`. Reutilizar el objeto de opciones reduce la sobrecarga de asignación. + +--- + +## Problemas Comunes y Cómo Evitarlos + +| Symptom | Likely Cause | Fix | +|---------|--------------|-----| +| El PNG está borroso a pesar de DPI alto | `UseAntialiasing` dejado en `false` | Establecer `UseAntialiasing = true`. | +| El tamaño de salida no coincide con Ancho/Altura | DPI no considerado | Multiplica el tamaño deseado por `Resolution / 96` o ajusta `Resolution`. | +| Excepción de falta de memoria en documentos grandes | Renderizar todo el documento a 300 DPI | Renderiza una página a la vez, libera cada imagen después de guardarla. | +| El PNG muestra fondo blanco en imágenes transparentes | `BackgroundColor` no establecido | Establecer `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Ejemplo Completo Funcional + +A continuación tienes un programa autónomo que puedes copiar y pegar en una aplicación de consola. Demuestra **convertir word a png**, **guardar docx como png**, y por supuesto **establecer ancho y altura de la imagen**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Ejecuta:** Compila el proyecto, coloca un `input.docx` válido en la ruta que especificaste y ejecuta. Deberías ver un `output.png` de exactamente **1024 × 768** píxeles, renderizado con bordes suaves. + +## Tutoriales Relacionados + +- [Cómo habilitar antialiasing al convertir DOCX a PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convertir docx a png – crear archivo zip tutorial c#](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Cómo usar Aspose para renderizar HTML a PNG – Guía paso a paso](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/spanish/net/html-extensions-and-conversions/_index.md b/html/spanish/net/html-extensions-and-conversions/_index.md index 58e38eec4..e976cff30 100644 --- a/html/spanish/net/html-extensions-and-conversions/_index.md +++ b/html/spanish/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,12 @@ Aspose.HTML para .NET no es solo una biblioteca, es un punto de inflexión en el ## Tutoriales de extensiones y conversiones de HTML ### [Convierte HTML a PDF en .NET con Aspose.HTML](./convert-html-to-pdf/) Convierta HTML a PDF sin esfuerzo con Aspose.HTML para .NET. Siga nuestra guía paso a paso y aproveche el poder de la conversión de HTML a PDF. + +### [Renderizar HTML como PDF en C# – Guía completa paso a paso](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Aprenda a renderizar HTML como PDF usando C# y Aspose.HTML con esta guía completa paso a paso. + +### [Convertir HTML a PDF con C# – Guía completa](./convert-html-to-pdf-with-c-complete-guide/) +Aprenda a convertir HTML a PDF usando C# con Aspose.HTML en esta guía completa paso a paso. ### [Crear PDF a partir de HTML – Guía paso a paso en C#](./create-pdf-from-html-c-step-by-step-guide/) Aprenda a generar un PDF desde HTML usando C# y Aspose.HTML con esta guía paso a paso. ### [Crear documento HTML con texto con estilo y exportarlo a PDF – Guía completa](./create-html-document-with-styled-text-and-export-to-pdf-full/) @@ -65,6 +71,8 @@ Convierta HTML a MHTML en .NET con Aspose.HTML: una guía paso a paso para archi Descubra cómo utilizar Aspose.HTML para .NET para manipular y convertir documentos HTML. Guía paso a paso para un desarrollo .NET eficaz. ### [Guardar HTML como ZIP – Tutorial completo en C#](./save-html-as-zip-complete-c-tutorial/) Aprenda a guardar documentos HTML como archivos ZIP usando Aspose.HTML para .NET con este tutorial paso a paso en C#. +### [Guardar HTML como ZIP – Guía completa para Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Aprenda a guardar HTML como archivo ZIP con Aspose.HTML mediante esta guía completa paso a paso. ### [Convierte HTML a TIFF en .NET con Aspose.HTML](./convert-html-to-tiff/) Aprenda a convertir HTML a TIFF con Aspose.HTML para .NET. Siga nuestra guía paso a paso para optimizar eficazmente el contenido web. ### [Convierta HTML a XPS en .NET con Aspose.HTML](./convert-html-to-xps/) diff --git a/html/spanish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/spanish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..0d3fc5971 --- /dev/null +++ b/html/spanish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,261 @@ +--- +category: general +date: 2026-05-22 +description: Convertir HTML a PDF en C# usando Aspose.HTML. Aprende cómo renderizar + HTML a PDF en C# con código paso a paso, opciones y sugerencias para Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: es +og_description: Convertir HTML a PDF en C# con Aspose.HTML. Esta guía muestra cómo + renderizar HTML a PDF en C# usando opciones claras y sugerencias compatibles con + Linux. +og_title: Convertir HTML a PDF con C# – Guía completa +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Convertir HTML a PDF con C# – Guía completa +url: /es/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Convert HTML to PDF with C# – Complete Guide + +Si necesitas **convertir HTML a PDF** rápidamente, Aspose.HTML for .NET lo hace muy fácil. En este tutorial también responderemos **cómo renderizar HTML a PDF en C#** con control total sobre las opciones de renderizado, para que no tengas que adivinar. + +Imagina que tienes una plantilla de correo de marketing, una página de recibo o un informe complejo construido con CSS moderno, y debes entregarlo como PDF a un cliente o a una impresora. Hacerlo manualmente es un dolor, pero unas pocas líneas de código C# pueden automatizar todo el proceso. Al final de esta guía tendrás una solución auto‑contenida, lista para producción, que funciona en Windows *y* Linux. + +## What You’ll Need + +Antes de sumergirnos, asegúrate de contar con lo siguiente: + +- **.NET 6.0 o posterior** – Aspose.HTML apunta a .NET Standard 2.0+, así que cualquier SDK reciente funciona. +- **Aspose.HTML for .NET** paquete NuGet (`Aspose.Html`) – necesitarás una licencia válida para producción, pero la prueba gratuita sirve para pruebas. +- Un **archivo HTML simple** que quieras convertir a PDF (lo llamaremos `input.html`). +- Tu IDE favorito (Visual Studio, Rider o VS Code) – no se requiere ninguna herramienta especial. + +Eso es todo. Sin convertidores PDF externos, sin trucos de línea de comandos. Solo C# puro. + +![Diagram illustrating the convert html to pdf workflow using Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## Convert HTML to PDF – Full Implementation + +A continuación tienes el programa completo, listo para ejecutar. Cópialo y pégalo en una nueva aplicación de consola, restaura los paquetes NuGet y pulsa **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Why This Works + +- **`Document`** es el punto de entrada de Aspose.HTML; analiza el HTML, resuelve el CSS y construye un DOM listo para renderizar. +- **`PdfRenderingOptions`** te permite ajustar la salida. La bandera `UseHinting` es la clave para obtener texto nítido en contenedores Linux sin cabeza donde el rasterizador predeterminado puede verse borroso. +- **`Save`** realiza el trabajo pesado: rasteriza el DOM en páginas PDF, respeta los saltos de página y embebe fuentes automáticamente. + +Al ejecutar el programa se generará `output.pdf` justo al lado de tu archivo fuente. Ábrelo con cualquier visor de PDF y deberías ver una coincidencia visual fiel del HTML original. + +## How to Render HTML to PDF in C# – Step‑by‑Step + +A continuación desglosamos el proceso en pasos manejables, explicando **cómo renderizar HTML a PDF en C#** y cubriendo los problemas más comunes. + +### Step 1 – Install the Aspose.HTML NuGet Package + +Abre tu terminal en la carpeta del proyecto y ejecuta: + +```bash +dotnet add package Aspose.Html +``` + +Si prefieres la UI de Visual Studio, haz clic derecho en el proyecto → **Manage NuGet Packages** → busca **Aspose.Html** e instala la última versión estable. + +> **Pro tip:** Después de instalar, agrega un archivo de licencia (`Aspose.Total.lic`) en la raíz de tu proyecto para evitar marcas de agua de evaluación. + +### Step 2 – Load Your HTML Correctly + +Aspose.HTML puede ingerir: + +- Rutas de archivo locales (`new Document("file.html")`) +- URLs (`new Document("https://example.com")`) +- Cadenas HTML sin procesar (`new Document("…", new HtmlLoadOptions())`) + +Cuando cargues desde el sistema de archivos, asegúrate de que la ruta sea absoluta o que el directorio de trabajo esté configurado correctamente; de lo contrario obtendrás una `FileNotFoundException`. En Linux, usa barras diagonales (`/`) o `Path.Combine`. + +### Step 3 – Choose the Right Rendering Options + +Además de `UseHinting`, quizá quieras ajustar: + +| Option | What it does | When to use it | +|--------|--------------|----------------| +| `PageSize` | Sets the PDF page dimensions (A4, Letter, custom) | Match the target paper size | +| `Landscape` | Rotates the page to landscape | Wide tables or charts | +| `RasterizeVectorGraphics` | Forces vector graphics to raster images | When the PDF consumer can’t handle SVG | +| `CompressionLevel` | Controls image compression (0‑9) | Reduce file size for email attachments | + +Puedes encadenar estas propiedades de forma fluida: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Step 4 – Save the PDF + +La sobrecarga del método `Save` que ves en el ejemplo completo escribe directamente a una ruta de archivo. También puedes transmitir el PDF a memoria: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Esto es útil cuando necesitas devolver el PDF como descarga desde una API web. + +### Step 5 – Verify the Output + +Una verificación rápida consiste en comparar el recuento de páginas del PDF con el número esperado de secciones HTML. Puedes leerlo nuevamente con Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Si el recuento parece incorrecto, revisa las reglas CSS `page-break` o ajusta `PdfRenderingOptions` según corresponda. + +## Edge Cases & Common Gotchas + +| Situation | What to watch for | Fix | +|-----------|-------------------|-----| +| **External resources (images, fonts) missing** | Relative URLs resolve against the HTML file’s folder. | Use `HtmlLoadOptions.BaseUri` to point to the correct root. | +| **Linux headless environment** | Default text rendering may be blurry. | Set `UseHinting = true` (as shown) and ensure `libgdiplus` is installed if you fall back to System.Drawing. | +| **Large HTML (> 10 MB)** | Memory consumption spikes during rendering. | Render page‑by‑page using `PdfRenderer` with `PdfRenderingOptions` and dispose each page after saving. | +| **JavaScript‑heavy pages** | Aspose.HTML does not execute JS; dynamic content stays static. | Pre‑process the HTML server‑side (e.g., using Puppeteer) before feeding it to Aspose.HTML. | +| **Unicode characters showing as squares** | Missing fonts in the runtime environment. | Embed custom fonts via `FontSettings` or ensure the OS has the required fonts installed. | + +## Full Working Example Recap + +Aquí tienes el programa completo nuevamente, sin comentarios para quienes prefieren una vista concisa: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Ejecuta el programa, abre `output.pdf` y verás una réplica pixel‑perfecta de `input.html`. Esa es la esencia de **convert html to pdf** con Aspose.HTML. + +## Conclusion + +Hemos repasado todo lo que necesitas para **convertir HTML a PDF** en C#: instalar Aspose.HTML, cargar HTML, ajustar las opciones de renderizado (incluyendo la crucial bandera `UseHinting`) y guardar el PDF final. Ahora sabes **cómo renderizar HTML a PDF en C#** tanto en entornos Windows como Linux, y has visto cómo manejar casos límite comunes como recursos faltantes y archivos grandes. + +¿Qué sigue? Prueba agregar: + +- **Headers/footers** con `PdfPageTemplate` para branding. +- **Password protection** vía `PdfSaveOptions`. +- **Batch conversion** iterando sobre una carpeta de + + +## Related Tutorials + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Convert EPUB to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Convert SVG to PDF in .NET with Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/spanish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/spanish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..c3d2f07dc --- /dev/null +++ b/html/spanish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,309 @@ +--- +category: general +date: 2026-05-22 +description: Renderiza HTML a PDF usando C# con un ejemplo conciso. Aprende a convertir + HTML a PDF con C# de forma rápida y fiable. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: es +og_description: Renderiza HTML como PDF en C# con un ejemplo claro y ejecutable. Esta + guía te muestra cómo convertir HTML a PDF en C# y generar un PDF a partir de un + archivo HTML. +og_title: Renderizar HTML como PDF en C# – Tutorial completo de programación +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Renderizar HTML como PDF en C# – Guía completa paso a paso +url: /es/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Renderizar HTML como PDF en C# – Guía Completa Paso a Paso + +¿Alguna vez necesitaste **renderizar HTML como PDF** pero no sabías qué biblioteca elegir para un proyecto .NET? No estás solo. En muchas aplicaciones empresariales tendrás que **convertir HTML a PDF C#** para facturas, informes o folletos de marketing—básicamente, siempre que quieras una versión imprimible de una página web. + +La cuestión es: no tienes que reinventar la rueda. Con unas pocas líneas de código puedes tomar un archivo `input.html`, pasárselo a un motor de renderizado probado y obtener un nítido `output.pdf`. En este tutorial recorreremos todo el proceso, desde agregar el paquete NuGet correcto hasta manejar casos límite como CSS externo. Al final podrás **generar PDF a partir de un archivo HTML** en cuestión de minutos. + +## Lo Que Aprenderás + +- Cómo configurar una aplicación de consola .NET que **crea PDF desde HTML C#**. +- Las llamadas exactas a la API que necesitas para **guardar documento HTML como PDF**. +- Por qué ciertas opciones de renderizado (como el hinting) importan para la calidad del texto. +- Consejos para solucionar problemas comunes como fuentes faltantes o rutas relativas de imágenes. + +**Prerequisitos** – debes tener .NET 6+ o .NET Framework 4.7 instalado, conocimientos básicos de C# y un IDE (Visual Studio 2022, Rider o VS Code). No se requiere experiencia previa con PDF. + +--- + +## Renderizar HTML como PDF – Configuración del Proyecto + +Antes de sumergirnos en el código, asegurémonos de que el entorno de desarrollo esté listo. La biblioteca que usaremos es **Select.Pdf** (gratuita para uso no comercial) porque ofrece una API sencilla y una fidelidad de renderizado sólida. + +### Instalar la biblioteca de renderizado PDF (convert html to pdf c#) + +Abre una terminal en la carpeta de tu proyecto y ejecuta: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Consejo:* Si usas Visual Studio, también puedes agregar el paquete mediante la UI del Administrador de paquetes NuGet. El número de versión puede ser más reciente; simplemente toma la última versión estable. + +### Crear un esqueleto de consola + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Eso es todo el código boilerplate que necesitas. El trabajo pesado ocurre dentro de `Main`. + +--- + +## Cargar el Documento HTML (generate pdf from html file) + +El primer paso real es indicar al renderizador un archivo HTML en disco. Select.Pdf ofrece dos formas convenientes: pasar una cadena HTML cruda o una ruta de archivo. Usar un archivo mantiene todo ordenado, especialmente cuando tienes CSS o imágenes vinculadas. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Aquí también protegemos contra un archivo faltante—algo que suele atrapar a los principiantes cuando olvidan copiar el HTML a la carpeta de salida. + +--- + +## Configurar Opciones de Renderizado (create pdf from html c#) + +Select.Pdf incluye un rico objeto `PdfDocumentOptions`. Para obtener texto nítido habilitamos el hinting, que suaviza los glifos a costa de un pequeño impacto en el rendimiento. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Puedes ajustar el tamaño de página, márgenes o incluso incrustar una fuente personalizada aquí. La idea clave es que **render html as pdf** no es solo una línea de código; tienes control sobre el aspecto y la sensación del documento final. + +--- + +## Guardar Documento HTML como PDF (render html as pdf) + +Ahora ocurre la magia. Le pasamos al convertidor la ruta de nuestro archivo HTML y le pedimos que escriba un PDF en disco. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +El método `ConvertUrl` resuelve automáticamente URLs relativas (imágenes, CSS) basándose en la ubicación del archivo HTML, por lo que este enfoque es robusto para la mayoría de los escenarios del mundo real. + +### Salida esperada + +Después de ejecutar el programa deberías ver un archivo `output.pdf` en la misma carpeta. Ábrelo—notarás: + +- Texto renderizado con anti‑aliasing claro (gracias al hinting). +- Estilos del CSS vinculado aplicados correctamente. +- Imágenes mostradas con el tamaño exacto definido en el HTML fuente. + +Si algo se ve extraño, verifica que los archivos CSS e imágenes estén colocados junto a `input.html` o usa URLs absolutas. + +--- + +## Manejo de Casos Límite Comunes + +### 1. Recursos externos bloqueados por firewalls + +Si tu HTML hace referencia a fuentes alojadas en un CDN al que tu servidor no puede acceder, el PDF podría recurrir a una fuente genérica. Para evitarlo, descarga los archivos de fuente localmente o incrústalos usando `@font-face` con una ruta relativa. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Archivos HTML muy grandes + +Al convertir documentos masivos, podrías alcanzar límites de memoria. Select.Pdf permite transmitir la conversión: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +El streaming mantiene el proceso ligero pero requiere que suministres el HTML como una cadena, la cual puedes leer en fragmentos si es necesario. + +### 3. Encabezados o pies de página personalizados + +Si necesitas un número de página o el logotipo de la empresa en cada página, establece las propiedades `Header` y `Footer` en `converter.Options` antes de llamar a `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## Ejemplo Completo Funcional (Todos los Pasos Combinados) + +A continuación tienes el programa completo, listo para copiar y pegar. Reemplaza `YOUR_DIRECTORY` con la ruta absoluta donde reside tu HTML. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Ejecuta:** `dotnet run` desde el directorio del proyecto. Si todo está configurado correctamente verás el mensaje de éxito y un reluciente `output.pdf`. + +--- + +## Resumen Visual + +![Render HTML as PDF example](render-html-as-pdf.png){alt="ejemplo de renderizar html como pdf"} + +La captura muestra la salida de la consola y el PDF resultante abierto en un visor. Observa los encabezados nítidos y las imágenes cargadas correctamente—exactamente lo que esperas al **render html as pdf**. + +--- + +## Conclusión + +Acabas de aprender cómo **renderizar HTML como PDF** en una aplicación C#, desde la instalación de la biblioteca hasta el ajuste fino de las opciones de renderizado. El ejemplo completo demuestra una forma fiable de **convertir HTML a PDF C#**, **generar PDF a partir de un archivo HTML**, y **guardar documento HTML como PDF** con solo unas cuantas líneas. + +¿Qué sigue? Prueba a experimentar con: + +- Añadir fuentes personalizadas para mantener la consistencia de la marca. +- Generar PDFs a partir de cadenas HTML dinámicas (p. ej., plantillas Razor). +- Fusionar varios PDFs en un único informe usando `PdfDocument.AddPage`. + +Cada una de esas extensiones se basa en los conceptos centrales cubiertos aquí, por lo que estarás listo para abordar escenarios más avanzados sin una curva de aprendizaje pronunciada. + +¿Tienes preguntas o encontraste algún obstáculo? Deja un comentario abajo y solucionemoslo juntos. ¡Feliz codificación! + +## Tutoriales Relacionados + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Create HTML Document with Styled Text and Export to PDF – Full Guide](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Convert HTML to PDF with Aspose.HTML – Full Manipulation Guide](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/spanish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/spanish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..49d5e354b --- /dev/null +++ b/html/spanish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,228 @@ +--- +category: general +date: 2026-05-22 +description: Guarda HTML como ZIP rápidamente usando Aspose.HTML. Aprende cómo comprimir + archivos HTML, renderizar HTML a ZIP y exportar HTML a un archivo ZIP con el código + completo. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: es +og_description: Guarda HTML como ZIP con Aspose.HTML. Esta guía muestra cómo renderizar + HTML a ZIP, exportar HTML a un archivo ZIP y comprimir archivos HTML programáticamente. +og_title: Guardar HTML como ZIP – Tutorial completo de Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Guardar HTML como ZIP – Guía completa para Aspose.HTML +url: /es/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Guardar HTML como ZIP – Guía completa para Aspose.HTML + +¿Alguna vez te has preguntado cómo **guardar HTML como ZIP** sin usar una herramienta de archivado separada? No eres el único. Muchos desarrolladores necesitan empaquetar una página HTML junto con sus imágenes, CSS y scripts para una distribución fácil, y hacerlo manualmente rápidamente se vuelve un dolor. + +En este tutorial recorreremos una solución limpia, de extremo a extremo, que **renderiza HTML a ZIP** usando Aspose.HTML para .NET. Al final sabrás exactamente cómo **exportar HTML a un archivo ZIP**, y también verás variaciones para **cómo comprimir archivos HTML** en diferentes escenarios. + +> *Consejo:* El enfoque mostrado funciona tanto si estás empaquetando una sola página como una carpeta completa del sitio. + +## Lo que necesitarás + +Antes de sumergirnos, asegúrate de tener: + +- .NET 6 (o cualquier runtime reciente de .NET) instalado. +- El paquete NuGet **Aspose.HTML for .NET** (`Aspose.Html`) referenciado en tu proyecto. +- Un archivo simple `input.html` colocado en una carpeta que controles. +- Un poco de comodidad con C#—nada elegante, solo lo básico. + +Eso es todo. Sin utilidades externas de zip, sin acrobacias de línea de comandos. Vamos a comenzar. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*Texto alternativo de la imagen: diagrama del proceso de guardar html como zip* + +## Paso 1: Cargar el documento HTML de origen + +Lo primero que debemos hacer es indicar a Aspose.HTML dónde está nuestro origen. La clase `HTMLDocument` lee el archivo y construye un DOM en memoria, listo para renderizar. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Por qué importa: cargar el documento le da a la biblioteca control total sobre la resolución de recursos (imágenes, CSS, fuentes). Si el HTML referencia rutas relativas, Aspose.HTML las resuelve automáticamente en relación con la carpeta del archivo. + +## Paso 2: (Opcional) Crear un controlador de recursos personalizado + +Si necesitas inspeccionar o manipular cada recurso—por ejemplo, comprimir imágenes antes de que entren al archivo—puedes conectar un `ResourceHandler`. Este paso es opcional, pero es la forma más flexible de **convertir HTML a archivo ZIP** con lógica personalizada. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*¿Qué pasa si no necesitas procesamiento especial?* Simplemente omite esta clase y usa el controlador predeterminado—Aspose.HTML escribirá los recursos directamente en el ZIP. + +## Paso 3: Configurar las opciones de guardado para usar el controlador + +El objeto `HtmlSaveOptions` indica al renderizador qué hacer con los recursos. Al asignar nuestro `MyResourceHandler`, obtenemos control total sobre la salida. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Observa cómo la propiedad `ResourceHandler` hace referencia directa a la capacidad de **renderizar HTML a ZIP**. Aquí es donde ocurre la magia: cada recurso enlazado se transmite al archivo en lugar de escribirse en disco. + +## Paso 4: Guardar el documento renderizado en un archivo ZIP + +Ahora finalmente **exportamos HTML a un archivo ZIP**. El método `Save` acepta cualquier `Stream`, por lo que podemos apuntarlo a un `FileStream` que crea `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Ese es todo el flujo de trabajo. Cuando el código termina, `result.zip` contiene: + +- `input.html` (el marcado original) +- Todas las imágenes, archivos CSS y fuentes referenciados +- Cualquier recurso transformado si los modificaste en `MyResourceHandler` + +## Cómo comprimir archivos HTML sin Aspose.HTML (alternativa rápida) + +A veces solo necesitas un enfoque clásico de **cómo comprimir archivos HTML**, quizá porque ya usas otro analizador HTML. En ese caso puedes usar `System.IO.Compression` incorporado en .NET: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Este método es simple pero carece del paso de renderizado; simplemente empaqueta lo que está en disco. Si tu HTML referencia URLs externas, esos recursos no se incluirán. Por eso la ruta Aspose.HTML se prefiere cuando necesitas una solución fiable de **renderizar HTML a ZIP**. + +## Casos límite y errores comunes + +| Situación | Qué observar | Solución recomendada | +|-----------|--------------|----------------------| +| **Imágenes grandes** | Picos de uso de memoria porque cada imagen se carga en un `MemoryStream`. | Transmitir directamente al zip usando un controlador personalizado que copie el flujo fuente en lugar de almacenarlo completamente en memoria. | +| **URLs externas** | Los recursos alojados en internet no se descargan automáticamente. | Configurar `HtmlLoadOptions` con `BaseUrl` apuntando a la raíz del sitio, o descargar manualmente los recursos antes de guardar. | +| **Colisiones de nombres de archivo** | Dos archivos CSS con el mismo nombre en diferentes subcarpetas pueden sobrescribirse. | Asegurarse de que el `ResourceHandler` preserve la ruta relativa completa al escribir en el zip. | +| **Errores de permiso** | Intentar escribir en una carpeta de solo lectura lanza `UnauthorizedAccessException`. | Ejecutar el proceso con los privilegios adecuados o elegir un directorio de salida con permisos de escritura. | + +Abordar estos escenarios hace que tu rutina de **convertir HTML a archivo ZIP** sea robusta para uso en producción. + +## Ejemplo completo (todas las piezas juntas) + +A continuación tienes el programa completo, listo para ejecutar. Pégalo en una nueva aplicación de consola, actualiza las rutas y pulsa **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Salida esperada:** La consola muestra un mensaje de éxito, y el archivo `result.zip` contiene `input.html` más cada activo dependiente. Abre el ZIP, haz doble clic en `input.html` y verás la página renderizada exactamente como lo hacía el navegador—sin imágenes faltantes, sin CSS roto. + +## Recapitulación – Por qué este enfoque es excelente + +- **Renderizado en un solo paso:** No tienes que copiar manualmente cada recurso; Aspose.HTML lo hace por ti. +- **Pipeline personalizable:** El `ResourceHandler` te da control total sobre cómo se almacena cada archivo, permitiendo compresión, encriptación o transformación sobre la marcha. +- **Multiplataforma:** Funciona en Windows, Linux y macOS siempre que tengas el runtime de .NET. +- **Sin herramientas externas:** Todo el proceso de **guardar HTML como ZIP** vive dentro de tu código C#. + +## ¿Qué sigue? + +Ahora que dominas **guardar HTML como ZIP**, considera explorar estos temas relacionados: + +- **Exportar HTML a PDF** – perfecto para informes imprimibles (el conocimiento de `export html to zip file` ayuda cuando necesitas ambos formatos). +- **Transmitir ZIP directamente a la respuesta HTTP** – ideal para APIs web que permiten a los usuarios descargar un sitio empaquetado al instante. +- **Encriptar archivos ZIP** – añade una capa de contraseña si manejas documentación confidencial. + +Siéntete libre de experimentar: cambia `MyResourceHandler` por un compresor que reduzca imágenes, o agrega un archivo de manifiesto que liste todos los recursos empaquetados. El cielo es el límite cuando controlas la cadena de renderizado. + +--- + +*¡Feliz codificación! Si encuentras algún obstáculo o tienes ideas de mejora, deja un comentario abajo. Lo resolveremos juntos.* + +## Tutoriales relacionados + +- [How to Zip HTML in C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Save HTML as ZIP – Complete C# Tutorial](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Save HTML to ZIP in C# – Complete In‑Memory Example](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/swedish/net/generate-jpg-and-png-images/_index.md b/html/swedish/net/generate-jpg-and-png-images/_index.md index 39785fb46..e8408cf2f 100644 --- a/html/swedish/net/generate-jpg-and-png-images/_index.md +++ b/html/swedish/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Lär dig att använda Aspose.HTML för .NET för att manipulera HTML-dokument, k Lär dig hur du aktiverar kantutjämning för att förbättra bildkvaliteten när du konverterar DOCX-dokument till PNG eller JPG med Aspose.HTML. ### [Konvertera DOCX till PNG – skapa zip‑arkiv C#‑handledning](./convert-docx-to-png-create-zip-archive-c-tutorial/) Lär dig hur du konverterar DOCX-filer till PNG-bilder och packar dem i ett zip‑arkiv med C# och Aspose.HTML. +### [Ställ in bildens bredd och höjd vid konvertering av Word till PNG – Fullständig guide](./set-image-width-height-when-converting-word-to-png-full-guid/) +Lär dig hur du anger bildens bredd och höjd när du konverterar Word-dokument till PNG med Aspose.HTML. ## Slutsats diff --git a/html/swedish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/swedish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..85218d71e --- /dev/null +++ b/html/swedish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,276 @@ +--- +category: general +date: 2026-05-22 +description: Ställ in bildens bredd och höjd när du konverterar ett Word‑dokument + till PNG. Lär dig hur du exporterar docx som bild med högkvalitativ rendering i + en steg‑för‑steg‑handledning. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: sv +og_description: Ställ in bildens bredd och höjd när du konverterar ett Word‑dokument + till PNG. Denna handledning visar hur du exporterar docx som bild med högkvalitativa + inställningar. +og_title: Ställ in bildens bredd och höjd vid konvertering av Word till PNG – Komplett + guide +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Ställ in bildens bredd och höjd vid konvertering från Word till PNG – Fullständig + guide +url: /sv/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Ställ in bildens bredd och höjd vid konvertering av Word till PNG – Komplett guide + +Har du någonsin undrat hur du **ställer in bildens bredd och höjd** när du **konverterar Word till PNG**? Du är inte ensam. Många utvecklare stöter på problem när standardexporten ger en suddig bild eller fel dimensioner, och sedan spenderar de timmar på att leta efter en lösning som faktiskt fungerar. + +I den här handledningen går vi igenom en ren, end‑to‑end‑lösning som visar **hur man renderar word**‑dokument som PNG‑bilder, så att du kan **spara docx som PNG** med exakt kontroll över bredd‑och‑höjd samt högkvalitativ kantutjämning. I slutet har du ett färdigt kodexempel, en gedigen förståelse för API‑alternativen och några pro‑tips för att undvika vanliga fallgropar. + +## Vad du kommer att lära dig + +- Läs in en `.docx`‑fil med Aspose.Words för .NET. +- **Ställ in bildens bredd och höjd** med `ImageRenderingOptions`. +- **Exportera docx som bild** (PNG) med antialiasing aktiverat. +- Hur man **konverterar word till png** för en enskild sida eller hela dokumentet. +- Tips för att hantera stora dokument, DPI‑aspekter och filsystemssökvägar. + +Inga externa verktyg, ingen rörig kommandorads‑gymnastik—bara ren C#‑kod som du kan klistra in i vilket .NET‑projekt som helst. + +--- + +## Förutsättningar + +Innan vi dyker ner, se till att du har följande: + +| Krav | Varför det är viktigt | +|------|-----------------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words stöder båda, men nyare runtime‑miljöer ger bättre prestanda. | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | Tillhandahåller `Document`‑klassen och renderingsmotorn. | +| A **Word document** (`.docx`) you want to turn into a PNG. | Källan du ska konvertera. | +| Basic C# knowledge – you’ll understand `using` statements and object initialization. | Håller inlärningskurvan mjuk. | + +Om du saknar NuGet‑paketet, kör detta i Package Manager Console: + +```powershell +Install-Package Aspose.Words +``` + +Det är allt—när paketet är på plats är du redo att börja koda. + +--- + +## Steg 1: Läs in källdokumentet + +Det allra första du behöver göra är att peka biblioteket på Word‑filen du vill omvandla. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Varför detta är viktigt:** `Document`‑klassen läser in hela Word‑paketet i minnet, vilket ger dig åtkomst till sidor, stilar och allt annat. Om sökvägen är fel får du ett `FileNotFoundException`, så dubbelkolla att filen finns och att sökvägen använder escapade bakåtsnedstreck (`\\`) eller en verbatim‑sträng (`@`). + +> **Pro‑tips:** Omge laddningsanropet med ett `try/catch`‑block om du förväntar dig att filen kan saknas vid körning. + +--- + +## Steg 2: Konfigurera Image Rendering Options (Ställ in bildens bredd och höjd) + +Nu kommer kärnan i handledningen: **hur man ställer in bildens bredd och höjd** så att den resulterande PNG‑filen inte blir utdragen eller pixelerad. Klassen `ImageRenderingOptions` ger dig fin‑granulär kontroll över dimensioner, DPI och utjämning. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Förklaring av de viktigaste egenskaperna:** + +- `Width` and `Height` – Detta är de exakta pixel‑dimensionerna du vill ha. Genom att sätta dem **ställer du in bildens bredd och höjd** direkt, och åsidosätter standard sidstorlek. +- `UseAntialiasing` – Aktiverar högkvalitativ utjämning för text och vektorgrafik, vilket är avgörande när du **konverterar word till png** och vill ha skarpa kanter. +- `Resolution` – Högre DPI ger mer detalj, särskilt för komplexa layouter. Håll ett öga på minnesanvändning; en 300 DPI‑bild kan bli stor. + +> **Varför inte bara förlita sig på standardstorleken?** Standard använder sidans fysiska dimensioner (t.ex. A4 vid 96 DPI). Det ger ofta en bild på 794 × 1123 pixlar—okej för vissa fall men inte när du behöver en specifik UI‑miniatur eller en förhandsvisning med fast storlek. + +--- + +## Steg 3: Rendera och spara som PNG (Exportera Docx som bild) + +När dokumentet är läst in och alternativen konfigurerade kan du äntligen **exportera docx som bild**. Metoden `RenderToImage` gör det tunga arbetet. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Om du vill rendera **hela dokumentet** (alla sidor) till separata PNG‑filer, loopa över sidkollektionen: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Vad händer under huven?** Renderaren rasteriserar varje sida med de dimensioner du angav, tillämpar antialiasing och skriver en PNG‑byte‑ström till disk. Eftersom PNG är förlustfri behåller du hela originallayoutens kvalitet. + +**Förväntat resultat:** En skarp PNG‑fil exakt 1024 × 768 pixlar (eller vilken storlek du än har angett). Öppna den i någon bildvisare så ser du Word‑innehållet renderat exakt som det visas i originaldokumentet, men nu som en bitmap‑bild. + +--- + +## Avancerade tips & variationer + +### 1. Bevara transparenta bakgrunder + +Om ditt Word‑dokument innehåller former med transparent bakgrund och du vill behålla den transparensen, sätt `BackgroundColor` till `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Rendera endast ett specifikt område + +Ibland behöver du bara ett stycke eller en tabell, inte hela sidan. Använd `DocumentVisitor` för att extrahera noden och rendera den separat. Det är ett mer avancerat scenario, men det visar **hur man renderar word**‑innehåll på en granular nivå. + +### 3. Justera DPI dynamiskt + +Om du behöver olika DPI per sida (t.ex. högupplöst för framsidan), ändra `Resolution` inuti loopen: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Batch‑bearbetning + +När du konverterar dussintals dokument, paketera hela flödet i en metod och återanvänd samma `ImageRenderingOptions`‑instans. Återanvändning av options‑objektet minskar allokeringskostnaden. + +--- + +## Vanliga fallgropar & hur man undviker dem + +| Symtom | Trolig orsak | Åtgärd | +|--------|--------------|--------| +| PNG är suddig trots hög DPI | `UseAntialiasing` lämnades på false | Sätt `UseAntialiasing = true`. | +| Utdata storlek matchar inte `Width`/`Height` | DPI beaktades inte | Multiplicera önskad storlek med `Resolution / 96` eller justera `Resolution`. | +| Out‑of‑memory‑undantag på stora dokument | Renderar hela dokumentet vid 300 DPI | Rendera en sida åt gången, frigör varje bild efter sparning. | +| PNG visar vit bakgrund på transparenta bilder | `BackgroundColor` är inte satt | Sätt `imageOptions.BackgroundColor = Color.Transparent`. | + +--- + +## Komplett fungerande exempel + +Nedan är ett fristående program som du kan kopiera och klistra in i en konsolapp. Det demonstrerar **konvertera word till png**, **spara docx som png**, och naturligtvis **ställa in bildens bredd och höjd**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Kör det:** Bygg projektet, placera en giltig `input.docx` på den sökväg du angav, och kör. Du bör se en `output.png` exakt **1024 × 768** pixlar, renderad med mjuka kanter. + +## Relaterade handledningar + +- [Hur man aktiverar antialiasing vid konvertering av DOCX till PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [konvertera docx till png – skapa zip‑arkiv c#‑handledning](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Hur man använder Aspose för att rendera HTML till PNG – steg‑för‑steg‑guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/swedish/net/html-extensions-and-conversions/_index.md b/html/swedish/net/html-extensions-and-conversions/_index.md index 6d01c9b96..1f2495c6d 100644 --- a/html/swedish/net/html-extensions-and-conversions/_index.md +++ b/html/swedish/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,8 @@ Aspose.HTML för .NET är inte bara ett bibliotek; det är en spelomvandlare i w ## Tutorials för HTML-tillägg och omvandlingar ### [Konvertera HTML till PDF i .NET med Aspose.HTML](./convert-html-to-pdf/) Konvertera HTML till PDF utan ansträngning med Aspose.HTML för .NET. Följ vår steg-för-steg-guide och släpp lös kraften i HTML-till-PDF-konvertering. +### [Rendera HTML till PDF i C# – Fullständig steg‑för‑steg‑guide](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Lär dig hur du renderar HTML till PDF i C# med en komplett steg‑för‑steg‑guide och kodexempel. ### [Konvertera EPUB till bild i .NET med Aspose.HTML](./convert-epub-to-image/) Lär dig hur du konverterar EPUB till bilder med Aspose.HTML för .NET. Steg-för-steg handledning med kodexempel och anpassningsbara alternativ. ### [Konvertera EPUB till PDF i .NET med Aspose.HTML](./convert-epub-to-pdf/) @@ -73,6 +75,10 @@ Skapa PDF från HTML med C# och Aspose.HTML för .NET. Följ vår steg‑för‑ Lär dig hur du sparar HTML som en ZIP-fil med en komplett C#-kodexempel och steg-för-steg-instruktioner. ### [Spara HTML till ZIP i C# – Komplett minnesexempel](./save-html-to-zip-in-c-complete-in-memory-example/) Lär dig hur du sparar HTML-filer i ett ZIP‑arkiv i minnet med C# och Aspose.HTML. +### [Spara HTML som ZIP – Komplett guide för Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Lär dig hur du sparar HTML som ZIP med en komplett guide för Aspose.HTML. +### [Konvertera HTML till PDF med C# – Komplett guide](./convert-html-to-pdf-with-c-complete-guide/) +Lär dig hur du konverterar HTML till PDF med C# i en komplett guide med kodexempel och steg‑för‑steg‑instruktioner. ## Slutsats diff --git a/html/swedish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/swedish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..c23b8b760 --- /dev/null +++ b/html/swedish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,257 @@ +--- +category: general +date: 2026-05-22 +description: Konvertera HTML till PDF i C# med Aspose.HTML. Lär dig hur du renderar + HTML till PDF i C# med steg‑för‑steg‑kod, alternativ och Linux‑tips. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: sv +og_description: Konvertera HTML till PDF i C# med Aspose.HTML. Den här guiden visar + hur du renderar HTML till PDF i C# med tydliga alternativ och Linux‑vänlig hintning. +og_title: Konvertera HTML till PDF med C# – komplett guide +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Konvertera HTML till PDF med C# – Komplett guide +url: /sv/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Konvertera HTML till PDF med C# – Komplett guide + +Om du snabbt behöver **konvertera HTML till PDF**, gör Aspose.HTML för .NET det enkelt. I den här handledningen kommer vi också att svara på **hur man renderar HTML till PDF i C#** med full kontroll över renderingsalternativ, så att du inte blir osäker. + +Föreställ dig att du har en marknadsförings‑e‑postmall, en kvittosida eller en komplex rapport byggd med modern CSS, och du måste leverera den som en PDF till en kund eller en skrivare. Att göra det manuellt är jobbigt, men några rader C#‑kod kan automatisera hela processen. I slutet av den här guiden har du en självständig, produktionsklar lösning som fungerar på Windows *och* Linux. + +## Vad du behöver + +- **.NET 6.0 or later** – Aspose.HTML riktar sig mot .NET Standard 2.0+, så alla nyare SDK fungerar. +- **Aspose.HTML for .NET** NuGet‑paket (`Aspose.Html`) – du behöver en giltig licens för produktion, men gratisprovversionen fungerar för testning. +- En **simple HTML file** du vill omvandla till en PDF (vi kallar den `input.html`). +- Din favorit‑IDE (Visual Studio, Rider eller VS Code) – ingen speciell verktygskedja krävs. + +Det är allt. Inga externa PDF‑konverterare, inga kommandorads‑akrobatik. Bara ren C#. + +![Diagram som illustrerar arbetsflödet för att konvertera html till pdf med Aspose.HTML](/images/convert-html-to-pdf-workflow.png "konvertera html till pdf arbetsflöde") + +## Konvertera HTML till PDF – Fullständig implementation + +Nedan är det kompletta, färdiga programmet. Kopiera och klistra in det i en ny konsolapp, återställ NuGet‑paket och tryck på **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Varför detta fungerar + +- **`Document`** är Aspose.HTML:s ingångspunkt; den parsar HTML, löser CSS och bygger ett DOM redo för rendering. +- **`PdfRenderingOptions`** låter dig finjustera utdata. `UseHinting`‑flaggan är den hemliga ingrediensen för skarp text i huvudlösa Linux‑behållare där standard‑rasterizern kan bli suddig. +- **`Save`** gör det tunga arbetet: den rasteriserar DOM‑en på PDF‑sidor, respekterar sidbrytningar och bäddar in typsnitt automatiskt. + +När programmet körs genereras `output.pdf` precis bredvid din källfil. Öppna den med någon PDF‑visare så bör du se en trogen visuell återgivning av den ursprungliga HTML‑koden. + +## Så renderar du HTML till PDF i C# – Steg för steg + +Nedan delar vi upp processen i mindre bitar och förklarar **hur man renderar HTML till PDF i C#** samtidigt som vi går igenom vanliga fallgropar. + +### Steg 1 – Installera Aspose.HTML NuGet‑paketet + +Öppna din terminal i projektmappen och kör: + +```bash +dotnet add package Aspose.Html +``` + +Om du föredrar Visual Studio‑gränssnittet, högerklicka på projektet → **Manage NuGet Packages** → sök efter **Aspose.Html** och installera den senaste stabila versionen. + +> **Pro tip:** Efter installationen, lägg till en licensfil (`Aspose.Total.lic`) i projektets rot för att undvika utvärderingsvattenmärken. + +### Steg 2 – Ladda din HTML korrekt + +Aspose.HTML kan ingest: + +- Lokala filsökvägar (`new Document("file.html")`) +- URL:er (`new Document("https://example.com")`) +- Råa HTML‑strängar (`new Document("…", new HtmlLoadOptions())`) + +När du laddar från filsystemet, se till att sökvägen är absolut eller att arbetskatalogen är korrekt inställd, annars får du ett `FileNotFoundException`. På Linux, använd framåtsnedstreck (`/`) eller `Path.Combine`. + +### Steg 3 – Välj rätt renderingsalternativ + +Förutom `UseHinting` kan du vilja justera: + +| Alternativ | Vad det gör | När det ska användas | +|------------|-------------|----------------------| +| `PageSize` | Ställer in PDF‑sidans dimensioner (A4, Letter, anpassad) | Matcha målpapperets storlek | +| `Landscape` | Rotera sidan till liggande | Breda tabeller eller diagram | +| `RasterizeVectorGraphics` | Tvingar vektorgrafik att rasteriseras till bilder | När PDF‑mottagaren inte kan hantera SVG | +| `CompressionLevel` | Styr bildkomprimering (0‑9) | Minska filstorlek för e‑postbilagor | + +Du kan kedja dessa egenskaper flytande: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Steg 4 – Spara PDF‑filen + +`Save`‑metodens överlagring du ser i hela exemplet skriver direkt till en filsökväg. Du kan också strömma PDF‑filen till minnet: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Det är praktiskt när du behöver returnera PDF‑filen som en nedladdning från ett webb‑API. + +### Steg 5 – Verifiera resultatet + +En snabb kontroll är att jämföra PDF‑sidantalet med det förväntade antalet HTML‑sektioner. Du kan läsa tillbaka det med Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Om antalet ser fel ut, gå tillbaka till CSS `page-break`‑reglerna eller justera `PdfRenderingOptions` därefter. + +## Edge Cases & vanliga fallgropar + +| Situation | Vad att hålla utkik efter | Lösning | +|-----------|---------------------------|---------| +| **External resources (images, fonts) missing** | Relativa URL:er löses mot HTML‑filens mapp. | Använd `HtmlLoadOptions.BaseUri` för att peka på rätt rot. | +| **Linux headless environment** | Standardtextrendering kan bli suddig. | Sätt `UseHinting = true` (som visat) och se till att `libgdiplus` är installerat om du faller tillbaka på System.Drawing. | +| **Large HTML (> 10 MB)** | Minnesanvändningen skjuter i höjden under rendering. | Rendera sida‑för‑sida med `PdfRenderer` och `PdfRenderingOptions` och frigör varje sida efter sparning. | +| **JavaScript‑heavy pages** | Aspose.HTML kör inte JS; dynamiskt innehåll förblir statiskt. | Förprocessa HTML‑en på servern (t.ex. med Puppeteer) innan du matar in den i Aspose.HTML. | +| **Unicode characters showing as squares** | Saknade typsnitt i körmiljön. | Bädda in egna typsnitt via `FontSettings` eller se till att OS har de nödvändiga typsnitten installerade. | + +## Sammanfattning av komplett fungerande exempel + +Här är hela programmet igen, utan kommentarer för dem som föredrar en koncis vy: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Kör det, öppna `output.pdf` och du kommer att se en pixel‑perfekt kopia av `input.html`. Det är kärnan i **convert html to pdf** med Aspose.HTML. + +## Slutsats + +Vi har gått igenom allt du behöver för att **convert HTML to PDF** i C#: installera Aspose.HTML, ladda HTML, finjustera renderingsalternativ (inklusive den avgörande `UseHinting`‑flaggan) och spara den slutgiltiga PDF‑filen. Du förstår nu **how to render HTML to PDF in C#** för både Windows‑ och Linux‑miljöer, och du har sett hur man hanterar vanliga edge cases som saknade resurser och stora filer. + +Vad blir nästa steg? Prova att lägga till: + +- **Headers/footers** med `PdfPageTemplate` för varumärkesprofilering. +- **Password protection** via `PdfSaveOptions`. +- **Batch conversion** genom att loopa över en mapp med + +## Relaterade handledningar + +- [Konvertera HTML till PDF i .NET med Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Konvertera EPUB till PDF i .NET med Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Konvertera SVG till PDF i .NET med Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/swedish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/swedish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..a2a42df74 --- /dev/null +++ b/html/swedish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,292 @@ +--- +category: general +date: 2026-05-22 +description: Rendera HTML som PDF med C# med ett koncist exempel. Lär dig hur du konverterar + HTML till PDF i C# snabbt och pålitligt. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: sv +og_description: Rendera HTML som PDF i C# med ett tydligt, körbart exempel. Den här + guiden visar hur du konverterar HTML till PDF i C# och genererar PDF från en HTML‑fil. +og_title: Rendera HTML till PDF i C# – Komplett programmeringshandledning +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Rendera HTML som PDF i C# – Fullständig steg‑för‑steg‑guide +url: /sv/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Rendera HTML som PDF i C# – Fullständig steg‑för‑steg‑guide + +Har du någonsin behövt **rendera HTML som PDF** men varit osäker på vilket bibliotek du ska välja för ett .NET‑projekt? Du är inte ensam. I många affärsapplikationer kommer du att behöva **konvertera HTML till PDF C#** för fakturor, rapporter eller marknadsföringsbroschyrer – i princip varje gång du vill ha en utskrivbar version av en webbsida. + +Poängen är den: du behöver inte uppfinna hjulet på nytt. Med några kodrader kan du ta en `input.html`‑fil, skicka den till en beprövad renderingsmotor och få en skarp `output.pdf`. I den här handledningen går vi igenom hela processen, från att lägga till rätt NuGet‑paket till att hantera kantfall som extern CSS. När du är klar kommer du kunna **generera PDF från HTML‑fil** på några minuter. + +## Vad du kommer att lära dig + +- Hur du sätter upp en .NET‑konsolapp som **skapar PDF från HTML C#**‑kod. +- De exakta API‑anropen du behöver för att **spara HTML‑dokument som PDF**. +- Varför vissa renderingsalternativ (som hinting) är viktiga för textkvaliteten. +- Tips för felsökning av vanliga fallgropar som saknade typsnitt eller relativa bildvägar. + +**Förutsättningar** – du bör ha .NET 6+ eller .NET Framework 4.7 installerat, grundläggande kunskaper i C# och en IDE (Visual Studio 2022, Rider eller VS Code). Ingen tidigare PDF‑erfarenhet krävs. + +## Rendera HTML som PDF – Ställ in projektet + +Innan vi dyker ner i koden, låt oss se till att utvecklingsmiljön är klar. Biblioteket vi kommer att använda är **Select.Pdf** (gratis för icke‑kommersiell användning) eftersom det erbjuder ett enkelt API och hög renderingskvalitet. + +### Installera PDF‑renderingsbiblioteket (convert html to pdf c#) + +Öppna en terminal i din projektmapp och kör: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Proffstips:* Om du använder Visual Studio kan du också lägga till paketet via NuGet Package Manager‑gränssnittet. Versionsnumret kan vara nyare – hämta bara den senaste stabila versionen. + +### Skapa ett konsolskelett + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Det är all boilerplate du behöver. Det tunga arbetet sker i `Main`. + +## Ladda HTML‑dokumentet (generate pdf from html file) + +Det första riktiga steget är att peka renderaren mot en HTML‑fil på disken. Select.Pdf erbjuder två praktiska sätt: att skicka en rå HTML‑sträng eller en filsökväg. Att använda en fil håller allt organiserat, särskilt när du har länkad CSS eller bilder. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Här skyddar vi också mot en saknad fil – något som ofta får nybörjare att snubbla när de glömmer att kopiera HTML‑filen till utdata‑mappen. + +## Konfigurera renderingsalternativ (create pdf from html c#) + +Select.Pdf levereras med ett rikt `PdfDocumentOptions`‑objekt. För skarp text aktiverar vi hinting, vilket jämnar ut glyferna åt priset av en liten prestandapåverkan. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Du kan justera sidstorlek, marginaler eller till och med bädda in ett eget typsnitt här. Huvudpoängen är att **render html as pdf** inte bara är en enradare; du har kontroll över det slutgiltiga dokumentets utseende och känsla. + +## Spara HTML‑dokument som PDF (render html as pdf) + +Nu händer magin. Vi ger konverteraren sökvägen till vår HTML‑fil och ber den skriva en PDF till disken. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +Metoden `ConvertUrl` löser automatiskt relativa URL:er (bilder, CSS) baserat på HTML‑filens plats, vilket gör att detta tillvägagångssätt är robust för de flesta verkliga scenarier. + +### Förväntad utdata + +Efter att du har kört programmet bör du se en fil `output.pdf` i samma mapp. Öppna den – du kommer märka: + +- Text renderad med tydlig anti‑aliasing (tack vare hinting). +- Stilar från länkad CSS tillämpas korrekt. +- Bilder visas i exakt den storlek som definierats i käll‑HTML. + +Om något ser felaktigt ut, dubbelkolla att CSS‑ och bildfilerna ligger bredvid `input.html` eller använd absoluta URL:er. + +## Hantera vanliga kantfall + +### 1. Externa resurser blockeras av brandväggar + +Om din HTML refererar till typsnitt som hostas på ett CDN som din server inte kan nå, kan PDF‑filen falla tillbaka på ett generiskt typsnitt. För att undvika detta, ladda ner typsnittsfilerna lokalt eller bädda in dem med `@font-face` och en relativ sökväg. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Mycket stora HTML‑filer + +När du konverterar enorma dokument kan du stöta på minnesgränser. Select.Pdf låter dig strömma konverteringen: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Strömning håller processen lättviktig men kräver att du levererar HTML som en sträng, vilket du kan läsa i delar om så behövs. + +### 3. Anpassade sidhuvuden eller sidfötter + +Om du behöver ett sidnummer eller företagets logotyp på varje sida, sätt `Header`‑ och `Footer`‑egenskaperna på `converter.Options` innan du anropar `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +## Fullt fungerande exempel (alla steg kombinerade) + +Nedan är det kompletta, kopiera‑och‑klistra‑klara programmet. Ersätt `YOUR_DIRECTORY` med den absoluta sökvägen där din HTML finns. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Kör det:** `dotnet run` från projektkatalogen. Om allt är korrekt konfigurerat kommer du se framgångsmeddelandet och en skinande `output.pdf`. + +## Visuell sammanfattning + +![Render HTML as PDF example](render-html-as-pdf.png){alt="render html as pdf example"} + +Skärmbilden visar konsolutdata och den resulterande PDF‑filen öppnad i en visare. Lägg märke till de skarpa rubrikerna och korrekt inlästa bilder – exakt vad du förväntar dig när du **render html as pdf**. + +## Slutsats + +Du har precis lärt dig hur du **renderar HTML som PDF** i en C#‑applikation, från att installera biblioteket till att finjustera renderingsalternativen. Det fullständiga exemplet visar ett pålitligt sätt att **convert HTML to PDF C#**, **generate PDF from HTML file**, och **save HTML document as PDF** med bara ett fåtal rader. + +Vad blir nästa steg? Prova att experimentera med: + +- Lägga till egna typsnitt för varumärkeskonsekvens. +- Generera PDF‑filer från dynamiska HTML‑strängar (t.ex. Razor‑mallar). +- Sammanfoga flera PDF‑filer till en enda rapport med `PdfDocument.AddPage`. + +Var och en av dessa tillägg bygger på de grundläggande koncepten som behandlats här, så du är redo att ta dig an mer avancerade scenarier utan en brant inlärningskurva. + +Har du frågor eller stött på ett problem? Lämna en kommentar nedan så felsöker vi tillsammans. Lycka till med kodandet! + +## Relaterade handledningar + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Create HTML Document with Styled Text and Export to PDF – Full Guide](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Convert HTML to PDF with Aspose.HTML – Full Manipulation Guide](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/swedish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/swedish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..d58a36008 --- /dev/null +++ b/html/swedish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,223 @@ +--- +category: general +date: 2026-05-22 +description: Spara HTML som ZIP snabbt med Aspose.HTML. Lär dig hur du zippar HTML-filer, + renderar HTML till ZIP och exporterar HTML till en ZIP-fil med fullständig kod. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: sv +og_description: Spara HTML som ZIP med Aspose.HTML. Denna guide visar hur du renderar + HTML till ZIP, exporterar HTML till en ZIP-fil och zippar HTML-filer programatiskt. +og_title: Spara HTML som ZIP – Komplett Aspose.HTML-handledning +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Spara HTML som ZIP – Komplett guide för Aspose.HTML +url: /sv/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Spara HTML som ZIP – Komplett guide för Aspose.HTML + +Har du någonsin undrat hur man **sparar HTML som ZIP** utan att ta fram ett separat arkiveringsverktyg? Du är inte ensam. Många utvecklare behöver paketera en HTML‑sida tillsammans med dess bilder, CSS och skript för enkel distribution, och att göra det manuellt blir snabbt ett problem. + +I den här handledningen går vi igenom en ren, end‑to‑end‑lösning som **renderar HTML till ZIP** med Aspose.HTML för .NET. I slutet vet du exakt hur man **exporterar HTML till en ZIP‑fil**, och du får också se variationer för **hur man zippar HTML‑filer** i olika scenarier. + +> *Proffstips:* Metoden som visas fungerar oavsett om du paketerar en enskild sida eller en hel webbplatsmapp. + +## Vad du behöver + +- .NET 6 (eller någon nyare .NET‑runtime) installerad. +- NuGet‑paketet Aspose.HTML för .NET (`Aspose.Html`) refererat i ditt projekt. +- En enkel `input.html`‑fil placerad i en mapp du kontrollerar. +- Lite C#‑kunskap—inget avancerat, bara grunderna. + +Det är allt. Inga externa zip‑verktyg, inga kommandorads‑akrobatik. Låt oss börja. + +![Diagram som visar processen för att spara HTML som ZIP med Aspose.HTML](save-html-as-zip.png) + +*Bildtext: diagram för att spara html som zip process* + +## Steg 1: Ladda käll‑HTML‑dokumentet + +Det första vi måste göra är att tala om för Aspose.HTML var vår källa finns. Klassen `HTMLDocument` läser filen och bygger ett DOM‑träd i minnet, redo för rendering. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Varför detta är viktigt: genom att ladda dokumentet får biblioteket full kontroll över resurshantering (bilder, CSS, typsnitt). Om HTML‑filen refererar till relativa sökvägar, löser Aspose.HTML dem automatiskt i förhållande till filens mapp. + +## Steg 2: (Valfritt) Skapa en anpassad Resource Handler + +Om du behöver inspektera eller manipulera varje resurs—t.ex. om du vill komprimera bilder innan de läggs i arkivet—kan du ansluta en `ResourceHandler`. Detta steg är valfritt, men det är det mest flexibla sättet att **konvertera HTML till ZIP‑arkiv** med anpassad logik. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Vad händer om du inte behöver någon speciell bearbetning?* Hoppa bara över den här klassen och använd standard‑handlern—Aspose.HTML skriver resurserna direkt in i ZIP‑filen. + +## Steg 3: Konfigurera sparalternativ för att använda handlern + +`HtmlSaveOptions`‑objektet talar om för renderaren vad som ska göras med resurserna. Genom att tilldela vår `MyResourceHandler` får vi full kontroll över resultatet. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Lägg märke till hur egenskapsnamnet `ResourceHandler` direkt refererar till **render HTML to ZIP**‑kapaciteten. Här sker magin: varje länkad resurs strömmas in i arkivet istället för att skrivas till disk. + +## Steg 4: Spara det renderade dokumentet i ett ZIP‑arkiv + +Nu **exporterar vi HTML till en ZIP‑fil**. Metoden `Save` accepterar vilken `Stream` som helst, så vi kan rikta den mot en `FileStream` som skapar `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Det är hela arbetsflödet. När koden är klar innehåller `result.zip`: + +- `input.html` (den ursprungliga markupen) +- Alla refererade bilder, CSS‑filer och typsnitt +- Eventuella transformerade resurser om du justerade dem i `MyResourceHandler` + +## Hur man zippar HTML‑filer utan Aspose.HTML (snabbt alternativ) + +Ibland behöver du bara ett enkelt **hur man zippar HTML‑filer**‑tillvägagångssätt, kanske för att du redan använder en annan HTML‑parser. I så fall kan du använda .NET:s inbyggda `System.IO.Compression`: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Denna metod är enkel men saknar renderingssteget; den packar bara det som finns på disk. Om din HTML refererar till externa URL‑er inkluderas inte dessa resurser. Därför föredras Aspose.HTML‑vägen när du behöver en pålitlig **render HTML to ZIP**‑lösning. + +## Edge Cases & vanliga fallgropar + +| Situation | Vad man bör se upp för | Rekommenderad åtgärd | +|-----------|-------------------|-----------------| +| **Stora bilder** | Minnesanvändningen skjuter i höjden eftersom varje bild laddas in i en `MemoryStream`. | Strömma direkt till zip‑filen med en anpassad handler som kopierar källströmmen istället för att buffra helt. | +| **Externa URL:er** | Resurser som hostas på internet laddas inte ner automatiskt. | Ställ in `HtmlLoadOptions` med `BaseUrl` som pekar på webbplatsens rot, eller ladda ner resurser manuellt innan sparning. | +| **Filnamnskollisioner** | Två CSS‑filer med samma namn i olika undermappar kan skriva över varandra. | Se till att `ResourceHandler` bevarar hela den relativa sökvägen när den skriver till zip‑filen. | +| **Behörighetsfel** | Försök att skriva till en skrivskyddad mapp kastar `UnauthorizedAccessException`. | Kör processen med rätt behörigheter eller välj en skrivbar utdatamapp. | + +Att hantera dessa scenarier gör din **convert HTML to ZIP archive**‑rutin robust för produktionsbruk. + +## Fullt fungerande exempel (alla delar tillsammans) + +Nedan är det kompletta, färdiga programmet. Klistra in det i en ny konsolapp, uppdatera sökvägarna och tryck på **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Förväntad output:** Konsolen skriver ut ett lyckat meddelande, och `result.zip`‑filen innehåller `input.html` plus alla beroende tillgångar. Öppna ZIP‑filen, dubbelklicka på `input.html`, så ser du sidan renderad exakt som i webbläsaren—inga saknade bilder, ingen trasig CSS. + +## Sammanfattning – Varför detta tillvägagångssätt är fantastiskt + +- **Enstegsrending:** Du behöver inte manuellt kopiera varje resurs; Aspose.HTML gör det åt dig. +- **Anpassningsbar pipeline:** `ResourceHandler` ger dig full kontroll över hur varje fil lagras, möjliggör komprimering, kryptering eller on‑the‑fly‑transformering. +- **Cross‑platform:** Fungerar på Windows, Linux och macOS så länge du har .NET‑runtime. +- **Inga externa verktyg:** Hela **save HTML as ZIP**‑processen lever inom din C#‑kodbas. + +## Vad blir nästa steg? + +Nu när du har bemästrat **save HTML as ZIP**, överväg att utforska dessa relaterade ämnen: + +- **Export HTML to PDF** – perfekt för utskrivbara rapporter (`export html to zip file`‑kunskap hjälper när du behöver båda formaten). +- **Streama ZIP direkt till HTTP‑svar** – utmärkt för webb‑API:er som låter användare ladda ner en paketerad webbplats i farten. +- **Kryptera ZIP‑arkiv** – lägg till ett lösenordslager om du hanterar konfidentiell dokumentation. + +Känn dig fri att experimentera: byt ut `MyResourceHandler` mot en kompressor som minskar bilder, eller lägg till en manifestfil som listar alla paketerade resurser. Himlen är gränsen när du styr renderings‑pipen. + +*Lycklig kodning! Om du stöter på problem eller har idéer för förbättringar, lämna en kommentar nedan. Vi löser det tillsammans.* + +## Relaterade handledningar + +- [Hur man zippar HTML i C# – Spara HTML till Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Spara HTML som ZIP – Komplett C#‑handledning](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Spara HTML till ZIP i C# – Komplett In‑Memory‑exempel](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/thai/net/generate-jpg-and-png-images/_index.md b/html/thai/net/generate-jpg-and-png-images/_index.md index bb3254275..aaf6914fb 100644 --- a/html/thai/net/generate-jpg-and-png-images/_index.md +++ b/html/thai/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Aspose.HTML สำหรับ .NET นำเสนอวิธีการง เรียนรู้วิธีเปิดใช้งาน Antialiasing เพื่อให้ภาพ PNG/JPG ที่แปลงจาก DOCX มีความคมชัดและลื่นไหล ### [แปลง DOCX เป็น PNG – สร้างไฟล์ ZIP ด้วย C#](./convert-docx-to-png-create-zip-archive-c-tutorial/) เรียนรู้วิธีแปลงไฟล์ DOCX เป็น PNG แล้วบีบอัดเป็นไฟล์ ZIP ด้วย C# โดยใช้ Aspose.HTML +### [ตั้งค่าความกว้างและความสูงของภาพเมื่อแปลง Word เป็น PNG – คู่มือเต็ม](./set-image-width-height-when-converting-word-to-png-full-guid/) +เรียนรู้วิธีกำหนดความกว้างและความสูงของภาพขณะแปลงไฟล์ Word เป็น PNG ด้วย Aspose.HTML สำหรับ .NET อย่างละเอียด ## บทสรุป diff --git a/html/thai/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/thai/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..44f061a08 --- /dev/null +++ b/html/thai/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,272 @@ +--- +category: general +date: 2026-05-22 +description: กำหนดความกว้างและความสูงของภาพขณะแปลงเอกสาร Word เป็น PNG. เรียนรู้วิธีส่งออกไฟล์ + docx เป็นภาพด้วยการเรนเดอร์คุณภาพสูงในบทแนะนำแบบทีละขั้นตอน. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: th +og_description: กำหนดความกว้างและความสูงของภาพขณะแปลงเอกสาร Word เป็น PNG. บทเรียนนี้แสดงวิธีส่งออกไฟล์ + docx เป็นภาพด้วยการตั้งค่าคุณภาพสูง. +og_title: ตั้งค่าความกว้างและความสูงของภาพเมื่อแปลง Word เป็น PNG – คู่มือเต็ม +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: ตั้งความกว้างและความสูงของภาพเมื่อแปลง Word เป็น PNG – คู่มือเต็ม +url: /th/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# ตั้งความกว้างและความสูงของภาพเมื่อแปลง Word เป็น PNG – คู่มือฉบับสมบูรณ์ + +เคยสงสัยไหมว่า **จะตั้งความกว้างและความสูงของภาพ** อย่างไรในขณะที่คุณ **แปลง Word เป็น PNG**? คุณไม่ได้เป็นคนเดียวที่เจอปัญหา นี้เป็นอุปสรรคที่หลายคนเจอเมื่อตัวส่งออกเริ่มต้นให้ภาพเบลอหรือขนาดไม่ตรงตามที่ต้องการ แล้วพวกเขาต้องใช้เวลาหลายชั่วโมงค้นหาแนวทางแก้ที่ใช้งานได้จริง + +ในบทเรียนนี้เราจะพาคุณผ่านโซลูชันแบบครบวงจรที่แสดง **วิธีเรนเดอร์เอกสาร word** เป็นภาพ PNG โดยให้คุณ **บันทึก docx เป็น PNG** พร้อมการควบคุมความกว้าง‑ความสูงที่แม่นยำและการแอนติอาลีซิ่งคุณภาพสูง เมื่อเสร็จคุณจะได้โค้ดสแนปเพียงชิ้นเดียวที่พร้อมรัน ความเข้าใจลึกซึ้งเกี่ยวกับตัวเลือก API และเคล็ดลับระดับมืออาชีพเพื่อหลีกเลี่ยงข้อผิดพลาดทั่วไป + +## สิ่งที่คุณจะได้เรียนรู้ + +- โหลดไฟล์ `.docx` ด้วย Aspose.Words for .NET +- **ตั้งความกว้างและความสูงของภาพ** ด้วย `ImageRenderingOptions` +- **ส่งออก docx เป็นภาพ** (PNG) พร้อมเปิดใช้งานแอนติอาลีซิ่ง +- วิธี **แปลง word เป็น png** สำหรับหน้าเดียวหรือทั้งเอกสาร +- เคล็ดลับการจัดการเอกสารขนาดใหญ่, การพิจารณา DPI, และเส้นทางไฟล์ระบบ + +ไม่มีเครื่องมือภายนอก, ไม่มีการใช้คำสั่งบรรทัดที่ซับซ้อน—เพียงโค้ด C# ธรรมดาที่คุณสามารถใส่ลงในโปรเจกต์ .NET ใดก็ได้ + +--- + +## ข้อกำหนดเบื้องต้น + +ก่อนที่เราจะเริ่ม, โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้: + +| ความต้องการ | เหตุผลที่สำคัญ | +|-------------|----------------| +| **.NET 6.0+** (หรือ .NET Framework 4.7.2) | Aspose.Words รองรับทั้งสอง, แต่รันไทม์ใหม่ให้ประสิทธิภาพดีกว่า | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | ให้คลาส `Document` และเอนจินเรนเดอร์ | +| เอกสาร **Word** (`.docx`) ที่คุณต้องการแปลงเป็น PNG | แหล่งข้อมูลต้นฉบับของคุณ | +| ความรู้พื้นฐาน C# – คุณต้องเข้าใจคำสั่ง `using` และการสร้างอ็อบเจ็กต์ | ทำให้การเรียนรู้ไม่ยากเกินไป | + +หากคุณยังไม่มีแพคเกจ NuGet, ให้รันคำสั่งต่อไปนี้ใน Package Manager Console: + +```powershell +Install-Package Aspose.Words +``` + +เท่านี้—เมื่อแพคเกจพร้อม, คุณก็พร้อมเริ่มเขียนโค้ดแล้ว + +--- + +## ขั้นตอนที่ 1: โหลดเอกสารต้นฉบับ + +สิ่งแรกที่ต้องทำคือชี้ให้ไลบรารีรู้ตำแหน่งไฟล์ Word ที่ต้องการแปลง + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**เหตุผลที่สำคัญ:** คลาส `Document` จะอ่านแพคเกจ Word ทั้งหมดเข้าสู่หน่วยความจำ, ทำให้คุณเข้าถึงหน้า, สไตล์, และทุกอย่างได้ หากเส้นทางไฟล์ผิด, คุณจะได้รับ `FileNotFoundException`, ดังนั้นตรวจสอบให้แน่ใจว่าไฟล์มีอยู่และใช้เครื่องหมาย escape (`\\`) หรือสตริงแบบ verbatim (`@`) อย่างถูกต้อง + +> **เคล็ดลับระดับมืออาชีพ:** หากคาดว่าไฟล์อาจหายไปในขณะรัน, ควรห่อการโหลดด้วยบล็อก `try/catch` + +--- + +## ขั้นตอนที่ 2: ตั้งค่าตัวเลือกการเรนเดอร์ภาพ (Set Image Width Height) + +ต่อมาคือหัวใจของบทเรียน: **วิธีตั้งความกว้างและความสูงของภาพ** เพื่อให้ PNG ที่ได้ไม่บิดเบือนหรือพิกเซลมากเกินไป คลาส `ImageRenderingOptions` ให้คุณควบคุมขนาด, DPI, และการทำให้เรียบอย่างละเอียด + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**คำอธิบายคุณสมบัติสำคัญ:** + +- `Width` และ `Height` – กำหนดพิกเซลที่ต้องการโดยตรง เมื่อกำหนดค่าเหล่านี้คุณ **ตั้งความกว้างและความสูงของภาพ** ได้ทันที, แทนการใช้ขนาดหน้าเริ่มต้น +- `UseAntialiasing` – เปิดการทำให้เรียบคุณภาพสูงสำหรับข้อความและกราฟิกเวกเตอร์, สิ่งสำคัญเมื่อคุณ **แปลง word เป็น png** และต้องการขอบคมชัด +- `Resolution` – DPI สูงให้รายละเอียดมากขึ้น, โดยเฉพาะกับเลย์เอาต์ซับซ้อน แต่ต้องระวังการใช้หน่วยความจำ; ภาพ 300 DPI อาจค่อนข้างใหญ่ + +> **ทำไมต้องไม่พึ่งขนาดเริ่มต้น?** ค่าเริ่มต้นใช้ขนาดกายภาพของหน้า (เช่น A4 ที่ 96 DPI) ซึ่งมักให้ภาพ 794 × 1123 พิกเซล—อาจพอใช้ในบางกรณี แต่ไม่เหมาะกับการทำ thumbnail UI หรือพรีวิวขนาดคงที่ + +--- + +## ขั้นตอนที่ 3: เรนเดอร์และบันทึกเป็น PNG (Export Docx as Image) + +เมื่อโหลดเอกสารและตั้งค่าตัวเลือกเรียบร้อย, คุณสามารถ **ส่งออก docx เป็นภาพ** ได้เลย เมธอด `RenderToImage` จะทำงานหนักให้คุณ + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +หากต้องการเรนเดอร์ **ทั้งเอกสาร** (ทุกหน้า) ลงไฟล์ PNG แยกกัน, ให้วนลูปผ่านคอลเลกชันของหน้า: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**สิ่งที่เกิดขึ้นเบื้องหลัง:** เรนเดอร์จะแปลงแต่ละหน้าเป็นภาพตามขนาดที่คุณกำหนด, ใช้แอนติอาลีซิ่ง, แล้วเขียนสตรีมไบต์ PNG ลงดิสก์ เนื่องจาก PNG เป็นแบบ lossless คุณจึงคงความคมชัดของเลย์เอาต์ Word ได้เต็มที่ + +**ผลลัพธ์ที่คาดหวัง:** ไฟล์ PNG คมชัดขนาด 1024 × 768 พิกเซล (หรือขนาดที่คุณตั้ง) เปิดด้วยโปรแกรมดูภาพใดก็ได้ คุณจะเห็นเนื้อหา Word แสดงผลเหมือนต้นฉบับ, แต่เป็นภาพบิตแมป + +--- + +## เคล็ดลับขั้นสูง & ตัวแปรต่าง ๆ + +### 1. รักษาพื้นหลังโปร่งใส + +หากเอกสาร Word ของคุณมีรูปร่างที่มีพื้นหลังโปร่งใสและต้องการคงไว้, ให้ตั้งค่า `BackgroundColor` เป็น `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. เรนเดอร์เฉพาะช่วงที่ต้องการ + +บางครั้งคุณต้องการเพียงย่อหน้าหรือ ตารางเดียว, ไม่ใช่ทั้งหน้า. ใช้ `DocumentVisitor` เพื่อดึงโหนดและเรนเดอร์แยกต่างหาก. นี่เป็นกรณีขั้นสูง, แต่แสดง **วิธีเรนเดอร์ word** ในระดับละเอียด + +### 3. ปรับ DPI แบบไดนามิก + +หากต้องการ DPI แตกต่างกันต่อหน้า (เช่น ความละเอียดสูงสำหรับหน้าปก), ให้ปรับ `Resolution` ภายในลูป: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. การประมวลผลแบบแบตช์ + +เมื่อแปลงเอกสารหลายสิบไฟล์, ให้ห่อขั้นตอนทั้งหมดในเมธอดเดียวและใช้ตัวแปร `ImageRenderingOptions` เดียวกันซ้ำ. การใช้ตัวเลือกเดียวกันหลายครั้งช่วยลดการจัดสรรหน่วยความจำ + +--- + +## ข้อผิดพลาดทั่วไป & วิธีหลีกเลี่ยง + +| อาการ | สาเหตุที่เป็นไปได้ | วิธีแก้ | +|-------|-------------------|--------| +| PNG เบลอแม้ DPI สูง | `UseAntialiasing` ตั้งเป็น `false` | ตั้ง `UseAntialiasing = true` | +| ขนาดผลลัพธ์ไม่ตรงกับ `Width`/`Height` | ไม่ได้คำนึงถึง DPI | คูณขนาดที่ต้องการด้วย `Resolution / 96` หรือปรับ `Resolution` | +| เกิด Out‑of‑memory ขณะแปลงเอกสารใหญ่ | เรนเดอร์ทั้งเอกสารที่ 300 DPI | เรนเดอร์ทีละหน้า, ทำลายอ็อบเจ็กต์ภาพหลังบันทึก | +| PNG มีพื้นหลังสีขาวแม้ต้องการโปร่งใส | `BackgroundColor` ไม่ได้ตั้ง | ตั้ง `imageOptions.BackgroundColor = Color.Transparent` | + +--- + +## ตัวอย่างทำงานเต็มรูปแบบ + +ด้านล่างเป็นโปรแกรมคอนโซลที่คุณสามารถคัดลอกไปวางได้เลย แสดงการ **แปลง word เป็น png**, **บันทึก docx เป็น png**, และแน่นอน **ตั้งความกว้างและความสูงของภาพ** + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**วิธีรัน:** คอมไพล์โปรเจกต์, วางไฟล์ `input.docx` ที่ตำแหน่งที่กำหนด, แล้วรัน. คุณจะได้ไฟล์ `output.png` ขนาด **1024 × 768** พิกเซล, เรนเดอร์ด้วยขอบที่เรียบเนียน + +## บทเรียนที่เกี่ยวข้อง + +- [วิธีเปิดใช้งานแอนติอาลีซิ่งเมื่อแปลง DOCX เป็น PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [แปลง docx เป็น png – สร้างไฟล์ zip ด้วย C# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [วิธีใช้ Aspose เรนเดอร์ HTML เป็น PNG – คู่มือขั้นตอน](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/thai/net/html-extensions-and-conversions/_index.md b/html/thai/net/html-extensions-and-conversions/_index.md index 2474ca32c..2562785ee 100644 --- a/html/thai/net/html-extensions-and-conversions/_index.md +++ b/html/thai/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,10 @@ Aspose.HTML สำหรับ .NET ไม่ใช่แค่ไลบรา ## บทช่วยสอนเกี่ยวกับส่วนขยายและการแปลง HTML ### [แปลง HTML เป็น PDF ใน .NET ด้วย Aspose.HTML](./convert-html-to-pdf/) แปลง HTML เป็น PDF ได้อย่างง่ายดายด้วย Aspose.HTML สำหรับ .NET ปฏิบัติตามคำแนะนำทีละขั้นตอนของเราและปลดปล่อยพลังแห่งการแปลง HTML เป็น PDF +### [แปลง HTML เป็น PDF ด้วย C# – คู่มือเต็ม](./convert-html-to-pdf-with-c-complete-guide/) +เรียนรู้วิธีแปลง HTML เป็น PDF ด้วย C# อย่างละเอียดตามขั้นตอนครบถ้วนในคู่มือเต็มของเรา +### [เรนเดอร์ HTML เป็น PDF ใน C# – คู่มือเต็มขั้นตอน](./render-html-as-pdf-in-c-full-step-by-step-guide/) +เรียนรู้วิธีเรนเดอร์ HTML เป็น PDF ด้วย C# อย่างละเอียดตามขั้นตอนครบถ้วนในคู่มือของเรา ### [แปลง EPUB เป็นรูปภาพใน .NET ด้วย Aspose.HTML](./convert-epub-to-image/) เรียนรู้วิธีการแปลง EPUB เป็นรูปภาพโดยใช้ Aspose.HTML สำหรับ .NET บทช่วยสอนแบบทีละขั้นตอนพร้อมตัวอย่างโค้ดและตัวเลือกที่ปรับแต่งได้ ### [แปลง EPUB เป็น PDF ใน .NET ด้วย Aspose.HTML](./convert-epub-to-pdf/) @@ -73,6 +77,8 @@ Aspose.HTML สำหรับ .NET ไม่ใช่แค่ไลบรา บันทึกไฟล์ HTML เป็น ZIP อย่างครบถ้วนด้วย C# ตามขั้นตอนของเรา ### [บันทึก HTML เป็น ZIP ใน C# – ตัวอย่างทำงานในหน่วยความจำเต็มรูปแบบ](./save-html-to-zip-in-c-complete-in-memory-example/) บันทึกไฟล์ HTML เป็นไฟล์ ZIP โดยใช้ C# ด้วยตัวอย่างทำงานในหน่วยความจำเต็มรูปแบบ +### [บันทึก HTML เป็น ZIP – คู่มือเต็มสำหรับ Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +เรียนรู้วิธีบันทึกไฟล์ HTML เป็น ZIP อย่างครบถ้วนด้วย Aspose.HTML สำหรับ .NET ตามขั้นตอนที่ชัดเจน ## บทสรุป diff --git a/html/thai/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/thai/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..85e41d762 --- /dev/null +++ b/html/thai/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,259 @@ +--- +category: general +date: 2026-05-22 +description: แปลง HTML เป็น PDF ใน C# ด้วย Aspose.HTML. เรียนรู้วิธีเรนเดอร์ HTML + เป็น PDF ใน C# พร้อมโค้ดขั้นตอนต่อขั้นตอน ตัวเลือก และเคล็ดลับสำหรับ Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: th +og_description: แปลง HTML เป็น PDF ใน C# ด้วย Aspose.HTML คู่มือนี้แสดงวิธีเรนเดอร์ + HTML เป็น PDF ใน C# โดยใช้ตัวเลือกที่ชัดเจนและการให้คำแนะนำที่เป็นมิตรกับ Linux +og_title: แปลง HTML เป็น PDF ด้วย C# – คู่มือฉบับสมบูรณ์ +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: แปลง HTML เป็น PDF ด้วย C# – คู่มือฉบับสมบูรณ์ +url: /th/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# แปลง HTML เป็น PDF ด้วย C# – คู่มือครบถ้วน + +หากคุณต้องการ **แปลง HTML เป็น PDF** อย่างรวดเร็ว Aspose.HTML สำหรับ .NET ทำให้เป็นเรื่องง่าย ในบทแนะนำนี้เราจะตอบ **วิธีแสดงผล HTML เป็น PDF ใน C#** พร้อมการควบคุมตัวเลือกการเรนเดอร์อย่างเต็มที่ เพื่อให้คุณไม่ต้องเดา + +ลองนึกว่าคุณมีเทมเพลตอีเมลการตลาด หน้าใบเสร็จ หรือรายงานซับซ้อนที่สร้างด้วย CSS สมัยใหม่ และคุณต้องส่งออกเป็น PDF ให้ลูกค้าหรือเครื่องพิมพ์ การทำเช่นนั้นด้วยมือเป็นเรื่องยุ่งยาก แต่เพียงไม่กี่บรรทัดของโค้ด C# ก็สามารถอัตโนมัติขั้นตอนทั้งหมดได้ ภายในตอนท้ายของคู่มือนี้คุณจะได้โซลูชันที่ทำงานได้อย่างอิสระและพร้อมใช้งานในสภาพแวดล้อม Windows *และ* Linux + +## สิ่งที่คุณต้องมี + +ก่อนที่เราจะลงลึก โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้แล้ว: + +- **.NET 6.0 หรือใหม่กว่า** – Aspose.HTML รองรับ .NET Standard 2.0+ ดังนั้น SDK ใดก็ได้ที่อัปเดตก็ใช้ได้ +- **แพ็กเกจ NuGet Aspose.HTML for .NET** (`Aspose.Html`) – คุณจะต้องมีลิขสิทธิ์ที่ถูกต้องสำหรับการใช้งานจริง แต่รุ่นทดลองฟรีก็เพียงพอสำหรับการทดสอบ +- **ไฟล์ HTML ง่าย ๆ** ที่คุณต้องการแปลงเป็น PDF (เราจะเรียกมันว่า `input.html`) +- IDE ที่คุณชื่นชอบ (Visual Studio, Rider หรือ VS Code) – ไม่ต้องการเครื่องมือพิเศษใด ๆ + +แค่นั้นเอง ไม่ต้องใช้ตัวแปลง PDF ภายนอก ไม่ต้องทำการตั้งค่า command‑line ซับซ้อน เพียงแค่ C# ธรรมดา + +![ไดอะแกรมแสดงกระบวนการแปลง html เป็น pdf ด้วย Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## แปลง HTML เป็น PDF – การทำงานเต็มรูปแบบ + +ด้านล่างเป็นโปรแกรมที่พร้อมรัน คัดลอก‑วางลงในแอปคอนโซลใหม่, ทำการกู้คืนแพ็กเกจ NuGet, แล้วกด **F5** + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### ทำไมวิธีนี้ถึงได้ผล + +- **`Document`** เป็นจุดเริ่มต้นของ Aspose.HTML; มันจะทำการพาร์ส HTML, แก้ไข CSS, และสร้าง DOM ที่พร้อมสำหรับการเรนเดอร์ +- **`PdfRenderingOptions`** ให้คุณปรับแต่งผลลัพธ์ ตัวเลือก `UseHinting` คือเคล็ดลับสำคัญสำหรับข้อความคมชัดในคอนเทนเนอร์ Linux แบบ headless ที่ rasterizer เริ่มต้นอาจดูเบลอ +- **`Save`** ทำหน้าที่หลัก: แปลง DOM ไปเป็นหน้า PDF, เคารพการแบ่งหน้า, และฝังฟอนต์โดยอัตโนมัติ + +เมื่อรันโปรแกรมจะสร้างไฟล์ `output.pdf` อยู่ข้างไฟล์ซอร์สของคุณ เปิดด้วยโปรแกรมดู PDF ใดก็ได้ คุณควรเห็นผลลัพธ์ที่ตรงกับ HTML ดั้งเดิมอย่างสมบูรณ์ + +## วิธีแสดงผล HTML เป็น PDF ใน C# – ขั้นตอน‑โดย‑ขั้นตอน + +ต่อไปเราจะแบ่งกระบวนการเป็นส่วนย่อย ๆ พร้อมอธิบาย **วิธีแสดงผล HTML เป็น PDF ใน C#** และชี้ให้เห็นกับดักทั่วไป + +### ขั้นตอนที่ 1 – ติดตั้งแพ็กเกจ NuGet Aspose.HTML + +เปิดเทอร์มินัลในโฟลเดอร์โปรเจกต์และรันคำสั่ง: + +```bash +dotnet add package Aspose.Html +``` + +หากคุณชอบใช้ UI ของ Visual Studio ให้คลิกขวาที่โปรเจกต์ → **Manage NuGet Packages** → ค้นหา **Aspose.Html** แล้วติดตั้งเวอร์ชันล่าสุดที่เสถียร + +> **เคล็ดลับมือโปร:** หลังจากติดตั้งแล้ว ให้เพิ่มไฟล์ลิขสิทธิ์ (`Aspose.Total.lic`) ไปที่โฟลเดอร์รากของโปรเจกต์ เพื่อหลีกเลี่ยงลายน้ำการประเมินผล + +### ขั้นตอนที่ 2 – โหลด HTML ของคุณอย่างถูกต้อง + +Aspose.HTML สามารถรับข้อมูลจาก: + +- เส้นทางไฟล์ในเครื่อง (`new Document("file.html")`) +- URL (`new Document("https://example.com")`) +- สตริง HTML ดิบ (`new Document("…", new HtmlLoadOptions())`) + +เมื่อโหลดจากระบบไฟล์ โปรดตรวจสอบให้เส้นทางเป็นแบบ absolute หรือกำหนด working directory ให้ถูกต้อง มิฉะนั้นจะเกิด `FileNotFoundException` บน Linux ให้ใช้เครื่องหมายทับ (`/`) หรือ `Path.Combine` + +### ขั้นตอนที่ 3 – เลือกตัวเลือกการเรนเดอร์ที่เหมาะสม + +นอกจาก `UseHinting` แล้ว คุณอาจต้องปรับ: + +| ตัวเลือก | ทำหน้าที่อะไร | ควรใช้เมื่อไร | +|----------|----------------|----------------| +| `PageSize` | กำหนดขนาดหน้ากระดาษ PDF (A4, Letter, กำหนดเอง) | ต้องการให้ตรงกับขนาดกระดาษเป้าหมาย | +| `Landscape` | หมุนหน้าเป็นแนวนอน | ตารางหรือแผนภูมิที่กว้าง | +| `RasterizeVectorGraphics` | บังคับให้กราฟิกเวกเตอร์แปลงเป็นภาพ raster | เมื่อผู้รับ PDF ไม่รองรับ SVG | +| `CompressionLevel` | ควบคุมการบีบอัดภาพ (0‑9) | ลดขนาดไฟล์สำหรับแนบอีเมล | + +คุณสามารถเชื่อมต่อคุณสมบัติเหล่านี้แบบ fluent ได้ดังนี้: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### ขั้นตอนที่ 4 – บันทึกเป็น PDF + +เมธอด `Save` ที่แสดงในตัวอย่างเต็มจะบันทึกโดยตรงไปยังเส้นทางไฟล์ คุณยังสามารถสตรีม PDF ไปยังหน่วยความจำได้เช่นกัน: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +วิธีนี้มีประโยชน์เมื่อคุณต้องการส่ง PDF กลับเป็นการดาวน์โหลดจาก Web API + +### ขั้นตอนที่ 5 – ตรวจสอบผลลัพธ์ + +การตรวจสอบอย่างง่ายคือการเปรียบเทียบจำนวนหน้าของ PDF กับจำนวนส่วนของ HTML ที่คาดไว้ คุณสามารถอ่านกลับด้วย Aspose.PDF ได้ดังนี้: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +หากจำนวนไม่ตรง ให้ตรวจสอบกฎ `page-break` ใน CSS หรือปรับ `PdfRenderingOptions` ให้เหมาะสม + +## กรณีขอบและข้อผิดพลาดที่พบบ่อย + +| สถานการณ์ | สิ่งที่ต้องระวัง | วิธีแก้ | +|-----------|-------------------|----------| +| **ทรัพยากรภายนอก (รูปภาพ, ฟอนต์) หาย** | URL แบบ relative จะอ้างอิงจากโฟลเดอร์ของไฟล์ HTML | ใช้ `HtmlLoadOptions.BaseUri` ชี้ไปยังโฟลเดอร์รากที่ถูกต้อง | +| **สภาพแวดล้อม Linux แบบ headless** | การเรนเดอร์ข้อความเริ่มต้นอาจเบลอ | ตั้งค่า `UseHinting = true` (ตามตัวอย่าง) และติดตั้ง `libgdiplus` หากต้องพึ่งพา System.Drawing | +| **HTML ขนาดใหญ่ (> 10 MB)** | การใช้หน่วยความจำพุ่งสูงระหว่างการเรนเดอร์ | เรนเดอร์หน้า‑ต่อหน้าโดยใช้ `PdfRenderer` กับ `PdfRenderingOptions` แล้วทำการ dispose หน้าแต่ละหน้าเมื่อเสร็จ | +| **หน้าเว็บที่ใช้ JavaScript มาก** | Aspose.HTML ไม่ทำการรัน JS; เนื้อหาแบบไดนามิกจะคงเป็นสถิต | ทำการพรี‑โปรเซส HTML ฝั่งเซิร์ฟเวอร์ (เช่น ใช้ Puppeteer) ก่อนส่งให้ Aspose.HTML | +| **อักขระ Unicode แสดงเป็นสี่เหลี่ยม** | ฟอนต์ที่จำเป็นไม่มีในสภาพแวดล้อมรันไทม์ | ฝังฟอนต์แบบกำหนดเองผ่าน `FontSettings` หรือให้ระบบปฏิบัติการติดตั้งฟอนต์ที่ต้องการ | + +## สรุปตัวอย่างทำงานเต็มรูปแบบ + +นี่คือโปรแกรมทั้งหมดอีกครั้ง โดยลบคอมเมนต์ออกเพื่อให้ดูกระชับสำหรับผู้ที่ต้องการโค้ดสั้น ๆ: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +รันโปรแกรม, เปิด `output.pdf` แล้วคุณจะเห็นสำเนาที่พิกเซล‑เพอร์เฟ็กต์ของ `input.html` นั่นคือสาระสำคัญของ **การแปลง html เป็น pdf** ด้วย Aspose.HTML + +## สรุป + +เราได้อธิบายทุกขั้นตอนที่คุณต้องทำเพื่อ **แปลง HTML เป็น PDF** ด้วย C#: การติดตั้ง Aspose.HTML, การโหลด HTML, การปรับตัวเลือกการเรนเดอร์ (รวมถึง `UseHinting` ที่สำคัญ) และการบันทึก PDF สุดท้าย คุณเข้าใจ **วิธีแสดงผล HTML เป็น PDF ใน C#** สำหรับสภาพแวดล้อม Windows และ Linux แล้ว และได้เห็นวิธีจัดการกับกรณีขอบต่าง ๆ เช่น ทรัพยากรหายหรือไฟล์ขนาดใหญ่ + +ต่อไปคุณอาจลองเพิ่ม: + +- **หัวกระดาษ/ท้ายกระดาษ** ด้วย `PdfPageTemplate` เพื่อสร้างแบรนด์ +- **การป้องกันด้วยรหัสผ่าน** ผ่าน `PdfSaveOptions` +- **การแปลงเป็นชุด** โดยวนลูปผ่านโฟลเดอร์ของไฟล์ + +## บทแนะนำที่เกี่ยวข้อง + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Convert EPUB to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Convert SVG to PDF in .NET with Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/thai/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/thai/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..cecceeabe --- /dev/null +++ b/html/thai/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,308 @@ +--- +category: general +date: 2026-05-22 +description: เรนเดอร์ HTML เป็น PDF ด้วย C# พร้อมตัวอย่างสั้น ๆ เรียนรู้วิธีแปลง HTML + เป็น PDF ด้วย C# อย่างรวดเร็วและเชื่อถือได้. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: th +og_description: เรนเดอร์ HTML เป็น PDF ใน C# พร้อมตัวอย่างที่ชัดเจนและสามารถรันได้ + คู่มือนี้จะแสดงวิธีแปลง HTML เป็น PDF ด้วย C# และสร้าง PDF จากไฟล์ HTML +og_title: เรนเดอร์ HTML เป็น PDF ใน C# – คู่มือการเขียนโปรแกรมเต็มรูปแบบ +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: แปลง HTML เป็น PDF ใน C# – คู่มือเต็มขั้นตอนโดยละเอียด +url: /th/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# แปลง HTML เป็น PDF ใน C# – คู่มือเต็มขั้นตอน + +เคยต้องการ **render HTML as PDF** แต่ไม่แน่ใจว่าจะเลือกไลบรารีใดสำหรับโครงการ .NET หรือไม่? คุณไม่ได้อยู่คนเดียว ในแอปพลิเคชันเชิงธุรกิจหลาย ๆ ตัวคุณอาจต้อง **convert HTML to PDF C#** สำหรับใบแจ้งหนี้ รายงาน หรือโบรชัวร์การตลาด — โดยทั่วไปเมื่อใดก็ตามที่คุณต้องการเวอร์ชันที่พิมพ์ได้ของหน้าเว็บ + +เรื่องคือคุณไม่จำเป็นต้องสร้างล้อใหม่ ด้วยไม่กี่บรรทัดของโค้ดคุณสามารถนำไฟล์ `input.html` ไปให้กับเอนจินการเรนเดอร์ที่เชื่อถือได้และได้ไฟล์ `output.pdf` ที่คมชัด ในบทแนะนำนี้เราจะพาคุณผ่านกระบวนการทั้งหมด ตั้งแต่การเพิ่มแพ็กเกจ NuGet ที่เหมาะจนถึงการจัดการกรณีขอบเช่น CSS ภายนอก เมื่อเสร็จคุณจะสามารถ **generate PDF from HTML file** ได้ภายในไม่กี่นาที + +## สิ่งที่คุณจะได้เรียนรู้ + +- วิธีตั้งค่าแอปคอนโซล .NET ที่ **creates PDF from HTML C#** +- การเรียกใช้ API ที่จำเป็นเพื่อ **save HTML document as PDF** +- เหตุผลที่ตัวเลือกการเรนเดอร์บางอย่าง (เช่น hinting) มีผลต่อคุณภาพของข้อความ +- เคล็ดลับการแก้ไขปัญหาที่พบบ่อย เช่น ฟอนต์หายหรือเส้นทางรูปภาพแบบ relative + +**Prerequisites** – คุณควรมี .NET 6+ หรือ .NET Framework 4.7 ติดตั้งอยู่, มีความคุ้นเคยพื้นฐานกับ C# และ IDE (Visual Studio 2022, Rider หรือ VS Code). ไม่จำเป็นต้องมีประสบการณ์กับ PDF มาก่อน. + +--- + +## แปลง HTML เป็น PDF – การตั้งค่าโปรเจกต์ + +ก่อนที่เราจะลงลึกในโค้ด ให้แน่ใจก่อนว่าสภาพแวดล้อมการพัฒนาพร้อมใช้งาน ไลบรารีที่เราจะใช้คือ **Select.Pdf** (ฟรีสำหรับการใช้งานที่ไม่ใช่เชิงพาณิชย์) เนื่องจากมี API ที่ง่ายและความแม่นยำในการเรนเดอร์ที่ดี + +### ติดตั้งไลบรารีการเรนเดอร์ PDF (convert html to pdf c#) + +เปิดเทอร์มินัลในโฟลเดอร์โปรเจกต์ของคุณและรัน: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* หากคุณใช้ Visual Studio คุณสามารถเพิ่มแพ็กเกจผ่าน UI ของ NuGet Package Manager ได้เช่นกัน หมายเลขเวอร์ชันอาจใหม่กว่า — เพียงแค่ดึงเวอร์ชันเสถียรล่าสุด + +### สร้างโครงสร้างคอนโซล + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +นั่นคือโค้ดพื้นฐานทั้งหมดที่คุณต้องการ การทำงานหนักเกิดขึ้นภายใน `Main`. + +--- + +## โหลดเอกสาร HTML (generate pdf from html file) + +ขั้นตอนแรกที่แท้จริงคือการชี้ตัวเรนเดอร์ไปที่ไฟล์ HTML บนดิสก์ Select.Pdf มีสองวิธีที่สะดวก: ส่งสตริง HTML ดิบหรือเส้นทางไฟล์ การใช้ไฟล์ทำให้เป็นระเบียบโดยเฉพาะเมื่อคุณมี CSS หรือรูปภาพที่เชื่อมโยง + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +ที่นี่เรายังตรวจสอบกรณีไฟล์หาย — สิ่งที่ทำให้ผู้เริ่มต้นสับสนเมื่อพวกเขาลืมคัดลอกไฟล์ HTML ไปยังโฟลเดอร์ผลลัพธ์ + +--- + +## ตั้งค่าตัวเลือกการเรนเดอร์ (create pdf from html c#) + +Select.Pdf มาพร้อมกับอ็อบเจ็กต์ `PdfDocumentOptions` ที่ครบถ้วน สำหรับข้อความที่คมชัดเราจะเปิดใช้งาน hinting ซึ่งทำให้ glyphs เรียบเนียนโดยมีผลกระทบต่อประสิทธิภาพเพียงเล็กน้อย + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +คุณสามารถปรับขนาดหน้า, ระยะขอบ, หรือแม้แต่ฝังฟอนต์ที่กำหนดเองได้ที่นี่ สิ่งสำคัญคือ **render html as pdf** ไม่ใช่แค่บรรทัดเดียว; คุณมีการควบคุมลักษณะและความรู้สึกของเอกสารสุดท้าย + +--- + +## บันทึกเอกสาร HTML เป็น PDF (render html as pdf) + +ตอนนี้จุดมหัศจรรย์เกิดขึ้น เราให้คอนเวอร์เตอร์เส้นทางไปยังไฟล์ HTML ของเราและสั่งให้เขียน PDF ลงดิสก์ + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +เมธอด `ConvertUrl` จะทำการแก้ไข URL แบบ relative (รูปภาพ, CSS) อัตโนมัติตามตำแหน่งของไฟล์ HTML ซึ่งทำให้วิธีนี้ทนทานต่อสถานการณ์จริงส่วนใหญ่ + +### ผลลัพธ์ที่คาดหวัง + +หลังจากรันโปรแกรมคุณควรเห็นไฟล์ `output.pdf` ในโฟลเดอร์เดียวกัน เปิดไฟล์นั้น — คุณจะสังเกตว่า: + +- ข้อความแสดงผลด้วยการ anti‑aliasing ชัดเจน (ขอบคุณ hinting). +- สไตล์จาก CSS ที่เชื่อมโยงถูกนำไปใช้อย่างถูกต้อง. +- รูปภาพแสดงผลที่ขนาดที่กำหนดใน HTML ต้นฉบับอย่างแม่นยำ. + +หากมีสิ่งใดดูผิดพลาด ให้ตรวจสอบอีกครั้งว่าไฟล์ CSS และรูปภาพอยู่เคียงข้าง `input.html` หรือใช้ URL แบบ absolute + +--- + +## การจัดการกรณีขอบที่พบบ่อย + +### 1. แหล่งทรัพยากรภายนอกถูกบล็อกโดยไฟร์วอลล์ + +หาก HTML ของคุณอ้างอิงฟอนต์ที่โฮสต์บน CDN ที่เซิร์ฟเวอร์ของคุณไม่สามารถเข้าถึงได้ PDF อาจใช้ฟอนต์ทั่วไปแทน เพื่อหลีกเลี่ยงนี้ ให้ดาวน์โหลดไฟล์ฟอนต์ลงเครื่องหรือฝังฟอนต์ด้วย `@font-face` พร้อมเส้นทาง relative + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. ไฟล์ HTML ขนาดใหญ่มาก + +เมื่อแปลงเอกสารขนาดใหญ่ คุณอาจเจอข้อจำกัดของหน่วยความจำ Select.Pdf ให้คุณสตรีมการแปลงได้: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +การสตรีมทำให้กระบวนการเบาแต่ต้องให้ HTML เป็นสตริง ซึ่งคุณสามารถอ่านเป็นชิ้นส่วนได้หากต้องการ + +### 3. ส่วนหัวหรือส่วนท้ายแบบกำหนดเอง + +หากคุณต้องการหมายเลขหน้า หรือโลโก้บริษัทบนทุกหน้า ให้ตั้งค่า `Header` และ `Footer` บน `converter.Options` ก่อนเรียก `ConvertUrl` + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +--- + +## ตัวอย่างทำงานเต็มรูปแบบ (รวมทุกขั้นตอน) + +ด้านล่างเป็นโปรแกรมที่พร้อมคัดลอก‑วางครบถ้วน แทนที่ `YOUR_DIRECTORY` ด้วยเส้นทางเต็มที่ไฟล์ HTML ของคุณอยู่ + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** `dotnet run` จากไดเรกทอรีโปรเจกต์ หากทุกอย่างตั้งค่าอย่างถูกต้องคุณจะเห็นข้อความสำเร็จและไฟล์ `output.pdf` ที่สวยงาม + +--- + +## สรุปภาพรวม + +![ตัวอย่างการแปลง HTML เป็น PDF](render-html-as-pdf.png){alt="ตัวอย่างการแปลง HTML เป็น PDF"} + +ภาพหน้าจอแสดงผลลัพธ์ของคอนโซลและ PDF ที่ได้เปิดในโปรแกรมดู PDF ให้สังเกตหัวข้อที่คมชัดและรูปภาพที่โหลดอย่างถูกต้อง — สิ่งที่คุณคาดหวังเมื่อ **render html as pdf** + +--- + +## สรุป + +คุณเพิ่งเรียนรู้วิธี **render HTML as PDF** ในแอปพลิเคชัน C# ตั้งแต่การติดตั้งไลบรารีจนถึงการปรับแต่งตัวเลือกการเรนเดอร์ ตัวอย่างเต็มแสดงวิธีที่เชื่อถือได้ในการ **convert HTML to PDF C#**, **generate PDF from HTML file**, และ **save HTML document as PDF** ด้วยไม่กี่บรรทัด + +ต่อไปคุณจะทำอะไร? ลองทดลองกับ: + +- เพิ่มฟอนต์กำหนดเองเพื่อความสอดคล้องของแบรนด์. +- สร้าง PDF จากสตริง HTML แบบไดนามิก (เช่น Razor templates). +- รวม PDF หลายไฟล์เป็นรายงานเดียวโดยใช้ `PdfDocument.AddPage`. + +แต่ละส่วนขยายเหล่านี้ต่อยอดจากแนวคิดหลักที่อธิบายไว้ที่นี่ ทำให้คุณพร้อมรับมือกับสถานการณ์ที่ซับซ้อนมากขึ้นโดยไม่ต้องเรียนรู้อย่างยากเย็น + +มีคำถามหรือเจอปัญหา? แสดงความคิดเห็นด้านล่างและมาช่วยกันแก้ไขกันเถอะ. โค้ดดิ้งให้สนุก! + +## บทแนะนำที่เกี่ยวข้อง + +- [แปลง HTML เป็น PDF ใน .NET ด้วย Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [สร้างเอกสาร HTML พร้อมข้อความสไตล์และส่งออกเป็น PDF – คู่มือเต็ม](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [แปลง HTML เป็น PDF ด้วย Aspose.HTML – คู่มือการจัดการเต็ม](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/thai/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/thai/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..fee71fcba --- /dev/null +++ b/html/thai/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,223 @@ +--- +category: general +date: 2026-05-22 +description: บันทึก HTML เป็น ZIP อย่างรวดเร็วด้วย Aspose.HTML เรียนรู้วิธีการบีบอัดไฟล์ + HTML, แปลง HTML เป็น ZIP, และส่งออก HTML ไปเป็นไฟล์ ZIP พร้อมโค้ดเต็ม. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: th +og_description: บันทึก HTML เป็น ZIP ด้วย Aspose.HTML คู่มือนี้แสดงวิธีการแปลง HTML + เป็น ZIP, ส่งออก HTML ไปยังไฟล์ ZIP, และบีบอัดไฟล์ HTML ด้วยโปรแกรม. +og_title: บันทึก HTML เป็น ZIP – คู่มือ Aspose.HTML ฉบับสมบูรณ์ +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: บันทึก HTML เป็น ZIP – คู่มือฉบับสมบูรณ์สำหรับ Aspose.HTML +url: /th/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# บันทึก HTML เป็น ZIP – คู่มือฉบับสมบูรณ์สำหรับ Aspose.HTML + +เคยสงสัยไหมว่า **บันทึก HTML เป็น ZIP** อย่างไรโดยไม่ต้องใช้เครื่องมือบีบอัดแยกต่างหาก? คุณไม่ได้เป็นคนเดียวที่มีคำถามนี้ นักพัฒนาจำนวนมากต้องการรวมหน้า HTML กับรูปภาพ, CSS, และสคริปต์เพื่อการแจกจ่ายที่ง่าย และการทำแบบนี้ด้วยตนเองมักกลายเป็นจุดบอดเร็ว ๆ นี้ + +ในบทเรียนนี้เราจะพาคุณผ่านโซลูชันแบบครบวงจรที่ **เรนเดอร์ HTML เป็น ZIP** ด้วย Aspose.HTML for .NET. เมื่อจบคุณจะรู้วิธี **ส่งออก HTML ไปเป็นไฟล์ ZIP** อย่างแม่นยำ และคุณยังจะได้เห็นวิธีต่าง ๆ สำหรับ **การบีบอัดไฟล์ HTML** ในสถานการณ์ที่แตกต่างกัน + +> *เคล็ดลับ:* วิธีที่แสดงนี้ทำงานได้ไม่ว่าจะเป็นการบรรจุหน้าเดียวหรือโฟลเดอร์เว็บไซต์ทั้งหมด + +## สิ่งที่คุณต้องเตรียม + +- .NET 6 (หรือ .NET runtime เวอร์ชันล่าสุดใดก็ได้) ที่ติดตั้งแล้ว +- แพคเกจ NuGet Aspose.HTML for .NET (`Aspose.Html`) ที่อ้างอิงในโปรเจกต์ของคุณ +- ไฟล์ `input.html` แบบง่ายที่วางไว้ในโฟลเดอร์ที่คุณควบคุม +- ความคุ้นเคยกับ C# เล็กน้อย—ไม่ต้องซับซ้อน เพียงพื้นฐาน + +เท่านี้เอง ไม่ต้องใช้เครื่องมือบีบอัดภายนอก ไม่ต้องทำคอมมานด์ไลน์ซับซ้อน มาเริ่มกันเลย + +![แผนภาพแสดงกระบวนการบันทึก HTML เป็น ZIP ด้วย Aspose.HTML](save-html-as-zip.png) + +*ข้อความแทนภาพ: แผนภาพกระบวนการบันทึก html เป็น zip* + +## ขั้นตอนที่ 1: โหลดเอกสาร HTML ต้นฉบับ + +สิ่งแรกที่เราต้องทำคือบอก Aspose.HTML ว่าแหล่งที่มาของเราอยู่ที่ไหน คลาส `HTMLDocument` จะอ่านไฟล์และสร้าง DOM ในหน่วยความจำพร้อมสำหรับการเรนเดอร์ + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +ทำไมเรื่องนี้ถึงสำคัญ: การโหลดเอกสารทำให้ไลบรารีมีการควบคุมเต็มที่ต่อการแก้ไขทรัพยากร (รูปภาพ, CSS, ฟอนต์) หาก HTML อ้างอิงเส้นทางแบบ relative, Aspose.HTML จะทำการ resolve อัตโนมัติตามโฟลเดอร์ของไฟล์นั้น + +## ขั้นตอนที่ 2: (ทางเลือก) สร้าง Custom Resource Handler + +หากคุณต้องการตรวจสอบหรือจัดการแต่ละทรัพยากร—เช่นต้องการบีบอัดรูปภาพก่อนใส่ลงใน archive—คุณสามารถเชื่อมต่อ `ResourceHandler` ได้ ขั้นตอนนี้เป็นทางเลือก แต่เป็นวิธีที่ยืดหยุ่นที่สุดในการ **แปลง HTML เป็น ZIP archive** ด้วยตรรกะที่กำหนดเอง + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*ถ้าคุณไม่ต้องการการประมวลผลพิเศษใด ๆ* เพียงข้ามคลาสนี้และใช้ handler เริ่มต้น—Aspose.HTML จะเขียนทรัพยากรลง ZIP โดยตรง + +## ขั้นตอนที่ 3: กำหนดค่า Save Options ให้ใช้ Handler + +อ็อบเจ็กต์ `HtmlSaveOptions` บอก renderer ว่าจะทำอะไรกับทรัพยากรต่าง ๆ โดยการกำหนด `MyResourceHandler` เราจะได้การควบคุมเต็มที่ต่อผลลัพธ์ + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +สังเกตว่าชื่อ property `ResourceHandler` อ้างอิงโดยตรงกับความสามารถ **เรนเดอร์ HTML เป็น ZIP** นี่คือจุดที่เวทมนตร์เกิดขึ้น: ทุกทรัพยากรที่เชื่อมโยงจะถูกสตรีมเข้า archive แทนการเขียนลงดิสก์ + +## ขั้นตอนที่ 4: บันทึกเอกสารที่เรนเดอร์แล้วลงใน ZIP Archive + +ตอนนี้เราจะ **ส่งออก HTML ไปเป็นไฟล์ ZIP** อย่างเป็นทางการ เมธอด `Save` รองรับ `Stream` ใด ๆ เราจึงสามารถชี้ไปที่ `FileStream` ที่สร้าง `result.zip` + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +นี่คือขั้นตอนทั้งหมด เมื่อโค้ดทำงานเสร็จ `result.zip` จะประกอบด้วย: + +- `input.html` (โค้ด HTML ดั้งเดิม) +- รูปภาพ, ไฟล์ CSS, และฟอนต์ที่อ้างอิงทั้งหมด +- ทรัพยากรที่ผ่านการแปลงใด ๆ หากคุณปรับแต่งใน `MyResourceHandler` + +## วิธีบีบอัดไฟล์ HTML เป็น ZIP โดยไม่ใช้ Aspose.HTML (ทางเลือกอย่างรวดเร็ว) + +บางครั้งคุณอาจต้องการวิธี **วิธีบีบอัดไฟล์ HTML** แบบดั้งเดิม เนื่องจากคุณอาจใช้ parser HTML ตัวอื่นอยู่ ในกรณีนั้นคุณสามารถใช้ `System.IO.Compression` ที่มาพร้อมกับ .NET: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +วิธีนี้ง่ายแต่ไม่มีขั้นตอนการเรนเดอร์; มันเพียงแค่บรรจุไฟล์ที่อยู่บนดิสก์เท่านั้น หาก HTML ของคุณอ้างอิง URL ภายนอก, ทรัพยากรเหล่านั้นจะไม่ถูกรวม นั่นคือเหตุผลที่เส้นทาง Aspose.HTML เป็นตัวเลือกที่น่าเชื่อถือเมื่อคุณต้องการโซลูชัน **เรนเดอร์ HTML เป็น ZIP** ที่มั่นคง + +## กรณีขอบและข้อผิดพลาดทั่วไป + +| สถานการณ์ | สิ่งที่ควรระวัง | วิธีแก้แนะนำ | +|-----------|-------------------|-----------------| +| **รูปภาพขนาดใหญ่** | การใช้หน่วยความจำพุ่งสูงเนื่องจากแต่ละรูปภาพถูกโหลดเข้าสู่ `MemoryStream`. | สตรีมโดยตรงไปยัง zip ด้วย custom handler ที่คัดลอกสตรีมต้นฉบับแทนการบัฟเฟอร์เต็ม. | +| **URL ภายนอก** | ทรัพยากรที่โฮสต์บนอินเทอร์เน็ตจะไม่ถูกดาวน์โหลดโดยอัตโนมัติ. | ตั้งค่า `HtmlLoadOptions` พร้อม `BaseUrl` ชี้ไปที่รากของเว็บไซต์ หรือดาวน์โหลดทรัพยากรด้วยตนเองก่อนบันทึก. | +| **ชื่อไฟล์ชนกัน** | ไฟล์ CSS สองไฟล์ที่มีชื่อเดียวกันในโฟลเดอร์ย่อยต่างกันอาจเขียนทับกัน. | ตรวจสอบให้ `ResourceHandler` คงเส้นทางสัมพันธ์เต็มเมื่อเขียนลง zip. | +| **ข้อผิดพลาดเรื่องสิทธิ์** | การพยายามเขียนลงโฟลเดอร์ที่เป็นแบบอ่าน‑อย่างเดียวจะทำให้เกิด `UnauthorizedAccessException`. | รันกระบวนการด้วยสิทธิ์ที่เหมาะสมหรือเลือกไดเรกทอรีที่สามารถเขียนได้. | + +การจัดการกับสถานการณ์เหล่านี้ทำให้ขั้นตอน **แปลง HTML เป็น ZIP archive** ของคุณแข็งแรงพอสำหรับการใช้งานในระดับ production + +## ตัวอย่างทำงานเต็มรูปแบบ (รวมทุกส่วนเข้าด้วยกัน) + +ด้านล่างเป็นโปรแกรมที่พร้อมรันทั้งหมด คัดลอกไปวางในแอปคอนโซลใหม่, ปรับเส้นทางตามต้องการ, แล้วกด **F5** + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**ผลลัพธ์ที่คาดหวัง:** คอนโซลจะแสดงข้อความสำเร็จ, และไฟล์ `result.zip` จะมี `input.html` พร้อมทุก asset ที่พึ่งพา เปิด ZIP, ดับเบิล‑คลิก `input.html` แล้วคุณจะเห็นหน้าเว็บแสดงผลเหมือนในเบราว์เซอร์—ไม่มีรูปภาพหาย, ไม่มี CSS ขาด + +## สรุป – ทำไมวิธีนี้ถึงยอดเยี่ยม + +- **การเรนเดอร์ขั้นตอนเดียว:** คุณไม่ต้องคัดลอกแต่ละทรัพยากรด้วยตนเอง; Aspose.HTML ทำให้คุณ +- **pipeline ที่ปรับแต่งได้:** `ResourceHandler` ให้คุณควบคุมเต็มที่ว่าทรัพยากรแต่ละไฟล์จะถูกจัดเก็บอย่างไร สามารถทำการบีบอัด, เข้ารหัส, หรือแปลงแบบเรียลไทม์ +- **ข้ามแพลตฟอร์ม:** ทำงานบน Windows, Linux, และ macOS ตราบใดที่คุณมี .NET runtime +- **ไม่มีเครื่องมือภายนอก:** กระบวนการ **บันทึก HTML เป็น ZIP** ทั้งหมดทำงานภายในโค้ด C# ของคุณ + +## ขั้นตอนต่อไปคืออะไร? + +ตอนนี้คุณได้เชี่ยวชาญ **บันทึก HTML เป็น ZIP** แล้ว ลองสำรวจหัวข้อที่เกี่ยวข้องต่อไปนี้: + +- **ส่งออก HTML เป็น PDF** – เหมาะสำหรับรายงานที่ต้องพิมพ์ (`export html to zip file` ความรู้ช่วยเมื่อคุณต้องการทั้งสองรูปแบบ) +- **สตรีม ZIP ตรงไปยัง HTTP response** – เหมาะสำหรับ API เว็บที่ให้ผู้ใช้ดาวน์โหลดเว็บไซต์ที่บรรจุไว้แบบเรียลไทม์ +- **การเข้ารหัส ZIP archive** – เพิ่มชั้นรหัสผ่านหากคุณจัดการเอกสารที่เป็นความลับ + +อย่ากลัวทดลอง: เปลี่ยน `MyResourceHandler` เป็นคอมเพรสเซอร์ที่ลดขนาดรูปภาพ, หรือเพิ่มไฟล์ manifest ที่ระบุรายการทรัพยากรทั้งหมดที่บรรจุ Sky's the limit เมื่อคุณควบคุม pipeline การเรนเดอร์ + +*Happy coding! หากคุณเจออุปสรรคหรือมีไอเดียปรับปรุง, ฝากคอมเมนต์ด้านล่าง เราจะมาช่วยกันแก้ไข* + +## บทแนะนำที่เกี่ยวข้อง + +- [วิธีบีบอัด HTML ใน C# – บันทึก HTML เป็น Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [บันทึก HTML เป็น ZIP – คอร์ส C# ฉบับสมบูรณ์](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [บันทึก HTML เป็น ZIP ใน C# – ตัวอย่าง In‑Memory ฉบับสมบูรณ์](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/turkish/net/generate-jpg-and-png-images/_index.md b/html/turkish/net/generate-jpg-and-png-images/_index.md index a918363c4..1f47e129b 100644 --- a/html/turkish/net/generate-jpg-and-png-images/_index.md +++ b/html/turkish/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ HTML belgelerini düzenlemek, HTML'yi resimlere dönüştürmek ve daha fazlası DOCX belgelerini PNG veya JPG formatına dönüştürürken antialiasing'i etkinleştirerek daha net ve pürüzsüz görüntüler elde edin. ### [docx'i png'ye dönüştür – zip arşivi oluşturma C# eğitimi](./convert-docx-to-png-create-zip-archive-c-tutorial/) C# kullanarak docx dosyalarını png formatına dönüştürüp, sonuçları zip arşivi içinde paketlemeyi öğrenin. +### [Word'ü PNG'ye Dönüştürürken Görüntü Genişliği ve Yüksekliğini Ayarlama – Tam Kılavuz](./set-image-width-height-when-converting-word-to-png-full-guid/) +Word belgelerini PNG'ye dönüştürürken görüntü boyutlarını nasıl ayarlayacağınızı adım adım öğrenin. ## Çözüm diff --git a/html/turkish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/turkish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..48a46509d --- /dev/null +++ b/html/turkish/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,276 @@ +--- +category: general +date: 2026-05-22 +description: Word belgesini PNG’ye dönüştürürken görüntü genişliğini ve yüksekliğini + ayarlayın. Adım adım bir öğreticide, docx dosyasını yüksek kaliteli render ile resim + olarak dışa aktarmayı öğrenin. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: tr +og_description: Word belgesini PNG’ye dönüştürürken görüntü genişliğini ve yüksekliğini + ayarlayın. Bu öğreticide, docx dosyasını yüksek kalite ayarlarıyla görüntü olarak + nasıl dışa aktaracağınız gösterilmektedir. +og_title: Word'ü PNG'ye Dönüştürürken Görüntü Genişliğini ve Yüksekliğini Ayarlama + – Tam Kılavuz +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Word'ü PNG'ye Dönüştürürken Görüntü Genişliği ve Yüksekliğini Ayarlama – Tam + Rehber +url: /tr/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Word'ü PNG'ye Dönüştürürken Görüntü Genişliği ve Yüksekliğini Ayarlama – Tam Kılavuz + +Hiç **set image width height** özelliğini **convert Word to PNG** yaparken nasıl ayarlayacağınızı merak ettiniz mi? Tek başınıza değilsiniz. Birçok geliştirici, varsayılan dışa aktarma bulanık bir resim ya da yanlış boyutlar verdiğinde bir çıkmaza giriyor ve ardından gerçekten işe yarayan bir çözüm bulmak için saatler harcıyor. + +Bu öğreticide, **how to render word** belgelerini PNG görüntüleri olarak nasıl oluşturacağınızı gösteren temiz, uçtan uca bir çözümü adım adım inceleyeceğiz; böylece **save docx as PNG** yaparken kesin genişlik‑yükseklik kontrolü ve yüksek kaliteli antialiasing elde edeceksiniz. Sonunda çalıştırmaya hazır bir kod parçacığı, API seçenekleri hakkında sağlam bir anlayış ve yaygın tuzaklardan kaçınmak için birkaç profesyonel ipucu elde edeceksiniz. + +## Öğrenecekleriniz + +- Aspose.Words for .NET kullanarak bir `.docx` dosyasını yükleyin. +- `ImageRenderingOptions` ile **set image width height** ayarlayın. +- **Export docx as image** (PNG) işlemini antialiasing etkinleştirerek yapın. +- Tek bir sayfa ya da tüm belge için **convert word to png** nasıl yapılır. +- Büyük belgeler, DPI hususları ve dosya‑sistemi yolları ile başa çıkma ipuçları. + +Harici araçlar yok, karmaşık komut satırı hileleri yok—sadece herhangi bir .NET projesine bırakabileceğiniz saf C# kodu. + +--- + +## Önkoşullar + +Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun: + +| Requirement | Why it matters | +|-------------|----------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words hem ikisini destekler, ancak daha yeni çalışma zamanları daha iyi performans sunar. | +| **Aspose.Words for .NET** NuGet paketi (`Install-Package Aspose.Words`) | `Document` sınıfını ve render motorunu sağlar. | +| Bir **Word belgesi** (`.docx`) – PNG'ye dönüştürmek istediğiniz dosya. | Dönüştüreceğiniz kaynak. | +| Temel C# bilgisi – `using` ifadelerini ve nesne başlatmayı anlayacaksınız. | Öğrenme eğrisini hafif tutar. | + +NuGet paketini eksikse, Package Manager Console’da şu komutu çalıştırın: + +```powershell +Install-Package Aspose.Words +``` + +Hepsi bu—paket yüklendikten sonra kodlamaya hazırsınız. + +--- + +## Adım 1: Kaynak Belgeyi Yükleyin + +İlk yapmanız gereken, kütüphaneyi dönüştürmek istediğiniz Word dosyasına yönlendirmektir. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Neden önemli:** `Document` sınıfı Word paketinin tamamını belleğe okur, sayfalara, stillere ve her şeye erişim sağlar. Yol yanlışsa `FileNotFoundException` alırsınız; bu yüzden dosyanın var olduğundan ve yolun kaçışlı ters eğik çizgiler (`\\`) ya da verbatim string (`@`) kullandığından emin olun. + +> **Pro tip:** Dosyanın çalışma zamanında eksik olabileceğini düşünüyorsanız, yükleme çağrısını bir `try/catch` bloğuna sarın. + +--- + +## Adım 2: Görüntü Render Seçeneklerini Yapılandırın (Set Image Width Height) + +Şimdi öğreticinin kalbi geliyor: **how to set image width height** nasıl yapılır, böylece ortaya çıkan PNG gerilmiş ya da pikselli olmaz. `ImageRenderingOptions` sınıfı, boyutlar, DPI ve yumuşatma üzerinde ince ayar yapmanızı sağlar. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Önemli özelliklerin açıklaması:** + +- `Width` ve `Height` – İstediğiniz tam piksel boyutları. Bunları ayarlayarak **set image width height** doğrudan belirleyebilir, varsayılan sayfa boyutunu geçersiniz. +- `UseAntialiasing` – Metin ve vektör grafikler için yüksek kaliteli yumuşatma sağlar; bu, **convert word to png** yaparken keskin kenarlar elde etmek için kritiktir. +- `Resolution` – Daha yüksek DPI daha fazla detay üretir, özellikle karmaşık düzenlerde. Bellek kullanımına dikkat edin; 300 DPI bir görüntü büyük olabilir. + +> **Neden varsayılan boyuta güvenilmiyor?** Varsayılan, sayfanın fiziksel boyutlarını (ör. A4 96 DPI) kullanır. Bu genellikle 794 × 1123 piksel bir görüntü üretir—bazı durumlar için yeterli olabilir ama belirli bir UI küçük resmi ya da sabit‑boyutlu ön izleme gerektiğinde yeterli değildir. + +--- + +## Adım 3: PNG Olarak Render Edin ve Kaydedin (Export Docx as Image) + +Belge yüklendi ve seçenekler yapılandırıldı, artık **export docx as image** yapabilirsiniz. `RenderToImage` metodu işi halleder. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Tüm belgeyi (tüm sayfaları) ayrı PNG dosyalarına render etmek isterseniz, sayfa koleksiyonu üzerinde döngü oluşturun: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Arka planda ne oluyor?** Renderlayıcı, sağladığınız boyutları kullanarak her sayfayı rasterleştirir, antialiasing uygular ve PNG bayt akışını diske yazar. PNG kayıpsız olduğu için orijinal Word düzeninin tam sadeliğini korursunuz. + +**Beklenen çıktı:** Tam olarak 1024 × 768 piksel (veya ayarladığınız boyut) net bir PNG dosyası. Herhangi bir görüntüleyicide açtığınızda, Word içeriğinin orijinal belgede göründüğü gibi bitmap olarak render edildiğini göreceksiniz. + +--- + +## İleri Düzey İpuçları & Varyasyonlar + +### 1. Şeffaf Arka Planları Koru + +Word belgenizde şeffaf arka planlı şekiller varsa ve bu şeffaflığı korumak istiyorsanız, `BackgroundColor` değerini `Color.Transparent` olarak ayarlayın: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Yalnızca Belirli Bir Aralığı Render Edin + +Bazen tüm sayfa yerine sadece bir paragraf ya da tablo gerekir. `DocumentVisitor` kullanarak düğümü çıkarın ve ayrı ayrı render edin. Bu daha gelişmiş bir senaryo, ancak **how to render word** içeriğini ayrıntılı seviyede nasıl yapacağınızı gösterir. + +### 3. DPI'yi Dinamik Olarak Ayarlayın + +Sayfa başına farklı DPI'ye ihtiyacınız varsa (ör. kapak sayfası için yüksek çözünürlük), döngü içinde `Resolution` değerini değiştirin: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Toplu İşlem + +Onlarca belgeyi dönüştürürken, tüm akışı bir metoda sarın ve aynı `ImageRenderingOptions` örneğini yeniden kullanın. Seçenek nesnesini yeniden kullanmak, tahsis yükünü azaltır. + +--- + +## Yaygın Tuzaklar & Kaçınma Yöntemleri + +| Symptom | Likely Cause | Fix | +|---------|--------------|-----| +| PNG yüksek DPI olmasına rağmen bulanık | `UseAntialiasing` `false` bırakılmış | `UseAntialiasing = true` olarak ayarlayın. | +| Çıktı boyutu `Width`/`Height` ile eşleşmiyor | DPI dikkate alınmamış | İstenen boyutu `Resolution / 96` ile çarpın ya da `Resolution`'ı ayarlayın. | +| Büyük belgelerde bellek hatası | Tüm belge 300 DPI'de render ediliyor | Tek sayfa render edin, her görüntüyü kaydettikten sonra serbest bırakın. | +| Şeffaf görüntülerde beyaz arka plan | `BackgroundColor` ayarlanmamış | `imageOptions.BackgroundColor = Color.Transparent` olarak ayarlayın. | + +--- + +## Tam Çalışan Örnek + +Aşağıda, bir console uygulamasına kopyalayıp yapıştırabileceğiniz, **convert word to png**, **save docx as png** ve tabii ki **set image width height** işlemlerini gösteren bağımsız bir program bulunuyor. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Çalıştırın:** Projeyi derleyin, belirtilen yola geçerli bir `input.docx` yerleştirin ve çalıştırın. Tam **1024 × 768** piksel, yumuşak kenarlı bir `output.png` dosyası görmelisiniz. + +## İlgili Öğreticiler + +- [How to Enable Antialiasing When Converting DOCX to PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [convert docx to png – create zip archive c# tutorial](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [How to Use Aspose to Render HTML to PNG – Step‑by‑Step Guide](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/turkish/net/html-extensions-and-conversions/_index.md b/html/turkish/net/html-extensions-and-conversions/_index.md index 8dd996b05..1ee394b52 100644 --- a/html/turkish/net/html-extensions-and-conversions/_index.md +++ b/html/turkish/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,8 @@ Aspose.HTML for .NET yalnızca bir kütüphane değil; web geliştirme dünyası ## HTML Uzantıları ve Dönüşümleri Eğitimleri ### [Aspose.HTML ile .NET'te HTML'yi PDF'ye dönüştürün](./convert-html-to-pdf/) Aspose.HTML for .NET ile HTML'yi zahmetsizce PDF'ye dönüştürün. Adım adım kılavuzumuzu izleyin ve HTML'den PDF'ye dönüştürmenin gücünü serbest bırakın. +### [C# ile HTML'yi PDF'ye dönüştürün – Tam Kılavuz](./convert-html-to-pdf-with-c-complete-guide/) +C# ve Aspose.HTML for .NET kullanarak HTML'yi PDF'ye zahmetsizce dönüştürün. Adım adım kılavuzla süreci keşfedin. ### [Aspose.HTML ile .NET'te EPUB'ı Görüntüye Dönüştürme](./convert-epub-to-image/) Aspose.HTML for .NET kullanarak EPUB'ı görsellere nasıl dönüştüreceğinizi öğrenin. Kod örnekleri ve özelleştirilebilir seçenekler içeren adım adım eğitim. ### [Aspose.HTML ile .NET'te EPUB'ı PDF'ye dönüştürün](./convert-epub-to-pdf/) @@ -68,9 +70,13 @@ Aspose.HTML for .NET kullanarak HTML'den PDF'ye nasıl dönüştüreceğinizi ad ### [C#'ta HTML'i Zip Dosyasına Sıkıştırma](./how-to-zip-html-in-c-save-html-to-zip/) ### [Stil Verilmiş Metinle HTML Belgesi Oluşturma ve PDF'ye Dışa Aktarma – Tam Kılavuz](./create-html-document-with-styled-text-and-export-to-pdf-full/) ### [HTML'yi ZIP Olarak Kaydet – Tam C# Öğreticisi](./save-html-as-zip-complete-c-tutorial/) -Aspose.HTML for .NET kullanarak HTML dosyalarını ZIP arşivine kaydetmeyi adım adım öğrenin. +Aspose.HTML for .NET kullanarak HTML dosalarını ZIP arşivine kaydetmeyi adım adım öğrenin. ### [C# ile HTML'yi ZIP'e Kaydet – Tam Bellek İçi Örnek](./save-html-to-zip-in-c-complete-in-memory-example/) Aspose.HTML for .NET kullanarak HTML dosyasını bellek içinde ZIP arşivine dönüştürmeyi adım adım öğrenin. +### [HTML'yi ZIP Olarak Kaydet – Aspose.HTML Tam Kılavuzu](./save-html-as-zip-complete-guide-for-aspose-html/) +Aspose.HTML for .NET kullanarak HTML dosalarını ZIP arşivine kaydetmeyi adım adım öğrenin. +### [C# ile HTML'yi PDF Olarak Render Et – Tam Adım Adım Kılavuz](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Aspose.HTML for .NET kullanarak C# ile HTML'yi PDF'ye dönüştürün. Adım adım kılavuzumuzla süreci öğrenin. {{< /blocks/products/pf/tutorial-page-section >}} diff --git a/html/turkish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/turkish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..73d244133 --- /dev/null +++ b/html/turkish/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,258 @@ +--- +category: general +date: 2026-05-22 +description: Aspose.HTML kullanarak C#'de HTML'yi PDF'ye dönüştürün. Adım adım kod, + seçenekler ve Linux ipuçlarıyla C#'de HTML'yi PDF'ye nasıl render edeceğinizi öğrenin. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: tr +og_description: Aspose.HTML ile C#'ta HTML'yi PDF'ye dönüştürün. Bu rehber, net seçenekler + ve Linux dostu ipuçları kullanarak C#'ta HTML'yi PDF'ye nasıl render edeceğinizi + gösterir. +og_title: C# ile HTML'yi PDF'ye Dönüştür – Tam Rehber +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: C# ile HTML'yi PDF'ye Dönüştürme – Tam Rehber +url: /tr/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML'yi PDF'ye Dönüştürme C# – Tam Kılavuz + +Eğer **HTML'yi PDF'ye dönüştürmek** istiyorsanız, Aspose.HTML for .NET bu işi çocuk oyuncağı haline getirir. Bu öğreticide ayrıca **C#'ta HTML'yi PDF'ye nasıl render ederiz** sorusuna da tam kontrol sağlayarak cevap vereceğiz, böylece tahmin yürütmek zorunda kalmayacaksınız. + +Bir pazarlama e-posta şablonunuz, bir makbuz sayfanız ya da modern CSS ile oluşturulmuş karmaşık bir raporunuz olduğunu ve bunu bir PDF olarak müşteriye ya da yazıcıya teslim etmeniz gerektiğini hayal edin. Bunu manuel yapmak zahmetli, ancak birkaç satır C# kodu tüm süreci otomatikleştirebilir. Bu kılavuzun sonunda, Windows *ve* Linux'ta çalışan, kendi içinde barındırılan, üretim‑hazır bir çözümünüz olacak. + +## Gerekenler + +- **.NET 6.0 veya üzeri** – Aspose.HTML, .NET Standard 2.0+ hedefler, bu yüzden herhangi bir yeni SDK çalışır. +- **Aspose.HTML for .NET** NuGet paketi (`Aspose.Html`) – üretim için geçerli bir lisansa ihtiyacınız olacak, ancak ücretsiz deneme sürümü test için çalışır. +- **Basit bir HTML dosyası**, PDF'ye dönüştürmek istediğiniz (biz buna `input.html` diyeceğiz). +- Favori IDE'niz (Visual Studio, Rider veya VS Code) – özel bir araç gerektirmez. + +Hepsi bu. Harici PDF dönüştürücüleri, komut‑satırı hileleri yok. Sadece saf C#. + +![Diagram illustrating the convert html to pdf workflow using Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## HTML'yi PDF'ye Dönüştürme – Tam Uygulama + +Aşağıda eksiksiz, çalıştırmaya hazır program yer alıyor. Yeni bir console uygulamasına kopyalayıp yapıştırın, NuGet paketlerini geri yükleyin ve **F5** tuşuna basın. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Neden Bu Çalışıyor + +- **`Document`**, Aspose.HTML'in giriş noktasıdır; HTML'i ayrıştırır, CSS'i çözer ve render için hazır bir DOM oluşturur. +- **`PdfRenderingOptions`**, çıktıyı ayarlamanıza olanak tanır. `UseHinting` bayrağı, varsayılan rasterizer'ın bulanık görünebildiği başsız Linux konteynerlerinde net metin için gizli sosdur. +- **`Save`**, ağır işi yapar: DOM'u PDF sayfalarına rasterleştirir, sayfa sonlarını dikkate alır ve fontları otomatik olarak gömer. + +Programı çalıştırdığınızda `output.pdf` kaynak dosyanızın yanına oluşturulur. Herhangi bir PDF görüntüleyiciyle açın ve orijinal HTML ile görsel olarak aynı olduğunu görmelisiniz. + +## C#'ta HTML'yi PDF'ye Render Etme – Adım‑Adım + +Aşağıda süreci küçük parçalara ayırarak **C#'ta HTML'yi PDF'ye nasıl render ederiz** açıklıyoruz ve yaygın tuzakları ele alıyoruz. + +### Adım 1 – Aspose.HTML NuGet Paketini Yükleyin + +Proje klasörünüzde terminali açın ve şu komutu çalıştırın: + +```bash +dotnet add package Aspose.Html +``` + +Visual Studio arayüzünü tercih ediyorsanız, projeye sağ‑tıklayın → **Manage NuGet Packages** → **Aspose.Html**'i arayın ve en son stabil sürümü yükleyin. + +> **Pro tip:** Yükledikten sonra, proje köküne bir lisans dosyası (`Aspose.Total.lic`) ekleyin; böylece değerlendirme filigranlarından kaçınırsınız. + +### Adım 2 – HTML'nizi Doğru Şekilde Yükleyin + +Aspose.HTML can ingest: + +- Yerel dosya yolları (`new Document("file.html")`) +- URL'ler (`new Document("https://example.com")`) +- Ham HTML dizgileri (`new Document("…", new HtmlLoadOptions())`) + +Dosya sisteminden yüklerken, yolun mutlak olduğundan veya çalışma dizininin uygun şekilde ayarlandığından emin olun; aksi takdirde `FileNotFoundException` alırsınız. Linux'ta, ileri eğik çizgi (`/`) veya `Path.Combine` kullanın. + +### Adım 3 – Doğru Render Seçeneklerini Seçin + +`UseHinting` dışında, aşağıdaki ayarları da değiştirmek isteyebilirsiniz: + +| Seçenek | Ne işe yarar | Ne zaman kullanılır | +|--------|--------------|----------------| +| `PageSize` | PDF sayfa boyutlarını ayarlar (A4, Letter, özel) | Hedef kağıt boyutuna uymak | +| `Landscape` | Sayfayı yatay konuma döndürür | Geniş tablolar veya grafikler | +| `RasterizeVectorGraphics` | Vektör grafikleri raster görüntülere zorlar | PDF alıcısı SVG'yi işleyemediğinde | +| `CompressionLevel` | Görüntü sıkıştırmasını kontrol eder (0‑9) | E‑posta ekleri için dosya boyutunu azaltmak | + +Bu özellikleri akıcı bir şekilde zincirleyebilirsiniz: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Adım 4 – PDF'yi Kaydedin + +`Save` metodunun tam örnekte gördüğünüz aşırı yüklemesi doğrudan bir dosya yoluna yazar. PDF'yi belleğe de akıtabilirsiniz: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Bu, PDF'yi bir web API'sinden indirme olarak döndürmeniz gerektiğinde kullanışlıdır. + +### Adım 5 – Çıktıyı Doğrulayın + +Hızlı bir mantık kontrolü, PDF sayfa sayısını beklenen HTML bölümleriyle karşılaştırmaktır. Bunu Aspose.PDF ile geri okuyabilirsiniz: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Sayım yanlış görünüyorsa, CSS `page-break` kurallarını yeniden gözden geçirin veya `PdfRenderingOptions`'ı buna göre ayarlayın. + +## Kenar Durumları ve Yaygın Tuzaklar + +| Durum | Dikkat Edilmesi Gereken | Çözüm | +|-------|------------------------|-------| +| **Harici kaynaklar (görseller, fontlar) eksik** | Göreceli URL'ler HTML dosyasının klasörüne göre çözülür. | Doğru kökü göstermek için `HtmlLoadOptions.BaseUri` kullanın. | +| **Linux başsız ortam** | Varsayılan metin render'ı bulanık olabilir. | `UseHinting = true` ayarlayın (gösterildiği gibi) ve System.Drawing'e geri dönüyorsanız `libgdiplus` kurulu olduğundan emin olun. | +| **Büyük HTML (> 10 MB)** | Render sırasında bellek tüketimi artar. | `PdfRenderer` ve `PdfRenderingOptions` ile sayfa‑sayfa render edin ve her sayfayı kaydettikten sonra serbest bırakın. | +| **JavaScript‑ağır sayfalar** | Aspose.HTML JS çalıştırmaz; dinamik içerik statik kalır. | HTML'yi sunucu tarafında (ör. Puppeteer kullanarak) ön‑işlemden geçirin ve ardından Aspose.HTML'e verin. | +| **Unicode karakterler kare olarak görünüyor** | Çalışma ortamında eksik fontlar. | `FontSettings` ile özel fontları gömün veya işletim sisteminde gerekli fontların yüklü olduğundan emin olun. | + +## Tam Çalışan Örnek Özeti + +İşte tüm program tekrar, yorumlar çıkarılmış şekilde, daha öz bir görünüm isteyenler için: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Çalıştırın, `output.pdf`'yi açın ve `input.html`'in piksel‑tam bir kopyasını göreceksiniz. Bu, Aspose.HTML ile **convert html to pdf** özüdür. + +## Sonuç + +C#'ta **HTML'yi PDF'ye dönüştürmek** için gereken her şeyi ele aldık: Aspose.HTML'i kurmak, HTML'yi yüklemek, render seçeneklerini (kritik `UseHinting` bayrağı dahil) ayarlamak ve son PDF'yi kaydetmek. Artık hem Windows hem de Linux ortamları için **C#'ta HTML'yi PDF'ye nasıl render ederiz** konusunda bilgi sahibisiniz ve eksik kaynaklar ya da büyük dosyalar gibi yaygın kenar durumlarını nasıl ele alacağınızı gördünüz. + +Ne yapabilirsiniz? Şunları eklemeyi deneyin: + +- **Başlıklar/altbilgiler** `PdfPageTemplate` ile marka eklemek için. +- **Şifre koruması** `PdfSaveOptions` aracılığıyla. +- **Toplu dönüşüm** bir klasördeki dosyalar üzerinde döngü yaparak + +## İlgili Öğreticiler + +- [Aspose.HTML ile .NET'te HTML'yi PDF'ye Dönüştürme](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Aspose.HTML ile .NET'te EPUB'u PDF'ye Dönüştürme](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Aspose.HTML ile .NET'te SVG'yi PDF'ye Dönüştürme](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/turkish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/turkish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..0d488c307 --- /dev/null +++ b/html/turkish/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,295 @@ +--- +category: general +date: 2026-05-22 +description: C# kullanarak HTML'yi PDF olarak render edin, kısa bir örnekle. HTML'yi + PDF'ye C# ile hızlı ve güvenilir bir şekilde nasıl dönüştüreceğinizi öğrenin. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: tr +og_description: C#'ta HTML'yi PDF olarak render edin, net ve çalıştırılabilir bir + örnekle. Bu rehber, HTML'yi C# ile PDF'ye nasıl dönüştüreceğinizi ve HTML dosyasından + PDF oluşturmayı gösterir. +og_title: C#'ta HTML'yi PDF olarak oluştur – Tam Programlama Öğreticisi +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: C#'te HTML'yi PDF Olarak Render Et – Tam Adım Adım Rehber +url: /tr/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# C#'ta HTML'yi PDF Olarak Oluşturma – Tam Adım‑Adım Kılavuz + +Ever needed to **render HTML as PDF** but weren’t sure which library to pick for a .NET project? You’re not alone. In many line‑of‑business apps you’ll find yourself needing to **convert HTML to PDF C#** for invoices, reports, or marketing brochures—basically any time you want a printable version of a web page. + +Şöyle ki: tekerleği yeniden icat etmenize gerek yok. Birkaç satır kodla bir `input.html` dosyasını alıp kanıtlanmış bir render motoruna besleyebilir ve net bir `output.pdf` elde edebilirsiniz. Bu öğreticide, doğru NuGet paketini eklemekten harici CSS gibi kenar durumlarını ele almaya kadar tüm süreci adım adım göstereceğiz. Sonunda sadece birkaç dakika içinde **generate PDF from HTML file** yapabilecek olacaksınız. + +## Öğrenecekleriniz + +- .NET console uygulamasını **creates PDF from HTML C#** kodu ile nasıl kuracağınızı. +- Gerekli **save HTML document as PDF** API çağrılarını tam olarak. +- Bazı render seçeneklerinin (örneğin hinting) metin kalitesi için neden önemli olduğunu. +- Eksik fontlar veya göreli resim yolları gibi yaygın sorunları gidermek için ipuçları. + +**Önkoşullar** – .NET 6+ veya .NET Framework 4.7 yüklü olmalı, C# hakkında temel bir bilgiye ve bir IDE'ye (Visual Studio 2022, Rider veya VS Code) sahip olmalısınız. Önceden PDF deneyimi gerekmiyor. + +--- + +## Render HTML as PDF – Projeyi Kurma + +Koda girmeden önce, geliştirme ortamının hazır olduğundan emin olalım. Kullanacağımız kütüphane **Select.Pdf** (ticari olmayan kullanım için ücretsiz) çünkü basit bir API ve sağlam render doğruluğu sunar. + +### PDF render kütüphanesini kurun (convert html to pdf c#) + +Proje klasörünüzde bir terminal açın ve şu komutu çalıştırın: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro ipucu:* Visual Studio kullanıyorsanız, paketi NuGet Package Manager UI üzerinden de ekleyebilirsiniz. Sürüm numarası daha yeni olabilir—sadece en son stabil sürümü alın. + +### Bir console iskeleti oluşturun + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Bu, ihtiyacınız olan tüm temel kod. Ağır iş `Main` içinde gerçekleşir. + +## HTML Belgesini Yükleyin (generate pdf from html file) + +İlk gerçek adım, render'ı diskteki bir HTML dosyasına yönlendirmektir. Select.Pdf iki kullanışlı yol sunar: ham HTML dizesi geçmek ya da dosya yolu vermek. Dosya kullanmak işleri düzenli tutar, özellikle bağlı CSS veya resimler olduğunda. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Burada ayrıca eksik dosyaya karşı bir koruma ekliyoruz—bu, HTML dosyasını çıktı klasörüne kopyalamayı unutan yeni başlayanları sık sık şaşırtan bir durumdur. + +## Render Seçeneklerini Yapılandırın (create pdf from html c#) + +Select.Pdf, zengin bir `PdfDocumentOptions` nesnesi ile gelir. Net metin için hinting'i etkinleştiririz; bu, glifleri pürüzsüzleştirir ancak çok küçük bir performans maliyeti vardır. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Burada sayfa boyutunu, kenar boşluklarını ayarlayabilir veya hatta özel bir font gömebilirsiniz. Önemli nokta, **render html as pdf** sadece tek satırlık bir işlem değildir; son belgenin görünüm ve hissi üzerinde kontrol sizde. + +## HTML Belgesini PDF Olarak Kaydedin (render html as pdf) + +Şimdi sihir gerçekleşir. Dönüştürücüye HTML dosyamızın yolunu verir ve ona diske bir PDF yazmasını söyleriz. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +`ConvertUrl` metodu, HTML dosyasının konumuna göre göreli URL'leri (resimler, CSS) otomatik olarak çözer; bu yüzden bu yaklaşım çoğu gerçek dünya senaryosu için sağlamdır. + +### Beklenen çıktı + +Programı çalıştırdıktan sonra aynı klasörde bir `output.pdf` dosyası görmelisiniz. Açın—şunları fark edeceksiniz: + +- Hinting sayesinde net anti‑aliasing ile render edilmiş metin. +- Bağlı CSS'den gelen stiller doğru uygulanmış. +- Resimler, kaynak HTML'de tanımlanan tam boyutta gösterilmiş. + +Bir şey yanlış görünüyorsa, CSS ve resim dosyalarının `input.html` ile aynı konumda olduğundan emin olun veya mutlak URL'ler kullanın. + +## Yaygın Kenar Durumlarını Ele Alma + +### 1. Güvenlik duvarları tarafından engellenen harici kaynaklar + +HTML'niz, sunucunuzun erişemediği bir CDN'de barındırılan fontlara referans veriyorsa, PDF genel bir fonta geri dönebilir. Bunu önlemek için, font dosyalarını yerel olarak indirin veya `@font-face` ile göreli bir yol kullanarak gömün. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Çok büyük HTML dosyaları + +Devasa belgeleri dönüştürürken bellek sınırlarına ulaşabilirsiniz. Select.Pdf, dönüşümü akış olarak yapmanıza izin verir: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +Akış, işlemi hafif tutar ancak HTML'yi bir dize olarak sağlamanızı gerektirir; gerektiğinde parçalar halinde okuyabilirsiniz. + +### 3. Özel başlıklar veya altbilgiler + +Her sayfada sayfa numarası veya şirket logosu gibi bir şey istiyorsanız, `ConvertUrl`'yi çağırmadan önce `converter.Options` üzerindeki `Header` ve `Footer` özelliklerini ayarlayın. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +## Tam Çalışan Örnek (All Steps Combined) + +Aşağıda, tamamen kopyala‑yapıştır hazır program yer alıyor. `YOUR_DIRECTORY` ifadesini HTML'nizin bulunduğu mutlak yol ile değiştirin. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Çalıştırın:** proje dizininden `dotnet run`. Her şey doğru kurulduysa başarı mesajını ve parlak bir `output.pdf` dosyasını göreceksiniz. + +## Görsel Özet + +![Render HTML as PDF example](render-html-as-pdf.png){alt="render html as pdf example"} + +Ekran görüntüsü, konsol çıktısını ve bir görüntüleyicide açılan sonuç PDF'yi gösterir. Net başlıkları ve doğru yüklenen resimleri fark edin—tam da **render html as pdf** beklediğiniz şey. + +## Sonuç + +Şimdi bir C# uygulamasında **render HTML as PDF** yapmayı, kütüphaneyi kurmaktan render seçeneklerini ince ayarlamaya kadar öğrendiniz. Tam örnek, **convert HTML to PDF C#**, **generate PDF from HTML file** ve **save HTML document as PDF** işlemlerini sadece birkaç satırla yapmanın güvenilir bir yolunu gösteriyor. + +Sonraki adım ne? Şunları deneyin: + +- Marka tutarlılığı için özel fontlar eklemek. +- Dinamik HTML dizelerinden PDF oluşturmak (ör. Razor şablonları). +- `PdfDocument.AddPage` kullanarak birden fazla PDF'i tek bir raporda birleştirmek. + +Bu uzantıların her biri burada ele alınan temel kavramlara dayanır, böylece zorlu bir öğrenme eğrisi olmadan daha gelişmiş senaryoları ele almaya hazır olursunuz. + +Sorularınız mı var ya da bir sorunla mı karşılaştınız? Aşağıya bir yorum bırakın, birlikte sorun giderelim. İyi kodlamalar! + +## İlgili Öğreticiler + +- [Aspose.HTML ile .NET'te HTML'yi PDF'ye Dönüştür](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Stil Verilmiş Metinle HTML Belgesi Oluştur ve PDF Olarak Dışa Aktar – Tam Kılavuz](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Aspose.HTML ile HTML'yi PDF'ye Dönüştür – Tam Manipülasyon Kılavuzu](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/turkish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/turkish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..fd9f0f5d6 --- /dev/null +++ b/html/turkish/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,229 @@ +--- +category: general +date: 2026-05-22 +description: Aspose.HTML kullanarak HTML'yi hızlıca ZIP olarak kaydedin. HTML dosyalarını + nasıl ZIP'leyebileceğinizi, HTML'yi ZIP'e nasıl render edeceğinizi ve tam kodla + HTML'yi bir ZIP dosyasına nasıl dışa aktaracağınızı öğrenin. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: tr +og_description: Aspose.HTML ile HTML'yi ZIP olarak kaydedin. Bu kılavuz, HTML'yi ZIP'e + nasıl render edeceğinizi, HTML'yi bir ZIP dosyasına nasıl dışa aktaracağınızı ve + HTML dosyalarını programlı olarak nasıl zipleyeceğinizi gösterir. +og_title: HTML'yi ZIP olarak kaydedin – Tam Aspose.HTML Öğreticisi +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: HTML'yi ZIP olarak kaydet – Aspose.HTML için Tam Kılavuz +url: /tr/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# HTML'yi ZIP olarak kaydet – Aspose.HTML için Tam Kılavuz + +Ayrı bir arşivleme aracı kullanmadan **HTML'yi ZIP olarak kaydetmeyi** hiç merak ettiniz mi? Tek başınıza değilsiniz. Birçok geliştirici, HTML sayfasını resimleri, CSS ve script'leriyle birlikte kolay dağıtım için paketlemeye ihtiyaç duyar ve bunu manuel olarak yapmak kısa sürede sorun haline gelir. + +Bu öğreticide, Aspose.HTML for .NET kullanarak **HTML'yi ZIP'e render** eden temiz, uçtan uca bir çözümü adım adım inceleyeceğiz. Sonunda **HTML'yi bir ZIP dosyasına dışa aktarmanın** tam olarak nasıl yapılacağını öğrenecek ve farklı senaryolarda **HTML dosyalarını nasıl zip'leyebileceğinize** dair varyasyonları göreceksiniz. + +> *Pro ipucu:* Gösterilen yaklaşım, tek bir sayfayı paketleseniz de tüm site klasörünü paketleseniz de çalışır. + +## Gerekenler + +Before we dive in, make sure you have: + +- .NET 6 (veya herhangi bir güncel .NET çalışma zamanı) yüklü. +- Projenizde Aspose.HTML for .NET NuGet paketi (`Aspose.Html`) referans olarak eklenmiş. +- Kontrol ettiğiniz bir klasöre yerleştirilmiş basit bir `input.html` dosyası. +- Biraz C# bilgisi—fantezi bir şey değil, sadece temeller. + +Hepsi bu. Harici zip araçları yok, komut satırı hileleri yok. Hadi başlayalım. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*Image alt text: HTML'yi ZIP olarak kaydetme süreci diyagramı* + +## Adım 1: Kaynak HTML Belgesini Yükle + +İlk yapmamız gereken, Aspose.HTML'e kaynağımızın nerede olduğunu söylemek. `HTMLDocument` sınıfı dosyayı okur ve render için hazır bir bellek içi DOM oluşturur. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Neden önemli: belgeyi yüklemek, kütüphaneye kaynak çözümlemesi (resimler, CSS, fontlar) üzerinde tam kontrol sağlar. HTML, göreli yollar referans veriyorsa, Aspose.HTML bunları dosyanın klasörüne göre otomatik olarak çözer. + +## Adım 2: (İsteğe Bağlı) Özel Bir Resource Handler Oluştur + +Her bir kaynağı incelemeniz veya değiştirmeniz gerekiyorsa—örneğin arşive eklenmeden önce resimleri sıkıştırmak istiyorsanız—bir `ResourceHandler` ekleyebilirsiniz. Bu adım isteğe bağlıdır, ancak özel mantıkla **HTML'yi ZIP arşivine dönüştürmenin** en esnek yoludur. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Özel bir işlem yapmanıza gerek yoksa ne olur?* Bu sınıfı atlayıp varsayılan handler'ı kullanın—Aspose.HTML kaynakları doğrudan ZIP'e yazar. + +## Adım 3: Handler'ı Kullanmak İçin Kaydetme Seçeneklerini Yapılandır + +`HtmlSaveOptions` nesnesi, renderer'a kaynaklarla ne yapılacağını söyler. `MyResourceHandler`'ımızı atayarak çıktının tam kontrolünü elde ederiz. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +`ResourceHandler` özelliğinin adı, **HTML'yi ZIP'e render** yeteneğine doğrudan referans gösterdiğine dikkat edin. Burası sihrin gerçekleştiği yer: her bağlı kaynak, diske yazılmak yerine arşive akıtılır. + +## Adım 4: Render Edilen Belgeyi ZIP Arşivine Kaydet + +Şimdi nihayet **HTML'yi bir ZIP dosyasına dışa aktar**. `Save` metodu herhangi bir `Stream` kabul eder, bu yüzden `result.zip` oluşturan bir `FileStream`'e yönlendirebiliriz. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Bu, tüm iş akışı. Kod tamamlandığında `result.zip` şunları içerir: + +- `input.html` (orijinal işaretleme) +- Tüm referans verilen resimler, CSS dosyaları ve fontlar +- `MyResourceHandler` içinde değiştirdiyseniz, dönüştürülmüş kaynaklar + +## Aspose.HTML Kullanmadan HTML Dosyalarını Zip'leme (Hızlı Alternatif) + +Bazen sadece klasik bir **HTML dosyalarını nasıl zip'leyebilirim** yaklaşımına ihtiyacınız olur, belki de zaten farklı bir HTML ayrıştırıcı kullanıyorsunuzdur. Bu durumda .NET'in yerleşik `System.IO.Compression`'ını kullanabilirsiniz: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Bu yöntem basit ama render adımını içermez; sadece diskteki dosyaları paketler. HTML'niz dış URL'lere referans veriyorsa, bu kaynaklar dahil edilmez. Bu yüzden güvenilir bir **HTML'yi ZIP'e render** çözümüne ihtiyacınız olduğunda Aspose.HTML yolu tercih edilir. + +## Kenar Durumları ve Yaygın Tuzaklar + +| Situation | What to Watch For | Recommended Fix | +|-----------|-------------------|-----------------| +| **Büyük resimler** | Bellek kullanımı, her resim bir `MemoryStream` içine yüklendiği için artar. | Tamamen tamponlamadan, kaynak akışı kopyalayan özel bir handler kullanarak doğrudan zip'e akıt. | +| **Harici URL'ler** | Internette barındırılan kaynaklar otomatik olarak indirilmez. | `HtmlLoadOptions` içinde `BaseUrl`'yi site köküne işaret edecek şekilde ayarlayın veya kaydetmeden önce kaynakları manuel olarak indirin. | +| **Dosya adı çakışmaları** | Farklı alt klasörlerde aynı ada sahip iki CSS dosyası birbirinin üzerine yazabilir. | `ResourceHandler`'ın zip'e yazarken tam göreli yolu koruduğundan emin olun. | +| **İzin hataları** | Salt okunur bir klasöre yazmaya çalışmak `UnauthorizedAccessException` hatası verir. | İşlemi uygun yetkilerle çalıştırın veya yazılabilir bir çıktı dizini seçin. | + +Bu senaryoları ele almak, **HTML'yi ZIP arşivine dönüştürme** rutininizi üretim ortamı için sağlam kılar. + +## Tam Çalışan Örnek (Tüm Parçalar Bir Arada) + +Aşağıda tam, çalıştırmaya hazır program yer alıyor. Yeni bir console uygulamasına yapıştırın, yolları güncelleyin ve **F5** tuşuna basın. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Beklenen çıktı:** Konsol bir başarı mesajı yazdırır ve `result.zip` dosyası `input.html` ile birlikte tüm bağımlı varlıkları içerir. ZIP'i açın, `input.html` dosyasına çift tıklayın ve sayfanın tarayıcıda olduğu gibi tam olarak render edildiğini göreceksiniz—eksik resim yok, kırık CSS yok. + +## Özet – Neden Bu Yaklaşım Harika + +- **Tek‑adımlı render:** Her kaynağı manuel kopyalamanıza gerek yok; Aspose.HTML sizin için yapar. +- **Özelleştirilebilir pipeline:** `ResourceHandler` her dosyanın nasıl saklanacağını tam kontrol etmenizi sağlar, sıkıştırma, şifreleme veya anlık dönüşüm gibi. +- **Çapraz‑platform:** .NET çalışma zamanı olduğu sürece Windows, Linux ve macOS'ta çalışır. +- **Harici araç yok:** Tüm **HTML'yi ZIP olarak kaydet** süreci C# kod tabanınız içinde gerçekleşir. + +## Sıradaki Adımlar? + +Artık **HTML'yi ZIP olarak kaydet** konusunda uzmanlaştığınıza göre, aşağıdaki ilgili konuları keşfetmeyi düşünün: + +- **Export HTML to PDF** – yazdırılabilir raporlar için mükemmel (`export html to zip file` bilgisi her iki formatı da ihtiyaç duyduğunuzda yardımcı olur). +- **Streaming ZIP directly to HTTP response** – kullanıcıların paketlenmiş bir siteyi anında indirmesine olanak tanıyan web API'leri için harika. +- **Encrypting ZIP archives** – gizli belgelerle çalışıyorsanız bir şifre katmanı ekleyin. + +Denemekten çekinmeyin: `MyResourceHandler`'ı resimleri küçülten bir sıkıştırıcıyla değiştirin veya tüm paketlenmiş kaynakları listeleyen bir manifest dosyası ekleyin. Render pipeline'ını kontrol ettiğinizde sınır yoktur. + +--- + +*Kodlamanız keyifli olsun! Herhangi bir sorunla karşılaşırsanız veya geliştirme fikirleriniz varsa, aşağıya yorum bırakın. Birlikte çözeriz.* + +## İlgili Öğreticiler + +- [C#'ta HTML Nasıl Zip'lenir – HTML'yi Zip'e Kaydet](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [HTML'yi ZIP Olarak Kaydet – Tam C# Öğreticisi](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [C#'ta HTML'yi ZIP'e Kaydet – Tam Bellek İçi Örnek](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/vietnamese/net/generate-jpg-and-png-images/_index.md b/html/vietnamese/net/generate-jpg-and-png-images/_index.md index 364f75161..9c63f9d3b 100644 --- a/html/vietnamese/net/generate-jpg-and-png-images/_index.md +++ b/html/vietnamese/net/generate-jpg-and-png-images/_index.md @@ -45,6 +45,8 @@ Học cách sử dụng Aspose.HTML cho .NET để thao tác với các tài li Hướng dẫn chi tiết cách bật khử răng cưa để cải thiện chất lượng hình ảnh khi chuyển đổi tài liệu DOCX sang PNG hoặc JPG bằng Aspose.HTML. ### [Chuyển đổi DOCX sang PNG – tạo tệp ZIP bằng C# – Hướng dẫn](./convert-docx-to-png-create-zip-archive-c-tutorial/) Hướng dẫn cách chuyển đổi tài liệu DOCX thành hình ảnh PNG và đóng gói chúng vào tệp ZIP bằng C#. +### [Đặt chiều rộng và chiều cao hình ảnh khi chuyển đổi Word sang PNG – Hướng dẫn đầy đủ](./set-image-width-height-when-converting-word-to-png-full-guid/) +Hướng dẫn chi tiết cách thiết lập kích thước ảnh khi chuyển đổi tài liệu Word sang PNG bằng Aspose.HTML. ## Phần kết luận diff --git a/html/vietnamese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md b/html/vietnamese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md new file mode 100644 index 000000000..06b02713c --- /dev/null +++ b/html/vietnamese/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/_index.md @@ -0,0 +1,262 @@ +--- +category: general +date: 2026-05-22 +description: Đặt chiều rộng và chiều cao của hình ảnh khi chuyển đổi tài liệu Word + sang PNG. Tìm hiểu cách xuất file docx thành hình ảnh với chất lượng render cao + trong hướng dẫn từng bước. +draft: false +keywords: +- set image width height +- convert word to png +- save docx as png +- export docx as image +- how to render word +language: vi +og_description: Đặt chiều rộng và chiều cao ảnh khi chuyển đổi tài liệu Word sang + PNG. Hướng dẫn này cho thấy cách xuất file docx thành hình ảnh với cài đặt chất + lượng cao. +og_title: Cài Đặt Chiều Rộng và Chiều Cao Hình Ảnh Khi Chuyển Đổi Word Sang PNG – + Hướng Dẫn Đầy Đủ +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + headline: Set Image Width Height When Converting Word to PNG – Full Guide + type: TechArticle +- description: Set image width height while converting a Word document to PNG. Learn + how to export docx as image with high‑quality rendering in a step‑by‑step tutorial. + name: Set Image Width Height When Converting Word to PNG – Full Guide + steps: + - name: 1. Preserve Transparent Backgrounds + text: 'If your Word document contains shapes with transparent backgrounds and + you want to keep that transparency, set the `BackgroundColor` to `Color.Transparent`:' + - name: 2. Render Only a Specific Range + text: Sometimes you only need a paragraph or a table, not the whole page. Use + `DocumentVisitor` to extract the node and render it separately. That’s a more + advanced scenario, but it shows **how to render word** content at a granular + level. + - name: 3. Adjust DPI Dynamically + text: 'If you need different DPI per page (e.g., high‑resolution for the cover + page), modify `Resolution` inside the loop:' + - name: 4. Batch Processing + text: When converting dozens of documents, wrap the whole flow in a method and + reuse the same `ImageRenderingOptions` instance. Re‑using the options object + reduces allocation overhead. + type: HowTo +tags: +- Aspose.Words +- C# +- Image Rendering +title: Đặt Chiều Rộng và Chiều Cao Hình Ảnh Khi Chuyển Đổi Word sang PNG – Hướng Dẫn + Đầy Đủ +url: /vi/net/generate-jpg-and-png-images/set-image-width-height-when-converting-word-to-png-full-guid/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Đặt Chiều Rộng Chiều Cao Hình Ảnh Khi Chuyển Đổi Word sang PNG – Hướng Dẫn Toàn Diện + +Bạn đã bao giờ tự hỏi cách **đặt chiều rộng chiều cao hình ảnh** khi **chuyển đổi Word sang PNG** chưa? Bạn không phải là người duy nhất. Nhiều nhà phát triển gặp khó khăn khi xuất mặc định cho ra hình mờ hoặc kích thước không đúng, và họ phải mất hàng giờ tìm kiếm một giải pháp thực sự hoạt động. + +Trong hướng dẫn này, chúng tôi sẽ trình bày một giải pháp sạch sẽ, từ đầu đến cuối, cho thấy **cách render word** tài liệu thành hình ảnh PNG, cho phép bạn **lưu docx dưới dạng PNG** với kiểm soát chính xác chiều rộng‑chiều cao và khử răng cưa chất lượng cao. Khi kết thúc, bạn sẽ có một đoạn mã sẵn sàng chạy, hiểu sâu về các tùy chọn API, và một vài mẹo chuyên nghiệp để tránh các lỗi thường gặp. + +## Những Điều Bạn Sẽ Học + +- Tải một tệp `.docx` bằng Aspose.Words cho .NET. +- **Đặt chiều rộng chiều cao hình ảnh** với `ImageRenderingOptions`. +- **Xuất docx dưới dạng hình ảnh** (PNG) với khử răng cưa được bật. +- Cách **chuyển đổi word sang png** cho một trang duy nhất hoặc toàn bộ tài liệu. +- Mẹo xử lý tài liệu lớn, cân nhắc DPI, và đường dẫn hệ thống tệp. + +Không cần công cụ bên ngoài, không cần các thao tác dòng lệnh rắc rối—chỉ cần mã C# thuần túy mà bạn có thể chèn vào bất kỳ dự án .NET nào. + +## Yêu Cầu Trước + +Trước khi chúng ta bắt đầu, hãy chắc chắn rằng bạn có những thứ sau: + +| Requirement | Why it matters | +|-------------|----------------| +| **.NET 6.0+** (or .NET Framework 4.7.2) | Aspose.Words hỗ trợ cả hai, nhưng các runtime mới hơn cho hiệu năng tốt hơn. | +| **Aspose.Words for .NET** NuGet package (`Install-Package Aspose.Words`) | Cung cấp lớp `Document` và engine render. | +| A **Word document** (`.docx`) you want to turn into a PNG. | Nguồn mà bạn sẽ chuyển đổi. | +| Basic C# knowledge – you’ll understand `using` statements and object initialization. | Giúp giảm độ khó học. | + +Nếu bạn chưa có gói NuGet, chạy lệnh sau trong Package Manager Console: + +```powershell +Install-Package Aspose.Words +``` + +Xong—khi gói đã được cài đặt, bạn đã sẵn sàng bắt đầu viết mã. + +## Bước 1: Tải Tài Liệu Nguồn + +Điều đầu tiên bạn cần làm là chỉ định thư viện tới tệp Word mà bạn muốn chuyển đổi. + +```csharp +using Aspose.Words; +using Aspose.Words.Rendering; + +// Load the .docx file from disk +Document doc = new Document(@"C:\MyFiles\input.docx"); +``` + +**Tại sao điều này quan trọng:** Lớp `Document` đọc toàn bộ gói Word vào bộ nhớ, cho phép bạn truy cập các trang, kiểu dáng và mọi thứ khác. Nếu đường dẫn sai, bạn sẽ nhận được `FileNotFoundException`, vì vậy hãy kiểm tra kỹ rằng tệp tồn tại và đường dẫn sử dụng dấu gạch chéo ngược đã escape (`\\`) hoặc chuỗi nguyên (`@`). + +> **Mẹo chuyên nghiệp:** Bao quanh lệnh tải trong khối `try/catch` nếu bạn dự đoán tệp có thể thiếu khi chạy. + +## Bước 2: Cấu Hình Tùy Chọn Render Hình Ảnh (Đặt Chiều Rộng Chiều Cao Hình Ảnh) + +Bây giờ là phần cốt lõi của hướng dẫn: **cách đặt chiều rộng chiều cao hình ảnh** để PNG kết quả không bị kéo dãn hoặc răng cưa. Lớp `ImageRenderingOptions` cung cấp cho bạn kiểm soát chi tiết về kích thước, DPI và làm mịn. + +```csharp +// Create rendering options and explicitly set width and height +ImageRenderingOptions imageOptions = new ImageRenderingOptions +{ + // Desired output size in pixels + Width = 1024, // Set image width height: 1024px wide + Height = 768, // Set image width height: 768px tall + + // High‑quality antialiasing works on Windows, Linux, and macOS + UseAntialiasing = true, + + // Optional: increase DPI for sharper output (default is 96) + Resolution = 300 +}; +``` + +**Giải thích các thuộc tính chính:** + +- `Width` và `Height` – Đây là kích thước pixel chính xác bạn muốn. Khi đặt chúng, bạn **đặt chiều rộng chiều cao hình ảnh** trực tiếp, ghi đè kích thước trang mặc định. +- `UseAntialiasing` – Bật làm mịn chất lượng cao cho văn bản và đồ họa vector, điều này rất quan trọng khi bạn **chuyển đổi word sang png** và muốn các cạnh sắc nét. +- `Resolution` – DPI cao hơn mang lại chi tiết nhiều hơn, đặc biệt cho bố cục phức tạp. Hãy chú ý tới việc sử dụng bộ nhớ; hình ảnh 300 DPI có thể rất lớn. + +> **Tại sao không chỉ dựa vào kích thước mặc định?** Mặc định sử dụng kích thước vật lý của trang (ví dụ, A4 ở 96 DPI). Điều này thường tạo ra hình ảnh 794 × 1123 pixel—đủ cho một số trường hợp nhưng không phù hợp khi bạn cần một thumbnail UI cụ thể hoặc bản xem trước kích thước cố định. + +## Bước 3: Render và Lưu dưới dạng PNG (Xuất Docx dưới dạng Hình Ảnh) + +Với tài liệu đã được tải và các tùy chọn đã cấu hình, cuối cùng bạn có thể **xuất docx dưới dạng hình ảnh**. Phương thức `RenderToImage` thực hiện công việc nặng. + +```csharp +// Render the first page (page index 0) to a PNG file +doc.RenderToImage(@"C:\MyFiles\output.png", imageOptions); +``` + +Nếu bạn muốn render **toàn bộ tài liệu** (tất cả các trang) thành các tệp PNG riêng biệt, hãy lặp qua bộ sưu tập trang: + +```csharp +for (int i = 0; i < doc.PageCount; i++) +{ + string outPath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(outPath, imageOptions, i); +} +``` + +**Điều gì đang diễn ra phía sau?** Trình render raster hoá mỗi trang bằng kích thước bạn cung cấp, áp dụng khử răng cưa, và ghi luồng byte PNG ra đĩa. Vì PNG không mất dữ liệu, bạn giữ nguyên độ trung thực của bố cục Word gốc. + +**Kết quả mong đợi:** Một tệp PNG sắc nét chính xác 1024 × 768 pixel (hoặc bất kỳ kích thước nào bạn đã đặt). Mở nó trong bất kỳ trình xem ảnh nào và bạn sẽ thấy nội dung Word được render chính xác như trong tài liệu gốc, nhưng bây giờ dưới dạng ảnh bitmap. + +## Mẹo Nâng Cao & Các Biến Thể + +### 1. Giữ Nền Trong Suốt + +Nếu tài liệu Word của bạn chứa các hình dạng có nền trong suốt và bạn muốn giữ lại độ trong suốt đó, đặt `BackgroundColor` thành `Color.Transparent`: + +```csharp +imageOptions.BackgroundColor = System.Drawing.Color.Transparent; +``` + +### 2. Render Chỉ Một Phạm Vi Cụ Thể + +Đôi khi bạn chỉ cần một đoạn văn hoặc một bảng, không phải toàn bộ trang. Sử dụng `DocumentVisitor` để trích xuất nút và render riêng biệt. Đây là một kịch bản nâng cao hơn, nhưng nó cho thấy **cách render word** nội dung ở mức độ chi tiết. + +### 3. Điều Chỉnh DPI Một Cách Động + +Nếu bạn cần DPI khác nhau cho mỗi trang (ví dụ, độ phân giải cao cho trang bìa), hãy thay đổi `Resolution` trong vòng lặp: + +```csharp +if (i == 0) imageOptions.Resolution = 600; // cover page +else imageOptions.Resolution = 300; +``` + +### 4. Xử Lý Hàng Loạt + +Khi chuyển đổi hàng chục tài liệu, hãy gói toàn bộ quy trình trong một phương thức và tái sử dụng cùng một đối tượng `ImageRenderingOptions`. Việc tái sử dụng đối tượng tùy chọn giảm thiểu chi phí cấp phát bộ nhớ. + +## Các Sai Lầm Thường Gặp & Cách Tránh + +| Symptom | Likely Cause | Fix | +|---------|--------------|-----| +| PNG bị mờ mặc dù DPI cao | `UseAntialiasing` để `false` | Đặt `UseAntialiasing = true`. | +| Kích thước đầu ra không khớp `Width`/`Height` | Không xét DPI | Nhân kích thước mong muốn với `Resolution / 96` hoặc điều chỉnh `Resolution`. | +| Ngoại lệ hết bộ nhớ trên tài liệu lớn | Render toàn bộ tài liệu ở 300 DPI | Render từng trang một, giải phóng mỗi ảnh sau khi lưu. | +| PNG hiển thị nền trắng trên ảnh trong suốt | `BackgroundColor` chưa được đặt | Đặt `imageOptions.BackgroundColor = Color.Transparent`. | + +## Ví Dụ Hoàn Chỉnh Hoạt Động + +Dưới đây là một chương trình tự chứa mà bạn có thể sao chép và dán vào một ứng dụng console. Nó minh họa **chuyển đổi word sang png**, **lưu docx dưới dạng png**, và dĩ nhiên **đặt chiều rộng chiều cao hình ảnh**. + +```csharp +using System; +using Aspose.Words; +using Aspose.Words.Rendering; +using System.Drawing; // For Color + +namespace WordToPngDemo +{ + class Program + { + static void Main(string[] args) + { + // 1️⃣ Load the source document + string inputPath = @"C:\MyFiles\input.docx"; + Document doc = new Document(inputPath); + + // 2️⃣ Configure rendering options (set image width height) + ImageRenderingOptions options = new ImageRenderingOptions + { + Width = 1024, // Desired pixel width + Height = 768, // Desired pixel height + UseAntialiasing = true, + Resolution = 300, + BackgroundColor = Color.Transparent // Keep transparency if needed + }; + + // 3️⃣ Render the first page to PNG (export docx as image) + string outputPath = @"C:\MyFiles\output.png"; + doc.RenderToImage(outputPath, options); + + Console.WriteLine($"✅ Document rendered successfully to {outputPath}"); + // Optional: render all pages + //RenderAllPages(doc, options); + } + + // Helper method for batch rendering (uncomment if needed) + static void RenderAllPages(Document doc, ImageRenderingOptions options) + { + for (int i = 0; i < doc.PageCount; i++) + { + string pagePath = $@"C:\MyFiles\page_{i + 1}.png"; + doc.RenderToImage(pagePath, options, i); + Console.WriteLine($"Page {i + 1} saved to {pagePath}"); + } + } + } +} +``` + +**Chạy nó:** Xây dựng dự án, đặt một tệp `input.docx` hợp lệ tại đường dẫn bạn đã chỉ định, và thực thi. Bạn sẽ thấy một tệp `output.png` chính xác **1024 × 768** pixel, được render với các cạnh mượt mà. + +## Các Hướng Dẫn Liên Quan + +- [Cách Bật Khử Răng Cưa Khi Chuyển Đổi DOCX sang PNG/JPG](/html/english/net/generate-jpg-and-png-images/how-to-enable-antialiasing-when-converting-docx-to-png-jpg/) +- [chuyển đổi docx sang png – tạo tệp zip c# hướng dẫn](/html/english/net/generate-jpg-and-png-images/convert-docx-to-png-create-zip-archive-c-tutorial/) +- [Cách Sử Dụng Aspose Để Render HTML sang PNG – Hướng Dẫn Từng Bước](/html/english/net/rendering-html-documents/how-to-use-aspose-to-render-html-to-png-step-by-step-guide/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/vietnamese/net/html-extensions-and-conversions/_index.md b/html/vietnamese/net/html-extensions-and-conversions/_index.md index 169c7624f..683ae01f7 100644 --- a/html/vietnamese/net/html-extensions-and-conversions/_index.md +++ b/html/vietnamese/net/html-extensions-and-conversions/_index.md @@ -39,6 +39,10 @@ Aspose.HTML for .NET không chỉ là một thư viện; mà còn là một côn ## Hướng dẫn về phần mở rộng và chuyển đổi HTML ### [Chuyển đổi HTML sang PDF trong .NET với Aspose.HTML](./convert-html-to-pdf/) Chuyển đổi HTML sang PDF dễ dàng với Aspose.HTML cho .NET. Làm theo hướng dẫn từng bước của chúng tôi và giải phóng sức mạnh của việc chuyển đổi HTML sang PDF. +### [Chuyển đổi HTML sang PDF bằng C# – Hướng dẫn đầy đủ](./convert-html-to-pdf-with-c-complete-guide/) +Chuyển đổi HTML sang PDF trong .NET bằng C#. Hướng dẫn chi tiết từng bước để thực hiện chuyển đổi nhanh chóng và hiệu quả. +### [Render HTML thành PDF trong C# – Hướng dẫn đầy đủ từng bước](./render-html-as-pdf-in-c-full-step-by-step-guide/) +Hướng dẫn chi tiết cách chuyển đổi HTML thành PDF trong C# bằng Aspose.HTML, bao gồm các bước cấu hình và mã mẫu. ### [Chuyển đổi EPUB sang hình ảnh trong .NET với Aspose.HTML](./convert-epub-to-image/) Tìm hiểu cách chuyển đổi EPUB sang hình ảnh bằng Aspose.HTML cho .NET. Hướng dẫn từng bước với các ví dụ về mã và tùy chọn có thể tùy chỉnh. ### [Chuyển đổi EPUB sang PDF trong .NET với Aspose.HTML](./convert-epub-to-pdf/) @@ -73,6 +77,8 @@ Tạo PDF từ HTML trong .NET bằng C#. Hướng dẫn chi tiết từng bư Hướng dẫn chi tiết cách lưu tài liệu HTML thành tệp ZIP bằng Aspose.HTML cho .NET với C#. ### [Lưu HTML thành ZIP trong C# – Ví dụ Toàn bộ trong Bộ nhớ](./save-html-to-zip-in-c-complete-in-memory-example/) Hướng dẫn lưu tài liệu HTML vào tệp ZIP trong C# bằng Aspose.HTML, sử dụng bộ nhớ tạm và không tạo file tạm trên đĩa. +### [Lưu HTML dưới dạng ZIP – Hướng dẫn đầy đủ cho Aspose.HTML](./save-html-as-zip-complete-guide-for-aspose-html/) +Hướng dẫn chi tiết cách lưu tài liệu HTML thành tệp ZIP bằng Aspose.HTML cho .NET, bao gồm ví dụ mã và tùy chọn cấu hình. ## Phần kết luận diff --git a/html/vietnamese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md b/html/vietnamese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md new file mode 100644 index 000000000..d0c818517 --- /dev/null +++ b/html/vietnamese/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/_index.md @@ -0,0 +1,258 @@ +--- +category: general +date: 2026-05-22 +description: Chuyển đổi HTML sang PDF trong C# bằng Aspose.HTML. Tìm hiểu cách render + HTML sang PDF trong C# với mã từng bước, các tùy chọn và gợi ý cho Linux. +draft: false +keywords: +- convert html to pdf +- how to render html to pdf in c# +language: vi +og_description: Chuyển đổi HTML sang PDF trong C# với Aspose.HTML. Hướng dẫn này chỉ + cách render HTML sang PDF trong C# bằng các tùy chọn rõ ràng và gợi ý thân thiện + với Linux. +og_title: Chuyển đổi HTML sang PDF bằng C# – Hướng dẫn đầy đủ +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + headline: Convert HTML to PDF with C# – Complete Guide + type: TechArticle +- description: Convert HTML to PDF in C# using Aspose.HTML. Learn how to render HTML + to PDF in C# with step‑by‑step code, options, and Linux hinting. + name: Convert HTML to PDF with C# – Complete Guide + steps: + - name: Why This Works + text: '- **`Document`** is Aspose.HTML’s entry point; it parses the HTML, resolves + CSS, and builds a DOM ready for rendering. - **`PdfRenderingOptions`** lets + you tweak the output. The `UseHinting` flag is the secret sauce for crisp text + on headless Linux containers where the default rasterizer can look fu' + - name: – Install the Aspose.HTML NuGet Package + text: 'Open your terminal in the project folder and execute:' + - name: – Load Your HTML Correctly + text: 'Aspose.HTML can ingest:' + - name: – Choose the Right Rendering Options + text: 'Aside from `UseHinting`, you might want to adjust:' + - name: – Save the PDF + text: 'The `Save` method overload you see in the full example writes directly + to a file path. You can also stream the PDF to memory:' + - name: – Verify the Output + text: 'A quick sanity check is to compare the PDF page count with the expected + number of HTML sections. You can read it back with Aspose.PDF:' + type: HowTo +tags: +- Aspose.HTML +- C# +- PDF generation +title: Chuyển đổi HTML sang PDF bằng C# – Hướng dẫn đầy đủ +url: /vi/net/html-extensions-and-conversions/convert-html-to-pdf-with-c-complete-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Chuyển đổi HTML sang PDF với C# – Hướng dẫn đầy đủ + +Nếu bạn cần **convert HTML to PDF** nhanh chóng, Aspose.HTML for .NET sẽ giúp việc này trở nên dễ dàng. Trong hướng dẫn này, chúng tôi cũng sẽ trả lời **how to render HTML to PDF in C#** với khả năng kiểm soát đầy đủ các tùy chọn render, vì vậy bạn sẽ không còn phải đoán mò. + +Hãy tưởng tượng bạn có một mẫu email marketing, một trang biên lai, hoặc một báo cáo phức tạp được xây dựng bằng CSS hiện đại, và bạn phải chuyển nó thành PDF cho khách hàng hoặc máy in. Thực hiện thủ công là rất phiền phức, nhưng chỉ với vài dòng mã C# bạn có thể tự động hoá toàn bộ quy trình. Khi hoàn thành hướng dẫn này, bạn sẽ có một giải pháp tự chứa, sẵn sàng cho môi trường production, hoạt động trên Windows *và* Linux. + +## Những gì bạn cần + +- **.NET 6.0 hoặc mới hơn** – Aspose.HTML nhắm tới .NET Standard 2.0+, vì vậy bất kỳ SDK gần đây nào cũng hoạt động. +- **Aspose.HTML for .NET** gói NuGet (`Aspose.Html`) – bạn sẽ cần một giấy phép hợp lệ cho môi trường production, nhưng bản dùng thử miễn phí vẫn hoạt động cho việc thử nghiệm. +- Một **tệp HTML đơn giản** mà bạn muốn chuyển thành PDF (chúng tôi sẽ gọi nó là `input.html`). +- IDE yêu thích của bạn (Visual Studio, Rider, hoặc VS Code) – không cần công cụ đặc biệt. + +Chỉ vậy thôi. Không cần bộ chuyển đổi PDF bên ngoài, không cần các thao tác phức tạp trên dòng lệnh. Chỉ cần C# thuần. + +![Diagram illustrating the convert html to pdf workflow using Aspose.HTML](/images/convert-html-to-pdf-workflow.png "convert html to pdf workflow") + +## Chuyển đổi HTML sang PDF – Triển khai đầy đủ + +Dưới đây là chương trình hoàn chỉnh, sẵn sàng chạy. Sao chép‑dán nó vào một ứng dụng console mới, khôi phục các gói NuGet, và nhấn **F5**. + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // --------------------------------------------------------- + // Step 1: Load the HTML document you want to convert. + // --------------------------------------------------------- + // Replace the path with the folder that holds your input.html. + string inputPath = @"YOUR_DIRECTORY\input.html"; + Document htmlDoc = new Document(inputPath); + + // --------------------------------------------------------- + // Step 2: Configure PDF rendering options. + // --------------------------------------------------------- + // Enabling hinting improves glyph clarity, especially on Linux. + PdfRenderingOptions pdfOptions = new PdfRenderingOptions + { + UseHinting = true, // Clears up text rendering + PageSize = PdfPageSize.A4, // Standard page size + Landscape = false // Portrait orientation + }; + + // --------------------------------------------------------- + // Step 3: Save the rendered PDF. + // --------------------------------------------------------- + string outputPath = @"YOUR_DIRECTORY\output.pdf"; + htmlDoc.Save(outputPath, pdfOptions); + + Console.WriteLine($"✅ HTML successfully converted to PDF at: {outputPath}"); + } + } +} +``` + +### Tại sao điều này hoạt động + +- **`Document`** là điểm vào của Aspose.HTML; nó phân tích HTML, giải quyết CSS, và xây dựng một DOM sẵn sàng để render. +- **`PdfRenderingOptions`** cho phép bạn tinh chỉnh đầu ra. Cờ `UseHinting` là bí quyết để có văn bản sắc nét trên các container Linux không giao diện, nơi rasterizer mặc định có thể bị mờ. +- **`Save`** thực hiện công việc nặng: nó rasterize DOM lên các trang PDF, tôn trọng các ngắt trang, và tự động nhúng phông chữ. + +Chạy chương trình sẽ tạo ra `output.pdf` ngay bên cạnh tệp nguồn của bạn. Mở nó bằng bất kỳ trình xem PDF nào và bạn sẽ thấy một bản sao hình ảnh trung thực của HTML gốc. + +## Cách render HTML sang PDF trong C# – Bước‑bước + +Dưới đây chúng tôi chia quy trình thành các phần nhỏ, giải thích **how to render HTML to PDF in C#** đồng thời đề cập đến các vấn đề thường gặp. + +### Bước 1 – Cài đặt gói NuGet Aspose.HTML + +Mở terminal trong thư mục dự án và thực thi: + +```bash +dotnet add package Aspose.Html +``` + +Nếu bạn thích giao diện Visual Studio, nhấp chuột phải vào dự án → **Manage NuGet Packages** → tìm kiếm **Aspose.Html** và cài đặt phiên bản ổn định mới nhất. + +> **Pro tip:** Sau khi cài đặt, thêm tệp giấy phép (`Aspose.Total.lic`) vào thư mục gốc của dự án để tránh các dấu nước đánh giá. + +### Bước 2 – Tải HTML của bạn một cách chính xác + +Aspose.HTML có thể tiếp nhận: + +- Đường dẫn tệp cục bộ (`new Document("file.html")`) +- URL (`new Document("https://example.com")`) +- Chuỗi HTML thô (`new Document("…", new HtmlLoadOptions())`) + +Khi bạn tải từ hệ thống tệp, hãy đảm bảo đường dẫn là tuyệt đối hoặc thư mục làm việc được đặt đúng, nếu không bạn sẽ gặp `FileNotFoundException`. Trên Linux, sử dụng dấu gạch chéo (`/`) hoặc `Path.Combine`. + +### Bước 3 – Chọn các tùy chọn render phù hợp + +Ngoài `UseHinting`, bạn có thể muốn điều chỉnh: + +| Option | Chức năng | Khi nên sử dụng | +|--------|-----------|-----------------| +| `PageSize` | Đặt kích thước trang PDF (A4, Letter, tùy chỉnh) | Phù hợp với kích thước giấy mục tiêu | +| `Landscape` | Xoay trang sang chế độ ngang | Bảng hoặc biểu đồ rộng | +| `RasterizeVectorGraphics` | Buộc đồ họa vector thành ảnh raster | Khi người nhận PDF không hỗ trợ SVG | +| `CompressionLevel` | Kiểm soát mức nén ảnh (0‑9) | Giảm kích thước tệp cho email đính kèm | + +Bạn có thể nối các thuộc tính này một cách lưu loát: + +```csharp +var pdfOptions = new PdfRenderingOptions +{ + UseHinting = true, + PageSize = PdfPageSize.Letter, + Landscape = true, + CompressionLevel = 6 +}; +``` + +### Bước 4 – Lưu PDF + +Phương thức `Save` overload bạn thấy trong ví dụ đầy đủ ghi trực tiếp vào đường dẫn tệp. Bạn cũng có thể stream PDF vào bộ nhớ: + +```csharp +using (var stream = new MemoryStream()) +{ + htmlDoc.Save(stream, pdfOptions); + // stream now contains the PDF bytes – perfect for ASP.NET responses +} +``` + +Điều này hữu ích khi bạn cần trả về PDF dưới dạng tải xuống từ một API web. + +### Bước 5 – Xác minh đầu ra + +Một kiểm tra nhanh là so sánh số trang PDF với số phần HTML mong đợi. Bạn có thể đọc lại bằng Aspose.PDF: + +```csharp +using Aspose.Pdf; +var pdfDoc = new Document(outputPath); +Console.WriteLine($"PDF contains {pdfDoc.Pages.Count} pages."); +``` + +Nếu số lượng trang không khớp, hãy xem lại các quy tắc CSS `page-break` hoặc điều chỉnh `PdfRenderingOptions` cho phù hợp. + +## Các trường hợp đặc biệt & Những lỗi thường gặp + +| Tình huống | Điều cần chú ý | Cách khắc phục | +|-----------|----------------|----------------| +| **Thiếu tài nguyên bên ngoài (hình ảnh, phông chữ)** | Các URL tương đối được giải quyết dựa trên thư mục của tệp HTML. | Sử dụng `HtmlLoadOptions.BaseUri` để chỉ đến thư mục gốc đúng. | +| **Môi trường Linux không giao diện** | Render văn bản mặc định có thể bị mờ. | Đặt `UseHinting = true` (như đã chỉ) và đảm bảo cài đặt `libgdiplus` nếu bạn quay lại System.Drawing. | +| **HTML lớn (> 10 MB)** | Tiêu thụ bộ nhớ tăng đột biến trong quá trình render. | Render từng trang bằng `PdfRenderer` với `PdfRenderingOptions` và giải phóng mỗi trang sau khi lưu. | +| **Trang web nặng JavaScript** | Aspose.HTML không thực thi JS; nội dung động sẽ tĩnh. | Tiền xử lý HTML phía server (ví dụ, dùng Puppeteer) trước khi đưa vào Aspose.HTML. | +| **Ký tự Unicode hiển thị dưới dạng hình vuông** | Thiếu phông chữ trong môi trường runtime. | Nhúng phông chữ tùy chỉnh qua `FontSettings` hoặc đảm bảo hệ điều hành có cài đặt các phông chữ cần thiết. | + +## Tổng kết ví dụ hoạt động đầy đủ + +Dưới đây là toàn bộ chương trình một lần nữa, đã loại bỏ các chú thích cho những ai muốn xem phiên bản ngắn gọn: + +```csharp +using System; +using Aspose.Html; +using Aspose.Html.Rendering.Pdf; + +class Program +{ + static void Main() + { + var doc = new Document(@"YOUR_DIRECTORY\input.html"); + var options = new PdfRenderingOptions + { + UseHinting = true, + PageSize = PdfPageSize.A4, + Landscape = false + }; + doc.Save(@"YOUR_DIRECTORY\output.pdf", options); + Console.WriteLine("PDF created successfully."); + } +} +``` + +Chạy nó, mở `output.pdf`, và bạn sẽ thấy một bản sao pixel‑perfect của `input.html`. Đó là cốt lõi của **convert html to pdf** với Aspose.HTML. + +## Kết luận + +Chúng tôi đã hướng dẫn toàn bộ những gì bạn cần để **convert HTML to PDF** trong C#: cài đặt Aspose.HTML, tải HTML, tinh chỉnh các tùy chọn render (bao gồm cờ quan trọng `UseHinting`), và lưu PDF cuối cùng. Bây giờ bạn đã hiểu **how to render HTML to PDF in C#** cho cả môi trường Windows và Linux, và bạn đã thấy cách xử lý các trường hợp đặc biệt thường gặp như thiếu tài nguyên và tệp lớn. + +Tiếp theo? Hãy thử thêm: + +- **Headers/footers** với `PdfPageTemplate` để tạo thương hiệu. +- **Password protection** qua `PdfSaveOptions`. +- **Batch conversion** bằng cách lặp qua một thư mục chứa + +## Các hướng dẫn liên quan + +- [Convert HTML to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Convert EPUB to PDF in .NET with Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-epub-to-pdf/) +- [Convert SVG to PDF in .NET with Aspose.HTML](/html/english/net/canvas-and-image-manipulation/convert-svg-to-pdf/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/vietnamese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md b/html/vietnamese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md new file mode 100644 index 000000000..62d6e338b --- /dev/null +++ b/html/vietnamese/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/_index.md @@ -0,0 +1,293 @@ +--- +category: general +date: 2026-05-22 +description: Render HTML thành PDF bằng C# với ví dụ ngắn gọn. Tìm hiểu cách chuyển + đổi HTML sang PDF trong C# một cách nhanh chóng và đáng tin cậy. +draft: false +keywords: +- render html as pdf +- convert html to pdf c# +- generate pdf from html file +- create pdf from html c# +- save html document as pdf +language: vi +og_description: Render HTML thành PDF trong C# với ví dụ rõ ràng, có thể chạy được. + Hướng dẫn này cho bạn biết cách chuyển đổi HTML sang PDF trong C# và tạo PDF từ + tệp HTML. +og_title: Chuyển đổi HTML sang PDF trong C# – Hướng dẫn lập trình toàn diện +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + headline: Render HTML as PDF in C# – Full Step‑by‑Step Guide + type: TechArticle +- description: Render HTML as PDF using C# with a concise example. Learn how to convert + HTML to PDF C# quickly and reliably. + name: Render HTML as PDF in C# – Full Step‑by‑Step Guide + steps: + - name: Install the PDF rendering library (convert html to pdf c#) + text: 'Open a terminal in your project folder and run:' + - name: Create a console skeleton + text: '```csharp using System; using SelectPdf; // <-- the rendering namespace' + - name: Expected output + text: 'After running the program you should see a file `output.pdf` in the same + folder. Open it—you’ll notice:' + - name: 1. External resources blocked by firewalls + text: If your HTML references fonts hosted on a CDN that your server can’t reach, + the PDF may fall back to a generic font. To avoid this, either download the + font files locally or embed them using `@font-face` with a relative path. + - name: 2. Very large HTML files + text: 'When converting massive documents, you might hit memory limits. Select.Pdf + lets you stream the conversion:' + - name: 3. Custom headers or footers + text: If you need a page number or company logo on every page, set the `Header` + and `Footer` properties on `converter.Options` before calling `ConvertUrl`. + type: HowTo +tags: +- C# +- PDF +- HTML +title: Chuyển đổi HTML sang PDF trong C# – Hướng dẫn chi tiết từng bước +url: /vi/net/html-extensions-and-conversions/render-html-as-pdf-in-c-full-step-by-step-guide/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Render HTML thành PDF trong C# – Hướng dẫn chi tiết từng bước + +Bạn đã bao giờ cần **render HTML as PDF** nhưng không chắc thư viện nào nên chọn cho dự án .NET? Bạn không phải là người duy nhất. Trong nhiều ứng dụng doanh nghiệp, bạn sẽ cần **convert HTML to PDF C#** cho hoá đơn, báo cáo, hoặc brochure marketing — cơ bản là bất cứ khi nào bạn muốn một phiên bản có thể in được của một trang web. + +Thực ra, bạn không cần phải tự phát minh lại bánh xe. Chỉ với vài dòng code, bạn có thể lấy một tệp `input.html`, đưa nó cho một engine render đã được chứng minh, và nhận được một tệp `output.pdf` sắc nét. Trong hướng dẫn này, chúng tôi sẽ đi qua toàn bộ quá trình, từ việc thêm gói NuGet phù hợp đến xử lý các trường hợp đặc biệt như CSS bên ngoài. Khi kết thúc, bạn sẽ có thể **generate PDF from HTML file** trong vài phút. + +## Những gì bạn sẽ học + +- Cách thiết lập một ứng dụng console .NET mà **creates PDF from HTML C#**. +- Các lời gọi API chính xác bạn cần để **save HTML document as PDF**. +- Tại sao một số tùy chọn render (như hinting) lại quan trọng đối với chất lượng văn bản. +- Mẹo khắc phục các vấn đề thường gặp như thiếu phông chữ hoặc đường dẫn ảnh tương đối. + +**Prerequisites** – bạn nên có .NET 6+ hoặc .NET Framework 4.7 đã cài đặt, có kiến thức cơ bản về C#, và một IDE (Visual Studio 2022, Rider, hoặc VS Code). Không cần kinh nghiệm PDF trước. + +--- + +## Render HTML thành PDF – Cài đặt dự án + +Trước khi chúng ta bắt đầu viết code, hãy chắc chắn môi trường phát triển đã sẵn sàng. Thư viện chúng ta sẽ dùng là **Select.Pdf** (miễn phí cho mục đích không thương mại) vì nó cung cấp API đơn giản và độ chính xác render tốt. + +### Cài đặt thư viện render PDF (convert html to pdf c#) + +Mở terminal trong thư mục dự án của bạn và chạy: + +```bash +dotnet add package Select.Pdf --version 30.0.0 +``` + +*Pro tip:* Nếu bạn đang dùng Visual Studio, bạn cũng có thể thêm gói qua giao diện NuGet Package Manager. Số phiên bản có thể mới hơn — chỉ cần lấy bản phát hành ổn định mới nhất. + +### Tạo khung console + +```csharp +using System; +using SelectPdf; // <-- the rendering namespace + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // We'll fill this in shortly + } + } +} +``` + +Đó là toàn bộ mã khởi tạo bạn cần. Công việc nặng sẽ diễn ra bên trong `Main`. + +## Tải tài liệu HTML (generate pdf from html file) + +Bước thực tế đầu tiên là chỉ định cho renderer một tệp HTML trên đĩa. Select.Pdf cung cấp hai cách tiện lợi: truyền chuỗi HTML thô hoặc một đường dẫn tệp. Sử dụng tệp giúp mọi thứ gọn gàng, đặc biệt khi bạn có CSS hoặc hình ảnh liên kết. + +```csharp +// Step 1: Load the HTML document from disk +string htmlPath = @"YOUR_DIRECTORY\input.html"; + +if (!System.IO.File.Exists(htmlPath)) +{ + Console.WriteLine($"Error: {htmlPath} not found."); + return; +} + +// The HtmlToPdf converter will read the file directly +HtmlToPdf converter = new HtmlToPdf(); +``` + +Ở đây chúng tôi cũng kiểm tra trường hợp tệp bị thiếu — điều mà thường làm người mới bối rối khi quên sao chép HTML vào thư mục output. + +## Cấu hình tùy chọn render (create pdf from html c#) + +Select.Pdf đi kèm với một đối tượng `PdfDocumentOptions` phong phú. Để có văn bản sắc nét, chúng tôi bật hinting, giúp làm mượt glyphs với một chi phí hiệu năng rất nhỏ. + +```csharp +// Step 2: Configure PDF rendering options (better text quality with hinting) +PdfDocumentOptions pdfOptions = converter.Options; +pdfOptions.UseTextHinting = true; // equivalent to UseHinting in other libs +pdfOptions.PdfPageSize = PdfPageSize.A4; +pdfOptions.PdfPageOrientation = PdfPageOrientation.Portrait; +``` + +Bạn có thể điều chỉnh kích thước trang, lề, hoặc thậm chí nhúng phông chữ tùy chỉnh ở đây. Điều quan trọng là **render html as pdf** không chỉ là một dòng lệnh; bạn có quyền kiểm soát giao diện và cảm giác của tài liệu cuối cùng. + +## Lưu tài liệu HTML thành PDF (render html as pdf) + +Bây giờ phép màu diễn ra. Chúng tôi đưa cho converter đường dẫn tới tệp HTML và yêu cầu nó ghi một PDF ra đĩa. + +```csharp +// Step 3: Render the HTML and save it as a PDF +string pdfPath = @"YOUR_DIRECTORY\output.pdf"; +PdfDocument doc = converter.ConvertUrl(htmlPath); // reads the file and any linked resources + +doc.Save(pdfPath); +doc.Close(); + +Console.WriteLine($"Success! PDF saved to {pdfPath}"); +``` + +Phương thức `ConvertUrl` tự động giải quyết các URL tương đối (hình ảnh, CSS) dựa trên vị trí của tệp HTML, vì vậy cách tiếp cận này mạnh mẽ cho hầu hết các tình huống thực tế. + +### Kết quả mong đợi + +Sau khi chạy chương trình, bạn sẽ thấy một tệp `output.pdf` trong cùng thư mục. Mở nó — bạn sẽ nhận thấy: + +- Văn bản được render với anti‑aliasing rõ ràng (cảm ơn hinting). +- Các kiểu từ CSS liên kết được áp dụng đúng. +- Hình ảnh hiển thị với kích thước chính xác như trong HTML nguồn. + +Nếu có gì không đúng, hãy kiểm tra lại rằng các tệp CSS và hình ảnh được đặt cùng bên `input.html` hoặc sử dụng URL tuyệt đối. + +## Xử lý các trường hợp đặc biệt thường gặp + +### 1. Tài nguyên bên ngoài bị chặn bởi tường lửa + +Nếu HTML của bạn tham chiếu tới phông chữ được lưu trên CDN mà máy chủ của bạn không thể truy cập, PDF có thể sẽ dùng phông chữ mặc định. Để tránh điều này, bạn có thể tải các tệp phông chữ về máy hoặc nhúng chúng bằng `@font-face` với đường dẫn tương đối. + +```css +@font-face { + font-family: 'OpenSans'; + src: url('fonts/OpenSans-Regular.ttf') format('truetype'); +} +``` + +### 2. Các tệp HTML rất lớn + +Khi chuyển đổi các tài liệu khổng lồ, bạn có thể gặp giới hạn bộ nhớ. Select.Pdf cho phép bạn stream quá trình chuyển đổi: + +```csharp +PdfDocument doc = converter.ConvertHtmlString(htmlString, baseUrl); +``` + +### 3. Header hoặc Footer tùy chỉnh + +Nếu bạn cần số trang hoặc logo công ty trên mỗi trang, hãy thiết lập các thuộc tính `Header` và `Footer` trên `converter.Options` trước khi gọi `ConvertUrl`. + +```csharp +converter.Options.DisplayHeader = true; +converter.Header.DisplayOnFirstPage = true; +converter.Header.Add(new PdfTextElement(0, 0, "My Company Report", new PdfStandardFont(PdfStandardFontFamily.Helvetica, 12))); +``` + +## Ví dụ hoàn chỉnh (Tất cả các bước kết hợp) + +Dưới đây là chương trình hoàn chỉnh, sẵn sàng sao chép và dán. Thay thế `YOUR_DIRECTORY` bằng đường dẫn tuyệt đối nơi HTML của bạn nằm. + +```csharp +using System; +using SelectPdf; // PDF rendering library + +namespace HtmlToPdfDemo +{ + class Program + { + static void Main(string[] args) + { + // ----------------------------------------------------------------- + // 1️⃣ Load the HTML document (generate pdf from html file) + // ----------------------------------------------------------------- + string htmlPath = @"YOUR_DIRECTORY\input.html"; + + if (!System.IO.File.Exists(htmlPath)) + { + Console.WriteLine($"Error: HTML file not found at {htmlPath}"); + return; + } + + // ----------------------------------------------------------------- + // 2️⃣ Create the converter and set options (create pdf from html c#) + // ----------------------------------------------------------------- + HtmlToPdf converter = new HtmlToPdf(); + + // Enable hinting for sharper text – this is the core of render html as pdf + PdfDocumentOptions opts = converter.Options; + opts.UseTextHinting = true; + opts.PdfPageSize = PdfPageSize.A4; + opts.PdfPageOrientation = PdfPageOrientation.Portrait; + + // Optional: add a header/footer, margins, etc. + // opts.DisplayHeader = true; // example + + // ----------------------------------------------------------------- + // 3️⃣ Convert and save (save html document as pdf) + // ----------------------------------------------------------------- + try + { + PdfDocument pdf = converter.ConvertUrl(htmlPath); + string pdfPath = @"YOUR_DIRECTORY\output.pdf"; + pdf.Save(pdfPath); + pdf.Close(); + + Console.WriteLine($"✅ PDF generated successfully: {pdfPath}"); + } + catch (Exception ex) + { + Console.WriteLine($"❌ Conversion failed: {ex.Message}"); + } + } + } +} +``` + +**Run it:** `dotnet run` từ thư mục dự án. Nếu mọi thứ đã được cấu hình đúng, bạn sẽ thấy thông báo thành công và một tệp `output.pdf` sáng bóng. + +## Tóm tắt bằng hình ảnh + +![Render HTML as PDF example](render-html-as-pdf.png){alt="ví dụ render html thành pdf"} + +Ảnh chụp màn hình hiển thị đầu ra console và PDF kết quả được mở trong trình xem. Lưu ý các tiêu đề sắc nét và hình ảnh được tải đúng — chính xác những gì bạn mong đợi khi **render html as pdf**. + +## Kết luận + +Bạn vừa học cách **render HTML as PDF** trong một ứng dụng C#, từ việc cài đặt thư viện đến tinh chỉnh các tùy chọn render. Ví dụ đầy đủ minh họa cách đáng tin cậy để **convert HTML to PDF C#**, **generate PDF from HTML file**, và **save HTML document as PDF** chỉ với vài dòng code. + +Tiếp theo gì? Hãy thử nghiệm với: + +- Thêm phông chữ tùy chỉnh để đồng nhất thương hiệu. +- Tạo PDF từ chuỗi HTML động (ví dụ, Razor templates). +- Gộp nhiều PDF thành một báo cáo duy nhất bằng `PdfDocument.AddPage`. + +Mỗi phần mở rộng này dựa trên các khái niệm cốt lõi đã trình bày, vì vậy bạn sẽ sẵn sàng đối mặt với các kịch bản nâng cao hơn mà không gặp khó khăn. + +Có câu hỏi hoặc gặp vấn đề? Để lại bình luận bên dưới, và chúng ta sẽ cùng khắc phục. Chúc lập trình vui vẻ! + +## Các hướng dẫn liên quan + +- [Chuyển đổi HTML sang PDF trong .NET với Aspose.HTML](/html/english/net/html-extensions-and-conversions/convert-html-to-pdf/) +- [Tạo tài liệu HTML với văn bản có kiểu và xuất ra PDF – Hướng dẫn đầy đủ](/html/english/net/html-extensions-and-conversions/create-html-document-with-styled-text-and-export-to-pdf-full/) +- [Chuyển đổi HTML sang PDF với Aspose.HTML – Hướng dẫn thao tác đầy đủ](/html/english/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/html/vietnamese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md b/html/vietnamese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md new file mode 100644 index 000000000..120416e33 --- /dev/null +++ b/html/vietnamese/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/_index.md @@ -0,0 +1,227 @@ +--- +category: general +date: 2026-05-22 +description: Lưu HTML dưới dạng ZIP nhanh chóng bằng Aspose.HTML. Tìm hiểu cách nén + các tệp HTML, chuyển đổi HTML sang ZIP và xuất HTML thành tệp ZIP với mã đầy đủ. +draft: false +keywords: +- save html as zip +- how to zip html files +- render html to zip +- export html to zip file +- convert html to zip archive +language: vi +og_description: Lưu HTML dưới dạng ZIP với Aspose.HTML. Hướng dẫn này chỉ cách chuyển + đổi HTML thành ZIP, xuất HTML ra tệp ZIP và nén các tệp HTML một cách lập trình. +og_title: Lưu HTML dưới dạng ZIP – Hướng dẫn đầy đủ Aspose.HTML +schemas: +- author: Aspose + dateModified: '2026-05-22' + description: Save HTML as ZIP quickly using Aspose.HTML. Learn how to zip HTML files, + render HTML to ZIP, and export HTML to a ZIP file with full code. + headline: Save HTML as ZIP – Complete Guide for Aspose.HTML + type: TechArticle +tags: +- Aspose.HTML +- C# +- file‑compression +title: Lưu HTML dưới dạng ZIP – Hướng dẫn đầy đủ cho Aspose.HTML +url: /vi/net/html-extensions-and-conversions/save-html-as-zip-complete-guide-for-aspose-html/ +--- + +{{< blocks/products/pf/main-wrap-class >}} +{{< blocks/products/pf/main-container >}} +{{< blocks/products/pf/tutorial-page-section >}} + +# Lưu HTML dưới dạng ZIP – Hướng dẫn đầy đủ cho Aspose.HTML + +Bạn đã bao giờ tự hỏi làm sao **lưu HTML dưới dạng ZIP** mà không cần dùng công cụ nén riêng? Bạn không phải là người duy nhất. Nhiều nhà phát triển cần đóng gói một trang HTML cùng với hình ảnh, CSS và script để phân phối dễ dàng, và việc làm thủ công nhanh chóng trở thành điểm đau. + +Trong tutorial này, chúng ta sẽ đi qua một giải pháp sạch sẽ, từ đầu tới cuối để **render HTML thành ZIP** bằng Aspose.HTML cho .NET. Khi hoàn thành, bạn sẽ biết chính xác cách **xuất HTML ra file ZIP**, và cũng sẽ thấy các biến thể cho **cách nén HTML thành ZIP** trong các kịch bản khác nhau. + +> *Mẹo chuyên nghiệp:* Cách tiếp cận này hoạt động dù bạn đang đóng gói một trang đơn hay toàn bộ thư mục site. + +## Những gì bạn cần + +Trước khi bắt đầu, hãy chắc chắn rằng bạn có: + +- .NET 6 (hoặc bất kỳ runtime .NET nào mới hơn) đã được cài đặt. +- Gói NuGet Aspose.HTML cho .NET (`Aspose.Html`) đã được tham chiếu trong dự án. +- Một file `input.html` đơn giản nằm trong thư mục bạn kiểm soát. +- Kiến thức cơ bản về C#—không cần gì phức tạp, chỉ cần những kiến thức nền tảng. + +Đó là tất cả. Không cần công cụ nén bên ngoài, không cần thao tác dòng lệnh. Hãy bắt đầu. + +![Diagram showing the process of saving HTML as ZIP using Aspose.HTML](save-html-as-zip.png) + +*Văn bản thay thế ảnh: sơ đồ quy trình lưu HTML thành ZIP bằng Aspose.HTML* + +## Bước 1: Tải tài liệu HTML nguồn + +Điều đầu tiên chúng ta phải làm là cho Aspose.HTML biết nguồn HTML của chúng ta nằm ở đâu. Lớp `HTMLDocument` đọc file và xây dựng một DOM trong bộ nhớ, sẵn sàng để render. + +```csharp +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +// Load the HTML file from disk +var document = new HTMLDocument(@"C:\MySite\input.html"); +``` + +Tại sao điều này quan trọng: việc tải tài liệu cho phép thư viện kiểm soát hoàn toàn việc giải quyết tài nguyên (hình ảnh, CSS, font). Nếu HTML tham chiếu các đường dẫn tương đối, Aspose.HTML sẽ tự động giải quyết chúng dựa trên thư mục của file. + +## Bước 2: (Tùy chọn) Tạo một Resource Handler tùy chỉnh + +Nếu bạn cần kiểm tra hoặc thao tác mỗi tài nguyên—ví dụ muốn nén hình ảnh trước khi đưa vào archive—bạn có thể gắn một `ResourceHandler`. Bước này là tùy chọn, nhưng là cách linh hoạt nhất để **chuyển đổi HTML thành ZIP archive** với logic tùy chỉnh. + +```csharp +// Define a custom handler that captures each resource in a memory stream +class MyResourceHandler : ResourceHandler +{ + public override Stream HandleResource(ResourceInfo info) + { + // Here you could modify the stream, e.g., resize images. + // For now we just return an empty stream placeholder. + return new MemoryStream(); + } +} +``` + +*Nếu bạn không cần xử lý đặc biệt?* Chỉ cần bỏ qua lớp này và sử dụng handler mặc định—Aspose.HTML sẽ ghi các tài nguyên trực tiếp vào ZIP. + +## Bước 3: Cấu hình Save Options để sử dụng Handler + +Đối tượng `HtmlSaveOptions` chỉ định cho renderer cách xử lý các tài nguyên. Bằng cách gán `MyResourceHandler` của chúng ta, chúng ta có toàn quyền kiểm soát đầu ra. + +```csharp +var saveOptions = new HtmlSaveOptions +{ + // Plug in the custom handler; replace with `new ResourceHandler()` if you don’t need custom logic + ResourceHandler = new MyResourceHandler() +}; +``` + +Chú ý cách thuộc tính `ResourceHandler` trực tiếp liên kết với khả năng **render HTML to ZIP**. Đây là nơi phép thuật xảy ra: mọi tài nguyên được liên kết sẽ được stream vào archive thay vì ghi ra đĩa. + +## Bước 4: Lưu tài liệu đã render vào một ZIP Archive + +Bây giờ chúng ta cuối cùng **xuất HTML ra file ZIP**. Phương thức `Save` chấp nhận bất kỳ `Stream` nào, vì vậy chúng ta có thể trỏ nó tới một `FileStream` tạo ra `result.zip`. + +```csharp +// Create (or overwrite) the ZIP file on disk +using (var zipStream = new FileStream(@"C:\MySite\result.zip", FileMode.Create)) +{ + document.Save(zipStream, saveOptions); +} +``` + +Đó là toàn bộ quy trình. Khi code kết thúc, `result.zip` sẽ chứa: + +- `input.html` (mã gốc) +- Tất cả các hình ảnh, file CSS và font được tham chiếu +- Bất kỳ tài nguyên đã được chuyển đổi nếu bạn đã tùy chỉnh chúng trong `MyResourceHandler` + +## Cách nén HTML thành ZIP mà không dùng Aspose.HTML (Giải pháp nhanh) + +Đôi khi bạn chỉ cần một cách **cách nén HTML thành ZIP** đơn giản, có thể vì bạn đang dùng một parser HTML khác. Trong trường hợp đó, bạn có thể sử dụng `System.IO.Compression` tích hợp sẵn của .NET: + +```csharp +using System.IO.Compression; + +// Assume the folder contains input.html and its assets +ZipFile.CreateFromDirectory(@"C:\MySite", @"C:\MySite\archive.zip"); +``` + +Phương pháp này đơn giản nhưng thiếu bước render; nó chỉ đóng gói những gì có trên đĩa. Nếu HTML của bạn tham chiếu các URL bên ngoài, các tài nguyên đó sẽ không được bao gồm. Vì vậy, cách dùng Aspose.HTML được ưu tiên khi bạn cần một giải pháp **render HTML to ZIP** đáng tin cậy. + +## Các trường hợp đặc biệt & Những lỗi thường gặp + +| Tình huống | Điều cần chú ý | Giải pháp đề xuất | +|-----------|-------------------|-----------------| +| **Hình ảnh lớn** | Sử dụng bộ nhớ tăng cao vì mỗi hình ảnh được tải vào một `MemoryStream`. | Stream trực tiếp vào zip bằng một handler tùy chỉnh sao chép stream nguồn thay vì buffer toàn bộ. | +| **URL bên ngoài** | Các tài nguyên trên internet không được tải tự động. | Đặt `HtmlLoadOptions` với `BaseUrl` trỏ tới root của site, hoặc tải tài nguyên thủ công trước khi lưu. | +| **Xung đột tên file** | Hai file CSS cùng tên trong các thư mục con khác nhau có thể ghi đè lên nhau. | Đảm bảo `ResourceHandler` giữ nguyên đường dẫn tương đối đầy đủ khi ghi vào zip. | +| **Lỗi quyền** | Cố ghi vào thư mục chỉ đọc sẽ gây `UnauthorizedAccessException`. | Chạy quá trình với quyền thích hợp hoặc chọn thư mục đầu ra có thể ghi. | + +Xử lý các kịch bản này sẽ làm cho quy trình **chuyển đổi HTML thành ZIP archive** của bạn trở nên vững chắc cho môi trường production. + +## Ví dụ đầy đủ (Tất cả các phần cùng nhau) + +Dưới đây là chương trình hoàn chỉnh, sẵn sàng chạy. Dán vào một ứng dụng console mới, cập nhật đường dẫn, và nhấn **F5**. + +```csharp +using System; +using System.IO; +using Aspose.Html; +using Aspose.Html.Saving; + +class Program +{ + // Optional custom handler – you can remove this class if you don’t need custom logic + class MyResourceHandler : ResourceHandler + { + public override Stream HandleResource(ResourceInfo info) + { + // Example: simply forward the original stream (no modification) + return info.Stream; // keep original resource + } + } + + static void Main() + { + // 1️⃣ Load the HTML document + var htmlPath = @"C:\MySite\input.html"; + var document = new HTMLDocument(htmlPath); + + // 2️⃣ Configure save options (use custom handler or default) + var options = new HtmlSaveOptions + { + ResourceHandler = new MyResourceHandler() // replace with new ResourceHandler() for default behavior + }; + + // 3️⃣ Save to ZIP archive + var zipPath = @"C:\MySite\result.zip"; + using (var zipStream = new FileStream(zipPath, FileMode.Create)) + { + document.Save(zipStream, options); + } + + Console.WriteLine($"Successfully saved HTML as ZIP: {zipPath}"); + } +} +``` + +**Kết quả mong đợi:** Console sẽ in thông báo thành công, và file `result.zip` sẽ chứa `input.html` cùng mọi tài nguyên phụ thuộc. Mở ZIP, nhấp đúp `input.html`, bạn sẽ thấy trang được render chính xác như trong trình duyệt—không thiếu hình ảnh, không CSS bị gãy. + +## Tóm tắt – Tại sao cách tiếp cận này tuyệt vời + +- **Render một bước:** Bạn không cần sao chép từng tài nguyên thủ công; Aspose.HTML làm điều đó cho bạn. +- **Pipeline tùy chỉnh:** `ResourceHandler` cho phép bạn kiểm soát hoàn toàn cách mỗi file được lưu, hỗ trợ nén, mã hoá, hoặc biến đổi ngay lúc tạo. +- **Đa nền tảng:** Hoạt động trên Windows, Linux và macOS miễn là có runtime .NET. +- **Không công cụ bên ngoài:** Toàn bộ quá trình **save HTML as ZIP** diễn ra trong code C# của bạn. + +## Tiếp theo là gì? + +Bây giờ bạn đã thành thạo **save HTML as ZIP**, hãy khám phá các chủ đề liên quan: + +- **Export HTML to PDF** – hoàn hảo cho báo cáo có thể in (kiến thức `export html to zip file` sẽ hữu ích khi bạn cần cả hai định dạng). +- **Streaming ZIP trực tiếp tới HTTP response** – tuyệt vời cho API web cho phép người dùng tải xuống site đã đóng gói ngay lập tức. +- **Mã hoá ZIP archive** – thêm lớp mật khẩu nếu bạn xử lý tài liệu nhạy cảm. + +Hãy thoải mái thử nghiệm: thay `MyResourceHandler` bằng một bộ nén giảm kích thước hình ảnh, hoặc thêm file manifest liệt kê tất cả tài nguyên đã đóng gói. Khi bạn kiểm soát pipeline render, khả năng chỉ có trời mới là giới hạn. + +--- + +*Chúc bạn lập trình vui! Nếu gặp khó khăn hoặc có ý tưởng cải tiến, hãy để lại bình luận bên dưới. Chúng ta sẽ cùng nhau giải quyết.* + +## Các tutorial liên quan + +- [Cách nén HTML trong C# – Save HTML to Zip](/html/english/net/html-extensions-and-conversions/how-to-zip-html-in-c-save-html-to-zip/) +- [Lưu HTML dưới dạng ZIP – Tutorial C# đầy đủ](/html/english/net/html-extensions-and-conversions/save-html-as-zip-complete-c-tutorial/) +- [Lưu HTML thành ZIP trong C# – Ví dụ In‑Memory đầy đủ](/html/english/net/html-extensions-and-conversions/save-html-to-zip-in-c-complete-in-memory-example/) + +{{< /blocks/products/pf/tutorial-page-section >}} +{{< /blocks/products/pf/main-container >}} +{{< /blocks/products/pf/main-wrap-class >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file