Penyetelan Halus Konverter di .NET dengan Aspose.HTML

Perkenalan

Aspose.HTML untuk .NET adalah pustaka canggih yang memungkinkan pengembang untuk memanipulasi dan mengonversi dokumen HTML dalam berbagai format. Baik Anda perlu mengonversi HTML ke PDF, XPS, atau gambar, atau melakukan tugas terkait HTML lainnya, Aspose.HTML menyediakan seperangkat alat canggih untuk membantu Anda menyelesaikan pekerjaan.

Dalam tutorial ini, kita akan menjelajahi beberapa fitur penting Aspose.HTML untuk .NET dan memberikan penjelasan langkah demi langkah untuk setiap contoh. Di akhir tutorial ini, Anda akan memiliki pemahaman yang kuat tentang cara menggunakan Aspose.HTML untuk .NET dalam aplikasi .NET Anda.

Prasyarat

Sebelum kita menyelami contoh-contohnya, pastikan Anda telah memenuhi prasyarat berikut:

  • Aspose.HTML untuk .NET: Anda harus menginstal pustaka Aspose.HTML untuk .NET. Anda dapat mengunduhnya daritautan unduhan.

  • Lisensi Sementara (Opsional): Jika Anda tidak memiliki lisensi yang valid, Anda dapat memperoleh lisensi sementara dariDi Sini.

Sekarang, mari kita jelajahi beberapa kasus penggunaan umum dengan Aspose.HTML untuk .NET.

Mengimpor Ruang Nama

Dalam kode C# Anda, mulailah dengan mengimpor namespace yang diperlukan:

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;

Konversi HTML ke PDF

Langkah 1: Siapkan Kode HTML

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

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Buat Perangkat PDF dan Tentukan File Output

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

Langkah 4: Render HTML ke PDF

document.RenderTo(device);

Contoh ini mengonversi potongan HTML menjadi dokumen PDF. Anda dapat menyesuaikan kode HTML dan berkas keluaran sesuai kebutuhan.

Atur Ukuran Halaman Kustom

Langkah 1: Siapkan Kode HTML

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

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Buat Opsi Rendering PDF

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

Langkah 4: Buat Perangkat PDF dan Tentukan Opsi dan File Output

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

Langkah 5: Render HTML ke PDF

document.RenderTo(device);

Contoh ini memperagakan cara mengatur ukuran halaman khusus untuk hasil dokumen PDF.

Sesuaikan Resolusi

Langkah 1: Siapkan Kode HTML dan Simpan ke File

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

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Buat Opsi Rendering PDF untuk Resolusi Rendah

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

Langkah 4: Buat Perangkat PDF dan Tentukan Opsi dan File Output untuk Resolusi Rendah

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

Langkah 5: Render HTML ke PDF untuk Resolusi Rendah

document.RenderTo(device);

Langkah 6: Buat Opsi Rendering PDF untuk Resolusi Tinggi

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

Langkah 7: Buat Perangkat PDF dan Tentukan Opsi dan File Output untuk Resolusi Tinggi

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

Langkah 8: Render HTML ke PDF untuk Resolusi Tinggi

document.RenderTo(device);

Contoh ini mengilustrasikan cara menyesuaikan resolusi saat merender HTML ke PDF, dengan mempertimbangkan layar beresolusi rendah dan tinggi.

Tentukan Warna Latar Belakang

Langkah 1: Siapkan Kode HTML dan Simpan ke File

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

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Inisialisasi Opsi Rendering PDF dengan Warna Latar Belakang

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

Langkah 4: Buat Perangkat PDF dan Tentukan Opsi dan File Output

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

Langkah 5: Render HTML ke PDF

document.RenderTo(device);

Contoh ini memperagakan cara menentukan warna latar belakang saat mengonversi HTML ke PDF.

Atur Ukuran Halaman Kiri dan Kanan

Langkah 1: Siapkan Kode 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>";

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Buat Opsi Rendering PDF dengan Ukuran Halaman Kiri dan Kanan

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

Langkah 4: Buat Perangkat PDF dan Tentukan Opsi dan File Output

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

Langkah 5: Render HTML ke PDF

document.RenderTo(device);

Contoh ini menunjukkan cara mengatur ukuran halaman yang berbeda untuk halaman kiri dan kanan saat mengonversi HTML ke PDF.

Sesuaikan Ukuran Halaman dengan Konten

Langkah 1: Siapkan Kode 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>";

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Buat Opsi Rendering PDF

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

Langkah 4: Buat Perangkat PDF dan Tentukan Opsi dan File Output

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

Langkah 5: Render HTML ke PDF

document.RenderTo(device);

Contoh ini menunjukkan cara menyesuaikan ukuran halaman ke konten terluas saat mengonversi HTML ke PDF.

Tentukan Izin PDF

Langkah 1: Siapkan Kode HTML

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

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Buat Opsi Rendering PDF dengan Izin

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

Langkah 4: Buat Perangkat PDF dan Tentukan Opsi dan File Output

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

Langkah 5: Render HTML ke PDF

document.RenderTo(device);

Contoh ini menunjukkan cara menentukan izin dan enkripsi saat mengonversi HTML ke PDF yang dilindungi.

Tentukan Opsi Spesifik Gambar

Langkah 1: Siapkan Kode HTML

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

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Buat Opsi Rendering Gambar

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

Langkah 4: Buat Perangkat Gambar dan Tentukan Opsi dan File Output

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

Langkah 5: Render HTML ke Gambar

document.RenderTo(device);

Contoh ini memperagakan cara mengonversi HTML menjadi gambar dengan opsi rendering tertentu, seperti format, resolusi, dan mode penghalusan.

Tentukan Opsi Rendering XPS

Langkah 1: Siapkan Kode HTML

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

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Buat Opsi Rendering XPS dengan Ukuran Halaman

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

Langkah 4: Buat Perangkat XPS dan Tentukan Opsi dan File Output

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

Langkah 5: Render HTML ke XPS

document.RenderTo(device);

Contoh ini menunjukkan cara mengonversi HTML ke XPS dengan ukuran halaman khusus dan opsi rendering.

Gabungkan Beberapa Dokumen HTML ke PDF

Langkah 1: Siapkan Kode HTML untuk Beberapa Dokumen

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

Langkah 2: Buat Dokumen HTML untuk Digabungkan

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

Langkah 3: Inisialisasi HTML Renderer

using (HTMLRenderer renderer = new HTMLRenderer())

Langkah 4: Buat Perangkat PDF untuk Output Gabungan

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

Langkah 5: Gabungkan Dokumen HTML ke PDF

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

Contoh ini menunjukkan cara menggabungkan beberapa dokumen HTML menjadi satu berkas PDF menggunakan Aspose.HTML untuk .NET.

Mengatur Batas Waktu Rendering

Langkah 1: Siapkan Kode HTML dengan 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>";

Langkah 2: Inisialisasi Dokumen HTML

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

Langkah 3: Inisialisasi HTML Renderer

using (HTMLRenderer renderer = new HTMLRenderer())

Langkah 4: Buat Perangkat PDF dan Atur Batas Waktu Rendering

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

Langkah 5: Render HTML ke PDF dengan Timeout

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

Contoh ini memperagakan cara menetapkan batas waktu rendering saat mengonversi HTML ke PDF, yang berguna saat menangani konten dinamis atau skrip yang berjalan lama.

Kesimpulan

Aspose.HTML untuk .NET adalah pustaka serbaguna yang memberdayakan pengembang untuk bekerja dengan dokumen HTML secara efisien. Dalam tutorial ini, kami membahas berbagai contoh, mulai dari konversi HTML dasar ke PDF hingga fitur yang lebih canggih seperti ukuran halaman kustom, resolusi, dan izin. Dengan mengikuti contoh-contoh ini, Anda dapat memanfaatkan potensi penuh Aspose.HTML untuk .NET dalam aplikasi .NET Anda.

Jika Anda memiliki pertanyaan atau memerlukan bantuan lebih lanjut, jangan ragu untuk mengunjungiForum Aspose.HTML untuk dukungan dan panduan.

Pertanyaan yang Sering Diajukan

Q1. Apa itu Aspose.HTML untuk .NET?

A1: Aspose.HTML untuk .NET adalah pustaka .NET yang memungkinkan pengembang untuk memanipulasi dan mengonversi dokumen HTML secara terprogram. Pustaka ini menawarkan berbagai fitur untuk bekerja dengan konten HTML, termasuk konversi HTML ke PDF, XPS, dan gambar, serta opsi rendering tingkat lanjut.

Q2. Di mana saya dapat mengunduh Aspose.HTML untuk .NET?

A2: Anda dapat mengunduh Aspose.HTML untuk .NET daritautan unduhan.

Q3. Apakah saya memerlukan lisensi untuk menggunakan Aspose.HTML untuk .NET?

A3: Meskipun Anda dapat menggunakan Aspose.HTML untuk .NET tanpa lisensi, disarankan untuk mendapatkan lisensi untuk penggunaan produksi guna membuka kunci semua fitur dan menghapus tanda air atau batasan apa pun.

Q4. Bagaimana cara melindungi berkas PDF yang dibuat dengan Aspose.HTML untuk .NET?

A4: Anda dapat menentukan izin PDF dan pengaturan enkripsi saat merender HTML ke PDF menggunakan Aspose.HTML untuk .NET. Ini memungkinkan Anda untuk mengontrol siapa yang dapat mengakses dan mengubah file PDF yang dihasilkan.

Q5. Dapatkah saya mengonversi HTML ke format lain seperti XPS atau gambar?

A5: Ya, Aspose.HTML untuk .NET mendukung konversi HTML ke berbagai format, termasuk PDF, XPS, dan gambar (misalnya, JPEG). Anda dapat menyesuaikan pengaturan konversi untuk memenuhi kebutuhan spesifik Anda.