Veldresultaatopmaak

Veldresultaatopmaak

Deze gids laat zien hoe je de numerieke, datum/tijd- en algemene opmaak die op het berekende resultaat van een veld wordt toegepast in Aspose.Words FOSS voor .NET, kunt beheersen, met behulp van de FieldFormat klasse, de GeneralFormat enum en GeneralFormatCollection. Elke Field instantie maakt deze opmaakschakelaars beschikbaar via zijn Format eigenschap; deze pagina gaat dieper in op wat die eigenschap biedt.

Toegang tot de opmaak van een veld

Elke Field — en zijn getypeerde subklassen zoals FieldDate, FieldCreateDate en FieldSymbol — biedt een Format eigenschap van type FieldFormat, die wordt gebruikt voor getypeerde toegang tot de numerieke, datum- en tijd- en algemene opmaak van het veld. Lees Field.Format om de schakelaars die aan de code van een veld zijn gekoppeld te inspecteren of te wijzigen zonder handmatig de ruwe veldcode-tekst te bewerken.

Numerieke en datum/tijd-opmaakafbeeldingen

FieldFormat.NumericFormat is een schrijfbare string eigenschap die de opmaak bevat die op een numeriek veldresultaat wordt toegepast. FieldFormat.DateTimeFormat is een schrijfbare string eigenschap die de opmaak bevat die op een datum- en tijd-veldresultaat wordt toegepast. Stel een van beide eigenschappen in om te wijzigen hoe het overeenkomstige veldtype zijn berekende waarde weergeeft.

Algemene opmaak

FieldFormat.GeneralFormats retourneert een GeneralFormatCollection — algemene formaten toegepast op een numeriek, tekst, of elk veldresultaat. De leden komen uit de GeneralFormat enum, die case-transformaties omvat (Upper, Lower, FirstCap, Caps), Romeinse en ordinale nummering (UppercaseRoman, LowercaseRoman, Ordinal, OrdText), valuta- en kardinale tekst (DollarText, BahtText, CardText), locale-specifieke nummeringssystemen (Aiueo, Arabic, ArabicAbjad, ArabicAlpha, ArabicDash, ChineseNum1–ChineseNum3, KanjiNum1–KanjiNum3, Hebrew1, Hebrew2, Ganada, Chosung, Zodiac1–Zodiac3, ThaiArabic, ThaiCardText, ThaiLetter, HindiArabic, HindiCardText, HindiLetter1, HindiLetter2, VietCardText, DBNum1–DBNum4, DBChar, SBChar, GB1–GB4, Hex, CircleNum, UppercaseAlphabetic, LowercaseAlphabetic), en de merge-veld-specifieke waarden CharFormat, MergeFormat en MergeFormatInet. None wist algemene opmaak.

Beheer van de GeneralFormatCollection

GeneralFormatCollection implementeert IEnumerable<GeneralFormat>, zodat je het kunt itereren met GetEnumerator() in een foreach lus. Roep Add(item) aan om een GeneralFormat waarde toe te voegen, Remove(item) om elke voorkoming van een waarde te verwijderen, of RemoveAt(index) om de waarde op een specifieke positie te verwijderen. Count meldt hoeveel algemene formaten momenteel zijn toegepast.

Tips en best practices

• Stel Field.Format.NumericFormat of Field.Format.DateTimeFormat in plaats van een opmaakafbeelding rechtstreeks in de veldcode-tekenreeks in te sluiten — de getypeerde eigenschap houdt de veldcode en zijn opmaakswitch synchroon.
• Combineer meerdere GeneralFormat waarden (bijvoorbeeld Upper en MergeFormat) door elk afzonderlijk aan GeneralFormats toe te voegen; de collectie staat meer dan één invoer toe.
• Na het wijzigen van een FieldFormat eigenschap, roep Update() aan op het eigenaar-veld zodat de nieuwe opmaak wordt weergegeven in Result / DisplayResult.
• Gebruik GeneralFormat.None om expliciet een algemene opmaakvermelding te wissen in plaats van verouderde opmaakwaarden in de collectie achter te laten.
• Controleer GeneralFormatCollection.Count voordat je aanneemt dat een veld geen algemene opmaak heeft toegepast — een lege collectie en een collectie die None bevat, zijn verschillende toestanden.

Veelvoorkomende problemen

FAQ

Waar wordt FieldFormat voor gebruikt?

Het is het getypeerde opmaakobject dat door Field.Format wordt blootgesteld, en geeft toegang tot het numerieke formaat van een veld (NumericFormat), datum/tijd-formaat (DateTimeFormat) en algemene formaten (GeneralFormats).

Kan een veld meer dan één algemene opmaak hebben toegepast?

Ja — GeneralFormats is een GeneralFormatCollection, en je kunt Add meer dan één GeneralFormat waarde eraan.

Hoe verwijder ik alle algemene opmaak van een veld?

Itereer GeneralFormats en roep Remove(item) aan voor elke waarde, of RemoveAt(index) voor een specifiek item.

Vernieuwt het instellen van FieldFormat eigenschappen automatisch de weergegeven tekst van het veld?

Nee — roep Update() aan op het veld nadat je de Format eigenschappen hebt gewijzigd, zodat Result en DisplayResult de nieuwe opmaak weergeven.

API Reference Samenvatting

Zie ook

• Aspose.Words for .NET — Enterprise Documentation