ایجاد، خواندن و ویرایش فایل های HTML در سی شارپ

اگر شما یک برنامه نویس سی شارپ هستید که به دنبال راهی کارآمد برای کار با فایل های HTML هستید، این مقاله برای شما مناسب است. ما اصول نحوه کار سی شارپ با فایل های HTML را توضیح خواهیم داد، از ایجاد آنها از ابتدا تا خواندن و ویرایش اسناد موجود. در این مقاله با نحوه ایجاد، خواندن و ویرایش فایل های HTML در سی شارپ آشنا می شویم.

HTML (Hyper Text Markup Language) زبانی است که برای ایجاد وب سایت ها و صفحات وب استفاده می شود. از سوی دیگر، سی شارپ یک زبان برنامه نویسی شی گرا است که برای ساخت برنامه های کاربردی استفاده می شود. یک فایل HTML حاوی تگ های نشانه گذاری است که برای قالب بندی ساختار یک صفحه وب برای نمایش در مرورگرها استفاده می شود. ما به راحتی می توانیم فایل های HTML را به صورت برنامه نویسی در برنامه های دات نت دستکاری کنیم. در این مقاله، نحوه استفاده از سی شارپ برای خواندن، نوشتن و ویرایش فایل های HTML را بررسی خواهیم کرد. ما راه هایی را برای تجزیه کد HTML برای عناصر خاص و ایجاد عناصر جدید از ابتدا یا ویرایش عناصر موجود بررسی خواهیم کرد. شروع کنیم!

موضوعات زیر در این مقاله پوشش داده خواهد شد:

1. C# API برای ایجاد، خواندن و ویرایش فایل‌های HTML
2. ایجاد یک فایل HTML
3. خواندن یک فایل HTML
4. ویرایش یک فایل HTML
5. افزودن محتوای خام HTML در C#

C# API برای ایجاد، خواندن و ویرایش فایل های HTML

برای ایجاد، خواندن و ویرایش فایل‌های HTML، از Aspose.HTML for .NET API استفاده خواهیم کرد. این یک 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 در سی شارپ

با انجام مراحل زیر می توانیم به راحتی یک فایل HTML ایجاد کنیم:

1. ابتدا یک نمونه از کلاس HTMLDocument ایجاد کنید.
2. در مرحله بعد، متد CreateElement() را برای ایجاد عناصری مانند عنوان، پاراگراف، متن و غیره فراخوانی کنید.
3. سپس، متد CreateTextNode() را برای اضافه کردن گره متن فراخوانی کنید.
4. سپس گره ایجاد شده را با استفاده از متد AppendChild() به عنصر اضافه کنید.
5. پس از آن، عناصر را با استفاده از متد HTMLDocument.Body.AppendChild به بدنه سند متصل کنید.
6. برای افزودن عناصر بیشتر مراحل بالا را تکرار کنید.
7. در نهایت، سند HTML را با استفاده از متد Save() ذخیره کنید. مسیر فایل خروجی را به عنوان آرگومان می گیرد.

نمونه کد زیر نحوه ایجاد یک فایل HTML با استفاده از سی شارپ را نشان می دهد.

// این مثال کد نحوه ایجاد یک سند 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 در سی شارپ

در قسمت قبل یک فایل HTML ایجاد کردیم. اکنون با انجام مراحل زیر فایل را بارگذاری کرده و محتوای آن را می خوانیم:

1. یک فایل HTML موجود را با استفاده از کلاس HTMLDocument بارگیری کنید.
2. محتوای HTMLDocument.DocumentElement.OuterHTML را بخوانید و نشان دهید.

نمونه کد زیر نحوه خواندن یک فایل HTML با استفاده از سی شارپ را نشان می دهد.

// این مثال کد نحوه خواندن یک فایل 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 در سی شارپ

همچنین می توانیم محتوای فایل های 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 را نشان می دهد.
// یک مسیر خروجی برای ذخیره سند آماده کنید
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 در سی شارپ

ما می توانیم با افزودن دستی کد HTML به عنوان محتوا با استفاده از ویژگی InnerHTML یک عنصر، عناصر را اضافه یا ویرایش کنیم. با دنبال کردن مراحل زیر می توانیم HTML خام اضافه کنیم:

1. ابتدا یک نمونه از کلاس HTMLDocument ایجاد کنید.
2. سپس محتوای عنصر Body.InnerHTML را به عنوان رشته HTML خام تنظیم کنید.
3. در نهایت، سند HTML را با استفاده از متد Save() ذخیره کنید. مسیر فایل خروجی را به عنوان آرگومان می گیرد.

نمونه کد زیر نحوه اضافه کردن محتوای خام HTML به فایل را با استفاده از C# نشان می دهد.

// این مثال کد نحوه اضافه کردن 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");
}

مجوز رایگان دریافت کنید

برای امتحان Aspose.HTML برای دات نت بدون محدودیت ارزیابی، می توانید یک مجوز موقت رایگان دریافت کنید.

نتیجه

در این مقاله یاد گرفتیم که چگونه:

• ایجاد اسناد HTML به صورت برنامه ریزی شده.
• یک سند HTML موجود را از مسیر دیسک محلی بارگیری کنید.
• خواندن HTML از فایل بارگذاری شده.
• اضافه کردن محتوای جدید به فایل HTML موجود.
• محتوای موجود در سی شارپ را تغییر دهید.

علاوه بر ایجاد، خواندن و ویرایش فایل‌های HTML در C#، می‌توانید با استفاده از documentation درباره Aspose.HTML برای .NET API اطلاعات بیشتری کسب کنید. در صورت وجود هرگونه ابهامی، لطفاً با ما در [تالار گفتمان پشتیبانی رایگان18 تماس بگیرید.

همچنین ببینید

• تصویر را از URL در سی شارپ دانلود کنید
• ایجاد Web Scraper در سی شارپ
• تبدیل HTML به فایل MHT در سی شارپ