1. IronPDF
  2. Tutoriales
  3. Generación de PDF en .NET Core

Generación de PDF en C#

Generador de PDF .NET Core

Crear archivos PDF en .NET Core es una tarea engorrosa. Trabajar con PDF en proyectos ASP.NET MVC, así como convertir vistas MVC, archivos HTML y páginas web en línea a PDF puede ser todo un reto. Este tutorial trabaja con la herramienta IronPDF para abordar estos problemas, proporcionando directrices instructivas para muchas de sus necesidades PDF .NET.

IronPDF también soporta la depuración de su HTML con Chrome para Pixel Perfect PDFs. Encontrará un tutorial para configurarlo aquí.

Visión general

Después de este tutorial, serás capaz de:

  • Convierte a PDF desde diferentes fuentes como URL, HTML, vistas MVC
  • Utiliza las opciones avanzadas para diferentes configuraciones de salida de PDF
  • Implanta tu proyecto en Linux y Windows
  • Trabajar con funciones de manipulación de documentos PDF
  • Añadir encabezados y pies de página, fusionar archivos, añadir sellos

  • Trabaja con Dockers

    Esta amplia gama de funciones de HTML a PDF de .NET Core le ayudará con toda una serie de necesidades de proyecto.

Primer paso

1. Instale la biblioteca IronPDF

Biblioteca NuGet C# para PDF

Instalar con NuGet

Install-Package IronPdf
nuget.org/packages/IronPdf/
o
Java PDF JAR

Descargar DLL

Descargar DLL

Instalar manualmente en su proyecto

IronPDF puede instalarse y utilizarse en todos los tipos de proyectos .NET, como aplicaciones Windows, ASP.NET MVC y aplicaciones .NET Core.

Para añadir la librería IronPDF a nuestro proyecto tenemos dos formas, o bien desde el editor de Visual Studio instalar usando NuGet, o bien con una línea de comandos usando el gestor de consola de paquetes.

Instalación con NuGet

Para añadir la librería IronPDF a nuestro proyecto utilizando NuGet, podemos utilizar la interfaz visualizada (Gestor de paquetes NuGet) o mediante un comando de la consola del gestor de paquetes:

1.1.1 Uso del gestor de paquetes NuGet

1- Click derecho sobre el nombre del proyecto -> Seleccionar Manage NuGet Package 2- Desde la pestaña del navegador -> busca IronPdf -> Instalar 3- Haga clic en Ok 4- ¡Hecho!

1.1.2 Uso del gestor de la consola de paquetes NuGet

1- Desde Herramientas -> Gestor de Paquetes NuGet -> Consola del Gestor de Paquetes 2- Ejecutar comando -> Install-Package IronPdf

Tutoriales prácticos

2. Convertir página web a PDF

Ejemplo: Aplicación de consola ConvertUrlToPdf

Siga estos pasos para crear un nuevo proyecto Asp.NET MVC


1- Abrir Visual Studio 2- Seleccione Crear nuevo proyecto 3- Elige Console App (.NET Core) 4- Dale a nuestro ejemplo el nombre "ConvertUrlToPdf" y pulsa crear 5- Ahora tenemos una aplicación de consola creada 6- Añade IronPdf => haz clic en instalar

7- Añadir nuestras primeras líneas que renderizan una página principal del sitio web Wikipedia a PDF

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-1.cs
Console.WriteLine("Hello World!");
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderUrlAsPdf("https://www.wikipedia.org/");
pdf.SaveAs("wiki.pdf");
Console.WriteLine("Hello World!")
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://www.wikipedia.org/")
pdf.SaveAs("wiki.pdf")
VB   C#

8- Ejecute y compruebe el archivo creado wiki.pdf

3. Convertir .NET Core HTML a PDF

Muestra: Aplicación de consola ConvertHTMLToPdf

Para convertir HTML en PDF tenemos dos formas:
1- Escribir HTML en cadena y luego renderizarlo
2- Escribir HTML en un archivo y pasarle la ruta a IronPDF para que lo renderice.

La representación del código de ejemplo de la cadena HTML tendrá el siguiente aspecto.

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-2.cs
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>");
pdf.SaveAs("HtmlString.pdf");
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<h1>Hello IronPdf</h1>")
pdf.SaveAs("HtmlString.pdf")
VB   C#

Y el PDF resultante tendrá este aspecto.

4. Convertir vista MVC a PDF

Ejemplo: TicketsApps .NET Core MVC Application

Pongamos un ejemplo de la vida real. He elegido un sitio de venta de entradas en línea. Abra el sitio, navegue hasta "reservar entrada", rellene la información requerida y, a continuación, descargue su copia en formato PDF.

Vamos a seguir estos pasos:

Crear proyecto

  1. Seleccione "ASP.NET Core Web App (Modelo-Vista-Controlador)".

  2. Nombra el proyecto "TicketsApps"

  3. Usemos .NET 8 con Linux Docker habilitado. Dentro del Dockerfile, cambia de "USER app" a "USER root". Esto garantizará que se conceden suficientes permisos a la biblioteca.

  4. Ya está listo.

Añadir modelo de cliente

  1. Haga clic con el botón derecho en la carpeta "Modelos" y añada una clase.

  2. Nombre el modelo "ClientModel" y haga clic en añadir.

  3. Añade los atributos 'name', 'phone' y 'email' a la clase ClientModel. Haz que todos sean obligatorios añadiendo el atributo 'Required' sobre cada uno de ellos como sigue:
:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-3.cs
public class ClientModel
{
    [Required]
    public string Name { get; set; }
    [Required]
    public string Phone { get; set; }
    [Required]
    public string Email { get; set; }
}
Public Class ClientModel
	<Required>
	Public Property Name() As String
	<Required>
	Public Property Phone() As String
	<Required>
	Public Property Email() As String
End Class
VB   C#

Añadir servicios al cliente

  1. Crea una carpeta y nómbrala "servicios"
  2. Añade una clase llamada "ClientServices"
  3. Añade un objeto estático de tipo "ClientModel" para utilizarlo como repositorio.
  4. Añade dos funciones: una para guardar clientes en el repositorio, y la segunda para recuperar clientes guardados.
:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-4.cs
public class ClientServices
{
    private static ClientModel _clientModel;
    public static void AddClient(ClientModel clientModel)
    {
        _clientModel = clientModel;
    }
    public static ClientModel GetClient()
    {
        return _clientModel;
    }
}
Public Class ClientServices
	Private Shared _clientModel As ClientModel
	Public Shared Sub AddClient(ByVal clientModel As ClientModel)
		_clientModel = clientModel
	End Sub
	Public Shared Function GetClient() As ClientModel
		Return _clientModel
	End Function
End Class
VB   C#

Diseño de la página de reserva de entradas

  1. Desde el explorador de soluciones, haga clic con el botón derecho en la carpeta "Controladores" y añada un controlador.

  2. Nómbralo "BookTicketController"

  3. Haga clic con el botón derecho en la función de índice (o como lo llamamos acción) y elija "Añadir vista"

  4. Añade una Vista llamada "índice"

  5. Actualice el HTML del siguiente modo
:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-5.cs
@model IronPdfMVCHelloWorld.Models.ClientModel
@{
  ViewBag.Title = "Book Ticket";
}
<h2>Index</h2>
@using (Html.BeginForm())
{
  <div class="form-horizontal">
    @Html.ValidationSummary(true, "", new { @class = "text-danger" })
    <div class="form-group">
      @Html.LabelFor(model => model.Name, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Name, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Name, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      @Html.LabelFor(model => model.Phone, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Phone, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Phone, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      @Html.LabelFor(model => model.Email, htmlAttributes: new { @class = "control-label col-md-2" })
      <div class="col-md-10">
        @Html.EditorFor(model => model.Email, new { htmlAttributes = new { @class = "form-control" } })
        @Html.ValidationMessageFor(model => model.Email, "", new { @class = "text-danger" })
      </div>
    </div>
    <div class="form-group">
      <div class="col-md-10 pull-right">
        <button type="submit" value="Save" class="btn btn-sm">
          <i class="fa fa-plus"></i>
          <span>
            Save
          </span>
        </button>
      </div>
    </div>
  </div>
}
model ReadOnly Property () As IronPdfMVCHelloWorld.Models.ClientModel
  ViewBag.Title = "Book Ticket"
End Property
'INSTANT VB TODO TASK: The following line could not be converted:
(Of h2) Index</h2> [using](Html.BeginForm())
If True Then
'INSTANT VB TODO TASK: The following line uses invalid syntax:
'  <div class="form-horizontal"> @Html.ValidationSummary(True, "", New { @class = "text-danger" }) <div class="form-group"> @Html.LabelFor(model => model.Name, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Name, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Name, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Phone, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Phone, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Phone, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> @Html.LabelFor(model => model.Email, htmlAttributes: New { @class = "control-label col-md-2" }) <div class="col-md-10"> @Html.EditorFor(model => model.Email, New { htmlAttributes = New { @class = "form-control" } }) @Html.ValidationMessageFor(model => model.Email, "", New { @class = "text-danger" }) </div> </div> <div class="form-group"> <div class="col-md-10 pull-right"> <button type="submit" value="Save" class="btn btn-sm"> <i class="fa fa-plus"></i> <span> Save </span> </button> </div> </div> </div> }
VB   C#
  1. Añadir un enlace de navegación que permita a los visitantes de nuestro sitio web navegar hasta nuestra nueva página de reservas. Esto puede hacerse actualizando el diseño en la ruta existente (Vistas -> Compartidas -> _Layout.cshtml). Añade el siguiente código:
<li class="nav-item">
    <a
        class="nav-link text-dark"
        asp-area=""
        asp-controller="BookTicket"
        asp-action="Index"
        >Book Ticket</a
    >
</li>
<li class="nav-item">
    <a
        class="nav-link text-dark"
        asp-area=""
        asp-controller="BookTicket"
        asp-action="Index"
        >Book Ticket</a
    >
</li>
HTML

  1. El resultado debería ser el siguiente.

  2. Vaya a la página "Reservar billete". Debería tener este aspecto:

Validar y guardar la información de la reserva

  1. Añade otra acción de índice con el atributo [HttpPost] para informar al motor MVC de que esta acción es para enviar datos. Valida el modelo enviado, y si es válido, el código redirigirá al visitante a la página TicketView. Si no es válida, el visitante recibirá mensajes de error de validación en la pantalla.
:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-7.cs
[HttpPost]
public ActionResult Index(ClientModel model)
{
    if (ModelState.IsValid)
    {
        ClientServices.AddClient(model);
        return RedirectToAction("TicketView");
    }
  return View(model);
}
<HttpPost>
Public Function Index(ByVal model As ClientModel) As ActionResult
	If ModelState.IsValid Then
		ClientServices.AddClient(model)
		Return RedirectToAction("TicketView")
	End If
  Return View(model)
End Function
VB   C#

Ejemplo de mensajes de error

  1. Cree un modelo Ticket en el archivo "Modelos" y añada el código siguiente
:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-9.cs
public class TicketModel : ClientModel
{
    public int TicketNumber { get; set; }
    public DateTime TicketDate { get; set; }
}
Public Class TicketModel
	Inherits ClientModel

	Public Property TicketNumber() As Integer
	Public Property TicketDate() As DateTime
End Class
VB   C#
  1. Añadir TicketView para mostrar nuestro ticket. Esta vista alojará una vista parcial del ticket que se encargará de mostrar el ticket y que se utilizará posteriormente para imprimir el ticket.
:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-8.cs
public ActionResult TicketView()
{
    var rand = new Random();
    var client = ClientServices.GetClient();
    var ticket = new TicketModel()
    {
        TicketNumber = rand.Next(100000, 999999),
        TicketDate = DateTime.Now,
        Email = client.Email,
        Name = client.Name,
        Phone = client.Phone
    };

    return View(ticket);
}
Public Function TicketView() As ActionResult
	Dim rand = New Random()
	Dim client = ClientServices.GetClient()
	Dim ticket = New TicketModel() With {
		.TicketNumber = rand.Next(100000, 999999),
		.TicketDate = DateTime.Now,
		.Email = client.Email,
		.Name = client.Name,
		.Phone = client.Phone
	}

	Return View(ticket)
End Function
VB   C#
  1. Haga clic con el botón derecho en la función TicketView, seleccione "Añadir vista" y nómbrela "TicketView". Añade el siguiente código:
@model TicketsApps.Models.TicketModel @{ ViewData["Title"] = "TicketView"; }
@Html.Partial("_TicketPdf", Model) @using (Html.BeginForm()) { @Html.HiddenFor(c
=> c.Email) @Html.HiddenFor(c => c.Name) @Html.HiddenFor(c => c.Phone)
@Html.HiddenFor(c => c.TicketDate) @Html.HiddenFor(c => c.TicketNumber)

<div class="form-group">
    <div class="col-md-10 pull-right">
        <button type="submit" value="Save" class="btn btn-sm">
            <i class="fa fa-plus"></i>
            <span> Download Pdf </span>
        </button>
    </div>
</div>
}
@model TicketsApps.Models.TicketModel @{ ViewData["Title"] = "TicketView"; }
@Html.Partial("_TicketPdf", Model) @using (Html.BeginForm()) { @Html.HiddenFor(c
=> c.Email) @Html.HiddenFor(c => c.Name) @Html.HiddenFor(c => c.Phone)
@Html.HiddenFor(c => c.TicketDate) @Html.HiddenFor(c => c.TicketNumber)

<div class="form-group">
    <div class="col-md-10 pull-right">
        <button type="submit" value="Save" class="btn btn-sm">
            <i class="fa fa-plus"></i>
            <span> Download Pdf </span>
        </button>
    </div>
</div>
}
HTML
  1. Haga clic con el botón derecho en el archivo BookTicket, añada otra Vista y nómbrela "_TicketPdf" Añada el siguiente código:
@model TicketsApps.Models.TicketModel @{ Layout = null; }
<link href="../css/ticket.css" rel="stylesheet" />
<div class="ticket">
    <div class="stub">
        <div class="top">
            <span class="admit">VIP</span>
            <span class="line"></span>
            <span class="num">
                @Model.TicketNumber
                <span> Ticket</span>
            </span>
        </div>
        <div class="number">1</div>
        <div class="invite">Room Number</div>
    </div>
    <div class="check">
        <div class="big">
            Your <br />
            Ticket
        </div>
        <div class="number">VIP</div>
        <div class="info">
            <section>
                <div class="title">Date</div>
                <div>@Model.TicketDate.ToShortDateString()</div>
            </section>
            <section>
                <div class="title">Issued By</div>
                <div>Admin</div>
            </section>
            <section>
                <div class="title">Invite Number</div>
                <div>@Model.TicketNumber</div>
            </section>
        </div>
    </div>
</div>
@model TicketsApps.Models.TicketModel @{ Layout = null; }
<link href="../css/ticket.css" rel="stylesheet" />
<div class="ticket">
    <div class="stub">
        <div class="top">
            <span class="admit">VIP</span>
            <span class="line"></span>
            <span class="num">
                @Model.TicketNumber
                <span> Ticket</span>
            </span>
        </div>
        <div class="number">1</div>
        <div class="invite">Room Number</div>
    </div>
    <div class="check">
        <div class="big">
            Your <br />
            Ticket
        </div>
        <div class="number">VIP</div>
        <div class="info">
            <section>
                <div class="title">Date</div>
                <div>@Model.TicketDate.ToShortDateString()</div>
            </section>
            <section>
                <div class="title">Issued By</div>
                <div>Admin</div>
            </section>
            <section>
                <div class="title">Invite Number</div>
                <div>@Model.TicketNumber</div>
            </section>
        </div>
    </div>
</div>
HTML
  1. Añada lo siguiente "ticket.css" en el archivo "wwwroot/css".

  2. Añada IronPDF al proyecto y acepte la licencia.

  3. Añade el método post TicketView que manejará el botón de descarga.
:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-10.cs
[HttpPost]
public ActionResult TicketView(TicketModel model)
{
    IronPdf.Installation.TempFolderPath = $@"{Directory.GetParent}/irontemp/";
    IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = true;
    var html = this.RenderViewAsync("_TicketPdf", model);
    var renderer = new IronPdf.ChromePdfRenderer();
    using var pdf = renderer.RenderHtmlAsPdf(html.Result, @"wwwroot/css");
    return File(pdf.Stream.ToArray(), "application/pdf");
}
<HttpPost>
Public Function TicketView(ByVal model As TicketModel) As ActionResult
	IronPdf.Installation.TempFolderPath = $"{AddressOf Directory.GetParent}/irontemp/"
	IronPdf.Installation.LinuxAndDockerDependenciesAutoConfig = True
	Dim html = Me.RenderViewAsync("_TicketPdf", model)
	Dim renderer = New IronPdf.ChromePdfRenderer()
	Dim pdf = renderer.RenderHtmlAsPdf(html.Result, "wwwroot/css")
	Return File(pdf.Stream.ToArray(), "application/pdf")
End Function
VB   C#
  1. Cree un controlador en el archivo "Controller" y nómbrelo "ControllerExtensions". Este controlador convertirá la vista parcial en una cadena. Utilice el código de extensión como se indica a continuación:
:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-11.cs
using System.IO;
using System.Threading.Tasks;

public static class ControllerExtensions
{
    public static async Task<string> RenderViewAsync<TModel>(this Controller controller, string viewName, TModel model, bool partial = false)
    {
        if (string.IsNullOrEmpty(viewName))
        {
            viewName = controller.ControllerContext.ActionDescriptor.ActionName;
        }
        controller.ViewData.Model = model;
        using (var writer = new StringWriter())
        {
            IViewEngine viewEngine = controller.HttpContext.RequestServices.GetService(typeof(ICompositeViewEngine)) as ICompositeViewEngine;
            ViewEngineResult viewResult = viewEngine.FindView(controller.ControllerContext, viewName, !partial);
            if (viewResult.Success == false)
            {
                return $"A view with the name {viewName} could not be found";
            }
            ViewContext viewContext = new ViewContext(controller.ControllerContext, viewResult.View, controller.ViewData, controller.TempData, writer, new HtmlHelperOptions());
            await viewResult.View.RenderAsync(viewContext);
            return writer.GetStringBuilder().ToString();
        }
    }
}
Imports System.IO
Imports System.Threading.Tasks

Public Module ControllerExtensions
	<System.Runtime.CompilerServices.Extension> _
	Public Async Function RenderViewAsync(Of TModel)(ByVal controller As Controller, ByVal viewName As String, ByVal model As TModel, Optional ByVal As Boolean = False) As Task(Of String)
		If String.IsNullOrEmpty(viewName) Then
			viewName = controller.ControllerContext.ActionDescriptor.ActionName
		End If
		controller.ViewData.Model = model
		Using writer = New StringWriter()
			Dim viewEngine As IViewEngine = TryCast(controller.HttpContext.RequestServices.GetService(GetType(ICompositeViewEngine)), ICompositeViewEngine)
			Dim viewResult As ViewEngineResult = viewEngine.FindView(controller.ControllerContext, viewName, Not partial)
			If viewResult.Success = False Then
				Return $"A view with the name {viewName} could not be found"
			End If
			Dim viewContext As New ViewContext(controller.ControllerContext, viewResult.View, controller.ViewData, controller.TempData, writer, New HtmlHelperOptions())
			Await viewResult.View.RenderAsync(viewContext)
			Return writer.GetStringBuilder().ToString()
		End Using
	End Function
End Module
VB   C#

  1. Ejecute la aplicación y rellene los datos de la entrada, después haga clic en "Guardar".

  2. Ver el billete generado

Descargar billete PDF

Para descargar el billete en formato PDF, haga clic en "Descargar Pdf". Recibirá un PDF con el billete.

Puede descargar el código completo de esta guía. Viene como un archivo comprimido que puede abrir en Visual Studio. Haga clic aquí para descargar el proyecto.

5. Tabla de opciones de renderizado de PDF de .NET

Tenemos algunas opciones avanzadas que definen las opciones de renderizado del PDF, como el ajuste de los márgenes,

orientación del papel, tamaño del papel, etc.

A continuación encontrará un cuadro que ilustra las distintas opciones.

ClaseChromePdfRenderer
DescripciónPermite definir las opciones de impresión del PDF, como el tamaño del papel, los PPP, los encabezados y los pies de página.
Propiedades / funcionesTipoDescripción
CustomCookiesDictionary<cadena, cadena>Cookies personalizadas para el renderizado HTML. Las cookies no persisten entre renderizaciones y deben configurarse cada vez.
PaperFitVirtualPaperLayoutManagerUn gestor para configurar diseños de papel virtual, controlando cómo se presentará el contenido en las páginas de "papel" PDF. Incluye opciones para Default Chrome Behavior, Zoomed, Responsive CSS3 Layouts, Scale-To-Page & Continuous Feed style PDF page setups.
UseMarginsOnHeaderAndFooterUseMarginsUtilizar los valores de margen del documento principal al representar los encabezados y pies de página.
CreatePdfFormsFromHtmlboolConvierte todos los elementos de formulario HTML en formularios PDF editables. El valor por defecto es true.
CssMediaTipoPdfCssMediaTipoEnables Media="screen" CSS Styles and StyleSheets. Default value is PdfCssMediaTipo.Screen.
CustomCssUrlcadenaPermite aplicar una hoja de estilo CSS personalizada al HTML antes de la visualización. Puede ser una ruta de archivo local o una URL remota. Sólo aplicable al convertir HTML a PDF.
Activar JavaScriptboolPermite ejecutar JavaScript y JSON antes de renderizar la página. Ideal para imprimir desde aplicaciones Ajax / Angular. El valor por defecto es false.
EnableMathematicalLaTexboolPermite la representación de elementos matemáticos LaTeX.
JavascriptcadenaA custom JavaScript cadena to be executed after all HTML has loaded but before PDF rendering.
JavascriptMessageListenerCadenaDelegateUn método de devolución de llamada que se invocará cada vez que un mensaje de la consola JavaScript del navegador esté disponible.
NúmeroPrimeraPáginaintNúmero de la primera página que se utilizará en los encabezados y pies de página del PDF. El valor por defecto es 1.
TablaDeContenidosTablaDeContenidosTiposGenera una tabla de contenidos en el lugar del documento HTML donde se encuentra un elemento con id "ironpdf-toc".
Escala de grisesboolImprime un PDF en blanco y negro. El valor por defecto es false.
Cabecera de textoICabecera de textoFooterEstablece el contenido del pie de página de cada página PDF como texto, admite la fusión de correo y convierte automáticamente las URL en hipervínculos.
Pie de texto
HtmlHeaderHtmlHeaderFooterEstablece el contenido de la cabecera de cada página PDF como HTML. Admite la fusión de correo.
HtmlFooter
Codificación de entradaCodificaciónThe input character encoding as a cadena. Default value is Codificación.UTF8.
MarginTopdobleMargen superior del PDF "papel" en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25.
MarginRightdobleMargen derecho del PDF "papel" en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25.
MarginBottomdobleMargen "papel" inferior del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25.
MargenIzquierdodobleMargen "papel" izquierdo del PDF en milímetros. Póngalo a cero para aplicaciones sin bordes y de impresión comercial. El valor por defecto es 25.
Orientación del papelPdfOrientación del papelLa orientación del papel PDF, como Vertical u Horizontal. El valor predeterminado es Vertical.
TamañoPapelPdfTamañoPapelEstablece el tamaño del papel
SetCustomTamañoPapelinCentimetersdobleEstablece el tamaño del papel in centimeters.
SetCustomTamañoPapelInInchesEstablece el tamaño del papel in inches.
SetCustomTamañoPapelinMilimetersEstablece el tamaño del papel in millimeters.
SetCustomTamañoPapelinPixelsOrPointsEstablece el tamaño del papel in screen pixels or printer points.
PrintHtmlBackgroundsBooleanooIndica si se imprimen los colores de fondo y las imágenes de HTML. El valor por defecto es true.
RequestContextRequestContextsContexto de la solicitud para este render, determinando el aislamiento de ciertos recursos como las cookies.
Tiempo de esperaEnteroTiempo de espera en segundos. El valor por defecto es 60.
TítuloCadenaPDF Document Name and Título metadata, useful for mail-merge and automatic file naming in the IronPdf MVC and Razor extensions.
ForceTamañoPapelBooleanooForce page sizes to be exactly what is specified via IronPdf.ChromePdfRenderOptions.TamañoPapel by resizing the page after generating a PDF from HTML. Helps correct small errors in page size when rendering HTML to PDF.
Espere enEspere enUn objeto envoltorio que contiene la configuración del mecanismo wait-for para que los usuarios esperen ciertos eventos antes de renderizar. Por defecto, no esperará nada.

6. Tabla de opciones de encabezado y pie de página de PDF .NET

ClaseEncabezado de textoPie de página
DescripciónSe utiliza para definir las opciones de visualización del encabezado y pie de texto
Propiedades \ funcionesTipoDescripción
CentrarTextocadenaSet the text in centered/left/right of PDF header or footer. Can also merge metadata using cadenas placeholders: {page}, {total-pages}, {url}, {date}, {time}, {html-title}, {pdf-title}
Textoizquierdo
RightText
DibujarLíneaDivisoriaBooleanoAñade una línea horizontal divisoria entre el encabezado/pie de página y el contenido de la página en cada página del documento PDF.
DibujarLíneaDivisoriaColorColorThe color of the divider line specified for IronPdf.Encabezado de textoPie de página.DibujarLíneaDivisoria.
FuentePdfFuenteFuente family used for the PDF document. Default is IronSoftware.Drawing.FuenteTipos.Helvetica.
FuenteSizeDobleFuente size in pixels.

7. Aplicar opciones de impresión PDF (renderizado)

Intentemos configurar nuestras opciones de renderizado de PDF.

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-12.cs
ChromePdfRenderer renderer = new ChromePdfRenderer();

//  Opciones de renderizado
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait;

renderer.RenderHtmlFileAsPdf(@"testFile.html").SaveAs("GeneratedFile.pdf");
Dim renderer As New ChromePdfRenderer()

'  Opciones de renderizado
renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4
renderer.RenderingOptions.PaperOrientation = IronPdf.Rendering.PdfPaperOrientation.Portrait

renderer.RenderHtmlFileAsPdf("testFile.html").SaveAs("GeneratedFile.pdf")
VB   C#

8. Aplicaciones .NET Core en Docker

8.1. ¿Qué es Docker?

Docker es un conjunto de productos de plataforma como servicio que utiliza la virtualización a nivel de sistema operativo para ofrecer software en paquetes denominados contenedores. Los contenedores están aislados unos de otros y agrupan su propio software, bibliotecas y archivos de configuración; pueden comunicarse entre sí a través de canales bien definidos.

Más información Aplicación Docker y ASP.NET Core aquí.

Vamos a pasar a trabajar con Docker, pero si quieres saber más, hay una gran introducción a .NET y Docker aquí. y aún más sobre cómo crear contenedores para aplicaciones .NET core.

Empecemos juntos con Docker.

8.2. Instalar Docker

Visite el sitio web de Docker aquí para instalar Docker. Haz clic en empezar. Haga clic en descargar para Mac y Windows. Regístrate gratis e inicia sesión. Descargar Docker para Windows. Comience a instalar Docker. Será necesario reiniciarlo. Después de que su máquina se reinicie, inicie sesión en Docker. Ahora puedes ejecutar Docker "hola mundo" abriendo la línea de comandos de Windows o el script PowerShell y escribir:

Docker ejecuta hello-world Aquí tienes una lista de las líneas de comandos más importantes para ayudarte:

  • Imágenes Docker => Para listar todas las imágenes disponibles en esta máquina
  • Docker ps => para listar todos los contenedores en ejecución
  • Docker ps -a => para listar todos los contenedores

8.3. Ejecutar en contenedor Linux

9. Trabajar con documentos PDF existentes

9.1. Abrir PDF existente

Como se puede crear un PDF a partir de URL y HTML (texto o archivo)También puede trabajar con documentos PDF existentes.

A continuación se muestra un ejemplo para abrir un PDF normal o un PDF cifrado con contraseña

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-13.cs
//  Abrir un pdf no encriptado
PdfDocument unencryptedPdf = PdfDocument.FromFile("testFile.pdf");

//  Abrir un pdf encriptado
PdfDocument encryptedPdf = PdfDocument.FromFile("testFile2.pdf", "MyPassword");
'  Abrir un pdf no encriptado
Dim unencryptedPdf As PdfDocument = PdfDocument.FromFile("testFile.pdf")

'  Abrir un pdf encriptado
Dim encryptedPdf As PdfDocument = PdfDocument.FromFile("testFile2.pdf", "MyPassword")
VB   C#

9.2. Fusionar varios PDF

Puedes fusionar varios PDF en uno solo de la siguiente manera:

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-14.cs

List<PdfDocument> PDFs = new List<PdfDocument>();
PDFs.Add(PdfDocument.FromFile("1.pdf"));
PDFs.Add(PdfDocument.FromFile("2.pdf"));
PDFs.Add(PdfDocument.FromFile("3.pdf"));
using PdfDocument PDF = PdfDocument.Merge(PDFs);
PDF.SaveAs("mergedFile.pdf");
foreach (PdfDocument pdf in PDFs)
{
    pdf.Dispose();
}

Dim PDFs As New List(Of PdfDocument)()
PDFs.Add(PdfDocument.FromFile("1.pdf"))
PDFs.Add(PdfDocument.FromFile("2.pdf"))
PDFs.Add(PdfDocument.FromFile("3.pdf"))
Using PDF As PdfDocument = PdfDocument.Merge(PDFs)
	PDF.SaveAs("mergedFile.pdf")
'INSTANT VB NOTE: The variable pdf was renamed since Visual Basic will not allow local variables with the same name as parameters or other local variables:
	For Each Me.pdf_Conflict As PdfDocument In PDFs
		Me.pdf_Conflict.Dispose()
	Next pdf_Conflict
End Using
VB   C#

Añada otro PDF al final del PDF actual de la siguiente manera:

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-15.cs
PdfDocument pdf = PdfDocument.FromFile("1.pdf");
PdfDocument pdf2 = PdfDocument.FromFile("2.pdf");
pdf.AppendPdf(pdf2);
pdf.SaveAs("appendedFile.pdf");
Dim pdf As PdfDocument = PdfDocument.FromFile("1.pdf")
Dim pdf2 As PdfDocument = PdfDocument.FromFile("2.pdf")
pdf.AppendPdf(pdf2)
pdf.SaveAs("appendedFile.pdf")
VB   C#

Inserta un PDF en otro PDF empezando por el índice dado:

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-16.cs
PdfDocument pdf = PdfDocument.FromFile("1.pdf");
PdfDocument pdf2 = PdfDocument.FromFile("2.pdf");
pdf.InsertPdf(pdf2, 0);
pdf.SaveAs("InsertIntoSpecificIndex.pdf");
Dim pdf As PdfDocument = PdfDocument.FromFile("1.pdf")
Dim pdf2 As PdfDocument = PdfDocument.FromFile("2.pdf")
pdf.InsertPdf(pdf2, 0)
pdf.SaveAs("InsertIntoSpecificIndex.pdf")
VB   C#

9.3 Añadir encabezados o pies de página

Puede añadir encabezados y pies de página a un PDF existente o cuando renderice el PDF desde HTML o URL.

Hay dos clases que puede utilizar para añadir encabezado o pie de página a un PDF:

  • TextHeaderFooter: añade texto simple en cabecera o pie de página.

  • HtmlHeaderFooter: añadir encabezado o pie de página con contenido HTML enriquecido e imágenes.

    Ahora veamos dos ejemplos de como añadir cabecera/pie a un pdf existente o cuando se renderiza usando estas dos clases.

    9.3.1 Añadir cabecera al pdf existente

    A continuación se muestra un ejemplo para cargar un PDF existente y, a continuación, añadir un encabezado y un pie de página mediante los métodos AddTextHeaders y AddHtmlFooters.

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-17.cs
PdfDocument pdf = PdfDocument.FromFile("testFile.pdf");
TextHeaderFooter header = new TextHeaderFooter()
{
    CenterText = "Pdf Header",
    LeftText = "{date} {time}",
    RightText = "{page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};
pdf.AddTextHeaders(header);
pdf.SaveAs("withHeader.pdf");

HtmlHeaderFooter Footer = new HtmlHeaderFooter()
{
    HtmlFragment = "<span style='text-align:right'> page {page} of {totalpages}</span>",
    DrawDividerLine = true,
    MaxHeight = 10 //mm
};
pdf.AddHtmlFooters(Footer);
pdf.SaveAs("withHeaderAndFooters.pdf");
Dim pdf As PdfDocument = PdfDocument.FromFile("testFile.pdf")
Dim header As New TextHeaderFooter() With {
	.CenterText = "Pdf Header",
	.LeftText = "{date} {time}",
	.RightText = "{page} of {total-pages}",
	.DrawDividerLine = True,
	.FontSize = 10
}
pdf.AddTextHeaders(header)
pdf.SaveAs("withHeader.pdf")

Dim Footer As New HtmlHeaderFooter() With {
	.HtmlFragment = "<span style='text-align:right'> page {page} of {totalpages}</span>",
	.DrawDividerLine = True,
	.MaxHeight = 10
}
pdf.AddHtmlFooters(Footer)
pdf.SaveAs("withHeaderAndFooters.pdf")
VB   C#

9.3.2 Añadir encabezado y pie de página a un nuevo pdf

A continuación se muestra un ejemplo para crear un PDF a partir de un archivo HTML y añadirle un encabezado y un pie de página utilizando las opciones de renderizado.

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-18.cs
ChromePdfRenderer renderer = new ChromePdfRenderer();
renderer.RenderingOptions.TextHeader = new TextHeaderFooter()
{
    CenterText = "Pdf Header",
    LeftText = "{date} {time}",
    RightText = "{page} of {total-pages}",
    DrawDividerLine = true,
    FontSize = 10
};

renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter()
{
    HtmlFragment = "<span style='text-align:right'> page {page} of {totalpages}</span>",
    DrawDividerLine = true,
    MaxHeight = 10
};
PdfDocument pdf = renderer.RenderHtmlFileAsPdf("test.html");
pdf.SaveAs("generatedFile.pdf");
Dim renderer As New ChromePdfRenderer()
renderer.RenderingOptions.TextHeader = New TextHeaderFooter() With {
	.CenterText = "Pdf Header",
	.LeftText = "{date} {time}",
	.RightText = "{page} of {total-pages}",
	.DrawDividerLine = True,
	.FontSize = 10
}

renderer.RenderingOptions.HtmlFooter = New HtmlHeaderFooter() With {
	.HtmlFragment = "<span style='text-align:right'> page {page} of {totalpages}</span>",
	.DrawDividerLine = True,
	.MaxHeight = 10
}
Dim pdf As PdfDocument = renderer.RenderHtmlFileAsPdf("test.html")
pdf.SaveAs("generatedFile.pdf")
VB   C#

10. Añadir contraseña PDF y seguridad

Puede proteger su PDF con una contraseña y editar la configuración de seguridad del archivo, como impedir la copia y la impresión.

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-19.cs
PdfDocument pdf = PdfDocument.FromFile("testFile.pdf");

//  Editar metadatos de archivos
pdf.MetaData.Author = "john smith";
pdf.MetaData.Keywords = "SEO, Friendly";
pdf.MetaData.ModifiedDate = DateTime.Now;

//  Editar la configuración de seguridad de los archivos
//  El siguiente código hace que un PDF sea de sólo lectura y no permitirá copiar y pegar ni imprimir
pdf.SecuritySettings.RemovePasswordsAndEncryption();
pdf.SecuritySettings.MakePdfDocumentReadOnly("secret-key"); //la clave secreta es una contraseña de propietario
pdf.SecuritySettings.AllowUserAnnotations = false;
pdf.SecuritySettings.AllowUserCopyPasteContent = false;
pdf.SecuritySettings.AllowUserFormData = false;
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights;

//  Cambiar o establecer la contraseña de ecripción del documento
pdf.Password = "123";
pdf.SaveAs("secured.pdf");
Dim pdf As PdfDocument = PdfDocument.FromFile("testFile.pdf")

'  Editar metadatos de archivos
pdf.MetaData.Author = "john smith"
pdf.MetaData.Keywords = "SEO, Friendly"
pdf.MetaData.ModifiedDate = DateTime.Now

'  Editar la configuración de seguridad de los archivos
'  El siguiente código hace que un PDF sea de sólo lectura y no permitirá copiar y pegar ni imprimir
pdf.SecuritySettings.RemovePasswordsAndEncryption()
pdf.SecuritySettings.MakePdfDocumentReadOnly("secret-key") 'la clave secreta es una contraseña de propietario
pdf.SecuritySettings.AllowUserAnnotations = False
pdf.SecuritySettings.AllowUserCopyPasteContent = False
pdf.SecuritySettings.AllowUserFormData = False
pdf.SecuritySettings.AllowUserPrinting = IronPdf.Security.PdfPrintSecurity.FullPrintRights

'  Cambiar o establecer la contraseña de ecripción del documento
pdf.Password = "123"
pdf.SaveAs("secured.pdf")
VB   C#

11. Firmar PDF digitalmente

También puedes firmar digitalmente un PDF de la siguiente manera:

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-20.cs
PdfDocument pdf = PdfDocument.FromFile("testFile.pdf");
pdf.Sign(new PdfSignature("cert123.pfx", "password"), IronPdf.Signing.SignaturePermissions.Default);
pdf.SaveAs("signed.pdf");
Dim pdf As PdfDocument = PdfDocument.FromFile("testFile.pdf")
pdf.Sign(New PdfSignature("cert123.pfx", "password"), IronPdf.Signing.SignaturePermissions.Default)
pdf.SaveAs("signed.pdf")
VB   C#

Ejemplo avanzado para un mayor control:

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-21.cs
PdfDocument pdf = PdfDocument.FromFile("testFile.pdf");
IronPdf.Signing.PdfSignature signature = new IronPdf.Signing.PdfSignature("cert123.pfx", "123");

//  Opciones opcionales de firma
signature.SigningContact = "support@ironsoftware.com";
signature.SigningLocation = "Chicago, USA";
signature.SigningReason = "To show how to sign a PDF";

//  Firme el PDF con PdfSignature. Se pueden utilizar varios certificados de firma
pdf.Sign(signature);
Dim pdf As PdfDocument = PdfDocument.FromFile("testFile.pdf")
Dim signature As New IronPdf.Signing.PdfSignature("cert123.pfx", "123")

'  Opciones opcionales de firma
signature.SigningContact = "support@ironsoftware.com"
signature.SigningLocation = "Chicago, USA"
signature.SigningReason = "To show how to sign a PDF"

'  Firme el PDF con PdfSignature. Se pueden utilizar varios certificados de firma
pdf.Sign(signature)
VB   C#

12. Extraer texto e imágenes de PDF

Extraer texto e imágenes Con IronPdf puede extraer texto e imágenes de un PDF de la siguiente manera:

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-22.cs
PdfDocument pdf = PdfDocument.FromFile("testFile.pdf");

pdf.ExtractAllText(); //  Extraer todo el texto del pdf
pdf.ExtractTextFromPage(0); //  Leer texto de una página específica

//  Extraer todas las imágenes del pdf
var AllImages = pdf.ExtractAllImages();

//  Extraer imágenes de una página específica
var ImagesOfAPage = pdf.ExtractImagesFromPage(0);
Dim pdf As PdfDocument = PdfDocument.FromFile("testFile.pdf")

pdf.ExtractAllText() '  Extraer todo el texto del pdf
pdf.ExtractTextFromPage(0) '  Leer texto de una página específica

'  Extraer todas las imágenes del pdf
Dim AllImages = pdf.ExtractAllImages()

'  Extraer imágenes de una página específica
Dim ImagesOfAPage = pdf.ExtractImagesFromPage(0)
VB   C#

12.1. Rasterizar PDF a imagen

También puedes convertir páginas PDF en imágenes de la siguiente manera

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-23.cs
PdfDocument pdf = PdfDocument.FromFile("testFile.pdf");

List<int> pageList = new List<int>() { 1, 2 };

pdf.RasterizeToImageFiles("*.png", pageList);
Dim pdf As PdfDocument = PdfDocument.FromFile("testFile.pdf")

Dim pageList As New List(Of Integer)() From {1, 2}

pdf.RasterizeToImageFiles("*.png", pageList)
VB   C#

13. Añadir marca de agua PDF

The following is an example of how to watermark PDF pages.

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-24.cs
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf");

//  Aplicar marca de agua
pdf.ApplyWatermark("<h2 style='color:red'>SAMPLE</h2>", 30, IronPdf.Editing.VerticalAlignment.Middle, IronPdf.Editing.HorizontalAlignment.Center);
pdf.SaveAs("Watermarked.pdf");
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderUrlAsPdf("https://www.nuget.org/packages/IronPdf")

'  Aplicar marca de agua
pdf.ApplyWatermark("<h2 style='color:red'>SAMPLE</h2>", 30, IronPdf.Editing.VerticalAlignment.Middle, IronPdf.Editing.HorizontalAlignment.Center)
pdf.SaveAs("Watermarked.pdf")
VB   C#

La marca de agua tiene un conjunto restringido de opciones y funciones. Para un mayor control, puede utilizar la clase HTMLStamper.

:path=/static-assets/pdf/content-code-examples/tutorials/dotnet-core-pdf-generating-25.cs
ChromePdfRenderer renderer = new ChromePdfRenderer();
PdfDocument pdf = renderer.RenderHtmlAsPdf("<div>test text </div>");

//  Configurar el estampador HTML
HtmlStamper backgroundStamp = new HtmlStamper()
{
    Html = "<h2 style='color:red'>copyright 2018 ironpdf.com",
    MaxWidth = new Length(20),
    MaxHeight = new Length(20),
    Opacity = 50,
    Rotation = -45,
    IsStampBehindContent = true,
    VerticalAlignment = VerticalAlignment.Middle
};

pdf.ApplyStamp(backgroundStamp);
pdf.SaveAs("stamped.pdf");
Dim renderer As New ChromePdfRenderer()
Dim pdf As PdfDocument = renderer.RenderHtmlAsPdf("<div>test text </div>")

'  Configurar el estampador HTML
Dim backgroundStamp As New HtmlStamper() With {
	.Html = "<h2 style='color:red'>copyright 2018 ironpdf.com",
	.MaxWidth = New Length(20),
	.MaxHeight = New Length(20),
	.Opacity = 50,
	.Rotation = -45,
	.IsStampBehindContent = True,
	.VerticalAlignment = VerticalAlignment.Middle
}

pdf.ApplyStamp(backgroundStamp)
pdf.SaveAs("stamped.pdf")
VB   C#

Acceso rápido a tutoriales

Obtener el código fuente

Acceda a todo el código fuente que se encuentra en este tutorial como un archivo ZIP de proyecto de Visual Studio, fácil de usar y compartir para su proyecto.

Obtener el código

Acceso al tutorial de GitHub

Explore este tutorial y muchos más a través de GitHub. Utilizar los proyectos y el código fuente es la mejor manera de aprender y aplicarlo a sus propias necesidades y casos de uso de PDF .NET Core.

Generar PDFs en .NET Core Tutorial

Conserve el PDF CSharp Cheat Sheet

Desarrolle PDFS en sus aplicaciones .NET utilizando nuestro práctico documento de referencia. Con acceso rápido a funciones y ejemplos comunes para generar y editar PDF en C# y VB.NET, esta herramienta para compartir le ayuda a ahorrar tiempo y esfuerzo al empezar a utilizar IronPDF y los requisitos comunes de PDF en su proyecto.

Guarde la chuleta

Más documentación

Lea la Referencia de la API de IronPDF, que presenta exhaustivamente los detalles de todas las características de IronPDF, además de los espacios de nombres, clases, métodos, campos y enums.

Documentación de referencia de la API