ניהול מסמכים מרכזי

המחלקה Document היא נקודת הכניסה הראשית ל‑Aspose.PDF FOSS עבור .NET.
היא מממשת IDisposable ויש להשתמש בה בבלוק using כדי להבטיח
כל המשאבים משתחררים מיידית.

יצירת מסמך PDF חדש

השתמש ב-Document.Create() כדי ליצור מסמך PDF ריק:

using Aspose.Pdf;
using var doc = Document.Create();
doc.Pages.Add();
doc.Save("new-document.pdf");

לחלופין, צור מופע Document ישירות עם new Document():

using Aspose.Pdf;
using var doc = new Document();
doc.Pages.Add();
doc.Save("new-document.pdf");

פתיחת מסמך PDF קיים

Document.Open מקבל byte[], נתיב קובץ string, או Stream.

פתיחה ממערך בתים:

using Aspose.Pdf;
byte[] data = File.ReadAllBytes("input.pdf");
using var doc = Document.Open(data);
Console.WriteLine($"Pages: {doc.Pages.Count}");

פתיחה מנתיב קובץ:

using Aspose.Pdf;
using var doc = Document.Open("input.pdf");
Console.WriteLine($"Pages: {doc.Pages.Count}");

פתח מ-Stream:

using Aspose.Pdf;
using var stream = File.OpenRead("input.pdf");
using var doc = Document.Open(stream);
Console.WriteLine($"Pages: {doc.Pages.Count}");

פתיחת PDF מוגן בסיסמה

העבר את הסיסמה כארגומנט שני לכל גרסה של Document.Open:

using Aspose.Pdf;
using var doc = Document.Open("protected.pdf", "mypassword");

שמירת מסמך

Document.Save כותב את המסמך הנוכחי לנתיב קובץ או זרם.
Document.ToArray מחזיר את הבייטים המיוצרים ישירות.

שמור לקובץ:

using Aspose.Pdf;
using var doc = Document.Open(File.ReadAllBytes("input.pdf"));
doc.Pages.Add();
doc.Save("output.pdf");

שמור סיבוב‑נסיעה ל‑MemoryStream (מתוך snippet_014.cs):

using Aspose.Pdf;
var data = File.ReadAllBytes("input.pdf");
using var doc = Document.Open(data);
var page = doc.Pages[1];
var action = PdfAction.CreateJavaScript("app.alert('Round trip');");
page.Annotations.AddLinkAnnotation(new Rectangle(50, 600, 200, 620), action);
using var ms = new MemoryStream();
doc.Save(ms);
ms.Position = 0;
using var doc2 = Document.Open(ms.ToArray());

סיראליזציה למערך בתים:

using Aspose.Pdf;
using var doc = Document.Open(File.ReadAllBytes("input.pdf"));
var bytes = doc.ToArray();
File.WriteAllBytes("output.pdf", bytes);

גישה לדפים

דפים נגישים דרך Document.Pages, שהיא מבוססת על 1
PageCollection. השתמש באינדקס השלם כדי לקבל Page ספציפי:

using Aspose.Pdf;
using var doc = Document.Open(File.ReadAllBytes("input.pdf"));
var page = doc.Pages[1];
Console.WriteLine($"Width: {page.Width}, Height: {page.Height}");
Console.WriteLine($"Rotation: {page.RotateDegrees}");
Console.WriteLine($"Annotations: {page.Annotations.Count}");

גישה לטופס

שדות AcroForm אינטראקטיביים זמינים דרך Document.Form. בדוק את null לפני הגישה כאשר ייתכן שהמסמך אינו מכיל טופס:

using Aspose.Pdf;
using var doc = Document.Open(File.ReadAllBytes("form.pdf"));
if (doc.Form is not null)
{
    foreach (var field in doc.Form.Fields)
    {
        Console.WriteLine($"{field.Name}: {field.Value}");
    }
}

שחרור מסמך

Document מיישמת IDisposable. תמיד השתמשו ב-using או קראו ל-Dispose() במפורש:

using Aspose.Pdf;
using var doc = Document.Open("input.pdf");
// doc is disposed automatically at the end of the using block.

ראה גם

Aspose.PDF — תיעוד ארגוני