JavaScript Kenttälaajennukset

JavaScript‑kenttälaajennukset

Aspose.Pdf.Annotations.JavascriptExtensions-nimialue sisältää hallittuja vastineita Acrobat JavaScript AF_ -muotoilufunktioille. Nämä luokat antavat sinun toistaa PDF-kenttäesityslogiikan .NET-sovelluksessasi ilman JavaScriptin suorittamista.

FieldDateTimeFormatter on staattinen luokka — kutsu Format suoraan tyypillä.
FieldNumberCurrencyFormatter ja FieldNumberPercentFormatter ovat tavallisia
luokkia — luo instanssi, sitten kutsu Format. Jokainen metodi hyväksyy samat
parametrit kuin vastaava Acrobat JavaScript -funktio ja palauttaa
muotoillun merkkijonon.

FieldDateTimeFormatter

FieldDateTimeFormatter muotoilee raakaa päivämäärä/aika -merkkijonoa käyttämällä Acrobat-tyylistä päivämäärämuotoilumallia. Se vastaa AF_Date_Format JavaScript-funktiota.

Metodin allekirjoitus

public static string Format(string dateFormat, string dateValue)

Parametri	Tyyppi	Kuvaus
`dateFormat`	`string`	Acrobat-tyylinen päivämäärämuotoilumalli (esim. `"mm/dd/yyyy"`)
`dateValue`	`string`	Muotoiltava raakapäivämäärämerkkijono

Esimerkki

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

Jos syötearvoa ei voida jäsentää, muotoilija palauttaa alkuperäisen arvon muuttumattomana.

FieldNumberCurrencyFormatter

FieldNumberCurrencyFormatter muotoilee numeerisen merkkijonon valuuttana. Se vastaa AF_Number_Format JavaScript-funktiota.

Metodin allekirjoitus

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

Parametri	Tyyppi	Kuvaus
`precision`	`int`	Desimaalien määrä
`sepStyle`	`int`	Tuhaterottimen tyyli (0 = pilkku, 1 = ei mitään, 2 = piste)
`negStyle`	`int`	Negatiivisen luvun tyyli (0 = miinus, 1 = sulkeet, 2 = punainen)
`currencySymbol`	`string`	Symboli eteen tai perään (esim. `"$"`)
`isPrependCurrency`	`bool`	Kun `true`, symboli lisätään eteen; muuten perään
`fieldValue`	`string`	Muotoiltava numeerinen merkkijono

Esimerkki

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 muotoilee numeerisen merkkijonon prosenttiosuutena, kertomalla arvon 100:lla ennen muotoilun soveltamista. Se vastaa AF_Percent_Format JavaScript-funktiota.

Metodin allekirjoitus

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

Parameter	Type	Description
`precision`	`int`	Desimaalien määrä
`sepStyle`	`int`	Tuhaterottimen tyyli
`isPrependPercent`	`bool`	Kun `true` `%`-symboli lisätään eteen; muuten perään
`fieldValue`	`string`	Muotoiltava numeerinen merkkijono (kerrottuna 100:lla)

Esimerkki

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%

Muotoilijoiden käyttö lomakkeen käsittelysilmukassa

Seuraava malli soveltaa valuuttamuotoilua kaikkiin tekstikentän arvoihin PDF-lomakkeessa:

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

Katso myös

Aspose.PDF — Yritysdokumentaatio