JavaScript-fältutökningar

Namnområdet Aspose.Pdf.Annotations.JavascriptExtensions innehåller hanterade motsvarigheter till Acrobat JavaScript AF_ formateringsfunktioner. Dessa klasser låter dig reproducera PDF-fältvisningslogik i din .NET-applikation utan att köra JavaScript.

FieldDateTimeFormatter är en statisk klass — anropa Format direkt på typen.
FieldNumberCurrencyFormatter och FieldNumberPercentFormatter är vanliga
klasser — skapa en instans, sedan anropa Format. Varje metod accepterar samma
parametrar som motsvarande Acrobat JavaScript-funktion och returnerar en
formaterad sträng.

FieldDateTimeFormatter

FieldDateTimeFormatter formaterar en rå datum/tid‑sträng med ett Acrobat‑stil datumformatmönster. Den motsvarar AF_Date_Format JavaScript‑funktionen.

Metodsignatur

public static string Format(string dateFormat, string dateValue)

Parameter	Typ	Beskrivning
`dateFormat`	`string`	Acrobat‑stil datumformatmönster (t.ex. `"mm/dd/yyyy"`)
`dateValue`	`string`	Rå datumsträng att formatera

Exempel

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

Om inmatningsvärdet inte kan parsas, returnerar formateraren det ursprungliga värdet oförändrat.

FältNummerValutaFormaterare

FieldNumberCurrencyFormatter formaterar en numerisk sträng som ett valutavärde.
Den motsvarar AF_Number_Format JavaScript-funktionen.

Metodsignatur

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

Parameter	Typ	Beskrivning
`precision`	`int`	Antal decimaler
`sepStyle`	`int`	Tusentalsavgränsare stil (0 = komma, 1 = ingen, 2 = punkt)
`negStyle`	`int`	Negativtalsstil (0 = minus, 1 = parenteser, 2 = röd)
`currencySymbol`	`string`	Symbol som läggs till i början eller i slutet (t.ex. `"$"`)
`isPrependCurrency`	`bool`	När `true` läggs symbolen till i början; annars i slutet
`fieldValue`	`string`	Numerisk sträng att formatera

Exempel

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

FieldNumberPercentFormatter

FieldNumberPercentFormatter formaterar en numerisk sträng som en procentandel, multiplicerar värdet med 100 innan formatet tillämpas. Det motsvarar AF_Percent_Format JavaScript-funktionen.

Metodsignatur

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

Parameter	Typ	Beskrivning
`precision`	`int`	Antal decimaler
`sepStyle`	`int`	Stil för tusentalsavgränsare
`isPrependPercent`	`bool`	När `true` läggs `%`-symbolen före; annars efter
`fieldValue`	`string`	Numerisk sträng att formatera (multiplicerad med 100)

Exempel

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%

Använda formaterare i en formulärbehandlingsloop

Följande mönster tillämpar valutformatering på alla textfältsvärden i ett PDF‑formulär:

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}");
        }
    }
}

Se även

Aspose.PDF — Företagsdokumentation