عرض مستندات Word كصفحات HTML باستخدام واجهة برمجة تطبيقات REST في C#

بصفتك مطور C# ، يمكنك بسهولة عرض ملفات DOC أو DOCX على صفحات HTML برمجيًا في تطبيقات .NET على السحابة. يمكن أن يكون مفيدًا في مشاركة مستندات Word الخاصة بك كصفحات HTML سريعة الاستجابة مع أصحاب المصلحة المعنيين. في هذه المقالة ، ستتعلم كيفية عرض مستندات Word كصفحات HTML باستخدام واجهة برمجة تطبيقات REST في C#.

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 في مشروع Visual Studio الخاص بك من مدير الحزم NuGet أو تثبيته باستخدام الأمر التالي في وحدة تحكم مدير الحزم:

Install-Package GroupDocs.Viewer-Cloud

يرجى الحصول على معرّف العميل والسرية من لوحة القيادة قبل البدء في اتباع الخطوات وأمثلة الكود المتاحة. بمجرد حصولك على معرّف العميل والسرية ، أضف الرمز كما هو موضح أدناه:

string MyClientId = "112f0f38-9dae-42d5-b4fc-cc84ae644972";
string MyClientSecret = "16ad3fe0bdc39c910f57d2fd48a5d618";
string MyStorage = "";

var configuration = new Configuration(MyClientId, MyClientSecret);

عرض مستندات Word كصفحات HTML باستخدام واجهة برمجة تطبيقات REST في C#

يمكنك عرض مستندات 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 باستخدام C#

يمكنك عرض مستندات Word الخاصة بك على صفحات HTML برمجيًا باتباع الخطوات الواردة أدناه:

  • إنشاء مثيل لـ ViewAPI
  • قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار ملف الإدخال
  • قم بإنشاء مثيل لـ ViewOptions
  • قم بتعيين FileInfo إلى ViewOptions
  • تعيين ViewFormat كـ “HTML”
  • قم بإنشاء طلب عرض عن طريق استدعاء طريقة CreateViewRequest باستخدام ViewOptions
  • احصل على رد عن طريق استدعاء طريقة CreateView() باستخدام CreateViewRequest

يوضح نموذج التعليمات البرمجية التالي كيفية تقديم مستند Word إلى صفحات HTML باستخدام واجهة برمجة تطبيقات REST في C#.

// تهيئة 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);
اعرض مستندات Word كصفحات HTML باستخدام واجهة برمجة تطبيقات REST في C#.

اعرض مستندات Word كصفحات HTML باستخدام واجهة برمجة تطبيقات REST في C#.

قم بتنزيل صفحات 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 مع خيارات التقديم باستخدام C#

يمكنك استخدام خيارات عرض محددة لعرض مستندات Word على صفحات HTML برمجيًا باتباع الخطوات الواردة أدناه:

  • إنشاء مثيل لـ ViewAPI
  • قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار ملف الإدخال
  • قم بإنشاء مثيل لـ ViewOptions
  • قم بتعيين FileInfo إلى ViewOptions
  • تعيين ViewFormat كـ “HTML”
  • قم بإنشاء مثيل لـ RenderOptions
  • قم بتعيين خيارات عرض متنوعة مثل PagesToRender و RenderComments وما إلى ذلك.
  • قم بإنشاء طلب عرض عن طريق استدعاء طريقة CreateViewRequest باستخدام ViewOptions
  • احصل على رد عن طريق استدعاء طريقة CreateView() باستخدام CreateViewRequest

يوضح نموذج التعليمات البرمجية التالي كيفية عرض مستند Word على صفحات HTML مع خيارات التقديم باستخدام واجهة برمجة تطبيقات REST في C#.

// تهيئة 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);

عرض Word إلى HTML مع علامة مائية باستخدام C#

يمكنك إضافة نص علامة مائية أثناء عرض مستندات Word إلى HTML برمجيًا باتباع الخطوات الواردة أدناه:

  • إنشاء مثيل لـ ViewAPI
  • قم بإنشاء مثيل FileInfo
  • قم بتوفير مسار ملف الإدخال
  • قم بإنشاء مثيل لـ ViewOptions
  • قم بتعيين FileInfo إلى ViewOptions
  • تعيين ViewFormat كـ “HTML”
  • تحديد خيار عرض العلامة المائية
  • قم بتعيين نص العلامة المائية وحجمها ولونها وموضعها
  • قم بإنشاء طلب عرض عن طريق استدعاء طريقة CreateViewRequest باستخدام ViewOptions
  • احصل على رد عن طريق استدعاء طريقة CreateView() باستخدام CreateViewRequest

يوضح نموذج التعليمات البرمجية التالي كيفية إضافة نص علامة مائية إلى صفحات HTML المعروضة باستخدام واجهة برمجة تطبيقات REST في C#.

// تهيئة 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);
تحويل Word إلى HTML مع علامة مائية باستخدام C#.

تحويل Word إلى HTML مع علامة مائية باستخدام C#.

جرب عبر الإنترنت

يرجى تجربة أداة عرض الكلمات المجانية التالية عبر الإنترنت ، والتي تم تطويرها باستخدام واجهة برمجة التطبيقات المذكورة أعلاه. https://products.groupdocs.app/viewer/docx

خاتمة

في هذه المقالة ، تعلمت كيفية عرض مستندات Word كصفحات HTML على السحابة. لقد تعلمت أيضًا كيفية تحويل Word إلى HTML باستخدام خيارات التقديم في C#. علاوة على ذلك ، لقد تعلمت كيفية إضافة علامة مائية نصية إلى صفحات HTML المعروضة برمجيًا باستخدام C#. علاوة على ذلك ، تعلمت كيفية تحميل ملف DOCX برمجيًا إلى السحابة ثم تنزيل ملفات HTML المقدمة من السحابة. يمكنك معرفة المزيد حول GroupDocs.Viewer Cloud API باستخدام التوثيق. نوفر أيضًا قسم مرجع واجهة برمجة التطبيقات الذي يتيح لك تصور واجهات برمجة التطبيقات الخاصة بنا والتفاعل معها مباشرةً من خلال المتصفح. في حالة وجود أي غموض ، فلا تتردد في الاتصال بنا على المنتدى.

أنظر أيضا