ضبط المحولات بدقة في .NET باستخدام Aspose.HTML

مقدمة

Aspose.HTML for .NET هي مكتبة قوية تتيح للمطورين التعامل مع مستندات HTML وتحويلها إلى تنسيقات مختلفة. سواء كنت بحاجة إلى تحويل HTML إلى PDF أو XPS أو صور، أو تنفيذ مهام أخرى متعلقة بـ HTML، فإن Aspose.HTML توفر مجموعة قوية من الأدوات لمساعدتك في إنجاز المهمة.

في هذا البرنامج التعليمي، سنستكشف بعض الميزات الأساسية لـ Aspose.HTML for .NET وسنقدم شرحًا خطوة بخطوة لكل مثال. وبحلول نهاية هذا البرنامج التعليمي، ستكون لديك فكرة واضحة عن كيفية استخدام Aspose.HTML for .NET في تطبيقات .NET الخاصة بك.

المتطلبات الأساسية

قبل أن نتعمق في الأمثلة، تأكد من توفر المتطلبات الأساسية التالية:

  • Aspose.HTML for .NET: يجب أن يكون لديك مكتبة Aspose.HTML for .NET مثبتة. يمكنك تنزيلها منرابط التحميل.

  • رخصة مؤقتة (اختياري): إذا لم يكن لديك ترخيص صالح، يمكنك الحصول على ترخيص مؤقت منهنا.

الآن، دعونا نستكشف بعض حالات الاستخدام الشائعة مع Aspose.HTML لـ .NET.

استيراد مساحات الأسماء

في الكود C# الخاص بك، ابدأ باستيراد المساحات الأساسية الضرورية:

using Aspose.Html;
using Aspose.Html.Rendering.Pdf;
using Aspose.Html.Rendering.Image;
using Aspose.Html.Rendering.Xps;
using Aspose.Html.Rendering.Pdf.Encryption;
using Aspose.Html.Drawing;

تحويل HTML إلى PDF

الخطوة 1: تحضير كود HTML

var code = @"<span>Hello World!!</span>";

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument(code, "."))

الخطوة 3: إنشاء جهاز PDF وتحديد ملف الإخراج

using (var device = new PdfDevice("output.pdf"))

الخطوة 4: تحويل HTML إلى PDF

document.RenderTo(device);

يقوم هذا المثال بتحويل مقتطف HTML إلى مستند PDF. يمكنك تخصيص كود HTML وملف الإخراج حسب الحاجة.

تعيين حجم الصفحة المخصص

الخطوة 1: تحضير كود HTML

var code = @"<span>Hello World!!</span>";

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument(code, "."))

الخطوة 3: إنشاء خيارات عرض PDF

var options = new PdfRenderingOptions()
{
    PageSetup =
    {
        AnyPage = new Page(
            new Size(
                Length.FromInches(5),
                Length.FromInches(2)))
    }
};

الخطوة 4: إنشاء جهاز PDF وتحديد الخيارات وملف الإخراج

using (var device = new PdfDevice(options, "output.pdf"))

الخطوة 5: تحويل HTML إلى PDF

document.RenderTo(device);

يوضح هذا المثال كيفية تعيين حجم صفحة مخصص للمستند PDF الناتج.

ضبط الدقة

الخطوة 1: تحضير كود HTML وحفظه في الملف

var code = @"
    <style>
    p
    { 
        background: blue; 
    }
    @media(min-resolution: 300dpi)
    {
        p 
        { 
            /* high-resolution screen color */
            background: green
        }
    }
    </style>
    <p>Hello World!!</p>";
System.IO.File.WriteAllText("document.html", code);

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument("document.html"))

الخطوة 3: إنشاء خيارات عرض PDF للدقة المنخفضة

var options = new PdfRenderingOptions()
{
    HorizontalResolution = 50,
    VerticalResolution = 50
};

الخطوة 4: إنشاء جهاز PDF وتحديد الخيارات وملف الإخراج للدقة المنخفضة

using (var device = new PdfDevice(options, "output_resolution_50.pdf"))

الخطوة 5: تحويل HTML إلى PDF للدقة المنخفضة

document.RenderTo(device);

الخطوة 6: إنشاء خيارات عرض PDF للدقة العالية

options = new PdfRenderingOptions()
{
    HorizontalResolution = 300,
    VerticalResolution = 300
};

الخطوة 7: إنشاء جهاز PDF وتحديد الخيارات وملف الإخراج للحصول على دقة عالية

using (var device = new PdfDevice(options, "output_resolution_300.pdf"))

الخطوة 8: تحويل HTML إلى PDF للحصول على دقة عالية

document.RenderTo(device);

يوضح هذا المثال كيفية ضبط الدقة عند عرض HTML إلى PDF، مع الأخذ في الاعتبار الشاشات ذات الدقة المنخفضة والعالية.

تحديد لون الخلفية

الخطوة 1: تحضير كود HTML وحفظه في الملف

var code = @"<p>Hello World!!</p>";
System.IO.File.WriteAllText("document.html", code);

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument("document.html"))

الخطوة 3: تهيئة خيارات عرض PDF باستخدام لون الخلفية

var options = new PdfRenderingOptions()
{
    BackgroundColor = System.Drawing.Color.Cyan
};

الخطوة 4: إنشاء جهاز PDF وتحديد الخيارات وملف الإخراج

using (var device = new PdfDevice(options, "output.pdf"))

الخطوة 5: تحويل HTML إلى PDF

document.RenderTo(device);

يوضح هذا المثال كيفية تحديد لون الخلفية عند تحويل HTML إلى PDF.

تعيين أحجام الصفحات اليمنى واليسرى

الخطوة 1: تحضير كود HTML

var code = @"<style>div { page-break-after: always; }</style>
    <div>First Page</div>
    <div>Second Page</div>
    <div>Third Page</div>
    <div>Fourth Page</div>";

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument(code, "."))

الخطوة 3: إنشاء خيارات عرض PDF باستخدام أحجام الصفحات اليمنى واليسرى

var options = new PdfRenderingOptions();
options.PageSetup.SetLeftRightPage(
    new Page(new Size(400, 200)),
    new Page(new Size(400, 100))
);

الخطوة 4: إنشاء جهاز PDF وتحديد الخيارات وملف الإخراج

using (var device = new PdfDevice(options, "output.pdf"))

الخطوة 5: تحويل HTML إلى PDF

document.RenderTo(device);

يوضح هذا المثال كيفية تعيين أحجام مختلفة للصفحات اليمنى واليسرى عند تحويل HTML إلى PDF.

ضبط حجم الصفحة حسب المحتوى

الخطوة 1: تحضير كود HTML

var code = @"<style>
    div { page-break-after: always; }
</style>
<div style='border: 1px solid red; width: 400px'>First Page</div>
<div style='border: 1px solid red; width: 600px'>Second Page</div>";

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument(code, "."))

الخطوة 3: إنشاء خيارات عرض PDF

var options = new PdfRenderingOptions();
options.PageSetup.AnyPage = new Page(new Size(500, 200));
options.PageSetup.AdjustToWidestPage = true;

الخطوة 4: إنشاء جهاز PDF وتحديد الخيارات وملف الإخراج

using (var device = new PdfDevice(options, "output.pdf"))

الخطوة 5: تحويل HTML إلى PDF

document.RenderTo(device);

يوضح هذا المثال كيفية ضبط حجم الصفحة لأوسع المحتوى عند تحويل HTML إلى PDF.

تحديد أذونات PDF

الخطوة 1: تحضير كود HTML

var code = @"<div>Hello World!!</div>";

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument(code, "."))

الخطوة 3: إنشاء خيارات عرض PDF باستخدام الأذونات

var options = new PdfRenderingOptions();
options.Encryption = new PdfEncryptionInfo(
    "user_pwd",
    "owner_pwd",
    PdfPermissions.PrintDocument,
    PdfEncryptionAlgorithm.RC4_128
);

الخطوة 4: إنشاء جهاز PDF وتحديد الخيارات وملف الإخراج

using (var device = new PdfDevice(options, "output.pdf"))

الخطوة 5: تحويل HTML إلى PDF

document.RenderTo(device);

يوضح هذا المثال كيفية تحديد الأذونات والتشفير عند تحويل HTML إلى ملف PDF محمي.

تحديد خيارات خاصة بالصورة

الخطوة 1: تحضير كود HTML

var code = @"<div>Hello World!!</div>";

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument(code, "."))

الخطوة 3: إنشاء خيارات عرض الصورة

var options = new ImageRenderingOptions()
{
    Format = ImageFormat.Jpeg,
    SmoothingMode = System.Drawing.Drawing2D.SmoothingMode.None,
    VerticalResolution = Resolution.FromDotsPerInch(75),
    HorizontalResolution = Resolution.FromDotsPerInch(75),
};

الخطوة 4: إنشاء جهاز الصورة وتحديد الخيارات وملف الإخراج

using (var device = new ImageDevice(options, "output.jpg"))

الخطوة 5: تحويل HTML إلى صورة

document.RenderTo(device);

يوضح هذا المثال كيفية تحويل HTML إلى صورة باستخدام خيارات عرض محددة، مثل التنسيق والدقة ووضع التنعيم.

تحديد خيارات عرض XPS

الخطوة 1: تحضير كود HTML

var code = @"<span>Hello World!!</span>";

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument(code, "."))

الخطوة 3: إنشاء خيارات عرض XPS باستخدام حجم الصفحة

var options = new XpsRenderingOptions();
options.PageSetup.AnyPage = new Page(
    new Size(
        Length.FromInches(5),
        Length.FromInches(2)
    )
);

الخطوة 4: إنشاء جهاز XPS وتحديد الخيارات وملف الإخراج

using (var device = new XpsDevice(options, "output.xps"))

الخطوة 5: تحويل HTML إلى XPS

document.RenderTo(device);

يوضح هذا المثال كيفية تحويل HTML إلى XPS باستخدام حجم الصفحة المخصص وخيارات العرض.

دمج مستندات HTML متعددة في PDF

الخطوة 1: إعداد كود HTML لمستندات متعددة

var code1 = @"<br><span style='color: green'>Hello World!!</span>";
var code2 = @"<br><span style='color: blue'>Hello World!!</span>";
var code3 = @"<br><span style='color: red'>Hello World!!</span>";

الخطوة 2: إنشاء مستندات HTML للدمج

using (var document1 = new HTMLDocument(code1, "."))
using (var document2 = new HTMLDocument(code2, "."))
using (var document3 = new HTMLDocument(code3, "."))

الخطوة 3: تهيئة مُقدم HTML

using (HTMLRenderer renderer = new HTMLRenderer())

الخطوة 4: إنشاء جهاز PDF للإخراج المدمج

using (var device = new PdfDevice("output.pdf"))

الخطوة 5: دمج مستندات HTML في PDF

renderer.Render(device, document1, document2, document3);

يوضح هذا المثال كيفية دمج مستندات HTML متعددة في ملف PDF واحد باستخدام Aspose.HTML لـ .NET.

تعيين مهلة العرض

الخطوة 1: تحضير كود HTML باستخدام JavaScript

var code = @"
    <script>
        var count = 0;
        setInterval(function()
        {
            var element = document.createElement('div');
            var message = (++count) + '. ' + 'Hello World!!';
            var text = document.createTextNode(message);
            element.appendChild(text);
            document.body.appendChild(element);
        }, 1000);
    </script>";

الخطوة 2: تهيئة مستند HTML

using (var document = new HTMLDocument(code, "."))

الخطوة 3: تهيئة مُقدم HTML

using (HTMLRenderer renderer = new HTMLRenderer())

الخطوة 4: إنشاء جهاز PDF وتعيين مهلة العرض

using (var device = new PdfDevice("output.pdf"))

الخطوة 5: تحويل HTML إلى PDF باستخدام مهلة زمنية

renderer.Render(device, TimeSpan.FromSeconds(5), document);

يوضح هذا المثال كيفية تعيين مهلة عرض عند تحويل HTML إلى PDF، وهو أمر قد يكون مفيدًا عند التعامل مع محتوى ديناميكي أو نصوص برمجية طويلة الأمد.

خاتمة

Aspose.HTML for .NET هي مكتبة متعددة الاستخدامات تمكن المطورين من العمل مع مستندات HTML بكفاءة. في هذا البرنامج التعليمي، قمنا بتغطية أمثلة مختلفة، من التحويلات الأساسية من HTML إلى PDF إلى ميزات أكثر تقدمًا مثل أحجام الصفحات المخصصة والدقة والأذونات. باتباع هذه الأمثلة، يمكنك الاستفادة من الإمكانات الكاملة لـ Aspose.HTML for .NET في تطبيقات .NET الخاصة بك.

إذا كان لديك أي أسئلة أو تحتاج إلى مزيد من المساعدة، فلا تتردد في زيارةمنتدى Aspose.HTML للحصول على الدعم والتوجيه.

الأسئلة الشائعة

س1. ما هو Aspose.HTML لـ .NET؟

A1: Aspose.HTML for .NET هي مكتبة .NET تتيح للمطورين التعامل مع مستندات HTML وتحويلها برمجيًا. وهي توفر مجموعة واسعة من الميزات للعمل مع محتوى HTML، بما في ذلك تحويل HTML إلى PDF وXPS وتحويل الصور، بالإضافة إلى خيارات العرض المتقدمة.

س2. أين يمكنني تنزيل Aspose.HTML لـ .NET؟

A2: يمكنك تنزيل Aspose.HTML لـ .NET منرابط التحميل.

س3. هل أحتاج إلى ترخيص لاستخدام Aspose.HTML لـ .NET؟

ج3: على الرغم من أنه يمكنك استخدام Aspose.HTML لـ .NET بدون ترخيص، فمن المستحسن الحصول على ترخيص للاستخدام الإنتاجي لفتح جميع الميزات وإزالة أي علامات مائية أو قيود.

س4. كيف يمكنني حماية ملفات PDF التي تم إنشاؤها باستخدام Aspose.HTML لـ .NET؟

ج4: يمكنك تحديد أذونات PDF وإعدادات التشفير عند عرض HTML إلى PDF باستخدام Aspose.HTML for .NET. يتيح لك هذا التحكم في من يمكنه الوصول إلى ملفات PDF الناتجة وتعديلها.

س5. هل يمكنني تحويل HTML إلى تنسيقات أخرى مثل XPS أو الصور؟

ج5: نعم، يدعم Aspose.HTML for .NET تحويل HTML إلى تنسيقات مختلفة، بما في ذلك PDF وXPS والصور (على سبيل المثال، JPEG). يمكنك تخصيص إعدادات التحويل لتلبية متطلباتك المحددة.

إنشاء ملف PDF مشفر بواسطة PdfDevice في .NET باستخدام Aspose.HTML استخدام قوالب HTML في .NET مع Aspose.HTML