A quick view of MS Word document transformation.
Μια κεφαλίδα είναι το επάνω περιθώριο κάθε σελίδας και ένα υποσέλιδο είναι το κάτω περιθώριο κάθε σελίδας. Οι κεφαλίδες και τα υποσέλιδα είναι χρήσιμα για τη συμπερίληψη πληροφοριών που θέλετε να εμφανίζονται σε κάθε σελίδα ενός εγγράφου, όπως το όνομά σας, οι ημερομηνίες, ο τίτλος του εγγράφου, οι αριθμοί σελίδων ή οι δηλώσεις αποποίησης ευθυνών σε έγγραφα. Όταν χρησιμοποιείτε το MS Word, παρέχει τις δυνατότητες προσθήκης κεφαλίδων και υποσέλιδων με βάση προκαθορισμένες διατάξεις ή σας δίνει τη δυνατότητα να προσθέτετε προσαρμοσμένες κεφαλίδες και υποσέλιδα. Οι περισσότερες ενσωματωμένες κεφαλίδες περιέχουν κάποιο κείμενο κράτησης θέσης και είτε, μπορείτε να διατηρήσετε το κείμενο κράτησης θέσης ή να το αντικαταστήσετε με τη δική σας ροή δεδομένων. Επίσης, κατά την ενημέρωση των πληροφοριών στην ενότητα Κεφαλίδα ή Υποσέλιδο, το περιεχόμενο μέσα στο κύριο σώμα του εγγράφου είναι γκριζαρισμένο, γεγονός που υποδεικνύει ότι αυτά τα αντικείμενα είναι πλήρως απομονωμένα από το υπόλοιπο περιεχόμενο της σελίδας και η λειτουργία που εκτελείτε σε αυτά τα αντικείμενα είναι συγκεκριμένη για αυτές τις περιοχές. Σε αυτό το άρθρο, θα μάθουμε τα βήματα για τον τρόπο προσθήκης ή ενημέρωσης του υποσέλιδου κεφαλίδας στο Έγγραφο του Word χρησιμοποιώντας το REST API.
API επεξεργασίας κειμένου
Το Aspose.Words Cloud API παρέχει τις δυνατότητες φόρτωσης αρχείων MS Word από τον χώρο αποθήκευσης Cloud, καθώς και επιτρέπει στον χρήστη να περάσει το αρχείο εισόδου απευθείας στο σώμα αιτήματος και το API επιστρέφει το ενημερωμένο αρχείο στο αντικείμενο απόκρισης. Παρέχει τις δυνατότητες ανάγνωσης, προσθήκης, ενημέρωσης ή διαγραφής συγκεκριμένων ή όλων των αντικειμένων κεφαλίδας και υποσέλιδου. Επιπλέον, μπορείτε επίσης να καθορίσετε την απόδοση διαφορετικών κεφαλίδων/υποδοσίων για την πρώτη σελίδα και για μονές/ζυγές σελίδες.
Επιπλέον, το API σάς δίνει επίσης τη δυνατότητα να ορίσετε πληροφορίες μορφοποίησης, όπως ιδιότητες γραμματοσειράς και παραγράφου για το κείμενο κεφαλίδας/υποσέλιδου. Έχετε επίσης τη δυνατότητα να εισαγάγετε δυναμικούς αριθμούς σελίδων στην ενότητα κεφαλίδας/υποσέλιδου. Τελευταίο αλλά όχι λιγότερο σημαντικό, μπορείτε να εξετάσετε το ενδεχόμενο να χρησιμοποιήσετε αντικείμενα πίνακα για να ευθυγραμμίσετε ένα μέρος του κειμένου κεφαλίδας/υποσέλιδου στο αριστερό άκρο και το άλλο στη δεξιά άκρη.
Πεδίο εφαρμογής του άρθρου
Το Aspose.Words Cloud SDK για .NET σάς επιτρέπει να εργάζεστε με APIs του Aspose.Words Cloud REST γρήγορα και εύκολα, καθώς φροντίζει για πολλές λεπτομέρειες χαμηλού επιπέδου σχετικά με την υποβολή αιτημάτων και τον χειρισμό των απαντήσεων και σας επιτρέπει να εστιάσετε στη σύνταξη κώδικα που είναι συγκεκριμένος για τις απαιτήσεις της επιχείρησής σας. Σε αυτό το άρθρο, θα χρησιμοποιήσουμε το Aspose.Words Cloud SDK για .NET στο Visual Studio για Mac. Αυτή η ανάρτηση ορίζει τα βήματα για την εισαγωγή του υποσέλιδου κεφαλίδας στο έγγραφο του Word όπου θα οριστεί προσαρμοσμένη μορφοποίηση. Στη συνέχεια, η μορφοποίηση του περιεχομένου εξόδου του υποσέλιδου ενημερώνεται και οι πληροφορίες Αριθμός Σελίδας εισάγονται στην κάτω δεξιά θέση. Όλες αυτές οι λειτουργίες θα εκτελούνται στο cloud.
Εγκατάσταση
Για να ξεκινήσετε, πρώτα, πρέπει να εγκαταστήσετε το Visual Studio στο σύστημά σας. Δημιουργήστε ένα δείγμα λύσης και προσθέστε αναφορά NuGet του Aspose.Words Cloud SDK για .NET. Για να προσθέσετε λοιπόν μια αναφορά, κάντε δεξί κλικ στη λύση και επιλέξτε την επιλογή μενού Manage NuGet Packages…. Εισαγάγετε το Aspose.Words-Cloud στο πεδίο κειμένου αναζήτησης. Επιλέξτε την επιλογή και κάντε κλικ στο κουμπί Προσθήκη πακέτου.
Τώρα η αναφορά Aspose.Words.Cloud.Sdk εμφανίζεται στη λύση. Υπάρχουν ορισμένα πλεονεκτήματα από τη χρήση των API cloud σε αντίθεση με τα API εσωτερικής εγκατάστασης (aspose.com).Ο λόγος είναι ότι δεν χρειάζεται να παρακολουθείτε χειροκίνητα και να ενημερώνετε τις εκδόσεις API και δεν χρειάζεται να πληρώνετε για ολόκληρη την άδεια.
Aspose.Cloud Dashboard
Απλώς δημιουργήστε έναν λογαριασμό στο Aspose.Cloud dashboard ή εγγραφείτε μέσω του υπάρχοντος λογαριασμού σας Google ή GitHub και αρχίστε να χρησιμοποιείτε τα API Cloud μας. Ένα άλλο εκπληκτικό χαρακτηριστικό των API Cloud είναι ότι μπορείτε να τα χρησιμοποιήσετε σε οποιαδήποτε πλατφόρμα χρησιμοποιώντας οποιαδήποτε υποστηριζόμενη γλώσσα.
Όπως αναφέρθηκε παραπάνω, το άρθρο δίνει έμφαση στις επιλογές σχετικά με την προσθήκη και ενημέρωση αντικειμένων κεφαλίδας και υποσέλιδου μέσα στα έγγραφα του MS Word. Για λόγους δοκιμής, χρησιμοποιήσαμε ένα υπάρχον πρότυπο εγγράφου MS Word με το όνομα Business Letter. Το έγγραφο πρέπει να μεταφορτωθεί στο Aspose cloud storage και όλος ο χειρισμός και η επεξεργασία του εγγράφου θα πραγματοποιηθούν μέσω του cloud. Μόλις ολοκληρωθεί όλη η επεξεργασία, μπορούμε επίσης να κατεβάσουμε το αντίγραφο του αρχείου που προκύπτει από το χώρο αποθήκευσης Cloud.
using Aspose.Words.Cloud.Sdk;
using Aspose.Words.Cloud.Sdk.Model;
using Aspose.Words.Cloud.Sdk.Model.Requests;
Τώρα, για να χρησιμοποιήσετε τα API Aspose.Cloud, πρέπει να χρησιμοποιήσετε πληροφορίες κλειδιού εφαρμογής και SID εφαρμογής στον κώδικά σας. Αυτά τα πλήκτρα αποτελούνται από αλφαριθμητικά ψηφία. Αυτοί είναι μοναδικοί κωδικοί που σχετίζονται με τον λογαριασμό συνδρομής σας. Για να λάβετε αυτές τις λεπτομέρειες, κάντε κλικ στην καρτέλα Οι εφαρμογές μου στο Aspose.Cloud dashboard. Μόλις έχουμε τα Κλειδιά, πρέπει να αρχικοποιήσουμε το αντικείμενο API Aspose.Words.
string MyAppKey = "f6axxxxxxxxxxxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "478e4827-xxxxx-xxxx-xxxx-xxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// create an object of WordsApi while passing AppKey and AppSid information
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
Εισαγωγή αντικειμένου κεφαλίδας
Για να προσθέσουμε το αντικείμενο κεφαλίδας μέσα στο αρχείο MS Word, πρέπει να εκτελέσουμε τις ακόλουθες λειτουργίες με τη σειρά.
- Δημιουργήστε ένα αντικείμενο του InsertHeaderFooterRequest όπου περνάμε τον τύπο HeaderFooterLink ως όρισμα.
- Εισαγωγή αντικειμένου HeaderFooterRequest στο αντικείμενο WordsApi χρησιμοποιώντας τη μέθοδο InsertHeaderFooter (…).
- Δημιουργήστε ένα αντικείμενο Run που περιέχει δείγματα πληροφοριών κειμένου.
- Δημιουργήστε αντικείμενο InsertRunRequest όπου περνάμε την αναφορά της παραγράφου (SectionPath) στο αντικείμενο HeaderFooter, όπου πρέπει να προστεθεί κείμενο Run.
Στη συνέχεια, καλέστε τη μέθοδο InsertRun (…) του WordsApi, η οποία προσθέτει το RunRequest στο αντικείμενο HeaderFooter.
Το HeaderFooter.TypeEnum μπορεί να είναι μία από τις ακόλουθες τιμές.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// δημιουργήστε ένα αντικείμενο του WordsAPI κατά τη μεταβίβαση πληροφοριών AppKey και AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// μεταφορτώστε δείγμα εγγράφου στο χώρο αποθήκευσης cloud
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Εισαγωγή αντικειμένου κεφαλίδας στην πρώτη σελίδα
var putHeaderFooterRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertHeaderFooterRequest("BusinessLetter.docx", "HeaderFirst", null,null);
var actual = wordsApi.InsertHeaderFooter(putHeaderFooterRequest);
// Δημιουργήστε αντικείμενο Run που περιέχει δείγμα κειμένου
var run = new Run { Text = "Aspose.Words Cloud SDK for .NET " };
// προσθέστε το κείμενο Εκτέλεση στην πρώτη παράγραφο του πρώτου αντικειμένου HeaderFooter στην πρώτη ενότητα του εγγράφου του Word
var runRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertRunRequest("BusinessLetter.docx", "sections/0/headersfooters/1/paragraphs/0", run);
// Εισαγάγετε το έγγραφο RunRequest to Word
var actual2 = wordsApi.InsertRun(runRequest);
Image showing preview of recently added Header
Ενημέρωση μορφοποίησης κειμένου της κεφαλίδας που εισήχθη πρόσφατα
Μόλις προστεθεί το αντικείμενο Header, μπορούμε να ενημερώσουμε τη μορφοποίηση κειμένου του περιεχομένου μέσα σε αυτό. Για να εκπληρώσουμε αυτή την απαίτηση, πρέπει να εκτελέσουμε τα παρακάτω βήματα.
- Δημιουργήστε ένα αντικείμενο της κλάσης Font, όπου καθορίζουμε Όνομα γραμματοσειράς, μέγεθος, πληροφορίες χρώματος.
- Για να κάνετε το κείμενο πιο εμφανίσιμο, επισημάνετε την ιδιότητα Engrave ως True.
- Δημιουργήστε ένα αντικείμενο της κλάσης UpdateRunFontRequest όπου περνάμε το αρχείο εισόδου, το Font, το SectionPath και το runIndex ως όρισμα.
- Τέλος, χρησιμοποιήστε τη μέθοδο UpdateRunFont(..) και προσθέστε το αντικείμενο UpdateRunFontRequest στην παρουσία του WordsApi.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// δημιουργήστε ένα αντικείμενο του WordsAPI κατά τη μεταβίβαση πληροφοριών AppKey και AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// μεταφορτώστε δείγμα εγγράφου στο χώρο αποθήκευσης cloud
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Το επόμενο βήμα είναι να ορίσετε τη μορφοποίηση του αντικειμένου κεφαλίδας
var runIndex = 0;
var fontDto = new Font { Bold = true, Name = "Verdana", Size = 16, Color = new XmlColor { Web = "#e0a50d" } };
// Ορίστε τη μορφοποίηση του κειμένου ως Engrave
fontDto.Engrave = true;
// Εφαρμογή μορφοποίησης στην πρώτη παράγραφο του αντικειμένου HeaderFooter
var documentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
fontDto, "sections/0/headersfooters/1/paragraphs/0", runIndex);
var actual4 = wordsApi.UpdateRunFont(documentParagraphRunFontRequest);
Image showing preview of Header after text formatting has been applied.
Ενημέρωση μορφοποίησης του υπάρχοντος αντικειμένου υποσέλιδου
Το API προσφέρει επίσης τη δυνατότητα ενημέρωσης της μορφοποίησης του περιεχομένου μέσα στο υπάρχον αντικείμενο Κεφαλίδας/Υποσέλιδου. Για να εκπληρώσουμε αυτήν την απαίτηση, μπορούμε να χρησιμοποιήσουμε τις παραπάνω καθορισμένες γραμμές κώδικα, αλλά η μόνη διαφορά είναι η αλλαγή του ευρετηρίου του υποσέλιδου κεφαλίδας σε 2. Δείτε την ακόλουθη γραμμή κώδικα.
// Apply formatting to first paragraph of HeaderFooter object
var FooterDocumentParagraphRunFontRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.UpdateRunFontRequest("BusinessLetter.docx",
FooterFontDto, "sections/0/headersfooters/2/paragraphs/0", FooterrunIndex);
Image displaying the change in Footer text formatting.
Προσθήκη πληροφοριών αριθμού σελίδας στην ενότητα υποσέλιδου
Οι αριθμοί σελίδων παρέχουν πολύ χρήσιμες πληροφορίες, όπως η τρέχουσα σελίδα και ο συνολικός αριθμός σελίδων σε ένα έγγραφο. Τα παρακάτω βήματα καθορίζουν τον τρόπο εκπλήρωσης των απαιτήσεων.
- Αρχικά δημιουργήστε ένα αντικείμενο της κλάσης PageNumber, όπου ορίζουμε, Στοίχιση κειμένου, τη μορφή του κειμένου, τη θέση απόδοσης των πληροφοριών Αριθμός Σελίδας και επίσης, προσδιορίζουμε εάν το PageNumber πρέπει να αποδοθεί στην πρώτη σελίδα ή όχι.
- Δημιουργήστε αντικείμενο InsertPageNumbersRequest και μεταβιβάστε το αντικείμενο PageNumber ως όρισμα.
- Τέλος, καλέστε τη μέθοδο InsertPageNumbers(..) για να προσθέσετε το InsertPageNumbersRequest στην παρουσία του WordsApi.
string MyAppKey = "xxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
string MyAppSid = "xxxxxxxxx"; // Get AppKey and AppSID from https://dashboard.aspose.cloud/
// δημιουργήστε ένα αντικείμενο του WordsAPI κατά τη μεταβίβαση πληροφοριών AppKey και AppSid
WordsApi wordsApi = new WordsApi(MyAppKey, MyAppSid);
// ανεβάστε δείγμα εγγράφου στο χώρο αποθήκευσης cloud
wordsApi.UploadFile(new UploadFileRequest(new System.IO.FileStream("/Users/nayyershahbaz/Documents/BusinessLetter.docx",
FileMode.Open, FileAccess.Read), "BusinessLetter.docx"));
// Το API προσφέρει επίσης τη δυνατότητα προσθήκης λεπτομερειών αριθμού σελίδας στο αντικείμενο HeaderFooter
// Προσθέστε πληροφορίες αριθμού σελίδας στο δεξί-κάτω μέρος της σελίδας
var body = new PageNumber { Alignment = "right", Format = "{PAGE} of {NUMPAGES}", IsTop = false, SetPageNumberOnFirstPage = true };
var insertPageNumbersRequest = new Aspose.Words.Cloud.Sdk.Model.Requests.InsertPageNumbersRequest("BusinessLetter.docx", body);
// Εισαγάγετε πληροφορίες Αριθμού σελίδας στο έγγραφο του Word
var actual6 = wordsApi.InsertPageNumbers(insertPageNumbersRequest);
Preview Page number in the footer section.
Σύναψη
Σε αυτό το άρθρο, μάθαμε τα βήματα σχετικά με τον τρόπο προσθήκης ενός υποσέλιδου κεφαλίδας στο έγγραφο του Word χρησιμοποιώντας το Aspose.Words Cloud SDK για .NET. Λάβετε υπόψη ότι διαθέτουμε επίσης Cloud SDK για Java, PHP, Ruby, Python, Go, Swift, C++, Node.Js, Android. Για περισσότερες λεπτομέρειες, επισκεφτείτε το Aspose.Words Cloud.
Σχετικά Άρθρα
Συνιστούμε επίσης να επισκεφθείτε τα παρακάτω για να μάθετε περισσότερα: