Hogyan dolgozzunk a mezőkkel a .NET-ban

Lépés 1: Szerezd meg a könyvtárat

Klónozza a tárolót és építse Aspose.Words.sln Release konfigurációban, majd adjon hozzá egy projektreferenciát a Aspose.Words.csproj a saját .NET projektjéből, ahogyan a Telepítési útmutató. Adjon hozzá using Aspose.Words; and using Aspose.Words.Fields; a mezőkkel dolgozó bármely fájl tetejére.

Lépés 2: Szúrj be egy mezőt és olvasd ki az eredményét

DocumentBuilder.InsertField() új mezőt szúr be a kurzor helyére, olyan felülterhelésekkel, amelyek vagy azonnal frissítik a mező eredményét, vagy későbbi frissítési lépésre hagyják. Minden mező egy Field példány, amely három jelző csomópontból áll — FieldStart, Separator és FieldEnd, és Field.Start / Field.Separator / Field.End formájában érhető el. Field.Type azonosítja, hogy melyik FieldType képviseli, Field.Result és Field.DisplayResult tárolja az utoljára kiszámított értéket, Field.Format a kódhoz csatolt formázási kapcsolókat tartalmazza, és Field.GetFieldCode() visszaadja a nyers mezőkód szöveget.

3. lépés: Mezők frissítése programozott szerkesztés után

Aspose.Words FOSS nem számolja újra a mezőket, amikor a dokumentum betöltődik vagy mentődik. Egy olyan szerkesztés után, amelynek meg kell változtatnia egy mező eredményét, hívja a Range.UpdateFields() függvényt, hogy újraszámolja az adott tartomány összes mezőjét — használja a Document.Range.UpdateFields() függvényt a teljes dokumentumra — vagy a Field.Update() egyetlen mezőre. A Range.UnlinkFields() egy hívással minden mezőt a tartományban statikus szöveggé alakít, és a Range.NormalizeFieldTypes() a mező tárolt típuskódját összeveti a tényleges mezőkóddal egy manuális szerkesztés után.

4. lépés: Mezőfrissítési viselkedés beállítása a(z) FieldOptions segítségével

Document.FieldOptions (egy FieldOptions példány) szabályozza, hogy a teljes dokumentum mezői hogyan viselkednek egy frissítés során: CurrentUser (egy UserInformation példány — Name, Initials, Address) biztosítja azt az azonosítót, amelyből a szerző- és felhasználónévhez kapcsolódó mezők olvasnak, DefaultDocumentAuthor beülteti a szerzőhöz kapcsolódó eredményeket, és a LegacyNumberFormat / UseInvariantCultureNumberFormat / PreProcessCulture / FieldUpdateCultureSource szabályozzák a szám- és dátumformázást. Felügyelet nélküli folyamatokhoz rendelje hozzá a FieldOptions.UserPromptRespondent (egy IFieldUserPromptRespondent) elemet, hogy a ASK és FILLINhez hasonló prompt-vezérelt mezők ne blokkolják a futást interaktív bemenet várásával, és rendelje hozzá egy egyedi IFieldDatabaseProvider elemet a FieldOptions.FieldDatabaseProviderhez, hogy a DATABASE mező sorait a saját adatforrásából szolgáltassa egy valódi adatbázis-kapcsolat helyett.

5. lépés: Mezőfrissítések nyomon követése egy visszahívással

Valósítsa meg a IFieldUpdatingCallback (FieldUpdating és FieldUpdated) és rendelje hozzá a FieldOptions elemhez, hogy a kódot minden mező újraszámolása előtt és után azonnal futtassa — hasznos annak auditálásához, hogy pontosan mely mezők változtak egy kötegelt feladatban. Nagy dokumentum esetén a haladásjelentéshez valósítsa meg a IFieldUpdatingProgressCallback (Notify) elemet, amely egy FieldUpdatingProgressArgs objektumot kap, amely bemutatja a TotalFieldsCount, UpdatedFieldsCount és UpdateCompleted értékeket.

6. lépés: Mező átalakítása vagy eltávolítása

Field.Unlink() a mezőt az utolsó számított eredményével helyettesíti, mint egyszerű statikus szöveg, eldobva a háttérben lévő mezőkódot — használja, ha a értéket véglegesen a dokumentumba szeretné beágyazni. Field.Remove() törli a FieldStart, Separator és FieldEnd csomópontokat a mezőkóddal és eredménnyel együtt, így a mező teljesen eltűnik. Inkább ezeket a két módszert válassza a marker csomópontok közvetlen törlésével szemben, mivel a mező szerkezetének csak egy részének kézi eltávolítása inkonzisztens dokumentumfát eredményezhet.