PDF‑ის თავსართის პერსონალიზაცია, რომელიც შეიცავს ტექსტსა და გრაფიკას, საერთო მოთხოვნაა ღრუბლოვანი ანგარიშგების გადაწყვეტებში. Aspose.PDF Cloud SDK for .NET საშუალებას გაძლევთ პროგრამულად დაამატოთ ტექსტი და სურათი PDF‑ის თავსართში C#‑ში მარტივი API‑ის გამოძახებებით. ამ გაკვეთილში ნახავთ სრულ კოდის მაგალითს, cURL ალტერნატივას და ნაბიჯ‑ნაბიჯ განმარტებებს. საბოლოოდ, შეძლებთ ბრენდირებული თავსართის ჩასმა PDF‑ის ყველა გვერდზე ღრუბლოვან გარემოში.

PDF-ის ჰედერში ტექსტის და სურათის დამატება C#-ში - სრული კოდის მაგალითი

შემდეგი მაგალითი აჩვენებს, თუ როგორ დავამატოთ ტექსტი და სურათი PDF‑ის ჰედერში C#‑ით, Aspose.PDF Cloud SDK for .NET-ის გამოყენებით.

using System;
using System.Collections.Generic;
using System.IO;
using Aspose.Pdf.Cloud.Sdk.Api;
using Aspose.Pdf.Cloud.Sdk.Client;
using Aspose.Pdf.Cloud.Sdk.Model;

class Program
{
    static void Main()
    {
        // -------------------------------------------------
        // Configuration – replace with your actual App SID and API Key
        // -------------------------------------------------
        var config = new Configuration
        {
            ApiKey = new Dictionary<string, string> { { "api_key", "YOUR_API_KEY" } },
            Host = "https://api.aspose.cloud"
        };
        var pdfApi = new PdfApi(config);

// -------------------------------------------------
        // File names (local)
        // -------------------------------------------------
        string localPdfPath = "input.pdf";
        string localImagePath = "headerImage.png";
        string outputPdfPath = "output.pdf";

// -------------------------------------------------
        // Upload PDF to Aspose Cloud storage
        // -------------------------------------------------
        using (var pdfStream = File.OpenRead(localPdfPath))
        {
            pdfApi.UploadFile(Path.GetFileName(localPdfPath), pdfStream);
        }

// -------------------------------------------------
        // Upload image to Aspose Cloud storage
        // -------------------------------------------------
        using (var imgStream = File.OpenRead(localImagePath))
        {
            pdfApi.UploadFile(Path.GetFileName(localImagePath), imgStream);
        }

// -------------------------------------------------
        // Build HeaderFooter object with text and image
        // -------------------------------------------------
        var headerFooter = new HeaderFooter
        {
            // Text part
            TextState = new TextState
            {
                Value = "Confidential Document",
                FontSize = 14,
                Font = "Helvetica",
                FontStyle = FontStyles.Bold,
                ForegroundColor = new Color { A = 255, R = 255, G = 0, B = 0 } // Red color
            },
            // Image part
            Image = new Image
            {
                File = Path.GetFileName(localImagePath), // reference uploaded image
                Width = 100,
                Height = 30,
                HorizontalAlignment = HorizontalAlignment.Center,
                Margin = new MarginInfo { Top = 5, Bottom = 5, Left = 5, Right = 5 }
            },
            // Header margin (optional)
            Margin = new MarginInfo { Top = 10, Bottom = 0, Left = 0, Right = 0 }
        };

// -------------------------------------------------
        // Apply header to all pages of the PDF
        // -------------------------------------------------
        pdfApi.PutHeaderFooter(Path.GetFileName(localPdfPath), headerFooter);

// -------------------------------------------------
        // Download the updated PDF
        // -------------------------------------------------
        using (var resultStream = pdfApi.GetDocument(Path.GetFileName(localPdfPath)))
        using (var fileStream = File.Create(outputPdfPath))
        {
            resultStream.CopyTo(fileStream);
        }

// -------------------------------------------------
        // Optional: clean up uploaded files from cloud storage
        // -------------------------------------------------
        pdfApi.DeleteFile(Path.GetFileName(localPdfPath));
        pdfApi.DeleteFile(Path.GetFileName(localImagePath));
    }
}

შენიშვნა: ეს კოდის მაგალითი აჩვენებს ძირითადი ფუნქციონირებას. თქვენს პროექტში მისი გამოყენებამდე, დარწმუნდით, რომ განაახლეთ ყველა ფაილის ბილიკი და კონფიგურაციის მნიშვნელობები, რომ შეესაბამებოდეს თქვენს რეალურ გარემოს, გადამოწმეთ, რომ ყველა საჭირო დამოკიდებულება სწორად დაინსტალირებულია, და სრულად ტესტირეთ თქვენი განვითარების გარემოში. თუ რაიმე პრობლემის გაგება გაქვთ, გთხოვთ მიმართოთ ოფიციალურ დოკუმენტაციას ან დაუკავშირდეთ მხარდაჭერის გუნდს დახმარებისთვის.

ტექსტის და სურათის ჩასმა PDF‑ის ჰედერში ღრუბლობით cURL‑ით

თქვენ შეგიძლიათ იგივე ოპერაცია შესრულება REST API-ის გამოყენებით. ქვემოთ მოცემულია აუცილებელი cURL ბრძანებები.

# 1. Obtain an access token (replace YOUR_CLIENT_ID and YOUR_CLIENT_SECRET)
curl -X POST "https://api.aspose.cloud/connect/token" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"

# 2. Upload the source PDF
curl -X PUT "https://api.aspose.cloud/v3.0/pdf/storage/file/input.pdf" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/pdf" \
  --data-binary "@input.pdf"

# 3. Upload the header image (PNG)
curl -X PUT "https://api.aspose.cloud/v3.0/pdf/storage/file/headerImage.png" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: image/png" \
  --data-binary "@headerImage.png"

# 4. Apply header with text and image
curl -X PUT "https://api.aspose.cloud/v3.0/pdf/input.pdf/headerfooter" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "TextState": {
            "Value": "Confidential Document",
            "FontSize": 14,
            "Font": "Helvetica",
            "FontStyle": "Bold",
            "ForegroundColor": { "A":255,"R":255,"G":0,"B":0 }
        },
        "Image": {
            "File": "headerImage.png",
            "Width": 100,
            "Height": 30,
            "HorizontalAlignment": "Center",
            "Margin": { "Top":5,"Bottom":5,"Left":5,"Right":5 }
        },
        "Margin": { "Top":10,"Bottom":0,"Left":0,"Right":0 }
      }'

# 5. Download the updated PDF
curl -X GET "https://api.aspose.cloud/v3.0/pdf/input.pdf" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.pdf


თითოეული endpoint-ის შესახებ მეტი დეტალისთვის იხილეთ [ოფიციალური API დოკუმენტაცია](https://reference.aspose.cloud/pdf/).

## PDF‑ის ჰედერის ტექსტის და სურათის დამატება C#-ში

გაგონება, თუ როგორ აერთიანებს კოდი ტექსტსა და სურათს PDF‑ის ჰედერში C#-ში, დაგეხმარებათ მასის სხვა სცენარებში ადაპტაციაში. აქ არის მოკლე მიმოხილვა:

1. **კონფიგურაციის დაყენება** – `Configuration` ობიექტი ინახავს თქვენი API გასაღებსა და ჰოსტის URL-ს.  
   <!--CODE_SNIPPET_START-->
   ```csharp
   var [config](https://docs.fileformat.com/programming/config/) = new Configuration
   {
       ApiKey = new Dictionary<string, string> { { "api_key", "YOUR_API_KEY" } },
       Host = "https://api.aspose.cloud"
   };

  1. ფაილების ატვირთვა – UploadFile აგზავნის ლოკალურ PDF-ს და სურათს Aspose Cloud-ის შენახვის ადგილას.

    pdfApi.UploadFile(Path.GetFileName(localPdfPath), pdfStream);
pdfApi.UploadFile(Path.GetFileName(localImagePath), imgStream);

  2. HeaderFooter-ის შექმნა – HeaderFooter მოდელი აერთიანებს TextState‑ს ტექსტისთვის და Image ობიექტს სურათისთვის.

    var headerFooter = new HeaderFooter
{
    TextState = new TextState { Value = "Confidential Document", FontSize = 14, Font = "Helvetica", FontStyle = FontStyles.Bold, ForegroundColor = new Color { A = 255, R = 255, G = 0, B = 0 } },
    Image = new Image { File = Path.GetFileName(localImagePath), Width = 100, Height = 30, HorizontalAlignment = HorizontalAlignment.Center }
};

  3. ჰედერის გადატარება – PutHeaderFooter აერთიანებს ჰედერს მითითებული PDF-ის ყველა გვერდზე.

    pdfApi.PutHeaderFooter(Path.GetFileName(localPdfPath), headerFooter);

  4. გადმოწერა და გასუფთავება – GetDocument იღებს მოდიფიცირებულ PDF-ს, ხოლო DeleteFile ამოღებს დროებით ფაილებს ღრუბლოვან შენახვიდან.

    var resultStream = pdfApi.GetDocument(Path.GetFileName(localPdfPath));
pdfApi.DeleteFile(Path.GetFileName(localPdfPath));
pdfApi.DeleteFile(Path.GetFileName(localImagePath));

HeaderFooter კლასის უფრო ღრმა შესწავლისთვის მიმართეთ API დოკუმენტაციას.

Aspose.PDF Cloud SDK-ის დაყენება და კონფიგურაცია .NET-ისთვის

  1. დაამატეთ NuGet პაკეტი
   dotnet add package Aspose.PDF-Cloud

  1. SDK-ის ბინარების გადმოწერა – შეგიძლიათ მიიღოთ უახლესი ვერსია ოფიციალურ გადმოწერის გვერდზე: Aspose.PDF Cloud SDK for .NET Download.

  2. მოთხოვნები – .NET 6.0 ან უფრო ახალი, Aspose Cloud ანგარიში, და სწორი კლიენტის ავტორიზაციის დეტალები (App SID და API Key).

  3. კლიენტის ინიციალიზაცია – გამოიყენეთ იგივე კონფიგურაციის კოდი, რომელიც წარმოდგენილია სრულ მაგალითში, ღრუბლოვანი სერვისის დაკავშირებისთვის.

SDK-ის დაყენებით და ავტორიზაციის დეტალებით, შეგიძლიათ დაუყოვნებლივ დაიწყოთ ტექსტის და სურათის დამატება PDF‑ის ჰედერში C#‑ში.

დასკვნა

ტექსტის და სურათის დამატება PDF‑ის ჰედერში C#‑ში ხდება მარტივად, როდესაც იყენებთ Aspose.PDF Cloud SDK for .NET‑ის შესაძლებლობებს. ბიბლიოთეკა ავტომატურად მართავს ფაილების ატვირთვას, ჰედერის კონსტრუქციას და დოკუმენტის მიღებას რამდენიმე API‑ის გამოძახებით, რაც მას იდეალურ არჩევანს ღრუბლოვანი PDF‑ის დამუშავების პაიპლაინებისთვის. არ დაგავიწყდეთ API გასაღების უსაფრთხოების დაცვა, გამოყენების ლიმიტების პატივისცემა და ჰედერის განლაგების ტესტირება სხვადასხვა გვერდის ზომებზე, რათა თავიდან აიცილოთ გადავსება. წარმოებაში განთავსებისთვის საჭიროა კომერციული ლიცენზია; ფასების დეტალები ხელმისაწვდომია პროდუქტის გვერდზე, ხოლო დროებით ლიცენზია შეგიძლიათ მიიღოთ დროებით ლიცენზიის გვერდიდან. დაიწყეთ ბრენდირებული ჰედერების ინტეგრაცია დღესვე და გაუწით თქვენს PDF‑ებს პროფესიონალური სახე.

ხშირად დასმული კითხვები

  • როგორ დავამატო ტექსტი და სურათი PDF‑ის ჰედერში C#‑ით ღრუბლოვან ბიბლიოთეკის გამოყენებით?
    გამოიყენეთ HeaderFooter მოდელი TextState‑ის და Image‑ის განსაზღვრისთვის, შემდეგ კი გამოიძახეთ PutHeaderFooter. სტატიის სრულ კოდურ მაგალითში ნაჩვენებია ყველა ნაბიჯი.

  • შეიძლება ჰედერის ტექსტი და სურათი დაამატოთ ღრუბლოვანად C#‑ის კოდის გარეშე?
    დიახ, იგივე ოპერაცია შეიძლება შესრულდეს REST‑გამოძახებით. cURL‑ის განყოფილება შეიცავს მზად-გამოსაყენებელ სკრიპტს, რომელიც ატვირთავს ფაილებს და გადატარებს ჰედერს.

  • რომელი სურათის ფორმატებია მხარდაჭერილი ჰედერისთვის?
    API‑ს აქვს მხარდაჭერა საერთო ფორმატებზე, როგორიცაა PNG და JPEG. სურათის ზომა უნდა იყოს განზრახული (მაგ. 100 x 30), რათა ჩასმული იყოს ჰედერის საზღვრებში.

  • გჭირდებათ ლიცენზია პროდუქციის გამოყენებისთვის წარმოებაში?
    კომერციული ლიცენზია აუცილებელია წარმოებაში. იხილეთ პროდუქტის გვერდზე ფასები და გამოიყენეთ დროებით ლიცენზიის გვერდი SDK‑ის შეფასებისთვის შესყიდვამდე.

მეტი კითხვა