این مقاله شامل فرآیند افزودن نشانک در Word با NET REST API است. ما از Aspose.Words برای NET Cloud SDK برای افزودن نشانک به سند Word با C# Low Code API استفاده خواهیم کرد. برای افزودن این نشانک به فایل Word خود در دیسک محلی، پارامترهای مختلف نشانک را تنظیم کرده و فراخوانی های API را فراخوانی می کنید.
پيش نياز
- یک حساب ایجاد کنید و اعتبارنامه API را دریافت کنید
- دانلود Aspose.Words Cloud SDK for Dotnet to add a bookmark in a Word file
- راه اندازی پروژه راه حل C# با SDK بالا
مراحل ایجاد نشانک در Word با NET REST API
- Client ID و Client Secret را برای API تنظیم کنید تا یک نشانک اضافه کند
- یک شی از کلاس WordsApi را با اعتبار مشتری خود نمونه سازی کنید
- برای ایجاد نشانک، فایل Word منبع را در جریان حافظه بخوانید
- محدوده شروع و پایان نشانک را با استفاده از کلاس PositionInsideNode تعریف کنید
- با ارائه پارامترهای مورد نیاز، شی InsertBookmarkOnlineRequest را ایجاد کنید
- با توجه به InsertBookmarkOnlineRequest، روش InsertBookmarkOnline را به insert a bookmark فراخوانی کنید.
- فایل Word حاصل را با نشانک جدید ذخیره کنید
مراحل فوق الذکر نحوه ایجاد نشانک در Word با C# Low Code API را شرح می دهد. فرآیند را با ایجاد یک شی WordsApi و سپس خواندن فایل Word منبع و تعریف پارامترهای نشانک شروع کنید. در نهایت، با فراخوانی چند تماس API و سپس ذخیره فایل Word حاصل در دیسک محلی، این نشانک را به فایل Word خود اضافه کنید.
کد برای درج نشانک در Word با C# REST API
| using System; | |
| using System.IO; | |
| using Aspose.Words.Cloud.Sdk; | |
| using Aspose.Words.Cloud.Sdk.Model; | |
| using Aspose.Words.Cloud.Sdk.Model.Requests; | |
| namespace WordsSample.Words | |
| { | |
| public class Bookmarks | |
| { | |
| public void AddBookmark() | |
| { | |
| try | |
| { | |
| // Set the client secret and ID | |
| var config = new Configuration(); | |
| config.ClientSecret = "Client Secret"; | |
| config.ClientId = "Client ID"; | |
| // Instantiate the WordsApi object | |
| var wordsApi = new WordsApi(config); | |
| // Read the input file | |
| using var requestDocument = File.OpenRead("Sample.docx"); | |
| // Define start and end range for the bookmark | |
| var requestBookmarkStartRange = new PositionInsideNode | |
| { | |
| NodeId = "0.0.0.0", | |
| Offset = 0 | |
| }; | |
| var requestBookmarkEndRange = new PositionInsideNode() | |
| { | |
| NodeId = "0.0.0.0", | |
| Offset = 0 | |
| }; | |
| // Initialize the BookmarkInsert object | |
| var requestBookmark = new BookmarkInsert() | |
| { | |
| StartRange = requestBookmarkStartRange, | |
| EndRange = requestBookmarkEndRange, | |
| Name = "new_bookmark", | |
| Text = "Some text" | |
| }; | |
| string output = "output.docx"; | |
| // Insert the bookmark | |
| var insertRequest = new InsertBookmarkOnlineRequest(requestDocument, requestBookmark,destFileName:output); | |
| var insertTask = wordsApi.InsertBookmarkOnline(insertRequest); | |
| insertTask.Wait(); | |
| var result = insertTask.Result; | |
| // Save the Word file with the bookmark | |
| if (result.Document.TryGetValue(output, out var stream)) | |
| { | |
| stream.Position = 0; | |
| using (var fileStream = File.Create(output)) | |
| { | |
| stream.Seek(0, SeekOrigin.Begin); | |
| stream.CopyTo(fileStream); | |
| } | |
| } | |
| } | |
| catch (Exception e) | |
| { | |
| Console.WriteLine(e.Message); | |
| } | |
| } | |
| } | |
| } |
این کد نمونه نحوه اضافه کردن نشانک در Word با C# REST API را نشان می دهد. کلاس PositionInsideNode برای تنظیم محدوده شروع و پایان نشانک در فایل Word مقصد استفاده می شود. جریان حاصل به عنوان یک مورد فرهنگ لغت با کلید مشخص شده برگردانده می شود و می توان آن را با استفاده از روش TryGetValue همانطور که در کد نمونه نشان داده شده است بازیابی کرد.
در این مبحث یاد گرفتیم که چگونه با C# REST API * در Word بوکمارک بسازیم. اگر به دنبال تبدیل فایل Word به فایل HTML هستید، به مقاله در با NET REST API DOCX را به HTML تبدیل کنید مراجعه کنید.
