Hoe te werken met documenten in .NET

Stap 1: Haal de bibliotheek op

Kloon de repository en bouw Aspose.Words.sln in Release-configuratie, voeg vervolgens een projectreferentie toe aan Aspose.Words.csproj vanuit je eigen .NET-project. De volledige kloon- en bouwopdrachten staan in de Installatiehandleiding. Zodra het is gerefereerd, voeg toe using Aspose.Words; aan het begin van elk bestand dat met documenten werkt.

Stap 2: Maak of laad een document

Roep new Document() aan voor een leeg document, of geef een bestandspad of Stream door aan de Document(fileName)/Document(stream)-constructor om een bestaande te openen. Een overload die een LoadOptions-argument accepteert, stelt je in staat een wachtwoord op te geven voor een versleuteld bestand. Voordat je een bestand laadt waarvan je het formaat nog niet vertrouwt, roep je FileFormatUtil.DetectFileFormat(fileName) aan — het retourneert een FileFormatInfo die de gedetecteerde LoadFormat rapporteert en aangeeft of het bestand IsEncrypted, HasDigitalSignature of HasMacros is, zodat je onverwachte invoer kunt afwijzen voordat Document probeert het te parseren.

Stap 3: Inhoud maken met DocumentBuilder

DocumentBuilder omhult een Document met een cursor die je door de boom beweegt terwijl je inhoud invoegt. Write(text) en Writeln(text) voegen tekst in op de cursor, en InsertParagraph() start een nieuwe alinea. Opmaak die is ingesteld op de Font, ParagraphFormat, ListFormat en PageSetup eigenschappen van de builder, wordt toegepast op alles wat je daarna schrijft. Verplaats de cursor met MoveToDocumentStart(), MoveToDocumentEnd(), MoveToSection(sectionIndex), MoveToBookmark(bookmarkName) of MoveToParagraph(paragraphIndex, characterIndex), en lees CurrentNode / CurrentParagraph / CurrentSection om te bevestigen waar de builder zich bevindt.

Stap 4: Inspecteer de sectie- en bodystructuur

Een Document maakt een SectionCollection zichtbaar via Document.Sections (plus FirstSection / LastSection). Elke Section heeft precies één Body, waarvan de hoofdinhoud bereikbaar is via Body.Paragraphs (een ParagraphCollection) en Body.Tables. Om tekst te lezen of te zoeken zonder handmatig door knooppunten te lopen, gebruik je de Range die beschikbaar is op Document, Section, Paragraph en andere knooppunten — Range.Text geeft de platte tekst terug, en Range.Replace(pattern, replacement) voert een zoeken-en-vervangen uit die beperkt is tot dat bereik.

Stap 5: Combineer twee documenten

Om een volledig document te kopiëren, roep je Document.Clone() aan. Om specifieke inhoud van de ene Document-instantie naar een andere te brengen, roep je ImportNode(srcNode, isImportChildren) aan op het bestemmingsdocument, of roep je Document.AppendDocument(srcDoc, importFormatMode) aan om elke sectie van een brondocument aan het einde van het huidige toe te voegen. DocumentBuilder.InsertDocument(srcDoc, importFormatMode) doet hetzelfde, maar voegt in op de cursor van de builder in plaats van aan het einde. In alle drie de gevallen kies je de ImportFormatMode waarde — KeepSourceFormatting, UseDestinationStyles of KeepDifferentStyles — bewust, aangezien deze bepaalt welke documentstijlen winnen waar de twee botsen.

Stap 6: Pas een bewerkingsbeperking toe

Roep Document.Protect(type, password) aan met een ProtectionType-waarde — ReadOnly, AllowOnlyComments, AllowOnlyRevisions of AllowOnlyFormFields — om te beperken welke bewerkingen Word accepteert voor het document. Unprotect() (met of zonder het bijbehorende wachtwoord) verwijdert de beperking. Dit beïnvloedt alleen het bewerken binnen Word; het versleutelt het opgeslagen bestand niet. Om een wachtwoord te eisen alleen om het bestand te openen, stel je OoxmlSaveOptions.Password in bij het opslaan.