Metadata và Utilities

Metadata và Utilities

Aspose.PDF FOSS for .NET includes utility classes for metadata access, coordinate geometry, image collections, and page-level artifacts. These building blocks support higher-level operations throughout the library.


XMP dữ liệu

Metadata trên một tài liệu cung cấp quyền truy cập vào dòng dữ liệu XMP. đọc và Tạo các thuộc tính XMP tiêu chuẩn hoặc tùy chỉnh.

using var doc = Document.Open(pdfBytes);

// Read existing metadata
foreach (var entry in doc.Metadata)
{
    Console.WriteLine($"{entry.Key}: {entry.Value}");
}

// Set a custom property
doc.Metadata.Add("xmp:CustomProp", new XmpValue("custom value"));
doc.Save("with-metadata.pdf");

Tính năng Geometry Coordinate

RectangleMatrix được sử dụng trên toàn bộ API để định vị và chuyển đổi .

var rect = new Rectangle(72, 700, 300, 720);
bool inside = rect.ContainsPoint(150, 710);

// Transformation matrix (translate by 100, 200)
var matrix = new Matrix(1, 0, 0, 1, 100, 200);

Trang thu thập hoạt động

PageCollection Hỗ trợ chỉ định, iteration và chấp nhận mô hình khách truy cập.

using var doc = Document.Open(pdfBytes);

for (int i = 1; i <= doc.Pages.Count; i++)
{
    var page = doc.Pages[i];
}

Image Collection Hình ảnh

XImageCollection quản lý hình ảnh được nhúng vào các tài nguyên của một trang. XImage cung cấp các phương pháp để kiểm tra thuộc tính hình ảnh.

var images = doc.Pages[1].Resources.Images;
foreach (var img in images)
{
    Console.WriteLine($"Color type: {img.GetColorType()}");
}

Artifacts

Artifact đại diện cho các yếu tố không chứa như dấu hiệu nước, đầu và Sử dụng các tài liệu để số trang và các yếu tố trang trí.

var artifact = new Artifact(ArtifactType.Watermark);
artifact.SetPageNumberReplacementString("Page {0}");

Mẹo và Thực hành Tốt nhất

  • Các khóa metadata XMP tuân theo các thông số kỹ thuật Dublin Core và X MP – sử dụng định dạng đặt tên không gian tiêu chuẩn.
  • Rectangle Các tọa độ được đặt trong các đơn vị không gian người dùng PDF (1/72 inch), với nguồn gốc ở phía dưới bên trái.
  • Sử dụng Matrix cho các biến đổi tinh tế: dịch, xoay, quy mô và phân.
  • XmpValue Hỗ trợ các loại string, integer, double, date và array.
  • Các vật liệu là các yếu tố cấu trúc - chúng không xuất hiện trong đường lối cây có thể truy cập.

Các vấn đề thường gặp

IssueCauseFix Đặt
Metadata Key Không Tìm thấyKey sử dụng một tên không gian khác nhau PrefixDanh sách tất cả các khóa trước tiên để tìm được tiền đề chính xác
Các tọa độ trực tiếp dường như bị đảo ngượcPDF nguồn là dưới trái, không phải ở trên tráiĐiều chỉnh và phối hợp theo
Bộ sưu tập hình ảnh trống rỗngHình ảnh là trong hình thức XObjects, không phải nguồn trang trực tiếpCheck XFormCollection Nguồn nguồn hình ảnh NESTED

FAQ

Làm thế nào để đọc tiêu đề tài liệu từ metadata?

Access doc.Metadata["dc:title"] Đối với tài sản tiêu đề Dublin Core.

Tôi có thể thêm một dấu hiệu nước không?

Có. tạo một Artifact với loại Watermark Và thêm vào trang.

Hệ thống phối hợp nào được sử dụng bởi Rectangle?

Không gian người dùng PDF: nguồn gốc ở phía dưới bên trái, đơn vị 1/72 inch. Một trang US Letter tiêu chuẩn là 612 x 792 đơn hàng.


Tóm tắt Tham chiếu API

Class / Phương phápDescription
MetadataXMP Metadata Dictionary trên tài liệu
XmpValueTích hợp cho giá trị tài sản XMP
Rectanglehộp biên axis (llx, ng, urx và ury)
Rectangle.ContainsPointKiểm tra xem một điểm nằm bên trong góc thẳng
Matrix2D affine transformation matrix
Matrix.TranslateTạo một bản dịch matrix
PageCollectionTrang thu thập đơn đặt hàng với indexing dựa trên 1
XImageCollectionNguồn ảnh trên một trang
XImageHình ảnh tích hợp duy nhất với loại màu phát hiện
Artifact- Không chứa nội dung (watermark, header, footer)
Artifact.SetPageNumberReplacementStringTemplate for page-number artifacts (Tình mẫu đối với trang số)

See Also

 Tiếng Việt