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
Rectangle và Matrix đượ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.
RectangleCá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
Matrixcho các biến đổi tinh tế: dịch, xoay, quy mô và phân. XmpValueHỗ 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
| Issue | Cause | Fix Đặt |
|---|---|---|
| Metadata Key Không Tìm thấy | Key sử dụng một tên không gian khác nhau Prefix | Danh 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ược | PDF 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ỗng | Hình ảnh là trong hình thức XObjects, không phải nguồn trang trực tiếp | Check 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áp | Description |
|---|---|
Metadata | XMP Metadata Dictionary trên tài liệu |
XmpValue | Tích hợp cho giá trị tài sản XMP |
Rectangle | hộp biên axis (llx, ng, urx và ury) |
Rectangle.ContainsPoint | Kiểm tra xem một điểm nằm bên trong góc thẳng |
Matrix | 2D affine transformation matrix |
Matrix.Translate | Tạo một bản dịch matrix |
PageCollection | Trang thu thập đơn đặt hàng với indexing dựa trên 1 |
XImageCollection | Nguồn ảnh trên một trang |
XImage | Hì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.SetPageNumberReplacementString | Template for page-number artifacts (Tình mẫu đối với trang số) |