JavaScript Veldextensies

De Aspose.Pdf.Annotations.JavascriptExtensions namespace bevat beheerde tegenhangers van de Acrobat JavaScript AF_ opmaakfuncties. Deze klassen laten je de PDF‑veldweergavelogica in je .NET‑applicatie reproduceren zonder JavaScript uit te voeren.

FieldDateTimeFormatter is een statische klasse — roep Format direct op het type aan.
FieldNumberCurrencyFormatter en FieldNumberPercentFormatter zijn reguliere
klassen — maak een instantie, roep dan Format aan. Elke methode accepteert dezelfde
parameters als de overeenkomstige Acrobat JavaScript-functie en retourneert een
geformatteerde string.

FieldDateTimeFormatter

FieldDateTimeFormatter formatteert een ruwe datum/tijd‑string met behulp van een Acrobat‑stijl datumopmaakpatroon. Het komt overeen met de AF_Date_Format JavaScript‑functie.

Methodehandtekening

public static string Format(string dateFormat, string dateValue)

Parameter	Type	Beschrijving
`dateFormat`	`string`	Acrobat‑stijl datumformaatpatroon (bijv. `"mm/dd/yyyy"`)
`dateValue`	`string`	Ruwe datumreeks om te formatteren

Voorbeeld

using Aspose.Pdf.Annotations.JavascriptExtensions;
string result = FieldDateTimeFormatter.Format("mm/dd/yyyy", "2026-06-11");
Console.WriteLine(result); // 06/11/2026

Als de invoerwaarde niet kan worden geparseerd, retourneert de formatter de oorspronkelijke waarde ongewijzigd.

FieldNumberCurrencyFormatter

FieldNumberCurrencyFormatter formatteert een numerieke tekenreeks als een valutawaarde. Het komt overeen met de AF_Number_Format JavaScript-functie.

Methodehandtekening

public string Format(
    int precision,
    int sepStyle,
    int negStyle,
    string currencySymbol,
    bool isPrependCurrency,
    string fieldValue)

Parameter	Type	Beschrijving
`precision`	`int`	Aantal decimalen
`sepStyle`	`int`	Stijl van duizendtallen‑scheidingsteken (0 = komma, 1 = geen, 2 = punt)
`negStyle`	`int`	Stijl van negatieve getallen (0 = min, 1 = haakjes, 2 = rood)
`currencySymbol`	`string`	Symbool vooraf of achtergevoegd (bijv. `"$"`)
`isPrependCurrency`	`bool`	Wanneer `true` wordt het symbool voorafgeplaatst; anders achtergevoegd
`fieldValue`	`string`	Numerieke tekenreeks om te formatteren

Voorbeeld

using Aspose.Pdf.Annotations.JavascriptExtensions;
var formatter = new FieldNumberCurrencyFormatter();
string result = formatter.Format(
    precision: 2,
    sepStyle: 0,
    negStyle: 0,
    currencySymbol: "$",
    isPrependCurrency: true,
    fieldValue: "1234.5");
Console.WriteLine(result); // $1,234.50

VeldNummerProcentFormatter

FieldNumberPercentFormatter formatteert een numerieke string als een percentage, waarbij de waarde met 100 wordt vermenigvuldigd voordat het formaat wordt toegepast. Het komt overeen met de AF_Percent_Format JavaScript-functie.

Methodehandtekening

public string Format(
    int precision,
    int sepStyle,
    bool isPrependPercent,
    string fieldValue)

Parameter	Type	Beschrijving
`precision`	`int`	Aantal decimalen
`sepStyle`	`int`	Stijl van duizendtallen‑scheidingsteken
`isPrependPercent`	`bool`	Wanneer `true` het `%` symbool wordt voorgeplaatst; anders wordt het achtergeplaatst
`fieldValue`	`string`	Numerieke tekenreeks om te formatteren (vermenigvuldigd met 100)

Voorbeeld

using Aspose.Pdf.Annotations.JavascriptExtensions;
var formatter = new FieldNumberPercentFormatter();
string result = formatter.Format(
    precision: 1,
    sepStyle: 0,
    isPrependPercent: false,
    fieldValue: "0.1234");
Console.WriteLine(result); // 12.3%

Formatter gebruiken in een formulierverwerkingslus

Het volgende patroon past valutavormgeving toe op alle tekstveldwaarden in een PDF‑formulier:

using Aspose.Pdf;
using Aspose.Pdf.Annotations.JavascriptExtensions;
byte[] data = File.ReadAllBytes("form.pdf");
using var doc = Document.Open(data);
if (doc.Form is not null)
{
    var currencyFormatter = new FieldNumberCurrencyFormatter();
    foreach (var field in doc.Form.Fields)
    {
        if (field.Value is not null)
        {
            string formatted = currencyFormatter.Format(
                precision: 2,
                sepStyle: 0,
                negStyle: 0,
                currencySymbol: "$",
                isPrependCurrency: true,
                fieldValue: field.Value);
            Console.WriteLine($"{field.Name}: {formatted}");
        }
    }
}

Zie ook

Aspose.PDF — Enterprise-documentatie