Bevezetés
Aspose.Words FOSS for .NET most már elérhető: egy ingyenes, nyílt forráskódú .NET könyvtár a Word dokumentumok létrehozására, olvasására és szerkesztésére tiszta C# környezetben, Microsoft Word telepítése nélkül. Olyan fejlesztőknek szól, akiknek sablonokból kell jelentéseket és leveleket generálniuk, meglévő .docx fájlokból tartalmakat olvasni és újraszerkeszteni, vagy a Word dokumentumokat Markdownra vagy egyszerű szövegre konvertálniuk kell egy feldolgozási csővezeték részeként, anélkül, hogy kereskedelmi SDK licencet vásárolnának.
A könyvtár MIT licenc alatt kerül kiadásra és nincs natív függősége — minden a kezelt kódban fut. A .NET Standard 2.0-t célozza, ezért működik a .NET Framework 4.6.2+ és a .NET 6, 8 és 10 verziókon, Windows, Linux és macOS rendszereken. Telepíthető a NuGet segítségével, vagy a könyvtárat építheti forrásból egyetlen dotnet build paranccsal (lásd az alábbi Gyors kezdés részt).
Az, ami megkülönbözteti ezt egy tipikus új nyílt forráskódú dokumentumkönyvtártól, az, hogy nem egy újraírás vagy wrapper. Aspose.Words FOSS for .NET a valódi Aspose.Words kódbázis — ugyanaz a dokumentummotor, amely 2003 óta termelésben kezeli a Word dokumentumokat — egy ingyenes, MIT licencű magra letisztítva. Azok a fejlesztők, akik túlnőnek ezen kiadáson és oldalelrendezésre, renderelésre vagy a további formátumkonverterekre van szükségük, áttérhetnek a kereskedelmi Aspose.Words a .NET kódjuk újraírása nélkül, mivel ugyanaz az alapul szolgáló API.
Főbb jellemzők
Dokumentumkészítés és -szerkesztés
Dokumentumokat építhet nulláról a new Document() és a magas szintű DocumentBuilder segítségével, vagy megnyithat meglévő .docx fájlokat a new Document(fileName) használatával. A DocumentBuilder sorozatos szerzői módszereket biztosít, mint a Write(), Writeln(), InsertParagraph() és InsertBreak(), valamint formázási tulajdonságokat (Font, ParagraphFormat, PageSetup), amelyek a tartalomra alkalmazódnak, amikor beillesztésre kerül. Alacsonyabb szintű hozzáféréshez bejárhatja a dokumentumfát közvetlenül a Section, Paragraph, Run és Table csomópontokon, vagy származtathatja a DocumentVisitor osztályt, hogy egyetlen átfutásban feldolgozza az összes csomóponttípust.
Táblázatok és listák
A táblákat Table, Row és Cell csomópontokból építik fel. A Table.SetBorders(), Table.SetShading() és Table.AutoFit() egyetlen lépésben formázza az egész táblát, míg a Table.Rows és soronkénti Cell hozzáférés finomabb vezérlést biztosít. Számozott és felsorolásos listák a ListCollection és ListFormat segítségével kezelhetők: alkalmazzon beépített stílust a ListFormat.ApplyBulletDefault() vagy ApplyNumberDefault() használatával, vagy regisztráljon egy egyéni lista definíciót a ListCollection.Add()-val.
Követett módosítások és dokumentumvédelem
Hívja meg a Document.StartTrackRevisions() metódust a szerkesztés előtt, hogy rögzítse a beszúrásokat, törléseket és formázási módosításokat, majd vizsgálja meg, fogadja el vagy utasítsa el őket a RevisionCollection segítségével (AcceptAll(), RejectAll(), Accept(criteria), Reject(criteria)), vagy egyszerre fogadja el az összeset a Document.AcceptAllRevisions() metódussal. A Document.Protect() jelszóval védelmet vagy csak olvasható állapotot alkalmaz a DocumentSecurity felsorolóval (ReadOnlyEnforced, ReadOnlyRecommended, PasswordProtected és kapcsolódó értékek), a Document.Unprotect() pedig visszavonja.
Mezők, makrók és digitális aláírások
A mezőértékelő motor a Document.UpdateFields() segítségével helyben frissíti a FieldDate (DATE mező) és a FieldDocProperty (DOCPROPERTY mező) mezőket — a lapelrendezéstől függő mezők, például az oldalszámok, helyettesítő értékekkel jelennek meg, mivel a lapelrendezés nem része ennek a kiadásnak. A DOCM és DOTM fájlok VBA-projektek megőrzésével járó körkörös átvitelre képesek. A meglévő digitális aláírások a DigitalSignatureCollection és a DigitalSignature (IsValid, SubjectName, IssuerName, SignTime) segítségével ellenőrizhetők, hogy megállapítsák, alá van-e írva a dokumentum és nem módosult-e; új aláírások létrehozása nem része ennek a kiadásnak.
Diagramok
Helyezzen be egy diagramot a dokumentumba a DocumentBuilder.InsertChart() használatával, majd a visszaadott Chart objektummal állítsa be az adat-sorozatokat.
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
Gyors kezdés
Aspose.Words FOSS a(z) .NET számára elérhető a(z) NuGet segítségével:
dotnet add package Aspose.Words.FOSSA forrásból történő építéshez:
git clone https://github.com/aspose-words-foss/Aspose.Words-FOSS-for-.NET.git
cd Aspose.Words-FOSS-for-.NET
dotnet build Aspose.Words.sln -c Release
Ezután adjon hozzá egy projektreferenciát a Aspose.Words.csproj elemhez az alkalmazásából. A referencia meglétével hozzon létre egy diagrammal ellátott dokumentumot, és mentse DOCX formátumban:
using Aspose.Words;
using Aspose.Words.Drawing.Charts;
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
// Delete default generated series.
chart.Series.Clear();
string[] categories = new string[] { "AW Category 1", "AW Category 2", "AW Category 3" };
chart.Series.Add("AW Series 1", categories, new double[] { 4.3, 2.5, 3.5 });
doc.Save("chart.docx");
Console.WriteLine("Saved chart.docx");
Támogatott formátumok
| Formázás | Kiterjesztés | Olvasás | Írás |
|---|---|---|---|
| DOCX | .docx | ✓ | ✓ |
| DOCM | .docm | ✓ | ✓ |
| DOTX | .dotx | ✓ | ✓ |
| DOTM | .dotm | ✓ | ✓ |
| Flat OPC (összes változat) | (különböző) | ✓ | ✓ |
| Markdown | .md | ✓ | ✓ |
| Text | .txt | ✓ | ✓ |
Ez a kiadás szándékosan kihagyja az oldalelrendezést és a renderelést — nincs PDF, XPS vagy képexport, illetve nyomtatás sem, ami azt is jelenti, hogy az elrendezéstől függő mezőértékek, például az oldalszámok, helyőrzőként jelennek meg ahelyett, hogy kiszámításra kerülnének. A további formátumkonvertálók (DOC, RTF, ODT, HTML, EPUB, MHTML, MOBI, AZW3 és WordML) nem olvashatók és nem írhatók, és a levélösszevonás végrehajtása, a LINQ Reporting, a dokumentumösszehasonlítás, új digitális aláírások létrehozása és a beágyazott betűkészlet alrészletezése sem szerepel. Ezek ugyanazok a alrendszerek, amelyeket a kereskedelmi kódbázisból eltávolítottak, hogy ez a kiadás ingyenes maradjon.
Nyílt forráskód és licencelés
Aspose.Words A .NET számára készült FOSS az MIT licenc alatt kerül kiadásra, kereskedelmi és személyes felhasználásra egyaránt ingyenes, jogdíjak vagy terjesztési korlátozások nélkül. A teljes forrás elérhető a GitHub-on a Aspose.Words FOSS a .NET tárolóhoz.
