1. Productes
  2.   Aspose.PDF
  3.   Aspose.PDF FOSS for .NET

Aspose.PDF FOSS per a .NET

Crea i manipula documents PDF des de .NET — amb anotacions, camps de formulari, extracció de text, gestió de pàgines, xifratge i importació de HTML/SVG/Markdown. Amb llicència MIT.

Aspose.PDF FOSS for .NET Aspose.PDF FOSS
for .NET

Aprèn GitHub

Biblioteca .NET gratuïta amb llicència MIT per a la creació i manipulació de PDF

Aspose.PDF FOSS per a .NET és una biblioteca amb llicència MIT per crear i treballar amb documents PDF a C# i .NET. El punt d’entrada central és la classe Document, que admet la construcció a partir d’un camí de fitxer, matriu de bytes, flux o fonts protegides per contrasenya, i exposa les operacions Open, Save, Merge, Encrypt, Decrypt i Convert a tota la especificació PDF.

La biblioteca exposa 805 classes que cobreixen l’estructura del document a través de Document, Page i PageCollection; anotacions riques mitjançant AnnotationCollection (incloent AddTextAnnotation, AddLinkAnnotation, AddHighlightAnnotation, AddWatermarkAnnotation i AddRedactAnnotation); formularis interactius amb Form, ButtonField, CheckboxField, RadioButtonField i ChoiceField; extracció de text i cerca a través de TextFragmentAbsorber i TextFragment; detecció de taules amb AbsorbedTable, AbsorbedRow i AbsorbedCell; i seguretat del document mitjançant Document.Encrypt i Document.Decrypt. La conversió de formats admet HTML, SVG i importació de Markdown juntament amb l’exportació de PDF.

Instal·la Aspose.PDF FOSS per a .NET des de NuGet: dotnet add package Aspose.Pdf.Foss --version 0.1.0-alpha. La biblioteca està totalment llicenciada sota MIT sense tarifes d’execució ni restriccions d’ús. Per a funcions i suport empresarial, consulta Aspose.PDF for .NET — Enterprise Product.

Estructura del document i gestió de pàgines

  • Document API: Crea nous PDFs amb Document() o obre fitxers existents a través de Document.Open(path), Document.Open(data) o Document.Open(stream).
  • Gestió de pàgines: Afegeix, accedeix i reordena les pàgines a través de PageCollection. Cada Page exposa Width, Height, MediaBox, rotació i Annotations.
  • Combina i divideix: Combina diversos fitxers amb Document.Merge(documents) o Document.MergeDocuments(files). Importa pàgines específiques amb Document.ImportPage i Document.ImportPages.
  • Metadades: Llegeix i escriu les metadades del document a través de DocumentInfo i Document.GetOrCreateMetadata().
  • Serialització: Persistiu documents amb Document.Save(filename), Document.Save(stream, format) o Document.ToArray().

Escenaris comuns de processament de documents

  • PDF generation: Creeu documents de manera programàtica creant una instància de Document i omplint les pàgines amb contingut.
  • Anàlisi de documents: Obriu fitxers existents per a inspecció de metadades, mesura de dimensions de pàgina o enumeració de camps de formulari.
  • Manipulació de pàgines: Redimensiona, gira o reordena les pàgines utilitzant Document.ImportPage i l’API Page.
  • Fusió per lots: Ajunteu seccions d’informe o pàgines de factura en un únic PDF utilitzant Document.MergeDocuments.

Anotacions i camps de formulari

  • Rich annotation API: AnnotationCollection exposa mètodes per a anotacions de text, enllaç, ressaltat, subratllat, ratllat, quadrat, cercle, línia, tinta, segell, cursor, redacció, marca d’aigua, polígon i polilínia.
  • Accions d’enllaç: Afegeix enllaços URI amb AddLinkAnnotation(rect, uri) o enllaços d’salt de pàgina interns amb AddLinkAnnotation(rect, destinationPage, destRect).
  • Formularis interactius: Accediu al formulari del document a través de Document.Form per enumerar o crear instàncies de ButtonField, CheckboxField, RadioButtonField i ChoiceField.
  • Selecció d’anotacions: Filtra les anotacions per tipus a través de AnnotationSelector amb sobrecàrregues per tipus Visit.
  • Indicadors d’anotació: Controla la visibilitat, la impressió i el comportament de bloqueig via AnnotationFlags.

Escenaris de revisió i col·laboració de documents

  • Revisió de marques: Afegeix ressaltats, subratllats o anotacions de text lliure per a fluxos de treball de revisió de documents.
  • Redacció: Elimina permanentment les regions de contingut sensible utilitzant AddRedactAnnotation.
  • Marca d’aigua: Estampa el text CONFIDENTIAL o APPROVED a les pàgines amb AddWatermarkAnnotation i AddStampAnnotation.
  • Formularis interactius: Crea documents omplibles amb botons d’opció, caselles de selecció i llistes de selecció per a canals de captura de dades.

Extracció de text i cerca

  • Cerca de text: Utilitzeu TextFragmentAbsorber per localitzar tots els fragments de text en una pàgina o en tot un document, amb coincidència de frases opcional.
  • Propietats del fragment: Cada TextFragment exposa Text, Position, TextState (font, mida, color), i el rectangle delimitador.
  • Control d’estat del text: TextFragmentState proporciona accés a Font, FontSize, ForegroundColor, BackgroundColor, i al mode de renderització.
  • Detecció de taules: Identificar i extreure el contingut tabular mitjançant AbsorbedTable, AbsorbedRow i AbsorbedCell, cadascun proporcionant Rect i TextFragments.

Escenaris d'extracció de text i dades

  • Indexació de contingut: Extreu tot el text de la pàgina per a les cadenes de cerca de text complet.
  • Extracció de dades del formulari: Llegeix els valors dels camps enviats per al processament del costat del servidor.
  • Anàlisi de factures: Utilitzeu AbsorbedTable per analitzar dades tabulars de files i columnes de PDFs financers.
  • Comparació de línies: Localitzeu fragments de text específics per a anotacions o substitucions precises basades en la posició.

Seguretat i xifratge

  • Xifratge AES i RC4: Xifra documents amb Document.Encrypt(userPassword, ownerPassword, permissions, algorithm) utilitzant Algorithm.AESx128, AESx256 o RC4x128.
  • Control de permisos: Restringir la impressió, la còpia i l’accessibilitat via DocumentPrivilege.
  • Gestió de contrasenyes: Canvia les contrasenyes d’usuari i propietari amb Document.ChangePasswords.
  • Desencriptació: Elimina la protecció amb Document.Decrypt().
  • Signatures digitals: Accediu als camps de signatura i a les dades PKCS#7 a través dels tipus Signature i Algorithm.

Escenaris de seguretat de documents

  • Distribució confidencial: Xifra PDFs amb contrasenyes per destinatari abans de l’entrega.
  • Contractes només d’impressió: Aplica contrasenyes de propietari amb només impressió DocumentPrivilege per evitar la còpia.
  • Arxiu de compliment: Elimina el xifratge dels arxius interns després de la revisió de seguretat.
  • Verificació de signatures: Inspeccioneu signatures digitals incrustades en els PDFs rebuts per a comprovacions d’autenticitat.

Obre un PDF, afegeix una anotació d’enllaç i desa

Obre un PDF existent, adjunta una anotació d’enllaç URI a la pàgina 1 i desa el resultat.

using Aspose.Pdf;

var data = System.IO.File.ReadAllBytes("input.pdf");
using var doc = Document.Open(data);
var page = doc.Pages[1];
var action = PdfAction.CreateUri("https://aspose.com");
page.Annotations.AddLinkAnnotation(
    new Rectangle(50, 700, 200, 720), action);
using var ms = new System.IO.MemoryStream();
doc.Save(ms);
System.IO.File.WriteAllBytes("output.pdf", ms.ToArray());

Afegeix una anotació de marca d’aigua

Estampar una marca d’aigua a la pàgina 1 d’un document existent i fer un viatge d’anada i tornada a través de la serialització.

using Aspose.Pdf;
var input = System.IO.File.ReadAllBytes("report.pdf");
using var doc = Document.Open(input);
doc.Pages[1].Annotations.AddWatermarkAnnotation(
    new Rectangle(0, 0, 612, 792), "CONFIDENTIAL");
var saved = doc.ToArray();
System.IO.File.WriteAllBytes("watermarked.pdf", saved);

Extreu fragments de text d’una pàgina

Utilitzeu TextFragmentAbsorber per enumerar tots els fragments de text a la primera pàgina.

using Aspose.Pdf;
using Aspose.Pdf.Text;

var data = System.IO.File.ReadAllBytes("document.pdf");
using var doc = Document.Open(data);
var absorber = new TextFragmentAbsorber();
absorber.Visit(doc.Pages[1]);
foreach (var fragment in absorber.TextFragments)
{
    Console.WriteLine(fragment.Text);
}

Preguntes freqüents

Quin és el model de llicència per a Aspose.PDF FOSS per a .NET?

Aspose.PDF FOSS per a .NET es publica sota la MIT License, permetent l’ús gratuït en productes comercials sense tarifes d’execució. El codi font està disponible públicament a GitHub.

Com instal·lo Aspose.PDF FOSS per a .NET?

Instal·leu des de NuGet utilitzant dotnet add package Aspose.Pdf.Foss --version 0.1.0-alpha. La biblioteca està dirigida a .NET 8 i versions posteriors sense dependències natives.

Quins formats de fitxer suporta Aspose.PDF FOSS per a .NET?

La biblioteca llegeix i escriu PDF i admet la importació de HTML, SVG i Markdown. També està disponible l’exportació raster — les pàgines PDF es poden renderitzar a BMP, JPEG, PNG i TIFF.

Com creo un document PDF nou?

Utilitzeu Document.Create() per crear un document buit, després afegiu pàgines i deseu amb Document.Save(stream) o Document.ToArray().

Cal una clau de llicència per utilitzar Aspose.PDF FOSS per a .NET?

No es requereix cap clau de llicència ni pas d’activació. La biblioteca s’executa completament sense llicència i sense cost sota la MIT License.

  

Suport i recursos d aprenentatge

 Català