Hoe te werken met overgangsvelden in .NET

Stap 1: Zoek overgangsvelden in een document

Enumerate Document.Range.Fields en vergelijk elke veld’s Type (een FieldType waarde) met de relevante constanten — FieldBarcode, FieldDisplayBarcode, FieldMergeBarcode, FieldBidiOutline, FieldEQ, FieldFootnoteRef of FieldInfo — en cast vervolgens het generieke Field naar de overeenkomende klasse om toegang te krijgen tot zijn specifieke eigenschappen. Controleer altijd Type vóór het casten: casten naar de verkeerde veldklasse veroorzaakt een InvalidCastException.

Stap 2: Configureer een DISPLAYBARCODE- of MERGEBARCODE-veld

FieldDisplayBarcode (het DISPLAYBARCODE veld) en FieldMergeBarcode (het MERGEBARCODE veld, dat ook IMergeFieldSurrogate implementeert voor mail-merge) delen dezelfde set barcode-configuratie-eigenschappen: BarcodeType, BarcodeValue, SymbolHeight, SymbolRotation, ScalingFactor, ForegroundColor, BackgroundColor, PosCodeStyle, CaseCodeStyle, ErrorCorrectionLevel, DisplayText, AddStartStopChar en FixCheckDigit. Stel deze in op de veld-instantie en roep vervolgens Update() aan zodat Result de nieuwe configuratie weergeeft voordat het document wordt opgeslagen.

Stap 3: Legacy BARCODE (Postal) Veldgegevens Lezen

FieldBarcode implementeert het oudere BARCODE veld, dat specifiek een US-postal barcode (POSTNET) veld is in plaats van een algemene barcode — het deelt de BarcodeType/BarcodeValue eigenschappen uit Stap 2 niet. In plaats daarvan maakt het PostalAddress (het adres dat de barcode codeert), FacingIdentificationMark, IsUSPostalAddress en IsBookmark beschikbaar. Controleer Field.Type specifiek tegen FieldType.FieldBarcode voordat u deze eigenschappen leest, aangezien het casten van een DISPLAYBARCODE of MERGEBARCODE veld naar FieldBarcode de verwachte eigenschappen niet zou blootstellen.

Stap 4: Barcode-afbeeldingen Renderen met een Aangepaste Generator

Deze FOSS-editie bevat barcode-veldgegevens maar bevat geen barcode-renderingengine. BarcodeParameters is de doorgeefcontainer die instellingen van beide barcode-veldfamilies — de DISPLAYBARCODE/MERGEBARCODE eigenschappen uit Stap 2 en de post-eigenschappen uit Stap 3 — consolideert tot één object dat aan een renderer wordt doorgegeven. Implementeer IBarcodeGenerator, waarbij GetBarcodeImage(parameters) en de legacy GetOldBarcodeImage(parameters) worden blootgesteld, om de daadwerkelijke afbeeldingsrendering te leveren; zonder een geleverde implementatie bevatten barcode-velden alleen configuratie-gegevens.

Stap 5: Werken met Legacy Compatibiliteitsvelden

Vier andere klassen behandelen oudere veldcodes die nog steeds voorkomen in legacy .docx bestanden. FieldBidiOutline implementeert het BIDIOUTLINE veld voor rechts-naar-links outline-nummering en maakt geen eigenschappen bloot buiten het gemeenschappelijke Field oppervlak. FieldEQ implementeert het EQ vergelijkingveld en maakt bovendien AsOfficeMath() beschikbaar om de inhoud om te zetten naar een OfficeMath object — dit slaagt alleen wanneer het veld daadwerkelijk een vergelijking codeert. FieldFootnoteRef implementeert het FOOTNOTEREF veld, dat een voetnoot- of eindnoot-markering kruist, en maakt ook geen eigenschappen bloot buiten het gemeenschappelijke Field oppervlak. FieldInfo implementeert het INFO veld, dat een document-samenvattings-informatie-eigenschap leest of schrijft via zijn InfoType en NewValue eigenschappen.

Stap 6: De waarde van een Transitional-veld bijwerken of bevriezen

Elke transitie-veldklasse erft GetFieldCode() (de onderliggende code-tekst van het veld), Update() (herberekent het resultaat), Unlink() (vervangt het veld door zijn laatst berekende resultaat als statische tekst), en Remove() (verwijdert het veld). Roep Update() aan na het wijzigen van de configuratie van een veld zodat Result de wijziging weerspiegelt, en gebruik Unlink() wanneer de huidige waarde van een veld bevroren moet worden in plaats van opnieuw berekenbaar te blijven.