התאמת כותרות 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
לפרטים נוספים על כל נקודת קצה, ראו את [תיעוד ה‑API הרשמי](https://reference.aspose.cloud/pdf/).
## פירוק הוספת טקסט לכותרת PDF ב‑C#
הבנת האופן שבו הקוד מוסיף טקסט ותמונה לכותרת PDF ב‑C# מסייעת להתאמה לתרחישים אחרים. הנה מדריך תמציתי:
1. **הגדרת תצורה** – אובייקט `Configuration` מאחסן את מפתח ה‑API וכתובת ה‑host.
<!--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"
};
-
העלאת קבצים –
UploadFileשולח את קובץ ה‑PDF המקומי ואת התמונה לאחסון Aspose Cloud.pdfApi.UploadFile(Path.GetFileName(localPdfPath), pdfStream); pdfApi.UploadFile(Path.GetFileName(localImagePath), imgStream); -
יצירת 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 } }; -
החלת הכותרת –
PutHeaderFooterמצרף את הכותרת לכל דף של קובץ ה‑PDF שצוין.pdfApi.PutHeaderFooter(Path.GetFileName(localPdfPath), headerFooter); -
הורדה וניקוי –
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
- הוספת חבילת NuGet
dotnet add package Aspose.PDF-Cloud
-
הורדת קבצי ה‑SDK – ניתן גם לקבל את הגרסה העדכנית מהדף הרשמי: Aspose.PDF Cloud SDK for .NET Download.
-
דרישות מוקדמות – .NET 6.0 ומעלה, חשבון Aspose Cloud, ופרטי אימות תקינים (App SID ומפתח API).
-
אתחול הלקוח – השתמשו בקוד התצורה המוצג בדוגמה המלאה כדי להתחבר לשירות הענן.
לאחר התקנת ה‑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 × 30) כדי שיתאימו למרווח הכותרת. -
האם נדרש רישיון להפעלת זה בייצור?
רישיון מסחרי נדרש לשימוש בייצור. בקרו בעמוד המוצר לקבלת פרטי תמחור והשתמשו ב-דף הרישיון הזמני כדי להעריך את ה‑SDK לפני הרכישה.