Cómo instalar la librería IronPDF en un proyecto .NET

This article was translated from English: Does it need improvement?
Translated
View the article in English

Instalar la biblioteca PDF de C# toma menos de 5 minutos.

El software gratuito para desarrolladores está disponible a través de NuGet y descarga directa, y con este tutorial, lo pondremos en marcha en Visual Studio. Siga las instrucciones siguientes para empezar a convertir HTML a PDF en su proyecto .NET.


Tutorial

1.1. Instalar IronPDF mediante NuGet

Utilice los siguientes pasos para instalar la biblioteca NuGet de IronPDF desde Visual Studio.

  1. En el Explorador de soluciones, haga clic con el botón derecho en Referencias, Gestionar paquetes NuGet

  2. Seleccione Navegar y busque "IronPdf"

  3. Seleccione el paquete e instálelo.
Install-Package IronPdf

También hay paquetes de NuGet de IronPDF disponibles para despliegues específicos en guía avanzada de instalación de NuGet de IronPDF.


1.2. Instalar IronPDF por DLL Descargar

La segunda forma de instalar IronPDF es descargándolo. Sigue estos pasos rápidos y sencillos:

  1. Descargue y descomprima el paquete de DLL de Windows IronPDF en una ubicación como ~/Libs dentro de su directorio de Solución

  2. En el Explorador de soluciones de Visual Studio, haz clic con el botón derecho del ratón en "Dependencias" y "Añadir referencia de proyecto". Seleccione Examinar e incluya todas las DLL extraídas del zip.

    Aquí encontrará otros paquetes zip DLL IronPDF disponibles para plataformas específicas:

Aplicar clave de licencia

Incluya este código al inicio de su aplicación, antes de utilizar IronPDF. Este enfoque es universalmente eficaz y fácil de aplicar.

IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY";
IronPdf.License.LicenseKey = "YOUR-IRONPDF-LICENSE-KEY"
$vbLabelText   $csharpLabel

Si prefiere no aplicar la clave de licencia usando código en línea, por favor visite la 'Guía de Claves de Licencia de IronPDF' para explorar métodos alternativos.


2. Conceder el acceso necesario al archivo o carpeta

A veces puede ser necesario añadir permisos a ciertos usuarios o roles en tu PC.

Por ejemplo, cada AppPool no pueden compartir un TempFolderPath.

¿Qué significa esto?

Un AppDomain simplemente proporciona una capa de aislamiento dentro de un determinado proceso. Todo lo que usted considera por programa es en realidad por dominio de aplicación. Cada una de estas aplicaciones del mismo grupo de aplicaciones necesita su propia carpeta Temporary para funcionar de forma totalmente independiente.

Si es necesario para cualquiera de las opciones de solución de problemas antes mencionadas, puede establecer los permisos de la siguiente manera:

  1. Haga clic con el botón derecho en un archivo o carpeta

  2. Seleccionar propiedades

  3. Seleccione Seguridad

  4. Haga clic en Editar...

  5. Seleccione los permisos deseados.

3. Establecer ruta de instalación

Para renderizar HTML como PDF, IronPDF debe integrar Chromium, que es un navegador web seguro. Por suerte, este proceso está totalmente automatizado.

Si HTML to PDF de IronPDF lanza una excepción de "renderización fallida", lo cual es muy poco probable, es posible que tenga que descomprimir los binarios nativos del navegador en una ubicación adecuada. La carpeta Temp suele ser ideal.

Nota: Archivos de programa nunca es una ubicación adecuada.

Configuración de IronPdf.Installation.TempFolderPath

Puede descomprimir en la ubicación correcta configurando la propiedad TempFolderPath del objeto IronPdf.Installation como se muestra aquí:

IronPdf.Installation.TempFolderPath = @"C:\My\Safe\Path";

Después de actualizar una ruta, recuerde siempre borrar todas las carpetas temporales y de caché de sus servidores de desarrollo. Vuelva a desplegar una versión LIMPIA de su aplicación.

Configuración de la variable de entorno de la carpeta Temp en el ámbito de la aplicación

IronPDF puede generar ocasionalmente archivos temporales mientras renderiza y edita documentos PDF en una carpeta temporal del sistema. Podemos establecer IronPDF.Installation.TempFolderPath para evitar esto, también, sin embargo, el Directorio TempPath Ambiental todavía puede a veces ser utilizado por paquetes de terceros.

Para resolver este problema, podemos establecer la Variable Ambiental TempPath a nivel de aplicación al iniciar la aplicación C# . Esto asegura que todos los archivos temporales creados por su aplicación se almacenen en una ubicación controlable.

using IronPdf;

// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
using IronPdf;

// Set Application scope Temp Files Path.
// This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
var MyTempPath = @"C:\Safe\Path\";
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process);
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process);

// Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf");

// Your PDF Generation and editing code here..E.G.
var Renderer = new IronPdf.ChromePdfRenderer();
using var Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>");
Doc.SaveAs("example.pdf");
Imports IronPdf

' Set Application scope Temp Files Path.
' This changes System.IO.Path.GetTempFileName and System.IO.Path.GetTempPath behavior for the entire .NET application
Private MyTempPath = "C:\Safe\Path\"
Environment.SetEnvironmentVariable("TEMP", MyTempPath, EnvironmentVariableTarget.Process)
Environment.SetEnvironmentVariable("TMP", MyTempPath, EnvironmentVariableTarget.Process)

' Set IronPDF Temp Path
IronPdf.Installation.TempFolderPath = System.IO.Path.Combine(MyTempPath, "IronPdf")

' Your PDF Generation and editing code here..E.G.
Dim Renderer = New IronPdf.ChromePdfRenderer()
Dim Doc = Renderer.RenderHtmlAsPdf("<h1>Html with CSS and Images</h1>")
Doc.SaveAs("example.pdf")
$vbLabelText   $csharpLabel

4. Permisos e IIS

En caso de que el servidor haya sido bloqueado, es posible que necesite otorgar al usuario de IIS (IUSER) permisos de lectura y escritura en su Carpeta de Ruta de Instalación, así como en sus Carpetas de Windows y Temp.


5. Microsoft Visual C++ y compatibilidad con Windows

IronPDF necesita que Microsoft Visual C++ esté instalado en el equipo Windows de destino. Si es necesario, puede empaquetarse con un instalador de aplicaciones como un MSI.

Microsoft Visual C++ es un componente de Windows y suele estar presente en las versiones modernas de Windows, a menos que se hayan reducido deliberadamente.

El .NET Framework puede ejecutarse como 32 bits (incluso en plataformas de 64 bits), por lo que es necesario instalar Visual C++ tanto en las versiones de 32 como de 64 bits.

Aquí puedes descargar Microsoft Visual C++ desde la página oficial de soporte.


6. Compatibilidad con Linux

7. Compatibilidad con Docker

8. Compatibilidad con Azure

9. Compatibilidad con Amazon AWS Lambda

10. Compatibilidad con macOS

Chaknith Bin
Ingeniero de software
Chaknith trabaja en IronXL e IronBarcode. Tiene una gran experiencia en C# y .NET, ayudando a mejorar el software y a apoyar a los clientes. Sus conocimientos de las interacciones con los usuarios contribuyen a mejorar los productos, la documentación y la experiencia general.