Pdfs
.NET
Developer Guide
JavaScript Sambungan Medan

JavaScript Sambungan Medan

Sambungan Medan JavaScript

Namespace Aspose.Pdf.Annotations.JavascriptExtensions mengandungi pasangan terurus kepada fungsi pemformatan Acrobat JavaScript AF_. Kelas‑kelas ini membolehkan anda meniru logik paparan medan PDF dalam aplikasi .NET anda tanpa melaksanakan JavaScript.

FieldDateTimeFormatter ialah kelas statik — panggil Format secara langsung pada jenis tersebut.
FieldNumberCurrencyFormatter dan FieldNumberPercentFormatter ialah kelas biasa — buat satu contoh, kemudian panggil Format. Setiap kaedah menerima parameter yang sama seperti fungsi Acrobat JavaScript yang sepadan dan mengembalikan rentetan yang diformat.

FieldDateTimeFormatter

FieldDateTimeFormatter memformat rentetan tarikh/masa mentah menggunakan corak format tarikh gaya Acrobat. Ia sepadan dengan fungsi JavaScript AF_Date_Format.

Tandatangan kaedah

public static string Format(string dateFormat, string dateValue)
ParameterJenisKeterangan
dateFormatstringCorak format tarikh gaya Acrobat (contohnya "mm/dd/yyyy")
dateValuestringRentetan tarikh mentah untuk diformat

Contoh

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

Jika nilai input tidak dapat diparse, formatter mengembalikan nilai asal tanpa perubahan.

MedanNomborMataWangPemformat

FieldNumberCurrencyFormatter memformat rentetan numerik sebagai nilai mata wang. Ia sepadan dengan fungsi JavaScript AF_Number_Format.

Tandatangan kaedah

public string Format(
    int precision,
    int sepStyle,
    int negStyle,
    string currencySymbol,
    bool isPrependCurrency,
    string fieldValue)
ParameterTypeDescription
precisionintBilangan tempat perpuluhan
sepStyleintGaya pemisah ribuan (0 = koma, 1 = tiada, 2 = titik)
negStyleintGaya nombor negatif (0 = tolak, 1 = kurungan, 2 = merah)
currencySymbolstringSimbol diletakkan di depan atau di belakang (contoh "$")
isPrependCurrencyboolApabila true simbol diletakkan di depan; jika tidak diletakkan di belakang
fieldValuestringRentetan nombor untuk diformat

Contoh

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

PemformatPeratusNomborMedan

FieldNumberPercentFormatter memformat rentetan berangka sebagai peratus, menggandakan nilai dengan 100 sebelum menerapkan format. Ia sepadan dengan fungsi JavaScript AF_Percent_Format.

Tandatangan kaedah

public string Format(
    int precision,
    int sepStyle,
    bool isPrependPercent,
    string fieldValue)
ParameterTypeDescription
precisionintBilangan tempat perpuluhan
sepStyleintGaya pemisah ribuan
isPrependPercentboolApabila true simbol % diletakkan di depan; jika tidak diletakkan di belakang
fieldValuestringRentetan nombor untuk diformat (dikali 100)

Contoh

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%

Menggunakan pemformat dalam gelung pemprosesan borang

Corak berikut menerapkan pemformatan mata wang kepada semua nilai medan teks dalam borang PDF:

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

Lihat Juga

 Bahasa Melayu