به‌عنوان یک توسعه‌دهنده C#، می‌توانید فایل‌های DOC یا DOCX را به‌صورت برنامه‌نویسی در برنامه‌های NET خود در فضای ابری به صفحات HTML ارائه دهید. می تواند در به اشتراک گذاری اسناد Word شما به عنوان صفحات HTML پاسخگو با ذینفعان مربوطه مفید باشد. در این مقاله یاد خواهید گرفت که چگونه اسناد Word را به صورت صفحات HTML با استفاده از REST API در سی شارپ مشاهده کنید.
- Word to HTML Viewer REST API و NET SDK
- مشاهده Word به عنوان صفحات HTML با استفاده از REST API در سی شارپ
- رندر Word به صفحات HTML با گزینه های رندر با استفاده از سی شارپ
- رندر ورد به HTML با واترمارک با استفاده از سی شارپ
Word to HTML Viewer REST API و NET SDK
برای رندر کردن فایل‌های DOC یا DOCX در HTML، از .NET SDK از GroupDocs.Viewer Cloud API استفاده خواهم کرد. این امکان را به شما می دهد تا انواع فرمت های سند و فایل تصویری محبوب مانند Word، Excel، PDF، PowerPoint، Visio، Project، Outlook، JPG، PNG و غیره را به صورت برنامه نویسی و مشاهده کنید.
می توانید GroupDocs.Viewer Cloud را در پروژه ویژوال استودیو خود از Package Manager NuGet نصب کنید یا با استفاده از دستور زیر در کنسول Package Manager نصب کنید:
Install-Package GroupDocs.Viewer-Cloud
لطفاً قبل از شروع به دنبال کردن مراحل و نمونه کدهای موجود، شناسه مشتری و راز خود را از داشبورد دریافت کنید. هنگامی که شناسه مشتری و Secret خود را دریافت کردید، کد را مطابق شکل زیر اضافه کنید:
string MyClientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string MyClientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string MyStorage = "";
var configuration = new Configuration(MyClientId, MyClientSecret);
مشاهده اسناد Word به عنوان صفحات HTML با استفاده از REST API در سی شارپ
با دنبال کردن مراحل ساده زیر می توانید اسناد Word را به عنوان صفحات HTML در فضای ابری مشاهده کنید:
سند را آپلود کنید
ابتدا فایل DOCX را با استفاده از نمونه کد زیر در فضای ابری آپلود کنید:
// API را مقداردهی کنید
var apiInstance = new FileApi(configuration);
// فایل را در IOStream از محلی/دیسک باز کنید.
var fileStream = File.Open(@"C:\Files\Sample.docx", FileMode.Open);
// ایجاد درخواست آپلود فایل
var request = new UploadFileRequest("sample.docx", fileStream, MyStorage);
// آپلود فایل
var response = apiInstance.UploadFile(request);
در نتیجه، فایل DOCX آپلود شده در بخش فایل ها داشبورد شما در دسترس خواهد بود.
رندر Word به صفحات HTML با استفاده از سی شارپ
با دنبال کردن مراحل زیر می توانید اسناد Word خود را به صورت برنامه نویسی در صفحات HTML ارائه دهید:
- یک نمونه از ViewAPI ایجاد کنید
- یک نمونه از FileInfo ایجاد کنید
- مسیر فایل ورودی را ارائه دهید
- یک نمونه از ViewOptions ایجاد کنید
- FileInfo را به ViewOptions اختصاص دهید
- ViewFormat را به عنوان “HTML” تنظیم کنید
- با فراخوانی متد CreateViewRequest با ViewOptions یک درخواست view ایجاد کنید
- با فراخوانی متد CreateView() با CreateViewRequest پاسخ دریافت کنید.
نمونه کد زیر نشان می دهد که چگونه می توان یک سند Word را با استفاده از REST API در سی شارپ به صفحات HTML ارائه کرد.
// مقداردهی اولیه API
var apiInstance = new ViewApi(configuration);
// مسیر فایل ورودی
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";
// گزینه های نمایش را تعریف کنید
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML; // output view format
// ایجاد درخواست مشاهده
var request = new CreateViewRequest(viewOptions);
// ایجاد نمای
var response = apiInstance.CreateView(request);
با استفاده از REST API در سی شارپ، اسناد Word را به صورت صفحات HTML مشاهده کنید.
صفحات HTML ارائه شده را دانلود کنید
نمونه کد بالا صفحات HTML ارائه شده را در ابر ذخیره می کند. با استفاده از نمونه کد زیر می توانید آنها را دانلود کنید:
// مقداردهی اولیه API
var fileApi = new FileApi(configuration);
// تمام صفحات HTML ارائه شده را ذخیره کنید
foreach (var page in response.Pages)
{
// ایجاد درخواست دانلود فایل
var downloadFileRequest = new DownloadFileRequest(page.Path, MyStorage);
// دریافت فایل
var file = fileApi.DownloadFile(downloadFileRequest);
// ذخیره فایل در پوشه کاری
using (var fileStream = System.IO.File.Create("C:\\Files\\" + page.Path))
{
file.Seek(0, SeekOrigin.Begin);
file.CopyTo(fileStream);
}
}
رندر Word به صفحات HTML با گزینه های رندر با استفاده از سی شارپ
با دنبال کردن مراحل زیر می توانید از گزینه های رندر خاصی برای رندر اسناد Word به صفحات HTML به صورت برنامه نویسی استفاده کنید:
- یک نمونه از ViewAPI ایجاد کنید
- یک نمونه از FileInfo ایجاد کنید
- مسیر فایل ورودی را ارائه دهید
- یک نمونه از ViewOptions ایجاد کنید
- FileInfo را به ViewOptions اختصاص دهید
- ViewFormat را به عنوان “HTML” تنظیم کنید
- یک نمونه از RenderOptions ایجاد کنید
- گزینه های مختلف رندر مانند PagesToRender، RenderComments و غیره را تنظیم کنید.
- با فراخوانی متد CreateViewRequest با ViewOptions یک درخواست view ایجاد کنید
- با فراخوانی متد CreateView() با CreateViewRequest پاسخ دریافت کنید.
نمونه کد زیر نحوه رندر کردن یک سند Word را به صفحات HTML با گزینه های رندر با استفاده از REST API در سی شارپ نشان می دهد.
// API را مقداردهی کنید
var apiInstance = new ViewApi(configuration);
// مسیر فایل ورودی
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";
// تعریف گزینه های نمایش
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML; // output view format
// گزینه های رندر را تعریف کنید
viewOptions.RenderOptions = new RenderOptions
{
// ارائه نظرات
RenderComments = true,
// رندر محدوده خاصی از صفحات
StartPageNumber = 1,
CountPagesToRender = 2,
};
// ایجاد درخواست مشاهده
var request = new CreateViewRequest(viewOptions);
// ایجاد نمای
var response = apiInstance.CreateView(request);
رندر ورد به HTML با واترمارک با استفاده از سی شارپ
با دنبال کردن مراحل زیر می‌توانید هنگام رندر کردن اسناد Word به HTML به صورت برنامه‌نویسی، یک متن واترمارک اضافه کنید:
- یک نمونه از ViewAPI ایجاد کنید
- یک نمونه از FileInfo ایجاد کنید
- مسیر فایل ورودی را ارائه دهید
- یک نمونه از ViewOptions ایجاد کنید
- FileInfo را به ViewOptions اختصاص دهید
- ViewFormat را به عنوان “HTML” تنظیم کنید
- گزینه مشاهده واترمارک را تعریف کنید
- متن، اندازه، رنگ و موقعیت واترمارک را تنظیم کنید
- با فراخوانی متد CreateViewRequest با ViewOptions یک درخواست view ایجاد کنید
- با فراخوانی متد CreateView() با CreateViewRequest پاسخ دریافت کنید.
نمونه کد زیر نحوه افزودن متن واترمارک به صفحات HTML ارائه شده با استفاده از REST API در سی شارپ را نشان می دهد.
// مقداردهی اولیه API
var apiInstance = new ViewApi(configuration);
// مسیر فایل ورودی
var fileInfo = new GroupDocs.Viewer.Cloud.Sdk.Model.FileInfo();
fileInfo.FilePath = "sample.docx";
// گزینه های نمایش را تعریف کنید
var viewOptions = new ViewOptions();
viewOptions.FileInfo = fileInfo;
viewOptions.ViewFormat = ViewOptions.ViewFormatEnum.HTML; // output view format
// واترمارک را تعریف کنید
viewOptions.Watermark = new Watermark
{
Text = "This is a sample watermark!",
Size = 100,
Color = "Red",
Position = Watermark.PositionEnum.Diagonal
};
// ایجاد درخواست مشاهده
var request = new CreateViewRequest(viewOptions);
// ایجاد نمای
var response = apiInstance.CreateView(request);
رندر ورد به HTML با واترمارک با استفاده از سی شارپ.
آنلاین را امتحان کنید
لطفاً ابزار رندر ورد آنلاین رایگان زیر را که با استفاده از API بالا ایجاد شده است، امتحان کنید. https://products.groupdocs.app/viewer/docx
نتیجه
در این مقاله یاد گرفتید که چگونه اسناد Word را به صورت صفحات HTML در فضای ابری مشاهده کنید. شما همچنین یاد گرفته اید که چگونه Word را به HTML با گزینه های رندر در سی شارپ رندر کنید. علاوه بر این، شما یاد گرفته‌اید که چگونه با استفاده از سی شارپ، یک واترمارک متنی به صفحات HTML رندر شده اضافه کنید. علاوه بر این، یاد گرفته‌اید که چگونه یک فایل DOCX را به صورت برنامه‌نویسی در فضای ابری آپلود کنید و سپس فایل‌های HTML ارائه‌شده را از ابر دانلود کنید. با استفاده از مستندات می‌توانید درباره GroupDocs.Viewer Cloud API بیشتر بیاموزید. ما همچنین یک بخش API Reference ارائه می‌کنیم که به شما امکان می‌دهد APIهای ما را مستقیماً از طریق مرورگر تجسم کرده و با آنها تعامل داشته باشید. در صورت وجود هرگونه ابهام، لطفاً با ما در [تالار] تماس حاصل فرمایید19.