Use o IronPDF com o Modo integrado ao mecanismo.

Diferença entre Native e Engine

O IronPDF possui algumas funções que exigem alto desempenho e que você pode optar por executar remotamente. Embora o IronPDF não exija o IronPDFEngine para funcionar, configurar o IronPDFEngine como um serviço remoto é uma maneira opcional de evitar problemas de compatibilidade com o Chrome em sistemas operacionais mais antigos e ambientes móveis.

Como o uso do Engine muda a forma como você programa com o IronPDF

Ao usar a configuração do Engine, recomendamos instalar o pacote IronPdf.Slim em vez do pacote completo IronPdf do NuGet, pois o Engine gerencia todo o volume extra incluído no pacote Native.

Install-Package IronPdf.Slim

Após instalar o IronPdf.Slim, configure as definições de conexão apontando o IronPDF para a sua instância do IronPdfEngine. Adicione o seguinte código na inicialização da sua aplicação (ou antes de chamar qualquer método do IronPDF) :

// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application

// Establish a connection with the remote IronPdfEngine
// Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Additional code for your application

' Establish a connection with the remote IronPdfEngine
' Remember to replace the IP address and port with your actual server details
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))

' Additional code for your application

Como funciona o IronPDFEngine?

O IronPDFEngine é um servidor conteinerizado projetado para gerenciar várias operações do IronPDF, incluindo a criação, gravação, edição e leitura de PDFs, tudo usando o protocolo gRPC. Construído como um aplicativo C# .NET independente, o IronPDFEngine opera de forma autônoma, eliminando a necessidade do ambiente de execução .NET durante a execução. Nós cuidamos da conexão gRPC para você, para que você possa se concentrar na programação!

Para um tutorial rápido sobre como executar o IronPDF como um contêiner independente, consulte este tutorial . O contêiner Docker suporta 16 parâmetros de configuração de tempo de execução para porta, registro de logs, limites do Chrome e muito mais — consulte a referência completa de parâmetros .

Outros esclarecimentos para o IronPDFEngine

O IronPDF .NET não requer o IronPDFEngine para funcionar. IronPDFEngine é apenas uma forma opcional de usar o IronPDF. Por padrão, o IronPDF for .NET não utiliza o IronPDFEngine.

Install-Package IronPdf.Slim

// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

// Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(
    IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350")
);

' Connect to the remote IronPdfEngine
Installation.ConnectToIronPdfHost(IronPdf.GrpcLayer.IronPdfConnectionConfiguration.RemoteServer("123.456.7.8:33350"))

Limitações do IronPDFEngine

• Atualmente, o IronPDFEngine ainda não suporta escalonamento horizontal (balanceamento de carga com múltiplas instâncias) porque armazenamos os binários do arquivo PDF em processamento na memória do servidor e usamos o PdfDocumentId para comunicação entre servidor e cliente. Isso também minimiza o uso de largura de banda e aumenta a velocidade de processamento. Para executar o IronPDFEngine em Docker remotamente, você precisa garantir que a porta do IronPDFEngine esteja acessível.
• O Docker do IronPDFEngine em execução no Linux x64 (Debian) usando imagens oficiais baseadas no Ubuntu 22.04 pode produzir PDFs com resultados ligeiramente diferentes daqueles obtidos com o IronPDF executado localmente, devido ao comportamento distinto do sistema operacional.
• Como o IronPdfEngine Docker é baseado em Linux, ele requer o daemon de contêineres do Linux (selecione Switch to Linux Containers se você estiver usando o Windows).
• Os binários do IronPDFEngine não são multiplataforma, por isso os compilamos especificamente para cada plataforma.
• Não há suporte disponível entre versões diferentes.