Cách làm việc với các tiện ích mở rộng JavaScript trong .NET

Aspose.PDF FOSS for .NET bao gồm các triển khai phía máy chủ của các hàm PDF JavaScript AF_Date_Format, AF_Number_Format và AF_Percent_Format thông qua các lớp FieldDateTimeFormatter, FieldNumberCurrencyFormatter và FieldNumberPercentFormatter. Cài đặt gói bằng dotnet add package Aspose.Pdf.Foss --version 0.1.0-alpha và sử dụng các lớp này để định dạng giá trị trường AcroForm trên máy chủ mà không yêu cầu một engine JavaScript.

Hướng Dẫn Từng Bước

dotnet add package Aspose.Pdf.Foss --version 0.1.0-alpha

using Aspose.Pdf.Annotations.JavascriptExtensions;

string formatted = FieldDateTimeFormatter.Format("mm/dd/yyyy", "2026-06-11");

var currencyFormatter = new FieldNumberCurrencyFormatter();
string formatted = currencyFormatter.Format(
    precision: 2,
    sepStyle: 0,
    negStyle: 0,
    currencySymbol: "$",
    isPrependCurrency: true,
    fieldValue: "1234.5");

var percentFormatter = new FieldNumberPercentFormatter();
string formatted = percentFormatter.Format(
    precision: 1,
    sepStyle: 0,
    isPrependPercent: false,
    fieldValue: "0.875");

Các vấn đề thường gặp và cách khắc phục

FieldDateTimeFormatter trả về chuỗi rỗng
Điều này xảy ra khi đối số dateValue không thể được phân tích theo mẫu ngày trong dateFormat. Các token ngày của Acrobat khác với chuỗi định dạng .NET DateTime.

FieldNumberCurrencyFormatter tạo ra dấu phân cách thập phân sai
Tham số sepStyle kiểm soát dấu phân cách hàng nghìn. Để sử dụng dấu chấm làm dấu phân cách hàng nghìn, truyền sepStyle: 1.

FieldNumberPercentFormatter đầu ra lớn hơn 100 lần
Bộ định dạng nhân giá trị đầu vào với 100. Nếu fieldValue của bạn đã đại diện cho phần trăm (ví dụ, “87.5” thay vì “0.875”), hãy chia cho 100 trước khi gọi Format.

Không tìm thấy không gian tên sau khi cài đặt gói
Đảm bảo bạn đang nhắm mục tiêu net8.0 hoặc phiên bản mới hơn. Không gian tên JavascriptExtensions chỉ có sẵn trong gói Aspose.Pdf.Foss.

NullReferenceException khi fieldValue trống Việc truyền null hoặc một chuỗi rỗng làm fieldValue sẽ gây ra một ngoại lệ phân tích. Hãy xác thực đầu vào trước khi gọi Format.

Câu hỏi thường gặp

Câu “corresponds to AF_Date_Format” có nghĩa là gì?

PDF AcroForm JavaScript sử dụng AF_Date_Format làm hàm định dạng tích hợp cho các trường ngày. FieldDateTimeFormatter tái tạo cùng logic định dạng trong mã .NET quản lý để bạn có thể áp dụng cùng các chuỗi định dạng trường mà không cần thực thi JavaScript.

Tôi có thể sử dụng các bộ định dạng này ngoài ngữ cảnh tài liệu PDF không?

Yes. FieldDateTimeFormatter, FieldNumberCurrencyFormatter, và FieldNumberPercentFormatter là các lớp đơn giản không phụ thuộc vào một thể hiện Document. Bạn có thể sử dụng chúng trong bất kỳ ngữ cảnh .NET 8+ nào như các bộ định dạng tiện ích.

Sự khác nhau giữa FieldNumberCurrencyFormatter và FieldNumberPercentFormatter là gì?

FieldNumberCurrencyFormatter định dạng một số thành số tiền mà không nhân. FieldNumberPercentFormatter nhân đầu vào với 100 và thêm hoặc đặt trước ký hiệu phần trăm.

Có cách nào để nối chuỗi nhiều bộ định dạng không?

Không có chuỗi nối tích hợp sẵn. Áp dụng các bộ định dạng tuần tự trong mã.

Tôi có cần toàn bộ tài liệu PDF để sử dụng các lớp này không?

Không. Các bộ định dạng hoạt động trên các chuỗi thuần và trả về các chuỗi đã định dạng. Chúng không yêu cầu một thể hiện Document mở.

Xem thêm

• Aspose.PDF FOSS for .NET - Tài liệu
• FAQ - Aspose.PDF FOSS for .NET
• Trường hợp sử dụng - Aspose.PDF FOSS for .NET
• Cách làm việc với Quản lý Tài liệu Cốt lõi trong .NET
• Aspose.PDF FOSS for .NET - Trang Sản phẩm
• Aspose.PDF for .NET — Cơ sở Kiến thức Doanh nghiệp