إنشاء وقراءة وتحرير ملفات HTML في C#

يحتوي ملف HTML(Hyper Text Markup Language) على علامات تمييز تُستخدم لتنسيق بنية صفحة الويب لعرضها في المستعرضات. يمكننا بسهولة معالجة ملفات HTML برمجيًا في تطبيقات .NET. في هذه المقالة ، سوف نتعلم كيفية إنشاء ملفات HTML وقراءتها وتحريرها في C#.

سيتم تناول الموضوعات التالية في هذه المقالة:

  1. C# API لإنشاء ملفات HTML وقراءتها وتحريرها
  2. إنشاء ملف HTML
  3. قراءة ملف HTML
  4. تحرير ملف HTML
  5. إضافة محتوى HTML Raw في C#

C# API لإنشاء ملفات HTML وقراءتها وتحريرها

لإنشاء ملفات HTML وقراءتها وتحريرها ، سنستخدم Aspose.HTML for .NET API. إنها واجهة برمجة تطبيقات متقدمة لمعالجة HTML تسمح بإنشاء وتعديل واستخراج البيانات من مستندات HTML. كما يسمح بتحويل مستندات HTML وتقديمها بدون أي برامج خارجية.

تمثل فئة HTMLDocument من API مستند HTML أو صفحة HTML التي نراها في المتصفح. طريقة CreateElement() لهذه الفئة تنشئ عنصر HTML المحدد بواسطة tagName. الطريقة CreateTextNode(string) تنشئ عقدة نصية مع إعطاء السلسلة المحددة. تضيف طريقة AppendChild() لواجهة Node عقدة إلى نهاية قائمة العناصر الفرعية للعقدة الأصلية المحددة. طريقة Save() تحفظ ملف الإخراج. يمكنك أيضًا قراءة المزيد حول DOM namespace في الوثائق.

يرجى إما تنزيل DLL من API أو تثبيته باستخدام NuGet.

PM> Install-Package Aspose.Html

قم بإنشاء ملف HTML في C#

يمكننا بسهولة إنشاء ملف HTML باتباع الخطوات الواردة أدناه:

  1. أولاً ، قم بإنشاء مثيل لفئة HTMLDocument.
  2. بعد ذلك ، قم باستدعاء طريقة CreateElement() لإنشاء عناصر مثل العنوان ، الفقرة ، النص ، إلخ.
  3. ثم قم باستدعاء الأسلوب CreateTextNode() لإضافة عقدة النص.
  4. بعد ذلك ، قم بإلحاق العقدة التي تم إنشاؤها بالعنصر باستخدام طريقة AppendChild().
  5. بعد ذلك ، قم بإرفاق العناصر بنص المستند باستخدام طريقة HTMLDocument.Body.AppendChild().
  6. كرر الخطوات المذكورة أعلاه لإضافة المزيد من العناصر.
  7. أخيرًا ، احفظ مستند HTML باستخدام طريقة Save().يأخذ مسار ملف الإخراج كوسيطة.

يوضح نموذج التعليمات البرمجية التالي كيفية إنشاء ملف HTML باستخدام C#.

// يوضح مثال التعليمات البرمجية هذا كيفية إنشاء مستند HTML.

// قم بإنشاء مستند HTML فارغ
var document = new HTMLDocument();

// أضف العنوان
// 1. قم بإنشاء عنصر عنوان
var h2 = (HTMLHeadingElement)document.CreateElement("h2");

// 2. قم بإنشاء عنصر نصي
var text = document.CreateTextNode("This is Sample Heading!");

// 3. إضافة عنصر نصي إلى العنوان
h2.AppendChild(text);

// 4. أضف العنوان to the document
document.Body.AppendChild(h2);

// أضف فقرة
// 1. قم بإنشاء عنصر فقرة
var p = (HTMLParagraphElement)document.CreateElement("p");

// 2. تعيين سمة مخصصة
p.SetAttribute("id", "first-paragraph");

// 3. قم بإنشاء عقدة نصية
var paraText = document.CreateTextNode("This is first paragraph. ");

// 4. أضف النص إلى الفقرة
p.AppendChild(paraText);

// 5. إرفاق فقرة في نص الوثيقة 
document.Body.AppendChild(p);

// أضف قائمة مرتبة
// قم بإنشاء عنصر فقرة
var list = (HTMLOListElement)document.CreateElement("ol");

// أضف لي البند 1
var item1 = (HTMLLIElement)document.CreateElement("li");
item1.AppendChild(document.CreateTextNode("First list item."));

// أضف لي البند 2
var item2 = (HTMLLIElement)document.CreateElement("li");
item2.AppendChild(document.CreateTextNode("Second list item."));

// أضف عناصر li إلى القائمة
list.AppendChild(item1);
list.AppendChild(item2);

// إرفاق قائمة بجسم المستند 
document.Body.AppendChild(list);

// احفظ مستند HTML في ملف 
document.Save(@"C:\Files\html\create-new-document.html");
إنشاء ملف HTML في CSharp

قم بإنشاء ملف HTML في C#

قراءة ملف HTML في C#

في القسم السابق ، أنشأنا ملف HTML. الآن ، سنقوم بتحميل الملف وقراءة محتواه باتباع الخطوات الموضحة أدناه:

  1. قم بتحميل ملف HTML موجود باستخدام فئة HTMLDocument.
  2. اقرأ وأظهر محتوى HTMLDocument.DocumentElement.OuterHTML.

يوضح نموذج التعليمات البرمجية التالي كيفية قراءة ملف HTML باستخدام C#.

// يوضح مثال التعليمات البرمجية هذا كيفية قراءة ملف HTML
// قم بإعداد مسار إخراج لحفظ المستند
string documentPath = @"C:\Files\html\create-new-document.html";

// قم بتحميل ملف HTML
var document = new HTMLDocument(documentPath);

// اكتب محتوى المستند إلى تدفق الإخراج
Console.WriteLine(document.DocumentElement.OuterHTML);
<html><head></head><body><h2>This is Sample Heading!</h2><p id="first-paragraph">This is first paragraph. </p><ol><li>First list item.</li><li>Second list item.</li></ol></body></html>

تحرير ملف HTML في C#

يمكننا أيضًا تحديث محتوى ملفات HTML. يمكننا إضافة المزيد من العقد / العناصر باتباع الخطوات المذكورة أعلاه. ومع ذلك ، يمكننا تعديل الملاحظات / العناصر الموجودة باتباع الخطوات الواردة أدناه:

  1. قم بتحميل ملف HTML موجود باستخدام فئة HTMLDocument.
  2. بعد ذلك ، قم باستدعاء الأسلوب CreateTextNode() لإضافة عقدة النص.
  3. بعد ذلك ، احصل على عنصر الفقرة الأول باستخدام طريقة GetElementsByTagName().تأخذ “p” كوسيطة.
  4. بعد ذلك ، قم باستدعاء طريقة AppendChild() لإلحاق العقدة النصية.
  5. كرر الخطوات المذكورة أعلاه لتعديل المزيد من العناصر.
  6. أخيرًا ، احفظ مستند HTML باستخدام طريقة Save().يأخذ مسار ملف الإخراج كوسيطة.

يوضح نموذج التعليمات البرمجية التالي كيفية تعديل ملف HTML باستخدام C#.

// يوضح مثال التعليمات البرمجية هذا كيفية تحرير محتوى esiting لملف HTML.
// قم بإعداد مسار إخراج لحفظ المستند
string documentPath = @"C:\Files\html\create-new-document.html";

// قم بإنشاء مثيل لمستند HTML
var document = new HTMLDocument(documentPath);

// قم بإنشاء عقدة نصية
var oldParaText = document.CreateTextNode("This is old first paragraph.");

// احصل على أول عنصر فقرة
var p = (HTMLParagraphElement)document.GetElementsByTagName("p").First();
p.AppendChild(oldParaText);

// احفظ مستند HTML في ملف 
document.Save(@"C:\Files\html\modify.html");
تحرير ملف HTML في CSharp

تحرير ملف HTML في C#

يُظهر نموذج الكود التالي مثالًا أكثر تعقيدًا نضيف فيه عناصر جديدة ونعدل العناصر الموجودة.

// يوضح مثال التعليمات البرمجية هذا كيفية وتحرير العناصر في ملف HTML esiting.
// قم بإعداد مسار إخراج لحفظ المستند
string documentPath = @"C:\Files\html\create-new-document.html";

// قم بإنشاء مثيل لمستند HTML
var document = new HTMLDocument(documentPath);

// قم بإنشاء عنصر نمط وقم بتعيين اللون الأخضر لجميع العناصر التي يكون اسم الفئة فيها يساوي "gr".
var style = document.CreateElement("style");
style.TextContent = ".rd { color: red }";

// ابحث عن عنصر رأس المستند وألحق عنصر النمط بالرأس
var head = document.GetElementsByTagName("head").First();
head.AppendChild(style);

// قم بإنشاء عقدة نصية
var oldParaText = document.CreateTextNode("This is old first paragraph.");

// قم بإنشاء عنصر فقرة باسم فئة 'gr'.
var p = (HTMLParagraphElement)document.GetElementsByTagName("p").First();
p.ClassName = "rd";
p.AppendChild(oldParaText);

// قم بإنشاء عنصر فقرة
var newPara = (HTMLParagraphElement)document.CreateElement("p");

// قم بإنشاء عقدة نصية
var paraText = document.CreateTextNode("This is second paragraph. ");

// أضف النص إلى الفقرة
newPara.AppendChild(paraText);

// إرفاق فقرة بنص الوثيقة 
document.Body.AppendChild(newPara);

// احفظ مستند HTML في ملف 
document.Save(@"C:\Files\html\edit.html");
إضافة تحرير العناصر في ملف HTML باستخدام CSharp

إضافة وتحرير العناصر في ملف HTML باستخدام C#

إضافة محتوى HTML الخام في C#

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

  1. أولاً ، قم بإنشاء مثيل لفئة HTMLDocument.
  2. بعد ذلك ، قم بتعيين محتوى عنصر Body.InnerHTML كسلسلة HTML خام.
  3. أخيرًا ، احفظ مستند HTML باستخدام طريقة Save().يأخذ مسار ملف الإخراج كوسيطة.

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

// يوضح مثال التعليمات البرمجية هذا كيفية إضافة Raw HTML إلى نص HTML.
// قم بإنشاء مثيل لمستند HTML
using (var document = new HTMLDocument())
{
    // اكتب محتوى مستند HTML في إخراج وحدة التحكم
    Console.WriteLine(document.DocumentElement.OuterHTML); 

    // اضبط محتوى عنصر الجسم
    document.Body.InnerHTML = "<p>HTML is the standard markup language for Web pages.</p>";

    /// احفظ مستند HTML في ملف 
    document.Save(@"C:\Files\html\using-innerHTML.html");
}
Add-Raw-HTML-Content-in-CSharp

إضافة HTML خام في ملف HTML باستخدام C#

احصل على ترخيص مجاني

يمكنك الحصول على ترخيص مؤقت مجاني لتجربة Aspose.HTML لـ .NET بدون قيود تقييم.

استنتاج

في هذه المقالة ، تعلمنا كيفية:

  • إنشاء مستندات HTML برمجيًا ؛
  • تحميل مستند HTML موجود من مسار القرص المحلي ؛
  • قراءة HTML من الملف المحمل ؛
  • إضافة محتوى جديد إلى ملف HTML الموجود ؛
  • تعديل المحتوى الموجود في C#.

إلى جانب إنشاء ملفات HTML وقراءتها وتحريرها في C# ، يمكنك معرفة المزيد حول Aspose.HTML لـ .NET API باستخدام التوثيق. في حالة وجود أي غموض ، لا تتردد في الاتصال بنا على منتدى الدعم المجاني.

أنظر أيضا