Class PdfFileEditor

فئة PdfFileEditor

تنفذ العمليات المتعلقة بملف PDF: الدمج، التقسيم، استخراج الصفحات، صنع كتيب، إلخ.

public sealed class PdfFileEditor

المنشئات

الاسمالوصف
PdfFileEditor()المنشئ الافتراضي.

الخصائص

الاسمالوصف
CloseConcatenatedStreams { get; set; }إذا تم تعيينه على true، يتم إغلاق التدفقات بعد العملية.
ConcatenationPacketSize { get; set; }عدد الوثائق المدمجة قبل إجراء تحديث تدريجي جديد أثناء الدمج عندما يتم تعيين UseDiskBuffer على true.
ConversionLog { get; }يحصل على سجل عملية التحويل.
ConvertTo { set; }يحدد تنسيق ملف PDF. سيتم حفظ الملف الناتج بالتنسيق المحدد. إذا لم يتم تحديد هذه الخاصية، فسيتم حفظ الملف بالتنسيق الافتراضي لـ PDF دون تحويل.
CopyLogicalStructure { get; set; }إذا كان true، يتم نسخ الهيكل المنطقي للملف عند إجراء الدمج.
CopyOutlines { get; set; }إذا كان true، سيتم نسخ المخططات.
CorruptedFileAction { get; set; }تحدد هذه الخاصية السلوك عند مواجهة ملف تالف أثناء عملية الدمج. القيم الممكنة هي: StopWithError و ConcatenateIgnoringCorrupted.
CorruptedItems { get; }مصفوفة من المشكلات التي تمت مواجهتها عند إجراء الدمج. لكل وثيقة تالفة من الممررة إلى دالة Concatenate() يتم إنشاء إدخال جديد من نوع CorruptedItem. يمكن استخدام هذه الخاصية فقط عندما تكون CorruptedFileAction هي ConcatenateIgnoringCorrupted.
IncrementalUpdates { get; set; }إذا كان true، يتم إجراء تحديثات تدريجية أثناء الدمج.
KeepActions { get; set; }إذا كان true، سيتم نسخ الإجراءات من الوثائق المصدر. القيمة الافتراضية: true.
KeepFieldsUnique { get; set; }إذا كان true، سيتم جعل أسماء الحقول فريدة عند دمج النماذج. سيتم إضافة لواحق إلى أسماء الحقول، ويمكن تحديد قالب اللاحقة في خاصية UniqueSuffix.
LastException { get; }يحصل على آخر استثناء حدث. يمكن استخدامه للتحقق من سبب الفشل.
MergeDuplicateLayers { get; set; }المحتويات الاختيارية للوثائق المدمجة ذات الأسماء المتساوية سيتم دمجها في طبقة واحدة في الوثيقة الناتجة إذا كانت هذه الخاصية true. خلاف ذلك، سيتم حفظ الطبقات ذات الأسماء المتساوية كطبقات مختلفة في الوثيقة الناتجة.
MergeDuplicateOutlines { get; set; }إذا كان true، يتم دمج المخططات المكررة.
OptimizeSize { get; set; }يحصل على أو يحدد علامة التحسين. يتم دمج تدفقات الموارد المتساوية في الملف الناتج في كائن PDF واحد إذا تم تعيين هذه العلامة. يسمح ذلك بتقليل حجم الملف الناتج ولكن قد يتسبب في تنفيذ أبطأ ومتطلبات ذاكرة أكبر. القيمة الافتراضية: false.
OwnerPassword { get; set; }يحدد كلمة مرور المالك إذا كان ملف PDF المدخل مشفرًا. لم يتم تنفيذ هذه الخاصية بعد.
PreserveUserRights { get; set; }إذا كان true، يتم تطبيق حقوق المستخدم للوثيقة الأولى على الوثيقة المدمجة. يتم تجاهل حقوق المستخدم لجميع الوثائق الأخرى.
RemoveSignatures { get; set; }إذا كان true، سيتم إزالة جميع التوقيعات من الحقول (ستبقى الحقول)؛ خلاف ذلك، يمكنك الحصول على توقيعات غير صالحة.
UniqueSuffix { get; set; }تنسيق اللاحقة التي تضاف إلى اسم الحقل لجعله فريدًا عند دمج النماذج. يجب أن تحتوي هذه السلسلة على جزء فرعي %NUM% سيتم استبداله بالأرقام. على سبيل المثال، إذا كانت UniqueSuffix = “ABC%NUM%"، فإن أسماء الحقول “fieldName” ستكون: fieldNameABC1، fieldNameABC2، fieldNameABC3، إلخ.
UseDiskBuffer { get; set; }إذا تم استخدام هذا الخيار، سيتم حفظ الوثيقة الوجهة على القرص بشكل دوري وسيتم تطبيق الدمج اللاحق عليها كتحديثات تدريجية.

الطرق

الاسمالوصف
AddMargins(Stream, Stream, int[], double, double, double, double)يعيد حجم محتويات الصفحة ويضيف الهوامش المحددة. يتم تحديد الهوامش بوحدات الفضاء الافتراضية.
AddMargins(string, string, int[], double, double, double, double)يعيد حجم محتويات الصفحة ويضيف الهوامش المحددة. يتم تحديد الهوامش بوحدات الفضاء الافتراضية.
AddMarginsPct(Stream, Stream, int[], double, double, double, double)يعيد حجم محتويات الصفحة ويضيف الهوامش المحددة. يتم تحديد الهوامش كنسب مئوية من حجم الصفحة الأولية.
AddMarginsPct(string, string, int[], double, double, double, double)يعيد حجم محتويات الصفحة ويضيف الهوامش المحددة. يتم تحديد الهوامش كنسب مئوية من حجم الصفحة الأولية.
AddPageBreak(Document, Document, PageBreak[])يضيف فواصل صفحات إلى صفحات الوثيقة.
AddPageBreak(Stream, Stream, PageBreak[])يضيف فواصل صفحات إلى صفحات الوثيقة.
AddPageBreak(string, string, PageBreak[])يضيف فواصل صفحات إلى صفحات الوثيقة.
Append(Stream, Stream, int, int, Stream)يضيف الصفحات، التي تم اختيارها من portStream ضمن النطاق من startPage إلى endPage، في portStream في نهاية firstInputStream.
Append(Stream, Stream[], int, int, Stream)يضيف الصفحات، التي تم اختيارها من مصفوفة الوثائق في portStreams. تتضمن الوثيقة الناتجة firstInputFile وجميع صفحات وثائق portStreams في النطاق من startPage إلى endPage.
Append(string, string, int, int, string)يضيف الصفحات، التي تم اختيارها من portFile ضمن النطاق من startPage إلى endPage، في portFile في نهاية firstInputFile.
Append(string, string[], int, int, string)يضيف الصفحات، التي تم اختيارها من وثائق portFiles. تتضمن الوثيقة الناتجة firstInputFile وجميع صفحات وثائق portFiles في النطاق من startPage إلى endPage.
Concatenate(Document[], Document)يدمج الوثائق.
Concatenate(Stream[], Stream)يدمج الملفات
Concatenate(string[], string)يدمج الملفات في ملف واحد.
Concatenate(Stream, Stream, Stream)يدمج ملفين.
Concatenate(string, string, string)يدمج ملفين.
Concatenate(Stream, Stream, Stream, Stream)يدمج وثيقتين PDF في وثيقة PDF جديدة مع الصفحات بطرق متناوبة ويملأ الأماكن الفارغة بصفحات فارغة. على سبيل المثال: تحتوي الوثيقة1 على 5 صفحات: p1، p2، p3، p4، p5. تحتوي الوثيقة2 على 3 صفحات: p1’، p2’، p3’. سيؤدي دمج وثيقتي PDF إلى إنتاج الوثيقة الناتجة مع الصفحات: p1، p1’، p2، p2’، p3، p3’، p4، صفحة فارغة، p5، صفحة فارغة.
Concatenate(string, string, string, string)يدمج وثيقتين PDF في وثيقة PDF جديدة مع الصفحات بطرق متناوبة ويملأ الأماكن الفارغة بصفحات فارغة. على سبيل المثال: تحتوي الوثيقة1 على 5 صفحات: p1، p2، p3، p4، p5. تحتوي الوثيقة2 على 3 صفحات: p1’، p2’، p3’. سيؤدي دمج وثيقتي PDF إلى إنتاج الوثيقة الناتجة مع الصفحات: p1، p1’، p2، p2’، p3، p3’، p4، صفحة فارغة، p5، صفحة فارغة.
Delete(Stream, int[], Stream)يحذف الصفحات المحددة بواسطة مصفوفة الأرقام من ملف الإدخال، ويحفظها كملف PDF جديد.
Delete(string, int[], string)يحذف الصفحات المحددة بواسطة مصفوفة الأرقام من ملف الإدخال، ويحفظها كملف PDF جديد.
Extract(Stream, int[], Stream)يستخرج الصفحات المحددة بواسطة مصفوفة الأرقام، ويحفظها كملف PDF جديد.
Extract(string, int[], string)يستخرج الصفحات المحددة بواسطة مصفوفة الأرقام، ويحفظها كملف PDF جديد.
Extract(Stream, int, int, Stream)يستخرج الصفحات من ملف الإدخال، ويحفظها كملف PDF جديد.
Extract(string, int, int, string)يستخرج الصفحات من ملف الإدخال، ويحفظها كملف PDF جديد.
Insert(Stream, int, Stream, int[], Stream)يُدخل الصفحات من ملف آخر في ملف PDF الإدخال.
Insert(string, int, string, int[], string)يُدخل الصفحات من ملف آخر في ملف PDF الإدخال.
Insert(Stream, int, Stream, int, int, Stream)يُدخل الصفحات من ملف آخر في ملف PDF الإدخال.
Insert(string, int, string, int, int, string)يُدخل الصفحات من ملف آخر في ملف PDF في موضع.
MakeBooklet(Stream, Stream)يصنع كتيب من InputStream إلى outputStream.
MakeBooklet(string, string)يصنع كتيب من ملف الإدخال إلى ملف الإخراج.
MakeBooklet(Stream, Stream, PageSize)يصنع كتيب من تدفق الإدخال ويحفظ النتيجة في تدفق الإخراج.
MakeBooklet(string, string, PageSize)يصنع كتيب من inputFile إلى outputFile.
MakeBooklet(Stream, Stream, int[], int[])يصنع كتيب مخصص من InputStream الأول إلى outputStream.
MakeBooklet(string, string, int[], int[])يصنع كتيب مخصص من firstInputFile إلى outputFile.
MakeBooklet(Stream, Stream, PageSize, int[], int[])يصنع كتيب من InputStream الأول إلى outputStream.
MakeBooklet(string, string, PageSize, int[], int[])يصنع كتيب مخصص من firstInputFile إلى outputFile.
MakeNUp(Stream, Stream, Stream)يصنع وثيقة N-Up من تدفقات PDF المدخلة إلى outputStream.
MakeNUp(Stream[], Stream, bool)يصنع وثيقة N-Up من تدفقات PDF المدخلة المتعددة إلى outputStream. ستحتوي كل صفحة من outputStream على صفحات متعددة، وهي مزيج من الصفحات في تدفقات الإدخال بنفس رقم الصفحة. تتراكم الصفحات المتعددة أفقيًا إذا كانت isSidewise true وتتراكم عموديًا إذا كانت isSidewise false.
MakeNUp(string, string, string)يصنع وثيقة N-Up من ملفي PDF المدخلين إلى outputFile. ستحتوي كل صفحة من outputFile على صفحتين، صفحة واحدة من ملف الإدخال الأول وأخرى من ملف الإدخال الثاني. تتراكم الصفحتان أفقيًا.
MakeNUp(string[], string, bool)يصنع وثيقة N-Up من ملفات PDF المدخلة المتعددة إلى outputFile. ستحتوي كل صفحة من outputFile على صفحات متعددة، وهي مزيج من الصفحات في ملفات الإدخال بنفس رقم الصفحة. تتراكم الصفحات المتعددة أفقيًا إذا كانت isSidewise true وتتراكم عموديًا إذا كانت isSidewise false.
MakeNUp(Stream, Stream, int, int)يصنع وثيقة N-Up من تدفق الإدخال ويحفظ النتيجة في تدفق الإخراج.
MakeNUp(string, string, int, int)يصنع وثيقة N-Up من firstInputFile إلى outputFile.
MakeNUp(Stream, Stream, int, int, PageSize)يصنع وثيقة N-Up من تدفق الإدخال الأول إلى تدفق الإخراج.
MakeNUp(string, string, int, int, PageSize)يصنع وثيقة N-Up من ملف الإدخال إلى outputFile.
ResizeContents(Document, ContentsResizeParameters)يعيد حجم صفحات الوثيقة. تتم إضافة هوامش فارغة حول الصفحة المتقلصة.
ResizeContents(Document, int[], ContentsResizeParameters)يعيد حجم صفحات الوثيقة. تتم إضافة هوامش فارغة حول الصفحة المتقلصة.
ResizeContents(Stream, Stream, int[], ContentsResizeParameters)يعيد حجم محتويات صفحات الوثيقة.
ResizeContents(string, string, int[], ContentsResizeParameters)يعيد حجم محتويات الصفحات في الوثيقة. إذا تم تقليص الصفحة، تتم إضافة هوامش فارغة حول الصفحة.
ResizeContents(Stream, Stream, int[], double, double)يعيد حجم محتويات صفحات الوثيقة. يتم تقليص محتويات الصفحة وإضافة هوامش. يتم تحديد الحجم الجديد للمحتويات بوحدات الفضاء الافتراضية.
ResizeContents(string, string, int[], double, double)يعيد حجم محتويات صفحات الوثيقة. يتم تقليص محتويات الصفحة وإضافة هوامش. يتم تحديد الحجم الجديد للمحتويات بوحدات الفضاء الافتراضية.
ResizeContentsPct(Stream, Stream, int[], double, double)يعيد حجم محتويات صفحات الوثيقة. يتم تقليص محتويات الصفحة وإضافة هوامش. يتم تحديد حجم المحتويات الجديد كنسب مئوية.
ResizeContentsPct(string, string, int[], double, double)يعيد حجم محتويات صفحات الوثيقة. يتم تقليص محتويات الصفحة وإضافة هوامش. يتم تحديد حجم المحتويات الجديد كنسب مئوية.
SplitFromFirst(Stream, int, Stream)يقسم من البداية إلى الموقع المحدد، ويحفظ الجزء الأمامي في تدفق الإخراج.
SplitFromFirst(string, int, string)يقسم ملف PDF من الصفحة الأولى إلى الموقع المحدد، ويحفظ الجزء الأمامي كملف جديد.
SplitToBulks(Stream, int[][])يقسم ملف PDF إلى عدة وثائق. يمكن أن تكون الوثائق ذات صفحة واحدة أو متعددة الصفحات.
SplitToBulks(string, int[][])يقسم ملف PDF إلى عدة وثائق. يمكن أن تكون الوثائق ذات صفحة واحدة أو متعددة الصفحات.
SplitToEnd(Stream, int, Stream)يقسم من الموقع المحدد، ويحفظ الجزء الخلفي كملف جديد.
SplitToEnd(string, int, string)يقسم من الموقع، ويحفظ الجزء الخلفي كملف جديد.
SplitToPages(Stream)يقسم ملف PDF إلى وثائق ذات صفحة واحدة.
SplitToPages(string)يقسم ملف PDF إلى وثائق ذات صفحة واحدة.
SplitToPages(Stream, string)يقسم ملف PDF إلى وثائق ذات صفحة واحدة ويحفظها في المسار المحدد. يتم تحديد المسار بواسطة قالب اسم الحقل.
SplitToPages(string, string)يقسم ملف PDF إلى وثائق ذات صفحة واحدة ويحفظها في المسار المحدد. يتم تحديد المسار بواسطة قالب اسم الحقل.
TryAppend(Stream, Stream[], int, int, Stream)يضيف الصفحات، التي تم اختيارها من مصفوفة الوثائق في portStreams. تتضمن الوثيقة الناتجة firstInputFile وجميع صفحات وثائق portStreams في النطاق من startPage إلى endPage.
TryAppend(string, string[], int, int, string)يضيف الصفحات، التي تم اختيارها من وثائق portFiles. تتضمن الوثيقة الناتجة firstInputFile وجميع صفحات وثائق portFiles في النطاق من startPage إلى endPage.
TryConcatenate(Document[], Document)يدمج الوثائق.
TryConcatenate(Stream[], Stream)يدمج الملفات
TryConcatenate(string[], string)يدمج الملفات في ملف واحد.
TryConcatenate(string, string, string)يدمج ملفين.
TryConcatenate(Stream, Stream, Stream, Stream)يدمج وثيقتين PDF في وثيقة PDF جديدة مع الصفحات بطرق متناوبة ويملأ الأماكن الفارغة بصفحات فارغة. على سبيل المثال: تحتوي الوثيقة1 على 5 صفحات: p1، p2، p3، p4، p5. تحتوي الوثيقة2 على 3 صفحات: p1’، p2’، p3’. سيؤدي دمج وثيقتي PDF إلى إنتاج الوثيقة الناتجة مع الصفحات: p1، p1’، p2، p2’، p3، p3’، p4، صفحة فارغة، p5، صفحة فارغة.
TryConcatenate(string, string, string, string)يدمج وثيقتين PDF في وثيقة PDF جديدة مع الصفحات بطرق متناوبة ويملأ الأماكن الفارغة بصفحات فارغة. على سبيل المثال: تحتوي الوثيقة1 على 5 صفحات: p1، p2، p3، p4، p5. تحتوي الوثيقة2 على 3 صفحات: p1’، p2’، p3’. سيؤدي دمج وثيقتي PDF إلى إنتاج الوثيقة الناتجة مع الصفحات: p1، p1’، p2، p2’، p3، p3’، p4، صفحة فارغة، p5، صفحة فارغة.
TryDelete(Stream, int[], Stream)يحذف الصفحات المحددة بواسطة مصفوفة الأرقام من ملف الإدخال، ويحفظها كملف PDF جديد.
TryDelete(string, int[], string)يحذف الصفحات المحددة بواسطة مصفوفة الأرقام من ملف الإدخال، ويحفظها كملف PDF جديد.
TryExtract(Stream, int[], Stream)يستخرج الصفحات المحددة بواسطة مصفوفة الأرقام، ويحفظها كملف PDF جديد.
TryExtract(string, int[], string)يستخرج الصفحات المحددة بواسطة مصفوفة الأرقام، ويحفظها كملف PDF جديد.
TryExtract(string, int, int, string)يستخرج الصفحات من ملف الإدخال، ويحفظها كملف PDF جديد.
TryInsert(Stream, int, Stream, int[], Stream)يُدخل الصفحات من ملف آخر في ملف PDF الإدخال.
TryInsert(string, int, string, int[], string)يُدخل الصفحات من ملف آخر في ملف PDF الإدخال.
TryMakeBooklet(Stream, Stream)يصنع كتيب من InputStream إلى outputStream.
TryMakeBooklet(string, string)يصنع كتيب من ملف الإدخال إلى ملف الإخراج.
TryMakeBooklet(Stream, Stream, PageSize)يصنع كتيب من تدفق الإدخال ويحفظ النتيجة في تدفق الإخراج.
TryMakeBooklet(string, string, PageSize)يصنع كتيب من inputFile إلى outputFile.
TryMakeBooklet(Stream, Stream, int[], int[])يصنع كتيب مخصص من InputStream الأول إلى outputStream.
TryMakeBooklet(string, string, int[], int[])يصنع كتيب مخصص من firstInputFile إلى outputFile.
TryMakeBooklet(Stream, Stream, PageSize, int[], int[])يصنع كتيب من InputStream الأول إلى outputStream.
TryMakeBooklet(string, string, PageSize, int[], int[])يصنع كتيب مخصص من firstInputFile إلى outputFile.
TryMakeNUp(Stream, Stream, Stream)يصنع وثيقة N-Up من تدفقات PDF المدخلة إلى outputStream.
TryMakeNUp(Stream[], Stream, bool)يصنع وثيقة N-Up من تدفقات PDF المدخلة المتعددة إلى outputStream. ستحتوي كل صفحة من outputStream على صفحات متعددة، وهي مزيج من الصفحات في تدفقات الإدخال بنفس رقم الصفحة. تتراكم الصفحات المتعددة أفقيًا إذا كانت isSidewise true وتتراكم عموديًا إذا كانت isSidewise false.
TryMakeNUp(string, string, string)يصنع وثيقة N-Up من ملفي PDF المدخلين إلى outputFile. ستحتوي كل صفحة من outputFile على صفحتين، صفحة واحدة من ملف الإدخال الأول وأخرى من ملف الإدخال الثاني. تتراكم الصفحتان أفقيًا.
TryMakeNUp(string[], string, bool)يصنع وثيقة N-Up من ملفات PDF المدخلة المتعددة إلى outputFile. ستحتوي كل صفحة من outputFile على صفحات متعددة، وهي مزيج من الصفحات في ملفات الإدخال بنفس رقم الصفحة. تتراكم الصفحات المتعددة أفقيًا إذا كانت isSidewise true وتتراكم عموديًا إذا كانت isSidewise false.
TryMakeNUp(Stream, Stream, int, int)يصنع وثيقة N-Up من تدفق الإدخال ويحفظ النتيجة في تدفق الإخراج.
TryMakeNUp(string, string, int, int)يصنع وثيقة N-Up من firstInputFile إلى outputFile.
TryMakeNUp(Stream, Stream, int, int, PageSize)يصنع وثيقة N-Up من تدفق الإدخال الأول إلى تدفق الإخراج.
TryMakeNUp(string, string, int, int, PageSize)يصنع وثيقة N-Up من ملف الإدخال إلى outputFile.
TryResizeContents(Stream, Stream, int[], ContentsResizeParameters)يعيد حجم محتويات صفحات الوثيقة.
TryResizeContents(string, string, int[], ContentsResizeParameters)يعيد حجم محتويات الصفحات في الوثيقة. إذا تم تقليص الصفحة، تتم إضافة هوامش فارغة حول الصفحة.
TryResizeContents(Stream, Stream, int[], double, double)يعيد حجم محتويات صفحات الوثيقة. يتم تقليص محتويات الصفحة وإضافة هوامش. يتم تحديد الحجم الجديد للمحتويات بوحدات الفضاء الافتراضية.
TrySplitFromFirst(Stream, int, Stream)يقسم من البداية إلى الموقع المحدد، ويحفظ الجزء الأمامي في تدفق الإخراج.
TrySplitFromFirst(string, int, string)يقسم ملف PDF من الصفحة الأولى إلى الموقع المحدد، ويحفظ الجزء الأمامي كملف جديد.
TrySplitToEnd(Stream, int, Stream)يقسم من الموقع المحدد، ويحفظ الجزء الخلفي كملف جديد.
TrySplitToEnd(string, int, string)يقسم من الموقع، ويحفظ الجزء الخلفي كملف جديد.

أعضاء آخرون

الاسمالوصف
enum ConcatenateCorruptedFileActionالإجراء المتخذ عند مواجهة ملف تالف في عملية الدمج.
class ContentsResizeParametersفئة لتحديد معلمات تغيير حجم الصفحة. يسمح بتعيين المعلمات التالية: حجم الصفحة الناتجة (العرض، الارتفاع) بوحدات الفضاء الافتراضية أو كنسب مئوية من حجم الصفحات الأولية؛ الهوامش اليسرى، العلوية، السفلية، واليمنى بوحدات الفضاء الافتراضية أو كنسب مئوية من حجم الصفحة الأولية؛ يمكن ترك بعض القيم فارغة للحساب التلقائي. سيتم حساب هذه القيم من بقية حجم الصفحة بعد حساب القيم المحددة صراحة. على سبيل المثال: إذا كان عرض الصفحة = 100 وتم تحديد عرض الصفحة الجديدة بـ 60 وحدة، فإن الهوامش اليسرى واليمنى يتم حسابها تلقائيًا: (100 - 60) / 2 = 15. تُستخدم هذه الفئة في طريقة ResizeContents.
class ContentsResizeValueقيمة الهامش أو حجم المحتوى المحدد كنسب مئوية من وحدات الفضاء الافتراضية. تُستخدم هذه الفئة في ContentsResizeParameters.
class CorruptedItemفئة توفر معلومات حول الملفات التالفة في وقت الدمج.
class PageBreakبيانات موضع فاصل الصفحة.

انظر أيضًا