FAQ — Aspose.PDF FOSS per .NET

Licenze e Open Source

Qual è il modello di licenza per Aspose.PDF FOSS per .NET?

Aspose.PDF FOSS per .NET è rilasciato sotto la licenza MIT. È possibile utilizzare, copiare, modificare e distribuire la libreria gratuitamente, anche in prodotti commerciali, senza acquistare una licenza commerciale. Il codice sorgente è disponibile pubblicamente su GitHub.

Posso usare Aspose.PDF FOSS per .NET in software commerciale?

Sì. La licenza MIT consente l’uso in applicazioni proprietarie e commerciali senza costi di runtime. È necessario conservare l’avviso di licenza in qualsiasi copia distribuita o parte sostanziale della libreria.

Ho bisogno di una chiave di licenza Aspose o di una licenza a consumo?

Non è necessaria alcuna chiave di licenza per Aspose.PDF FOSS. La proprietà Document.IsLicensed riflette lo stato interno della licenza ma non è necessario alcun passaggio di attivazione — la libreria funziona completamente senza licenza a costo zero.

Installazione e Requisiti

Come installo Aspose.PDF FOSS per .NET?

Installa da NuGet usando la CLI .NET:

dotnet add package Aspose.Pdf.Foss --version 0.1.0-alpha

Oppure aggiungi al file di progetto:

<PackageReference Include="Aspose.Pdf.Foss" Version="0.1.0-alpha" />

Quale versione .NET è richiesta?

Aspose.PDF FOSS mira a .NET 8 e versioni successive. Non supporta .NET Framework, .NET Standard o versioni precedenti di .NET Core. Verifica che il tuo progetto abbia come target net8.0 o versioni successive nel file .csproj.

Ci sono dipendenze native o strumenti esterni richiesti?

No. Aspose.PDF FOSS è una libreria .NET completamente gestita senza binari nativi non gestiti e senza dipendenza da Adobe Acrobat, Ghostscript o qualsiasi altro strumento esterno.

Supporto Formato

Quali formati supporta Aspose.PDF FOSS per .NET?

La libreria legge e scrive il formato PDF. Il metodo Document.Open accetta array di byte, percorsi di file e stream. I metodi Document.Save e Document.ToArray producono output PDF. L’output immagine (per il rendering delle pagine) è gestito dall’enum ImageFormat, che supporta BMP, GIF, JPEG, PNG, TIFF e altri formati raster.

Aspose.PDF FOSS può convertire le pagine PDF in immagini?

Sì. Il rendering delle pagine in formati raster è supportato tramite l’enumerazione ImageFormat, che include i membri Bmp, Jpeg, Png, Gif, Tiff e Emf. Classi di dispositivo specifiche gestiscono la pipeline di rendering.

Utilizzo dell’API

Come creo un nuovo documento PDF?

Usa Document.Create() per creare un documento vuoto, quindi aggiungi pagine e salva:

using var doc = Document.Create();
// add pages, content, annotations
using var ms = new MemoryStream();
doc.Save(ms);
byte[] pdfBytes = ms.ToArray();

Come posso aprire un PDF esistente da un percorso file o da un array di byte?

// From file path
using var doc = Document.Open("input.pdf");
// From byte array
byte[] data = File.ReadAllBytes("input.pdf");
using var doc = Document.Open(data);
// From stream
using var stream = File.OpenRead("input.pdf");
using var doc = Document.Open(stream);

Come posso unire più documenti PDF?

Usa Document.Merge per combinare più documenti:

var merged = Document.Merge(new[] { doc1, doc2, doc3 });
merged.Save("combined.pdf");

Document.MergeDocuments è una sovraccarico equivalente che accetta percorsi di file direttamente.

Limitazioni note

La libreria è completa di funzionalità rispetto all’edizione commerciale di Aspose.PDF?

No. Aspose.PDF FOSS è un sottoinsieme open-source. Alcune funzionalità commerciali avanzate — come il rendering completo di moduli XFA, la conversione PDF/A, le firme digitali (PKCS7) e alcune operazioni di linearizzazione — potrebbero essere parzialmente implementate o assenti. Controlla il tracker delle issue su GitHub per lo stato attuale delle funzionalità specifiche.

Le estensioni JavaScript di AcroForm sono completamente supportate?

Le classi FieldDateTimeFormatter, FieldNumberCurrencyFormatter e FieldNumberPercentFormatter implementano le equivalenti funzioni PDF JavaScript AF_Date_Format, AF_Number_Format e AF_Percent_Format per la formattazione dei campi lato server senza un motore JavaScript. Queste sono disponibili nell’attuale versione alpha.