การปรับแต่งส่วนหัวของ 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** – วัตถุ `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. ตัวอย่างโค้ดเต็มในบทความนี้แสดงขั้นตอนที่ชัดเจน.

  • ฉันสามารถแทรกข้อความและรูปภาพลงในส่วนหัวของ PDF บนคลาวด์โดยไม่ต้องเขียนโค้ด C# ได้หรือไม่?
    ได้, การดำเนินการเดียวกันสามารถทำได้ด้วยการเรียก REST. ส่วน cURL มีสคริปต์พร้อมใช้ที่อัปโหลดไฟล์และนำส่วนหัวไปใช้.

  • รูปแบบภาพใดบ้างที่รองรับสำหรับส่วนหัว?
    API รองรับรูปแบบทั่วไปเช่น PNG และ JPEG. ควรรักษาขนาดภาพให้เหมาะสม (เช่น 100 x 30) เพื่อให้พอดีกับขอบส่วนหัว.

  • ฉันต้องมีใบอนุญาตเพื่อใช้งานในสภาพแวดล้อมการผลิตหรือไม่?
    จำเป็นต้องมีใบอนุญาตเชิงพาณิชย์สำหรับการใช้งานในผลิตภัณฑ์. เยี่ยมชมหน้าผลิตภัณฑ์เพื่อดูราคาและใช้ หน้าใบอนุญาตชั่วคราว เพื่อประเมิน SDK ก่อนซื้อ.

อ่านเพิ่มเติม