Cómo empezar con la biblioteca PDF de C# de IronPDF

Translated

View the article in English

IronPDF es nuestra completa y versátil biblioteca de software que le brinda control granular total sobre la generación, edición y exportación de archivos PDF en su proyecto o flujo de trabajo. Así como cada aspecto y detalle en su salida.

Con esta poderosa herramienta que tiene soporte en una variedad de lenguajes como C#, F#, VB.NET, Java y más. Es la mejor solución para tus problemas de PDF. Este artículo le guiará a través del método de Instalación de IronPDF en C#.

El software gratuito para desarrollo está disponible a través de NuGet y descarga directa. Siga las instrucciones siguientes para empezar a convertir HTML a PDF en su proyecto .NET.

Comience a usar IronPDF en su proyecto hoy con una prueba gratuita.

Primer Paso:

Cómo instalar IronPDF: Elegir el modo adecuado: Nativo vs Remoto

IronPDF ofrece dos modos para renderizar PDF: Modo Nativo y Modo Remoto, adaptados para ajustarse a diferentes entornos de desarrollo:

Modo Nativo: Ideal para desarrolladores que buscan ejecutar todo localmente, adecuado para implementaciones modernas en Windows, macOS y Linux. Simplemente instale el siguiente paquete:

IronPdf
Modo Remoto (IronPdfEngine): Ideal para entornos en la nube y contenerizados como Azure, AWS y Docker, donde las dependencias se pueden gestionar de forma centralizada. También es ideal para sistemas operativos no compatibles de forma nativa o heredados, como Windows Server 2012 y distribuciones de Linux menos populares. Simplemente instale el siguiente paquete en su proyecto y conéctese al contenedor de IronPdfEngine:
IronPdf.Slim

Utilice IronPDF con Remote Engine

Atención

¿Cuál es la diferencia entre Native y Engine?

IronPDF tiene algunas funciones de alto rendimiento que puedes elegir ejecutar de forma remota. Aunque IronPDF no requiere IronPdfEngine para funcionar, configurar IronPdfEngine como un servicio remoto es una forma opcional de evitar problemas de compatibilidad específicos de la plataforma con Chrome en sistemas operativos más antiguos y en entornos móviles.

¿Cómo cambia el uso de Engine la forma en que programo con IronPDF?

Al utilizar la configuración del Engine, recomendamos instalar IronPdf.Slim en lugar del paquete completo IronPdf de NuGet, ya que el Engine gestiona todo el volumen adicional incluido en el paquete Nativo.

PM> Install-Package IronPdf.Slim

Después de instalar IronPdf.Slim, configure los ajustes de conexión apuntando IronPDF a su instancia de IronPdfEngine. Agrega el siguiente código al inicio de tu aplicación (o antes de llamar a cualquier método de IronPDF):

// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));

// Assuming that IronPdfEngine runs
// remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost( IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"));

' Assuming that IronPdfEngine runs
' remotely at 123.456.7.8:33350.
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))

$vbLabelText $csharpLabel

Cómo instalar la biblioteca IronPDF en un proyecto .NET (nativo)

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

El software gratuito para desarrollo 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.

Instalación paso a paso de la biblioteca PDF de C#

Instalar a través de NuGet
Instalación por descarga directa
Conceder acceso a la ruta o carpeta correcta
Establecer la ruta de instalación
Obtenga soporte para Docker, Linux y más

Tutorial

Método 1: Instalar IronPDF a través de NuGet

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

En el Explorador de soluciones, haga clic con el botón derecho en Referencias, Gestionar paquetes NuGet
Selecciona Navegar y busca IronPdf
Seleccione el paquete e instálelo.

Install-Package IronPdf

También hay paquetes NuGet de IronPDF disponibles para implementaciones específicas en Mac, Linux, Azure, Docker y AWS, documentados en nuestra guía avanzada de instalación de NuGet de IronPDF.

Método 2: Instalar IronPDF mediante descarga de DLL

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

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

Operating System	ZIP Package
Windows	IronPdf.zip
Linux	IronPdf.Linux.zip
Mac	IronPdf.MacOs.zip

Descarga y descomprime el archivo ZIP correcto para tu sistema operativo en una ubicación como ~/Libs dentro del directorio de tu Solución.
En el Explorador de soluciones de Visual Studio, haz clic con el botón derecho en "Dependencias" y "Añadir referencia de proyecto". Seleccione Examinar e incluya todas las dll extraídas del zip.

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 prefieres no aplicar la clave de licencia usando código inline, por favor visita el artículo 'IronPDF License Keys' 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 AppDomain requiere su propio TempFolderPath y las aplicaciones en el mismo 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:

Haga clic con el botón derecho en un archivo o carpeta
Seleccionar propiedades
Seleccione Seguridad
Haga clic en Editar...
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 ser utilizado a veces por paquetes de terceros.

Para resolver este problema, podemos establecer la variable de entorno 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 necesites otorgar al usuario de IIS (IUSER) permisos de lectura y escritura en tu Carpeta del Camino de Instalación, así como en tus 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, se puede empaquetar con un instalador de aplicaciones, como un MSI.

Microsoft Visual C++ es un componente de Windows y normalmente está 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í puede descargar Microsoft Visual C++.

6. Compatibilidad con Linux

IronPDF es compatible con Linux. Oficialmente, damos soporte a: Ubuntu, Debian, CentOS, Fedora y Amazon Linux 2.
Implementación de IronPDF en Linux está bien documentada y es una opción popular para implementaciones en la nube como Azure.

7. Compatibilidad con Docker

Implementar IronPDF en Docker está bien documentado.
Oficialmente admitimos Docker para: Windows, Ubuntu, Debian, CentOS y Amazon Linux 2 y proporcionamos archivos Docker funcionales.

8. Compatibilidad con Azure

Soporte oficial para Azure WebApps, Azure WebJobs, Azure Functions y Azure Docker instances y Azure VMs.
Lea la Guía de configuración de Azure y Azure Function de IronPDF.