Cómo instalar la librería IronPDF en un proyecto .NET
Instalación del Biblioteca PDF en C# tarda 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#
Tutorial
1.1. Instalar IronPDF mediante NuGet
Siga los siguientes pasos para instalar el Biblioteca IronPDF NuGet desde Visual Studio.
- En el Explorador de soluciones, haga clic con el botón derecho en Referencias, Gestionar paquetes NuGet
- Selecciona Examinar y busca
"IronPdf"
. - Seleccione el paquete e instálelo.
Install-Package IronPdf
También hay paquetes NuGet de IronPDF disponibles para implementaciones específicas para Mac, Linux, Azure, Docker y AWS documentados en nuestro Guía de instalación avanzada de NuGet para IronPDF.
1.2. Instalar IronPDF por DLL Descargar
La segunda forma de instalar IronPDF es descargándolo. Sigue estos pasos rápidos y sencillos:
- Descargue y descomprima Windows Archivo IronPDF en una ubicación como ~/Libs dentro de su directorio de soluciones
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.
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 = "IRONPDF-MYLICENSE-KEY-1EF01";
IronPdf.License.LicenseKey = "IRONPDF-MYLICENSE-KEY-1EF01";
IRON VB CONVERTER ERROR developers@ironsoftware.com
Si prefiere no aplicar la clave de licencia mediante código en línea, visite la página 'Claves de licencia de IronPDFpara 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 Aplicaciones en el mismo AppPool no pueden compartir una 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
Prestar HTML como PDFIronPDF debe integrar Chromium, que es un navegador 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 estableciendo la propiedad TempFolderPath del archivo Instalación de IronPdf 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 Ambiental TempPath a nivel de aplicación en el inicio de la aplicación C#. Esto asegura que todos los archivos temporales creados por su aplicación se almacenan 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");
IRON VB CONVERTER ERROR developers@ironsoftware.com
4. Permisos e IIS
En caso de que el servidor haya sido bloqueado, es posible que tenga que dar al usuario IIS (IUSER) permisos de lectura y escritura en su carpeta de ruta de instalación, así como en su carpeta 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.
.NET Framework puede ejecutarse en 32 bits (incluso en plataformas de 64 bits)por lo que es necesario instalar Visual C++ en sus versiones de 32 y 64 bits.
Aquí puede descargar Microsoft Visual C.
6. Compatibilidad con Linux
- IronPDF es compatible con Linux. Apoyamos oficialmente: Ubuntu, Debian, CentOS, Fedora y Amazon Linux 2.
- Implantación de IronPDF en Linux está bien documentado y es una opción popular para implementaciones en la nube como Azure.
7. Compatibilidad con Docker
- Despliegue de IronPDF en Docker está bien documentada.
- Soportamos oficialmente Docker para: Windows, Ubuntu, Debian, CentOS y Amazon Linux 2 y proporcionamos archivos Docker de trabajo.
8. Compatibilidad con Azure
- Soporte oficial para Azure WebApps, Azure WebJobs, Azure Functions y Azure Docker instances y Azure VMs.
- Lea el IronPDF Guía de configuración de Azure y Azure Function.
9. Compatibilidad con Amazon AWS Lambda
- A tutorial y soporte para Amazon AWS Lambda está incluido.
10. Compatibilidad con macOS
- Asistencia oficial para la implantación y el desarrollo de macOS utilizando Rider y "Visual Studio para Mac" son compatibles
- Lea nuestro Guía completa de macOS.