Como Instalar Aspose.PDF for .NET

Componente Aspose.PDF C#

Descrição do Produto

Aspose.PDF for .NET é um componente .NET robusto que permite aos desenvolvedores criar documentos PDF do zero sem usar o Adobe Acrobat. Ele fornece uma Interface de Programação de Aplicações (API) simples que é fácil de aprender e usar.

Aspose.PDF for .NET é implementado usando C# Gerenciado e pode ser usado com qualquer linguagem .NET, como C#, VB.NET e J#, etc. Ele pode ser integrado a qualquer tipo de aplicação, seja uma Aplicação Web ASP.NET ou uma Aplicação Windows.

Para que os desenvolvedores possam começar rapidamente, Aspose.PDF for .NET fornece demos totalmente funcionais e exemplos práticos escritos em C#. Usando essas demos, os desenvolvedores podem aprender rapidamente sobre os recursos fornecidos por Aspose.PDF for .NET.

O componente rápido e leve cria documentos PDF de forma eficiente e ajuda sua aplicação a ter um desempenho melhor. Aspose.PDF for .NET é a primeira escolha de nossos clientes ao criar documentos PDF devido ao seu preço, desempenho excepcional e ótimo suporte.

Aspose.PDF for .NET é seguro para multithread, desde que apenas um thread trabalhe em um documento por vez. É um cenário típico ter um thread trabalhando em um documento. Threads diferentes podem trabalhar com segurança em documentos diferentes ao mesmo tempo.

Declaração

Todos os componentes Aspose .NET requerem um conjunto de permissões de Confiança Total. A razão é que os componentes Aspose .NET precisam acessar configurações de registro, arquivos de sistema além do diretório virtual para certas operações, como análise de fontes, etc. Além disso, os Componentes Aspose .NET são baseados em classes do sistema .NET core que também requerem um conjunto de permissões de Confiança Total em muitos casos.

Provedores de Serviços de Internet que hospedam várias aplicações de diferentes empresas geralmente impõem um nível de segurança de Confiança Média. No caso do .NET 2.0, tal nível de segurança aplica as seguintes restrições:

  • OleDbPermission não está disponível. Isso significa que você não pode usar o provedor de dados OLE DB gerenciado ADO.NET para acessar bancos de dados.
  • EventLogPermission não está disponível. Isso significa que você não pode acessar o log de eventos do Windows.
  • ReflectionPermission não está disponível. Isso significa que você não pode usar reflexão.
  • RegistryPermission não está disponível. Isso significa que você não pode acessar o registro.
  • WebPermission é restrito. Isso significa que sua aplicação só pode se comunicar com um endereço ou intervalo de endereços que você define no elemento <trust>.
  • FileIOPermission é restrito. Isso significa que você só pode acessar arquivos na hierarquia do diretório virtual da sua aplicação. Devido às razões especificadas acima, os componentes Aspose .NET não podem ser usados em servidores que concedem um conjunto de permissões diferente de Confiança Total.

Instalação

Avaliar Aspose.PDF for .NET

Você pode facilmente baixar Aspose.PDF for .NET para avaliação. O download de avaliação é o mesmo que o download comprado. A versão de avaliação simplesmente se torna licenciada quando você adiciona algumas linhas de código para aplicar a licença.

A versão de avaliação do Aspose.PDF (sem uma licença especificada) fornece total funcionalidade do produto. No entanto, possui duas limitações: insere uma marca d’água de avaliação e apenas as quatro primeiras páginas de qualquer documento podem ser visualizadas/editadas.

Instalando Aspose.PDF for .NET através do NuGet

NuGet é um sistema de gerenciamento de pacotes gratuito e de código aberto, focado em desenvolvedores, para a plataforma .NET, com a intenção de simplificar o processo de incorporação de bibliotecas de terceiros em uma aplicação .NET durante o desenvolvimento. É uma extensão do Visual Studio que facilita a adição, remoção e atualização de bibliotecas e ferramentas em projetos do Visual Studio que usam o .NET Framework. Uma biblioteca ou ferramenta pode ser facilmente compartilhada com outros desenvolvedores criando um pacote NuGet e armazenando-o dentro de um repositório NuGet. Quando você instala o pacote, o NuGet copia arquivos para sua solução e faz automaticamente as alterações necessárias, como adicionar referências e alterar seus arquivos app.config ou web.config. Se você decidir remover a biblioteca, o NuGet remove arquivos e reverte quaisquer alterações que fez em seu projeto para que nenhum resíduo permaneça.

Referenciando Aspose.PDF for .NET

Instalar pacote usando o Console do Gerenciador de Pacotes

  • Abra sua aplicação .NET no Visual Studio.
  • No menu Ferramentas, selecione Gerenciador de Pacotes NuGet e depois Console do Gerenciador de Pacotes.
  • Digite o comando Install-Package Aspose.PDF para instalar a versão completa mais recente, ou digite o comando Install-Package Aspose.PDF -prerelease para instalar a versão mais recente incluindo correções.
  • Pressione Enter.

Atualizar pacote usando o Console do Gerenciador de Pacotes

Se você já referenciou o componente através do NuGet, siga estes passos para atualizar a referência para a versão mais recente:

  • Abra sua aplicação .NET no Visual Studio.
  • No menu Ferramentas, selecione Gerenciador de Pacotes NuGet e depois Console do Gerenciador de Pacotes.
  • Digite o comando Update-Package Aspose.PDF para referenciar a versão completa mais recente, ou digite o comando Update-Package Aspose.PDF -prerelease para instalar a versão mais recente incluindo correções.

Instalar Pacote usando a GUI do Gerenciador de Pacotes

Siga estes passos para referenciar o componente usando a GUI do gerenciador de pacotes:

  • Abra sua aplicação .NET no Visual Studio.

  • No menu Projeto, selecione Gerenciar Pacotes NuGet.

Installation_step

  • Selecione a aba Broswe.

Installation_step1

  • Digite Aspose.PDF na caixa de pesquisa para encontrar Aspose.PDF for .NET.

  • Clique em Instalar/Atualizar ao lado da versão mais recente de Aspose.PDF for .NET.

Installation_step2

  • E clique em Aceitar na janela pop-up.

Installation_step3

Installation

Trabalhando com DLLs .NET Core em Ambiente Não-Windows

Como Aspose.PDF for .NET fornece suporte ao .NET Standard 2.0 (.NET Core 2.0), ele pode ser usado em Aplicações Core executando em sistemas operacionais semelhantes ao Linux. Estamos constantemente trabalhando para melhorar o suporte ao .NET Core em nossa API. No entanto, existem algumas operações que recomendamos que nossos clientes realizem, a fim de obter melhores resultados ao usar os recursos de Aspose.PDF for .NET:

Por favor, instale:

  • pacote libgdiplus
  • pacote com fontes compatíveis com Microsoft: ttf-mscorefonts-installer. (por exemplo, sudo apt-get install ttf-mscorefonts-installer) Essas fontes devem ser colocadas no diretório “/usr/share/fonts/truetype/msttcorefonts”, pois Aspose.PDF for .NET escaneia esta pasta em sistemas operacionais semelhantes ao Linux. Caso o sistema operacional tenha outra pasta/diretório padrão para fontes, você deve usar a seguinte linha de código antes de realizar qualquer operação usando Aspose.PDF.
Aspose.Pdf.Text.FontRepository.Sources.Add(new FolderFontSource("<user's path to ms fonts>"));

Configurar Aspose.PDF for .NET no Visual Studio Code

  • Instale o SDK .NET
  1. Visite o site oficial da Microsoft .NET.
  2. Baixe o SDK .NET mais recente.
  3. Execute o instalador.
  4. Abra um terminal e verifique a instalação executando:
dotnet --version
  • Instale o Visual Studio Code
  1. Vá para https://code.visualstudio.com/.
  2. Baixe a versão apropriada para seu sistema operacional.
  • Instale as Extensões Necessárias do VS Code
  1. Abra o Visual Studio Code.
  2. Clique no ícone de visualização de Extensões (ícone quadrado na barra lateral esquerda).
  3. Pesquise e instale as seguintes extensões:
    • “C#” da Microsoft
    • “C# Dev Kit” da Microsoft
    • “.NET Core Test Explorer” (opcional, mas recomendado)
  • Crie um novo projeto .NET
  1. Abra o Visual Studio Code
  2. Vá para Terminal > Novo Terminal
  3. Navegue até o diretório do seu projeto desejado
# Create a new console application
dotnet new console -n AsposePDFNetDemo
# Navigate into the project directory
cd AsposePDFNetDemo
  • Adicione o pacote NuGet
# Install Aspose.PDF package
dotnet add package Aspose.PDF
  • Verifique a instalação do pacote
  1. Abra o arquivo .csproj
  2. Confirme que a referência do pacote Aspose.PDF foi adicionada:
<ItemGroup>
  <PackageReference Include="Aspose.PDF" Version="x.x.x" />
</ItemGroup>
  • Crie a Configuração de Depuração
  1. Pressione Ctrl+Shift+P (Cmd+Shift+P no Mac).
  2. Digite “>.NET: Gerar Ativos para Compilação e Depuração”.
  3. Selecione seu projeto.
  4. Crie ou modifique .vscode/launch.json:
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": ".NET Core Launch (console)",
            "type": "coreclr",
            "request": "launch",
            "preLaunchTask": "build",
            "program": "${workspaceFolder}/bin/Debug/net7.0/AsposePDFNetDemo.dll",
            "args": [],
            "cwd": "${workspaceFolder}",
            "console": "internalConsole",
            "stopAtEntry": false
        }
    ]
}
  • Escreva o código de exemplo em Program.cs

Substitua o conteúdo de Program.cs por:

// For complete examples and data files, visit https://github.com/aspose-pdf/Aspose.PDF-for-.NET
using System;
using Aspose.Pdf;
using Aspose.Pdf.Text;

class Program 
{
    static void Main(string[] args)
    {
        // Activate your license, you can comment out these codelines to use library in Evaluation mode
        var license = new Aspose.Pdf.License();
        license.SetLicense("Aspose.PDF.NET.lic");

        // Create PDF document
        using (var document = new Aspose.Pdf.Document())
        {
            // Add page
            var page = document.Pages.Add();
            
            // Create a text fragment
            var textFragment = new Aspose.Pdf.Text.TextFragment("Hello, Aspose.PDF for .NET!");
            textFragment.Position = new Aspose.Pdf.Text.Position(100, 600);
            
            // Add text to the page
            page.Paragraphs.Add(textFragment);
            
            // Save PDF document
            document.Save("sample.pdf");
        }
    }
}
  • Compile e execute
dotnet restore
dotnet build
dotnet run
Por que Aspose.PDF Requisitos do Sistema