نحوه ادغام چندین فایل PDF به یک در C#.Net

نحوه ادغام فایل های PDF در سی شارپ با استفاده از REST API.

PDF(قالب سند قابل حمل) به طور گسترده برای به اشتراک گذاری اسناد و در عین حال حفظ قالب بندی و طرح بندی آنها استفاده می شود. در سناریوهای خاصی، ممکن است لازم باشد چندین فایل PDF را در یک سند واحد ترکیب کنید تا اطلاعات را ساده کنید یا دسترسی را بهبود ببخشید. GroupDocs.Merger Cloud SDK for .Net یک راه قدرتمند و شهودی برای ادغام فایل‌های PDF به صورت برنامه‌نویسی ارائه می‌کند و در زمان و تلاش شما صرفه‌جویی می‌کند. در این مقاله، نحوه ادغام و ترکیب فایل‌های PDF در سی شارپ با استفاده از REST API را بررسی خواهیم کرد.

موضوعات زیر در این مقاله پوشش داده خواهد شد:

C# REST API برای ادغام فایل‌های PDF و C# SDK Installation

GroupDocs.Merger Cloud SDK for .NET یک راه حل قدرتمند و قابل اعتماد است که به توسعه دهندگان اجازه می دهد قابلیت های ادغام PDF را در برنامه های C# خود بگنجانند. مجموعه ای جامع از ویژگی ها و عملکردها را برای ادغام و ترکیب فایل های PDF به صورت یکپارچه ارائه می دهد. با استفاده از SDK، می‌توانید چندین [قالب‌های سند پشتیبانی شده6 را در یک سند ادغام کنید و قالب، طرح‌بندی و محتوای اصلی آنها را حفظ کنید. SDK را می توان در یک برنامه مبتنی بر C# ادغام کرد تا فرآیند توسعه شما را ساده کند.

می‌توانید GroupDocs.Merger Cloud SDK برای دات‌نت را از NuGet Package manager یا با استفاده از دستور زیر در NET CLI روی پروژه خود نصب کنید:

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

سپس، قبل از اینکه مراحل و نمونه کدهای موجود را دنبال کنید، شناسه مشتری و راز مشتری را از داشبورد جمع آوری کنید. شناسه مشتری و Client Secret را در کدی که در زیر نشان داده شده است اضافه کنید:

//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 در یک در سی شارپ با استفاده از REST API

اکنون که محیط توسعه خود را راه اندازی کرده ایم و SDK را نصب کرده ایم، بیایید به ادغام فایل های PDF ادامه دهیم. این مراحل را دنبال کنید:

آپلود فایل‌ها

ابتدا سند PDF را با استفاده از یکی از روش های زیر در فضای ذخیره سازی ابری آپلود کنید:

  • با استفاده از dashboard
  • همه فایل ها را یکی یکی با استفاده از Upload File API از مرورگر آپلود کنید
  • با استفاده از نمونه کد زیر به صورت برنامه نویسی آپلود کنید:
// آپلود فایل ها با استفاده از سی شارپ
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 را در یک فایل به صورت برنامه‌نویسی در سی شارپ نشان می‌دهد.

  • ابتدا یک نمونه از کلاس DocumentApi ایجاد کنید.
  • در مرحله دوم، یک نمونه از کلاس JoinItem ایجاد کنید.
  • سوم، مسیر فایل ورودی را برای اولین JoinItem در FileInfo تنظیم کنید.
  • سپس، یک نمونه جدید از JoinItem برای فایل ورودی دوم ایجاد کنید.
  • اکنون مسیر فایل ورودی را برای JoinItem دوم در FileInfo ارائه دهید.
  • می‌توانید JoinItems بیشتری برای ادغام فایل‌های PDF بیشتر اضافه کنید.
  • سپس یک نمونه از کلاس JoinOptions ایجاد کنید.
  • فهرستی از موارد پیوسته ایجاد شده با کاما را اضافه کنید.
  • همچنین مسیر فایل خروجی را در فضای ابری تنظیم کنید.
  • اکنون یک نمونه از JoinRequest ایجاد کنید و پارامتر JoinOptions را پاس کنید.
  • در نهایت، با فراخوانی متد join() از DocumentApi و ارسال پارامتر JoinRequest به نتیجه برسید.

قطعه کد زیر نحوه ادغام چندین فایل PDF را در یک شارپ با استفاده از REST API نشان می دهد:

// نحوه ادغام چندین فایل PDF به یک در سی شارپ با استفاده از 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 در یک با استفاده از سی شارپ
  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 ادغام شده را در فضای ابری ذخیره می کند. می توانید آن را با استفاده از قطعه کد زیر دانلود کنید:

// فایل Resultant را از Cloud دانلود کنید
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 در سی شارپ با استفاده از REST API

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 در سی شارپ
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
{
  // ترکیب فایل های پی دی اف به یکی در سی شارپ
  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 Merger را برای ترکیب چندین فایل PDF در یک فایل واحد از هر دستگاهی امتحان کنید.

جمع بندی

در نتیجه، GroupDocs.Merger Cloud SDK for .Net راه حلی قابل اعتماد و کارآمد برای ادغام فایل های PDF در برنامه های C# ارائه می دهد. این پست وبلاگ به ما یاد داده است:

  • چگونه چندین فایل PDF را در یک C#.NET در فضای ابری ترکیب کنیم.
  • به صورت برنامه نویسی فایل PDF را از ابر بارگذاری و دانلود کنید.
  • چگونه صفحات خاصی از چندین فایل PDF را در یک فایل واحد در سی شارپ ترکیب کنیم.
  • و ابزار ادغام فایل های PDF آنلاین رایگان.

علاوه بر این، می‌توانید با استفاده از مستندات درباره GroupDocs.Merge Cloud API اطلاعات بیشتری کسب کنید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آن‌ها تعامل داشته باشید. کد منبع کامل GroupDocs.Merger Cloud SDK برای Net به صورت رایگان در GitHub در دسترس است.

در نهایت، ما به نوشتن مقالات وبلاگ جدید در قالب‌های فایل مختلف و تجزیه آنها با استفاده از REST API ادامه می‌دهیم. بنابراین، لطفا برای آخرین به روز رسانی تماس بگیرید.

یه سوال بپرس

در صورتی که در مورد API ادغام PDF سؤالی دارید، لطفاً از طریق [فروم 23 ما با ما تماس بگیرید.

سوالات متداول

آیا می توان صفحات خاصی را از فایل های PDF مختلف با استفاده از سی شارپ ادغام کرد؟

بله، با استفاده از GroupDocs.Merger Cloud SDK for .NET، می توانید محدوده صفحه را برای ادغام صفحات خاص از فایل های PDF مختلف مشخص کنید. این به شما انعطاف پذیری می دهد تا اطلاعات مربوطه را در صورت نیاز استخراج و ترکیب کنید.

چگونه می توانم یک کتابخانه ادغام PDF آنلاین نصب کنم؟

می‌توانید GroupDocs.Merger Cloud SDK برای Net را از وب‌سایت GroupDocs رسمی دریافت کنید. دستورالعمل های نصب ارائه شده را برای راه اندازی SDK در برنامه C# خود دنبال کنید.

چگونه چندین فایل PDF را بصورت آنلاین به صورت رایگان ادغام کنیم؟

لطفاً برای ادغام و ترکیب دو یا چند فایل PDF به صورت رایگان، در عرض چند ثانیه، از [آنلاین ابزار ادغام PDF27 بازدید کنید.

همچنین ببینید

اگر می خواهید درباره موضوعات مرتبط بیشتر بدانید، توصیه می کنیم مقالات فهرست شده در زیر را مطالعه کنید: