كيفية دمج ملفات PDF متعددة في ملف واحد في C# .Net

كيفية دمج ملفات PDF في C# باستخدام REST API.

PDF(تنسيق المستند المحمول) يُستخدم على نطاق واسع لمشاركة المستندات مع الحفاظ على تنسيقها وتخطيطها. في سيناريوهات معينة ، قد تحتاج إلى دمج ملفات PDF متعددة في مستند واحد لتبسيط المعلومات أو تحسين إمكانية الوصول. توفر GroupDocs.Merger Cloud SDK لـ .Net طريقة فعالة وبديهية لدمج ملفات PDF برمجيًا ، مما يوفر لك الوقت والجهد. في هذه المقالة ، سوف نستكشف كيفية دمج ودمج ملفات PDF في C# باستخدام REST API.

سيتم تناول الموضوعات التالية في هذه المقالة:

C# REST API لدمج ملفات PDF وتثبيت C# SDK

GroupDocs.Merger Cloud SDK for .NET هو حل قوي وموثوق يسمح للمطورين بدمج إمكانات دمج PDF في تطبيقات C# الخاصة بهم. يوفر مجموعة شاملة من الميزات والوظائف لدمج ملفات PDF ودمجها بسلاسة. باستخدام SDK ، يمكنك دمج العديد من تنسيقات المستندات المدعومة في مستند واحد ، مع الاحتفاظ بتنسيقها الأصلي وتخطيطها ومحتواها. يمكن دمج SDK في تطبيق قائم على C# لتبسيط عملية التطوير لديك.

يمكنك تثبيت GroupDocs.Merger Cloud SDK for .NET على مشروعك من NuGet Package manager أو باستخدام الأمر التالي في .NET CLI:

dotnet add package GroupDocs.Merger-Cloud --version 23.4.0

بعد ذلك ، اجمع معرّف العميل وسر العميل من لوحة القيادة قبل أن تبدأ في اتباع الخطوات وأمثلة الكود المتاحة. أضف معرف العميل وسر العميل في الكود كما هو موضح أدناه:

//احصل على clientId & clientSecret من https://dashboard.groupdocs.cloud (التسجيل المجاني مطلوب).
string clientId = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
string clientSecret = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx";
string myStorage = "test-internal-storage";

var configuration = new Configuration(clientId, clientSecret);
configuration.ApiBaseUrl = "https://api.groupdocs.cloud";

دمج ملفات PDF متعددة في ملف واحد في C# باستخدام واجهة برمجة تطبيقات REST

الآن بعد أن تم إعداد بيئة التطوير الخاصة بنا وتثبيت SDK ، فلنبدأ في دمج ملفات PDF. اتبع هذه الخطوات:

  • تحميل ملفات PDF على السحابة
  • دمج ملفات PDF التي تم تحميلها
  • تحميل الشرائح المدمجة

تحميل الملفات

أولاً ، قم بتحميل مستند PDF إلى التخزين السحابي باستخدام أي من الطرق التالية:

  • استخدام لوحة التحكم
  • قم بتحميل جميع الملفات واحدًا تلو الآخر باستخدام Upload File API من المتصفح
  • قم بالتحميل برمجيًا باستخدام مثال الرمز الموضح أدناه:
// تحميل الملفات باستخدام C#
using System;
using System.IO;
using GroupDocs.Merger.Cloud.Sdk.Api;
using GroupDocs.Merger.Cloud.Sdk.Client;
using GroupDocs.Merger.Cloud.Sdk.Model;
using GroupDocs.Merger.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Merger.CSharp
{
  class Upload_PDF_Files

  {
    static void Main(string[] args)
    {
      
      try
      {
        // إنشاء مثيلات API الضرورية
        var storageApi = new StorageApi(configuration);
        var fileApi = new FileApi(configuration);

        var path = @"H:\groupdocs-cloud-data";

        var files = Directory.GetFiles(path, "*.pdf", SearchOption.AllDirectories);
        foreach (var file in files)
        {
          var relativeFilePath = file.Replace(path, string.Empty).Trim(Path.DirectorySeparatorChar);

          var response = storageApi.ObjectExists(new ObjectExistsRequest(relativeFilePath, myStorage));
          if (response.Exists != null && !response.Exists.Value)
          {
            var fileStream = File.Open(file, FileMode.Open);

            fileApi.UploadFile(new UploadFileRequest(relativeFilePath, fileStream, myStorage));
            fileStream.Close();
          }
        }

        Console.WriteLine("File Uploaded to Cloud Storage.");
      }
      catch (Exception e)
      {
        Console.WriteLine("Exception when calling GroupDocs API: " + e.Message);
      }

    }
  }
}

نتيجة لذلك ، سيكون ملف PDF الذي تم تحميله متاحًا في قسم الملفات من لوحة التحكم على السحابة.

دمج مستندات PDF في C#

فيما يلي الخطوات ومثال مقتطف الشفرة الذي يوضح كيفية دمج مستندات PDF متعددة في ملف واحد برمجيًا في C#.

  • أولاً ، قم بإنشاء مثيل للفئة DocumentApi.
  • ثانيًا ، قم بإنشاء مثيل لفئة JoinItem.
  • ثالثًا ، قم بتعيين مسار ملف الإدخال لأول JoinItem في FileInfo.
  • ثم قم بإنشاء مثيل جديد من JoinItem لملف الإدخال الثاني.
  • الآن ، قم بتوفير مسار ملف الإدخال لـ JoinItem الثاني في FileInfo.
  • يمكنك إضافة المزيد من JoinItems لدمج المزيد من ملفات PDF.
  • بعد ذلك ، قم بإنشاء مثيل لفئة JoinOptions.
  • أضف قائمة مفصولة بفواصل لعناصر الانضمام التي تم إنشاؤها.
  • أيضًا ، قم بتعيين مسار ملف الإخراج على السحابة.
  • الآن ، قم بإنشاء مثيل لـ JoinRequest وقم بتمرير المعلمة JoinOptions.
  • أخيرًا ، احصل على النتائج عن طريق استدعاء طريقة Join() الخاصة بـ DocumentApi وتمرير المعلمة JoinRequest.

يوضح مقتطف الشفرة التالي كيفية دمج ملفات PDF متعددة في ملف واحد في C# باستخدام REST API:

// كيفية دمج ملفات PDF متعددة في ملف واحد في C# باستخدام REST API
using System;
using GroupDocs.Merger.Cloud.Sdk.Api;
using GroupDocs.Merger.Cloud.Sdk.Client;
using GroupDocs.Merger.Cloud.Sdk.Model;
using GroupDocs.Merger.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Merger.CSharp
{
  // كيفية دمج ملفات PDF في ملف واحد باستخدام C#
  class Merge_PDF_Files

  {
    static void Main(string[] args)
    {

      try
      {
        // إنشاء مثيلات API الضرورية
        var documentApi = new DocumentApi(configuration);
        var item1 = new JoinItem
        {
          FileInfo = new GroupDocs.Merger.Cloud.Sdk.Model.FileInfo
          {
            FilePath = "csharp-testing/sample-file-one.pdf"
          }
        };

        var item2 = new JoinItem
        {
          FileInfo = new GroupDocs.Merger.Cloud.Sdk.Model.FileInfo
          {
            FilePath = "csharp-testing/sample-file-two.pdf"
          }
        };

        var options = new JoinOptions
        {
          JoinItems = new List<JoinItem> { item1, item2 },
          OutputPath = "csharp-testing/merged-file.pdf"
        };

        var request = new JoinRequest(options);
        var response = documentApi.Join(request);
        Console.WriteLine("Successfully merged PDF files in C#: " + response.Path);
      }
      catch (Exception e)
      {
        Console.WriteLine("Exception when calling GroupDocs Api: " + e.Message);
      }

    }
  }
}

باستخدام بضعة أسطر من التعليمات البرمجية ، يمكنك الآن دمج ملفات PDF بسهولة باستخدام GroupDocs.Merger Cloud SDK لـ .Net.

تنزيل الملف

سيحفظ مثال الكود أعلاه ملف PDF المدمج على السحابة. يمكنك تنزيله باستخدام مقتطف الشفرة التالي:

// قم بتنزيل الملف الناتج من السحابة
using System;
using GroupDocs.Conversion.Cloud.Sdk.Api;
using GroupDocs.Conversion.Cloud.Sdk.Client;
using GroupDocs.Conversion.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Merger.CSharp
{
  // تنزيل ملف الإخراج
  class Download_File
  {
    static void Main(string[] args)
    {
      try
      {
        // تهيئة api
        var fileApi = new FileApi(configuration);
        // طلب إنشاء ملف تنزيل
        var downloadRequest = new DownloadFileRequest("csharp-testing/merged-file.pdf", myStorage);
        // تحميل الملف
        Stream downloadResponse = fileApi.DownloadFile(downloadRequest);

        // حفظ الملف في دليل العمل
        using (var fileStream = System.IO.File.Create("H:\\groupdocs-cloud-data\\merged-file.pdf"))
        {
          downloadResponse.Seek(0, SeekOrigin.Begin);
          downloadResponse.CopyTo(fileStream);
        }
        Console.WriteLine("File downloaded successfully.");
      }
      catch (Exception e)
      {
        Console.WriteLine("Exception when calling GroupDocs FileApi: " + e.Message);
      }

    }
  }
}

دمج صفحات معينة من ملفات PDF في C# باستخدام واجهة برمجة تطبيقات REST

تقدم GroupDocs.Merger Cloud SDK خيارات متقدمة متنوعة لتخصيص عملية دمج PDF وفقًا لمتطلباتك. يمكنك بسهولة دمج صفحات معينة من ملفات PDF متعددة في ملف واحد برمجيًا باتباع الخطوات التالية:

  • أولاً ، قم بإنشاء مثيل للفئة DocumentApi.
  • ثانيًا ، قم بإنشاء مثيل لفئة JoinItem.
  • ثالثًا ، قم بتعيين مسار ملف الإدخال لأول JoinItem في FileInfo.
  • بعد ذلك ، قدم قائمة الصفحات المفصولة بفواصل للانضمام.
  • ثم قم بإنشاء مثيل جديد من JoinItem لملف الإدخال الثاني.
  • الآن ، قم بتوفير مسار ملف الإدخال لـ JoinItem الثاني في FileInfo.
  • قم بتعيين قيم StartPageNumber و EndPageNumber و RangeMode.
  • يمكنك إضافة المزيد من JoinItems لدمج المزيد من ملفات PDF.
  • بعد ذلك ، قم بإنشاء مثيل لفئة JoinOptions.
  • أضف قائمة مفصولة بفواصل لعناصر الانضمام التي تم إنشاؤها.
  • أيضًا ، قم بتعيين مسار ملف الإخراج على السحابة.
  • الآن ، قم بإنشاء مثيل لـ JoinRequest وقم بتمرير المعلمة JoinOptions.
  • أخيرًا ، احصل على النتائج عن طريق استدعاء طريقة Join() الخاصة بـ DocumentApi وتمرير المعلمة JoinRequest.

يوضح مقتطف الشفرة التالي كيفية دمج صفحات معينة من ملفين PDF في C# .NET باستخدام REST API:

// كيفية دمج صفحات معينة من ملفات PDF متعددة في C#
using System;
using GroupDocs.Merger.Cloud.Sdk.Api;
using GroupDocs.Merger.Cloud.Sdk.Client;
using GroupDocs.Merger.Cloud.Sdk.Model;
using GroupDocs.Merger.Cloud.Sdk.Model.Requests;

namespace GroupDocs.Merger.CSharp
{
  // ادمج ملفات PDF في ملف واحد في C#
  class Merge_PDF_Files
  {
    static void Main(string[] args)
    { 

      try
      {
        
        // إنشاء مثيلات API الضرورية
        var documentApi = new DocumentApi(configuration);
        var item1 = new JoinItem
        {
          FileInfo = new GroupDocs.Merger.Cloud.Sdk.Model.FileInfo
          {
            FilePath = "csharp-testing/sample-file-one.pdf"
          },
          Pages = new List<int?> { 1, 4, 7 }
        };

        var item2 = new JoinItem
        {
          FileInfo = new GroupDocs.Merger.Cloud.Sdk.Model.FileInfo
          {
            FilePath = "csharp-testing/sample-file-two.pdf"
          },
          StartPageNumber = 1,
          EndPageNumber = 5,
          RangeMode = JoinItem.RangeModeEnum.OddPages
        };

        var options = new JoinOptions
        {
          JoinItems = new List<JoinItem> { item1, item2 },
          OutputPath = "csharp-testing/merged-file.pdf"
        };

        var request = new JoinRequest(options);
        var response = documentApi.Join(request);
        Console.WriteLine("Successfully combined two PDF files into one in CSharp: " + response.Path);
      }
      catch (Exception e)
      {
        Console.WriteLine("Exception when calling GroupDocs Api: " + e.Message);
      }

    }
  }
}

برنامج دمج PDF مجاني عبر الإنترنت

كيفية دمج ملفات PDF في ملف واحد عبر الإنترنت مجانًا؟ يرجى تجربة التطبيق التالي برنامج دمج PDF عبر الإنترنت لدمج ملفات PDF متعددة في ملف واحد من أي جهاز.

تلخيص لما سبق

في الختام ، توفر GroupDocs.Merger Cloud SDK لـ .Net حلاً موثوقًا وفعالًا لدمج ملفات PDF في تطبيقات C#. لقد علمتنا مشاركة المدونة هذه:

  • كيفية دمج ملفات PDF متعددة في ملف واحد في C# .NET على السحابة ؛
  • تحميل وتنزيل ملف PDF برمجيًا من السحابة ؛
  • كيفية دمج صفحات معينة من ملفات PDF متعددة في ملف واحد في C# ؛
  • وأداة دمج ملفات PDF مجانية عبر الإنترنت.

بالإضافة إلى ذلك ، يمكنك معرفة المزيد حول GroupDocs.Merge Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. كود المصدر الكامل لـ GroupDocs.Merger Cloud SDK لـ .Net متاح مجانًا على GitHub.

أخيرًا ، نواصل كتابة مقالات مدونة جديدة حول تنسيقات ملفات مختلفة وتحليلها باستخدام REST API. لذا ، يرجى التواصل معنا للحصول على آخر التحديثات.

طرح سؤال

في حال كان لديك أي استفسارات حول PDF Merger API ، فلا تتردد في الاتصال بنا عبر المنتدى.

أسئلة وأجوبة

هل من الممكن دمج صفحات معينة من ملفات PDF مختلفة باستخدام C#؟

نعم ، باستخدام GroupDocs.Merger Cloud SDK for .NET ، يمكنك تحديد نطاقات الصفحات لدمج صفحات معينة من ملفات PDF مختلفة. يمنحك هذا المرونة لاستخراج ودمج المعلومات ذات الصلة حسب الحاجة.

كيف يمكنني تثبيت مكتبة دمج PDF عبر الإنترنت؟

يمكنك الحصول على GroupDocs.Merger Cloud SDK لـ .Net من [موقع GroupDocs] الرسمي 25. اتبع إرشادات التثبيت المتوفرة لإعداد SDK في تطبيق C# الخاص بك.

كيفية دمج ملفات PDF متعددة عبر الإنترنت مجانًا؟

يرجى زيارة أداة دمج PDF عبر الإنترنت لدمج ودمج ملفين أو أكثر من ملفات PDF مجانًا ، في ثوانٍ.

أنظر أيضا

إذا كنت ترغب في معرفة المزيد حول الموضوعات ذات الصلة ، نوصي بقراءة المقالات المدرجة أدناه: