Метаданни и утилитетни услуги
Метаданни и утилитетни услуги
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
Metadata на документ дава достъп до потока от XMP метаданни. Прочетете и да пише стандартни или персонализирани XMP свойства.
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");Координатна геометрия
Rectangle и в) Matrix се използват в целия API за позициониране и преобразуване.
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);Операции по събиране на страници
PageCollection Поддържа индексиране, итерация и приемане на паттерна от посетители.
using var doc = Document.Open(pdfBytes);
for (int i = 1; i <= doc.Pages.Count; i++)
{
var page = doc.Pages[i];
}Снимки от колекции
XImageCollection Управлява изображения, вградени в ресурсите на страницата. XImage предоставя методи за проверка на свойствата на изображението.
var images = doc.Pages[1].Resources.Images;
foreach (var img in images)
{
Console.WriteLine($"Color type: {img.GetColorType()}");
}Артефакти
Artifact представлява елементи, които не са съдържание като водни знаци, заглавия и Използвайте артефакти за нумерация на страници и декоративни елементи.
var artifact = new Artifact(ArtifactType.Watermark);
artifact.SetPageNumberReplacementString("Page {0}");Съвети и най-добри практики
- Ключовете за метаданни на XMP следват спецификациите Dublin Core и X MP използват стандартните префикси в пространството на имената.
Rectangleкоординатите са в PDF потребителски пространствени единици (1/72 инча), с произход от долната лява страна.- Използване на:
Matrixза аффини преобразувания: трансляция, ротация, скалиране и резене. XmpValueПоддържа типове на струни, цели числа, двойно число, дата и масиви.- Артефактите са структурни елементи те не се появяват в преминаванията на дърветата за достъпност.
Общи проблеми
| Издание | Причина за това | Ремонтиране |
|---|---|---|
| Не е намерен ключ за метаданни. | Ключът използва различен префикс на пространство за имена. | Избройте всички ключове първо, за да намерите правилната префикс. |
| Координатите на правоъгълника изглеждат обърнати. | PDF произходът е от долната лява страна, а не от горната лева. | Съответно коригирайте координатите на Y. |
| Снимка е празна. | Изображенията са във формата XObjects, не директно ресурси на страницата. | Проверка. XFormCollection за ресурсите на вградени изображения |
FAQ
Как да прочета заглавието на документа от метаданните?
Достъп до информация doc.Metadata["dc:title"] за имота Dublin Core.
Мога ли да добавя артефакт с водна марка?
Да, да създадем… Artifact с тип Watermark и да го добавим на страницата.
Каква координатна система използва “Правоъгълникът”?
PDF потребителско пространство: произход в долната лява част, единици от 1/72 инч. Стандартна страница на US Letter е 612 х 792 единица.
Снимка на API референтна информация
| Клас / метод | Описание на състоянието |
|---|---|
Metadata | XMP речник на метаданните за документа |
XmpValue | Тип обертвач за стойности на свойствата XMP |
Rectangle | Определяща кутия, подредена към оста (llx, lly, urx и ury) |
Rectangle.ContainsPoint | Пробване дали точка се намира в рамките на правоъгълника |
Matrix | 2D affine transformation matrix |
Matrix.Translate | Създаване на матрица за превод |
PageCollection | Поръчано събиране на страници с индексиране, основаващо се на 1 |
XImageCollection | Източник на изображения в страница |
XImage | Еднообразно вградено изображение с цветно разпознаване на типа |
Artifact | Елемент на страница, който не съдържа (водолейка, заглавие, краища) |
Artifact.SetPageNumberReplacementString | Шаблон за артефакти с номера на страници |