VB.NET PDF Generator
Published: 2022-01-20 02:44:28

---
canonical_url: https://ironpdf.com/tutorials/vb-net-pdf/
---

This tutorial will guide you step-by-step how to create and edit PDF files in VB.Net. This technique is equally valid for use in **ASP.NET web apps** as well as **console applications**, **Windows Services** , and **desktop programs**. We will use VB.NET to create PDF projects targeting .NET Framework 4 or .NET Core 2. All you need is a Visual Basic .NET development environment, such as Microsoft Visual Studio Community.

---

**Overview**

# How to Generate PDF File in VB .NET Library

1. Download the VB .NET PDF Library
2. Create a PDF document with VB .NET Library
3. Customize your PDF document styles
4. Choose which methods to create dynamic content
5. Edit your PDF files from VB .NET Library

# VB .NET Codes for PDF Creating and Editing with IronPDF

Render HTML to PDF with VB.NET, apply styling, utilize dynamic content, and edit your files easily. Creating PDFs is straightforward and compatible with .NET Framework 4 or .NET Core 2. And no need for proprietary file formats or pulling different API's.

This tutorial provides the documentation to walk you through each task step-by-step, all using the free for development [IronPDF software favored by developers](https://ironpdf.com/). VB.NET code examples are specific to your use cases so you can see the steps easily in a familiar environment. This VB dot NET PDF Library has comprehensive creation and settings capabilities for every project, whether in ASP.NET applications, console, or desktop.

**Included with IronPDF:**

- Ticket support direct from our .NET PDF Library development team (real humans!)
- Works with HTML, ASPX forms, MVC views, images, and all the document formats you already use
- Microsoft Visual Studio installation gets you up and running fast
- Unlimited free development, and licenses to go live starting at $499

---

**Step 1**

# 1. Download the VB .NET PDF Library FREE from IronPDF

**Install via NuGet**

In Visual Studio, right click on your project solution explorer and select "Manage Nuget Packages...". From there simply search for IronPDF and install the latest version... click ok to any dialog boxes that come up.

This will work in any C# .Net Framework project from Framework 4 and above, or .Net Core 2 and above. It will also work just as well in VB.Net projects.

`PM > Install-Package IronPdf`

[https://www.nuget.org/packages/IronPdf](https://www.nuget.org/packages/IronPdf)

**Install via DLL**

Alternatively, the IronPDF DLL can be downloaded and manually installed to the project or GAC from [https://ironpdf.com/packages/IronPdf.zip](https://ironpdf.com/packages/IronPdf.zip)

Remember to add this statement to the top of any **cs** class file using IronPDF:

`using IronPdf;`

---

**How to Tutorials**

# 2. Create a PDF with VB .NET

Using **Visual Basic ASP.Net** to create a PDF file for the first time is surprising easy using IronPDF, as compared to libraries with proprietary design API's such as **_iTextSharp_**.

We can use HTML (with a pixel perfect rending engine based on Google Chromium) to define the content of our PDF and simply render it to a file.

Here is our simplest code to create a PDF in VB.Net:

**VB:**

```
/**
Create PDF in VB
anchor-create-a-pdf-with-vb-net
**/
Module Module1
    Sub Main()
        Dim renderer = New IronPdf.HtmlToPdf()
        Dim document = renderer.RenderHtmlAsPdf("<h1> My First PDF in VB.Net</h1>")
        document.SaveAs("MyFirst.pdf")
    End Sub
End Module
```

This will produce a .NET generated PDF file containing your exact text, albeit lacking some design at this point.

We can improve upon this code by adding the header line **Imports IronPdf**. By adding the last line of code **_System.Diagnostics.Process.Start_**, we open the PDF in the operating system's default PDF viewer to make the project more meaningful.

**VB:**
```
Imports IronPdf
Module Module1
    Sub Main()
        Dim renderer = New HtmlToPdf()
        Dim document = renderer.RenderHtmlAsPdf("<h1> My First PDF in VB.Net</h1>")
        document.SaveAs("MyFirst.pdf")
        System.Diagnostics.Process.Start("MyFirst.pdf")
    End Sub
End Module
```

An alternative method would be to render any existing web page from a URL to a PDF by using the elegant “RenderUrlAsPdf” method from IronPDF.

**VB:**
```
/**
Render URL to PDF
anchor-create-a-pdf-with-vb-net
**/
Imports IronPdf
Module Module1
    Sub Main()
        Dim renderer = New HtmlToPdf()
        Dim document = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf/")
        document.SaveAs("UrlToPdf.pdf")
        System.Diagnostics.Process.Start("UrlToPdf.pdf")
    End Sub
End Module
```
# 3. Apply Styling to VB.Net PDF

To style our **PDF** content in VB.Net, we can make full use of CSS, Javascript and images. We may link to local assets, or even to remote or CDN based assets such as Google Fonts. We can even use [DataURIs to embed images and assets as a string into your HTML](https://ironpdf.com/docs/questions/datauris/).

For advanced design, we can use a 2 stage process:

1. First we develop and design our HTML perfectly. This task may involve in-house design staff, splitting the work load.
2. Render that file as a PDF using VB.Net and our PDF Library

**The VB.Net Code to render the HTML file as a PDF:**

This method renders an HTML document as if it were opened as a file (**_file:// protocol_**).

**VB:**
```
/**
Render HTML as File
anchor-apply-styling-to-vb-net-pdf
**/
Imports IronPdf
Module Module1
    Sub Main()
        Dim renderer = New HtmlToPdf()
        renderer.PrintOptions.CssMediaType = PdfPrintOptions.PdfCssMediaType.Print
        renderer.PrintOptions.PrintHtmlBackgrounds = False
        renderer.PrintOptions.PaperOrientation = PdfPrintOptions.PdfPaperOrientation.Landscape
        renderer.PrintOptions.RenderDelay = 150
        Dim document = renderer.RenderHTMLFileAsPdf("C:\Users\jacob\Dropbox\Visual Studio\Tutorials\VB.Net.Pdf.Tutorial\VB.Net.Pdf.Tutorial\slideshow\index.html")
        document.SaveAs("Html5.pdf")
        System.Diagnostics.Process.Start("Html5.pdf")
    End Sub
End Module
```

We might also shorten that URL by adding a project relative file path such as:

**VB:**
```
 Dim document = renderer.RenderHTMLFileAsPdf("..\..\slideshow\index.html")
```

You can see that the **_HtmlToPdf_** renderer has a **PrintOptions** object which we can use in this example to:

- Set the CSS media type to 'print' so we see no screen-only CSS3 styles
- Ignore HTML backgrounds
- Set the PDF's virtual paper to Landscape orientation
- Add a small delay in rendering for the Javascript to finish processing

Our example HTML File uses Javascript, CSS3 and images. This HTML creates a dynamic, mobile-aware slideshow and was found at [https://github.com/leemark/better-simple-slideshow](https://github.com/leemark/better-simple-slideshow)

```html
/**
Styling with Webpage Capabilities
anchor-apply-styling-to-vb-net-pdf
**/
<!DOCTYPE html>
<html>
    <head>
        <meta charset="utf-8">
        <meta http-equiv="X-UA-Compatible" content="IE=edge">
        <title>A simple DIY responsive slideshow made with HTML5, CSS3, and JavaScript</title>
        <meta name="description" content="">
        <meta name="viewport" content="width=device-width, initial-scale=1">
        <link href='http://fonts.googleapis.com/css?family=Open+Sans|Open+Sans+Condensed:700' rel='stylesheet' type='text/css'>
        <link rel="stylesheet" href="demo/css/demostyles.css">
        <link rel="stylesheet" href="css/simple-slideshow-styles.css">
    </head>
    <body>
        <!--[if lt IE 8]>
            <p class="browsehappy">You are using an <strong>outdated</strong> browser. Please <a href="http://browsehappy.com/">upgrade your browser</a> to improve your experience.</p>
        <![endif]-->
        <header>
            <h1>A Better Simple Slideshow</h1>
            <p><span class="desc">A simple DIY responsive JavaScript slideshow.</span> [<a href="https://github.com/leemark/better-simple-slideshow">GitHub<span> repo</span></a>]</p>
        </header>    
        <div class="bss-slides num1" tabindex="1" autofocus="autofocus">
            <figure>
              <img src="demo/img/medium.jpg" width="100%" /><figcaption>"Medium" by <a href="https://www.flickr.com/photos/thomashawk/14586158819/">Thomas Hawk</a>.</figcaption> 
            </figure>
            <figure>
              <img src="demo/img/colorado.jpg" width="100%" /><figcaption>"Colorado" by <a href="https://www.flickr.com/photos/stuckincustoms/88370744">Trey Ratcliff</a>.</figcaption> 
            </figure>
            <figure>
              <img src="demo/img/monte-vista.jpg" width="100%" /><figcaption>"Early Morning at the Monte Vista Wildlife Refuge, Colorado" by <a href="https://www.flickr.com/photos/davesoldano/8572429635">Dave Soldano</a>.</figcaption> 
            </figure>
            <figure>
              <img src="demo/img/sunrise.jpg" width="100%" /><figcaption>"Sunrise in Eastern Colorado" by <a href="https://www.flickr.com/photos/35528040@N04/6673031153">Pam Morris</a>.</figcaption> 
            </figure>
            <figure>
              <img src="demo/img/colorado-colors.jpg" width="100%" /><figcaption>"colorado colors" by <a href="https://www.flickr.com/photos/cptspock/2857543585">Jasen Miller</a>.</figcaption> 
            </figure>
        </div> <!-- // bss-slides -->  
<div class="content">
<h2>What is it?</h2>
<p>It's a fairly basic slideshow, written in javascript. This is a dual-purpose project, it's meant to be something you can drop right into your page and use if you so choose, but it's also meant as an example/tutorial script showing how to build a simple DIY slideshow from scratch on your own. <a href="http://themarklee.com/2014/10/05/better-simple-slideshow/">Here is a tutorial/walkthrough</a>.</p>
<h2>Features</h2>
<ul>
    <li>fully responsive</li>
    <li>option for auto-advancing slides, or manually advancing by user</li>
    <li>multiple slideshows per-page</li>
    <li>supports arrow-key navigation</li>
    <li>full-screen toggle using HTML5 fullscreen api</li>
    <li>swipe events supported on touch devices (requires <a href="https://github.com/hammerjs/hammer.js">hammer.js</a>)</li>
    <li>written in vanilla JS--this means no jQuery dependency (much &hearts; for <a href="https://github.com/jquery/jquery">jQuery</a> though!)</li>
</ul>
<h2>Getting Started</h2>
<ol>
<li><p>HTML markup for the slideshow should look basically like this, with a container element wrapping the whole thing (doesn't have to be a <span class="code">&lt;div&gt;</span>) and each slide is a <span class="code">&lt;figure&gt;</span>.</p>
<script src="https://gist.github.com/leemark/83571d9f8f0e3ad853a8.js"></script> </li>   
<li>Include the script: <span class="code">js/better-simple-slideshow.min.js</span> or <span class="code">js/better-simple-slideshow.js</span></li>
<li>Include the stylesheet <span class="code">css/simple-slideshow-styles.css</span></li>
<li>Initialize the slideshow:
<script src="https://gist.github.com/leemark/479d4ecc4df38fba500c.js"></script>
</li>
</ol>
<h2>Options</h2>
To customize functionality, create an options object, then pass it into <span class="code">makeBSS()</span> as the second argument, as seen below:
<script src="https://gist.github.com/leemark/c6e0f5c47acb7bf9be16.js"></script>
<h2>Demo/Examples</h2>
    <h3>Example #1 (slideshow at top of this page)</h3>
    <p>HTML markup:</p>
    <script src="https://gist.github.com/leemark/19bafdb1abf8f6b4e147.js"></script>
    <p>JavaScript code:</p>
    <script src="https://gist.github.com/leemark/a09d2726b5bfc92ea68c.js"></script>
    <h3>Example #2 (below)</h3>
        <div class="bss-slides num2" tabindex="2">
           <figure>
              <img src="http://themarklee.com/wp-content/uploads/2013/12/snowying.jpg" width="100%" /><figcaption>"Snowying" by <a href="http://www.flickr.com/photos/fiddleoak/8511209344/">fiddleoak</a>.</figcaption> 
           </figure>
            <figure>
                <img src="http://themarklee.com/wp-content/uploads/2013/12/starlight.jpg" width="100%" /><figcaption>"Starlight" by <a href="http://www.flickr.com/photos/chaoticmind75/10738494123/in/set-72157626146319517">ChaoticMind75</a>.</figcaption> 
           </figure>
           <figure>
              <img src="http://themarklee.com/wp-content/uploads/2013/12/snowstorm.jpg" width="100%" /><figcaption>"Snowstorm" by <a href="http://www.flickr.com/photos/tylerbeaulawrence/8539457508/">Beaulawrence</a>.</figcaption> 
           </figure>
            <figure>
              <img src="http://themarklee.com/wp-content/uploads/2013/12/misty-winter-afternoon.jpg" width="100%" /><figcaption>"Misty winter afternoon" by <a href="http://www.flickr.com/photos/22746515@N02/5277611659/">Bert Kaufmann</a>.</figcaption> 
           </figure>
            <figure>
              <img src="http://themarklee.com/wp-content/uploads/2013/12/good-morning.jpg" width="100%" /><figcaption>"Good Morning!" by <a href="http://www.flickr.com/photos/frank_wuestefeld/4306107546/">Frank Wuestefeld</a>.</figcaption> 
           </figure>
        </div> <!-- // bss-slides --> 
<p>HTML markup:</p>
<script src="https://gist.github.com/leemark/de90c78cb73673650a5a.js"></script>
<p>JavaScript code:</p>
<script src="https://gist.github.com/leemark/046103061c89cdf07e4a.js"></script>
</div> <!-- // content -->   
<footer>Example photos are property of their respective owners, all code is <a href="https://github.com/leemark/better-simple-slideshow/blob/gh-pages/LICENSE">freely licensed for your use</a>. <br>Made especially for you by <a href="http://themarklee.com">Mark Lee</a> aka <a href="http://twitter.com/@therealmarklee">@therealmarklee</a> <br><span>&#9774; + &hearts;</span></footer>        
<script src="demo/js/hammer.min.js"></script><!-- for swipe support on touch interfaces -->
<script src="js/better-simple-slideshow.min.js"></script>
<script>
var opts = {
    auto : {
        speed : 3500, 
        pauseOnHover : true
    },
    fullScreen : false, 
    swipe : true
};
makeBSS('.num1', opts);
var opts2 = {
    auto : false,
    fullScreen : true,
    swipe : true
};
makeBSS('.num2', opts2);
</script>
</body>
</html>
```

As you can see, the full 'kitchen sink' of HTML web page capabilities are used in this example. The rendering is performed internally by IronPDF using the Chromium HTML engine and v8 javascript engine from Google. They do not need to be installed in your system, the entire package is automatically added to your project when you use IronPDF.

## 3.1. Add Headers and Footers

As we have a beautiful PDF render working, we may now wish to add attractive headers and footers.

**VB:**
```
/**
Add Headers and Footers
anchor-add-headers-and-footers
**/
Imports IronPdf
Module Module1
    Sub Main()
        Dim renderer = New HtmlToPdf()
        renderer.PrintOptions.CssMediaType = PdfPrintOptions.PdfCssMediaType.Print
        renderer.PrintOptions.PrintHtmlBackgrounds = False
        renderer.PrintOptions.PaperOrientation = PdfPrintOptions.PdfPaperOrientation.Landscape
        renderer.PrintOptions.RenderDelay = 150
        renderer.PrintOptions.Header.CenterText = "VB.Net PDF Slideshow"
        renderer.PrintOptions.Header.DrawDividerLine = True
        renderer.PrintOptions.Header.FontSize = "13"
        renderer.PrintOptions.Footer.RightText = "page {page} of {total-pages}"
        renderer.PrintOptions.Footer.FontFamily = "Arial"
        renderer.PrintOptions.Footer.FontSize = "9"
        Dim document = renderer.RenderHTMLFileAsPdf("..\..\slideshow\index.html")
        document.SaveAs("Html5WithHeader.pdf")
        System.Diagnostics.Process.Start("Html5WithHeader.pdf")
    End Sub
End Module
```

There is support for logical headers and footers as shown. You may also add HTML based headers and footers as described in [the VB.Net PDF developer API reference online](https://ironpdf.com/object-reference/api/IronPdf.HtmlHeaderFooter.html)

You can download and explore [the source code for this "vb.net html to pdf" project](https://ironpdf.com/tutorials/vb-net-pdf/downloads/VB.Net.Pdf.Tutorial.zip) as a VB.Net Visual Studio project.

---

# 4. Create PDF w/ Dynamic Content: 2 Methods

Historically, PDF 'templating' has been an overwhelming task for Software Engineers. Stamping content into PDF templates rarely works. This is because each case or report will contain content of varying types and length. Fortunately, HTML is exceptionally good at handling Dynamic Data.

For this we have 2 ways forward:

- String Templating of HTML then conversion to PDF using .NET
- Rendering out content as an ASP.NET Web Page and then rendering the page as a PDF

## 4.1. Method 1 - ASP.NET - ASPX to PDF using VB.Net Web Forms

Fortunately this solution is surprisingly simple. Any flavor of .Net Web Form (including Razor) can be rendered into a PDF document using this VB.Net code in the Page_Load subroutine in the VB.Net code behind.

The PDF document may be set with a content-disposition to display in-browser, or to act as a file download.

**VB:**

```
/**
Render WebForm as PDF
anchor-method-asp-net-aspx-to-pdf-using-vb-net-web-forms
**/
    Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs)
        Dim PdfOptions As PdfPrintOptions = New IronPdf.PdfPrintOptions
        PdfPrintOptions.
        IronPdf.AspxToPdf.RenderThisPageAsPDF(AspxToPdf.FileBehavior.Attachment, "MyPdf.pdf", PdfOptions)
    End Sub
```

## 4.2. Method 2 - HTML to PDF with String Templating

To create dynamic PDF documents that include instance specific data, we simply create a HTML string to match the data we wish to render as a PDF.

This is probably the largest advantage of the HTML-to-PDF solution in VB.Net - the ability to easily and intuitively create dynamic PDF documents and reports by creating HTML 'on the fly.'

The simplest version of this is the **String.Format** method from VB.Net

**VB:**
```
/**
HTML String to PDF
anchor-method-html-to-pdf-with-string-templating
**/
Imports IronPdf
Module Module1
    Sub Main()
        Dim renderer = New HtmlToPdf()
        Dim Html = "Hello {0}"
        String.Format(Html, "World")
        Dim document = renderer.RenderHtmlAsPdf("Html")
        document.SaveAs("HtmlTemplate.pdf")
        System.Diagnostics.Process.Start("HtmlTemplate.pdf")
    End Sub
End Module
```

As PDFs get more complicated, the String will get more complicated. We might consider using a String Builder, or even a templating framework such as HandleBars.Net or Razor [https://github.com/rexm/Handlebars.Net](https://github.com/rexm/Handlebars.Net)

---

5. Edit PDF Files with VB.Net

IronPDF for VB.Net also allows PDF documents to be edited, encrypted, watermarked or even turned back into plain text:

## 5.1. Merging Multiple PDF Files into One Document in VB

**VB:**
```
/**
Merge Multiple Files
anchor-edit-pdf-files-with-vb-net
**/
Dim Renderer As var = New IronPdf.HtmlToPdf
Dim PDFs As var = New List(Of PdfDocument)
PDFs.Add(PdfDocument.FromFile("A.pdf"))
PDFs.Add(PdfDocument.FromFile("B.pdf"))
PDFs.Add(PdfDocument.FromFile("C.pdf"))
Dim PDF As PdfDocument = PdfDocument.Merge(PDFs)
PDF.SaveAs("merged.pdf")
```

## 5.2. Add a Cover Page to the PDF

**VB:**
```
/**
Add Cover Page
anchor-add-a-cover-page-to-the-pdf
**/
PDF.PrependPdf(Renderer.RenderHtmlAsPdf("<h1>Cover Page</h1><hr>"))
```

## 5.3. Remove the last page from the PDF

**VB:*
```
/**
Remove Last Page
anchor-remove-the-last-page-from-the-pdf
**/
PDF.RemovePage((PDF.PageCount - 1))
```

## 5.4. Encrypt a PDF using 128 Bit Encryption


**VB:*
```
/**
Use 128 Bit Encryption
anchor-encrypt-a-pdf-using-bit-encryption
**/
// Save with a strong encryption password.
PDF.Password = "my.secure.password";
PDF.SaveAs("secured.pdf")
```

## 5.5. Stamp Additional HTML Content Onto a Page in VB

**VB:*
```
/**
Stamp HTML Content
anchor-stamp-additional-html-content-onto-a-page-in-vb
**/
Imports IronPdf
Module Module1
    Sub Main()
        Dim Renderer As IronPdf.HtmlToPdf = New IronPdf.HtmlToPdf
        Dim pdf = Renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf")
        Dim stamp = New HtmlStamp()
        stamp.Html = "<h2>Completed</h2>"
        stamp.Opacity = 50
        stamp.Rotation = -45
        stamp.Top = 10
        pdf.StampHTML(stamp)
        pdf.SaveAs("C:\Path\To\Stamped.pdf")
    End Sub
End Module
```

## 5.6. Add Page Break to PDF Using HTML

The easiest way to do this is with HTML and CSS

/**
```html
/**
Add Page Break
anchor-add-page-break-to-pdf-using-html
**/
<div style='page-break-after: always;'>&nbsp;</div>
```
---

# 6. More .NET PDF Tutorials
You may also be interested in:

- [The full VB.Net and C# MSDN style API reference](https://ironpdf.com/object-reference/api/IronPdf.html)
- [A tutorial about converting ASPX to PDF for Vb.Net and C#](https://ironpdf.com/tutorials/aspx-to-pdf/)
- [An in depth tutorial about rendering HTML to PDF for Vb.Net and C#](https://ironpdf.com/tutorials/html-to-pdf/)

---

# Conclusion

In this tutorial we discovered 6 ways to achieve VB.Net to PDF results using VB.NET as our programming language of choice.

- HTML string to PDF
- Creating a PDF in VB.Net using an HTML string to define its content
- Rendering existing URLs as PDF files
- Generating PDF from HTML files
- HTML templating in VB.Net and conversion to dynamic PDFs
- Converting ASP.Net pages with live data, such as ASPX to PDF files
For each we used the popular IronPDF VB .NET library to allow us to turn HTML directly into PDF documents within .NET projects