A .NET konvertereinek finomhangolása az Aspose.HTML-lel

Bevezetés

Az Aspose.HTML for .NET egy hatékony könyvtár, amely lehetővé teszi a fejlesztők számára HTML-dokumentumok kezelését és konvertálását különféle formátumokban. Függetlenül attól, hogy a HTML-t PDF-vé, XPS-vé vagy képekké kell konvertálnia, vagy más, HTML-lel kapcsolatos feladatokat kell végrehajtania, az Aspose.HTML robusztus eszközkészletet kínál a munka elvégzéséhez.

Ebben az oktatóanyagban megvizsgáljuk az Aspose.HTML for .NET néhány alapvető funkcióját, és lépésről lépésre magyarázatot adunk az egyes példákhoz. Ennek az oktatóanyagnak a végére alapos ismerete lesz az Aspose.HTML for .NET használatáról .NET-alkalmazásaiban.

Előfeltételek

Mielőtt belemerülnénk a példákba, győződjön meg arról, hogy a következő előfeltételek teljesülnek:

  • Aspose.HTML for .NET: telepítenie kell az Aspose.HTML for .NET könyvtárat. Letöltheti aletöltési link.

  • Ideiglenes licenc (opcionális): Ha nem rendelkezik érvényes engedéllyel, ideiglenes engedélyt szerezhet a következő címen:itt.

Most nézzünk meg néhány gyakori használati esetet az Aspose.HTML for .NET esetében.

Névterek importálása

A C# kódban kezdje a szükséges névterek importálásával:

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 konvertálása PDF-be

1. lépés: Készítsen HTML kódot

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

2. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Hozzon létre PDF-eszközt, és adja meg a kimeneti fájlt

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

4. lépés: Rendelje meg a HTML-t PDF-be

document.RenderTo(device);

Ez a példa egy HTML-részletet konvertál PDF-dokumentummá. Szükség szerint testreszabhatja a HTML-kódot és a kimeneti fájlt.

Állítsa be az egyéni oldalméretet

1. lépés: Készítsen HTML kódot

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

2. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Hozzon létre PDF-leképezési beállításokat

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

4. lépés: Hozzon létre PDF-eszközt, és adja meg a beállításokat és a kimeneti fájlt

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

5. lépés: Rendelje meg a HTML-t PDF-be

document.RenderTo(device);

Ez a példa bemutatja, hogyan állíthat be egyéni oldalméretet az eredményül kapott PDF-dokumentumhoz.

Állítsa be a felbontást

1. lépés: Készítse elő a HTML-kódot, és mentse fájlba

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. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Hozzon létre PDF-leképezési beállításokat alacsony felbontáshoz

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

4. lépés: Hozzon létre PDF-eszközt, és adja meg az alacsony felbontású beállításokat és a kimeneti fájlt

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

5. lépés: Rendelje meg a HTML-t PDF formátumban az alacsony felbontás érdekében

document.RenderTo(device);

6. lépés: Hozzon létre PDF-leképezési beállításokat a nagy felbontáshoz

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

7. lépés: Hozzon létre PDF-eszközt, és adja meg a beállításokat és a kimeneti fájlt a nagy felbontáshoz

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

8. lépés: Rendelje meg a HTML-t PDF formátumban a nagy felbontás érdekében

document.RenderTo(device);

Ez a példa azt szemlélteti, hogyan állíthatja be a felbontást a HTML PDF-formátumba való renderelésekor, figyelembe véve mind az alacsony, mind a nagy felbontású képernyőket.

Adja meg a Háttér színét

1. lépés: Készítse elő a HTML-kódot, és mentse fájlba

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

2. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Inicializálja a PDF-leképezési beállításokat háttérszínnel

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

4. lépés: Hozzon létre PDF-eszközt, és adja meg a beállításokat és a kimeneti fájlt

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

5. lépés: Rendelje meg a HTML-t PDF-be

document.RenderTo(device);

Ez a példa bemutatja, hogyan kell megadni a háttérszínt a HTML PDF formátumba konvertálásakor.

Bal és jobb oldalméret beállítása

1. lépés: Készítsen HTML kódot

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. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Hozzon létre PDF-leképezési beállításokat bal és jobb oldalmérettel

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

4. lépés: Hozzon létre PDF-eszközt, és adja meg a beállításokat és a kimeneti fájlt

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

5. lépés: Rendelje meg a HTML-t PDF-be

document.RenderTo(device);

Ez a példa bemutatja, hogyan állíthat be különböző oldalméreteket a bal és a jobb oldali oldalakhoz, amikor HTML-t PDF-be konvertál.

Állítsa be az oldalméretet a tartalomhoz

1. lépés: Készítsen HTML kódot

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. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Hozzon létre PDF-leképezési beállításokat

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

4. lépés: Hozzon létre PDF-eszközt, és adja meg a beállításokat és a kimeneti fájlt

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

5. lépés: Rendelje meg a HTML-t PDF-be

document.RenderTo(device);

Ez a példa bemutatja, hogyan állíthatja be az oldalméretet a legszélesebb tartalomhoz, amikor HTML-t PDF-be konvertál.

Adja meg a PDF engedélyeket

1. lépés: Készítsen HTML kódot

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

2. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Hozzon létre PDF-leképezési beállításokat engedélyekkel

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

4. lépés: Hozzon létre PDF-eszközt, és adja meg a beállításokat és a kimeneti fájlt

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

5. lépés: Rendelje meg a HTML-t PDF-be

document.RenderTo(device);

Ez a példa bemutatja, hogyan kell megadni az engedélyeket és a titkosítást a HTML védett PDF formátumba konvertálásakor.

Adja meg a képspecifikus beállításokat

1. lépés: Készítsen HTML kódot

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

2. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Hozzon létre képmegjelenítési beállításokat

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

4. lépés: Hozzon létre képeszközt, és adja meg a beállításokat és a kimeneti fájlt

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

5. lépés: Rendelje meg a HTML-t képben

document.RenderTo(device);

Ez a példa bemutatja, hogyan lehet HTML-t képpé konvertálni meghatározott megjelenítési beállításokkal, például formátummal, felbontással és simítási móddal.

Adja meg az XPS renderelési beállításokat

1. lépés: Készítsen HTML kódot

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

2. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Hozzon létre XPS-leképezési beállításokat az oldalmérettel

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

4. lépés: Hozzon létre XPS-eszközt, és adja meg a beállításokat és a kimeneti fájlt

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

5. lépés: Rendelje meg a HTML-t XPS-ben

document.RenderTo(device);

Ez a példa bemutatja, hogyan lehet HTML-t XPS-re konvertálni egyéni oldalmérettel és megjelenítési beállításokkal.

Kombináljon több HTML-dokumentumot PDF-be

1. lépés: Készítsen HTML-kódot több dokumentumhoz

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. lépés: Hozzon létre HTML-dokumentumokat egyesítéshez

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

3. lépés: Inicializálja a HTML renderert

using (HTMLRenderer renderer = new HTMLRenderer())

4. lépés: PDF-eszköz létrehozása az egyesített kimenethez

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

5. lépés: Egyesítse a HTML-dokumentumokat PDF-be

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

Ez a példa bemutatja, hogyan lehet több HTML-dokumentumot egyetlen PDF-fájlba egyesíteni az Aspose.HTML for .NET használatával.

Renderelési időtúllépés beállítása

1. lépés: Készítsen HTML kódot JavaScript segítségével

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. lépés: Inicializálja a HTML-dokumentumot

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

3. lépés: Inicializálja a HTML renderert

using (HTMLRenderer renderer = new HTMLRenderer())

4. lépés: PDF-eszköz létrehozása és renderelési időtúllépés beállítása

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

5. lépés: Rendelje meg a HTML-t PDF-formátumban időtúllépéssel

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

Ez a példa bemutatja, hogyan állíthat be renderelési időtúllépést a HTML PDF-be konvertálásakor, ami hasznos lehet dinamikus tartalom vagy hosszan futó szkriptek kezelésekor.

Következtetés

Az Aspose.HTML for .NET egy sokoldalú könyvtár, amely lehetővé teszi a fejlesztők számára, hogy hatékonyan dolgozzanak HTML-dokumentumokkal. Ebben az oktatóanyagban különféle példákkal foglalkoztunk, az alapvető HTML-től a PDF-konverziókon át a fejlettebb funkciókig, például az egyéni oldalméretek, felbontások és engedélyekig. A példák követésével kihasználhatja az Aspose.HTML for .NET teljes potenciálját .NET-alkalmazásaiban.

Ha bármilyen kérdése van, vagy további segítségre van szüksége, ne habozzon felkeresni aAspose.HTML fórum támogatásért és útmutatásért.

GYIK

Q1. Mi az Aspose.HTML a .NET számára?

  1. válasz: Az Aspose.HTML for .NET egy .NET-könyvtár, amely lehetővé teszi a fejlesztők számára a HTML-dokumentumok programozott kezelését és konvertálását. Funkciók széles skáláját kínálja a HTML-tartalommal való munkavégzéshez, beleértve a HTML-ből PDF-be, XPS-be és képkonverziót, valamint speciális megjelenítési lehetőségeket.

Q2. Honnan tölthetem le az Aspose.HTML-t .NET-hez?

  1. válasz: Letöltheti az Aspose.HTML for .NET webhelyetletöltési link.

Q3. Szükségem van licencre az Aspose.HTML for .NET használatához?

  1. válasz: Bár az Aspose.HTML for .NET licenc nélkül is használható, ajánlatos licencet szerezni éles használatra, hogy feloldja az összes funkciót, és eltávolítson minden vízjelet vagy korlátozást.

Q4. Hogyan védhetem meg az Aspose.HTML for .NET segítségével generált PDF fájljaimat?

  1. válasz: Megadhat PDF-engedélyeket és titkosítási beállításokat, amikor a HTML-t PDF-be rendereli az Aspose.HTML for .NET használatával. Ez lehetővé teszi annak szabályozását, hogy ki férhet hozzá és módosíthatja az eredményül kapott PDF-fájlokat.

Q5. Átalakíthatom a HTML-t más formátumokra, például XPS-re vagy képekre?

  1. válasz: Igen, az Aspose.HTML for .NET támogatja a HTML konvertálását különféle formátumokba, beleértve a PDF-t, XPS-t és képeket (pl. JPEG). Testreszabhatja a konverziós beállításokat, hogy megfeleljenek az Ön egyedi igényeinek.