JavaScript-feltudvidelser

JavaScript Feltudvidelser

Aspose.Pdf.Annotations.JavascriptExtensions-navneområdet indeholder administrerede modparter til Acrobat JavaScript AF_ formateringsfunktioner. Disse klasser giver dig mulighed for at genskabe PDF-feltvisningslogik i din .NET-applikation uden at udføre JavaScript.

FieldDateTimeFormatter er en statisk klasse — kald Format direkte på typen.
FieldNumberCurrencyFormatter and FieldNumberPercentFormatter er almindelige
klasser — opret en instans, og kald derefter Format. Hver metode accepterer de samme
parametre som den tilsvarende Acrobat JavaScript-funktion og returnerer en
formateret streng.

FieldDateTimeFormatter

FieldDateTimeFormatter formaterer en rå dato/tid‑streng ved hjælp af et Acrobat‑stil datoformatmønster. Den svarer til AF_Date_Format JavaScript‑funktionen.

Metodesignatur

public static string Format(string dateFormat, string dateValue)

Parameter	Type	Beskrivelse
`dateFormat`	`string`	Acrobat‑stil datoformatmønster (f.eks. `"mm/dd/yyyy"`)
`dateValue`	`string`	Rå datostreng, der skal formateres

Eksempel

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

Hvis inputværdien ikke kan parses, returnerer formatteren den oprindelige værdi uændret.

FieldNumberCurrencyFormatter

FieldNumberCurrencyFormatter formaterer en numerisk streng som en valutaværdi. Det svarer til AF_Number_Format JavaScript-funktionen.

Metodesignatur

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

Parameter	Type	Beskrivelse
`precision`	`int`	Antal decimaler
`sepStyle`	`int`	Tusindtalsseparatorstil (0 = komma, 1 = ingen, 2 = punktum)
`negStyle`	`int`	Negativt tal stil (0 = minus, 1 = parenteser, 2 = rød)
`currencySymbol`	`string`	Symbol foranstillet eller efterstillet (f.eks. `"$"`)
`isPrependCurrency`	`bool`	Når `true` er symbolet foranstillet; ellers efterstillet
`fieldValue`	`string`	Numerisk streng, der skal formateres

Eksempel

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 formaterer en numerisk streng som en procent, ved at multiplicere værdien med 100 før formatet anvendes. Den svarer til AF_Percent_Format JavaScript-funktionen.

Metodesignatur

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

Parameter	Type	Beskrivelse
`precision`	`int`	Antal decimaler
`sepStyle`	`int`	Tusindtalsseparatorstil
`isPrependPercent`	`bool`	Når `true`, bliver `%`-symbolet foranstillet; ellers efterstillet
`fieldValue`	`string`	Numerisk streng, der skal formateres (multiplikeret med 100)

Eksempel

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%

Brug af formateringsværktøjer i en formularbehandlingsløkke

Følgende mønster anvender valutaformatering på alle tekstfeltværdier i en PDF-formular:

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 også

Aspose.PDF — Enterprise-dokumentation