C# – HtmlAgilityPack Nedir, Neler Yapılabilir?

HTML Agility Pack, web scraping (web kazıma) veya HTML belgelerini işlemek gibi görevlerle uğraşan C# geliştiriciler için oldukça yararlı bir araçtır. Bir web sayfasından veri kazımayı veya dinamik içerikleri ayrıştırmayı düşündüğünüzde, HTML Agility Pack sizin için ideal bir seçenek olabilir.

Bu kütüphane, HTML belgelerini analiz etmek, dolaşmak ve manipüle etmek için kullanılabilir. Örneğin, belirli bir HTML etiketini bulmak, içeriklerini okumak, değiştirmek veya silmek gibi işlemler yapabilirsiniz. Bu, özellikle bir web sitesinden belirli verileri çekmek veya web tabanlı bir uygulamada içeriği yönetmek için faydalıdır.

HTML Agility Pack’ı kullanmak oldukça kolaydır. İlk olarak, projenize NuGet paketi olarak eklemeniz gerekmektedir. Ardından, HTML belgesini yükleyip analiz etmek için bir HtmlDocument nesnesi oluşturmanız gerekmektedir. HtmlWeb sınıfı, belgeyi web adresinden indirmek için kullanışlı bir araçtır. Belgeyi indirdikten sonra, XPath veya LINQ ifadeleri gibi yöntemlerle belgenin içeriğini arayabilirsiniz.

Örneğin, bir web sayfasındaki başlıkları (h1 etiketleri gibi) almak istediğinizi düşünelim. HTML Agility Pack, bu görevi oldukça basit hale getirir. Aşağıdaki örnek kod, bu işlemi gerçekleştirmek için bir başlangıç noktası olabilir:

using HtmlAgilityPack;

// HtmlDocument oluşturma
HtmlWeb web = new HtmlWeb();
HtmlDocument belge = web.Load("http://www.example.com");

// Başlıkları seçmek için XPath ifadesi kullanma
HtmlNodeCollection basliklar = belge.DocumentNode.SelectNodes("//h1");

// Başlıkları yazdırma
if (basliklar != null)
{
   foreach (HtmlNode baslik in basliklar)
   {
      Console.WriteLine(baslik.InnerText);
   }
}

Yukarıdaki örnekte, HtmlWeb ve HtmlDocument sınıflarını kullanarak bir web sayfasını yüklüyoruz. Ardından, XPath ifadesi “//h1” kullanarak tüm h1 başlıklarını seçiyoruz. Son olarak, başlıkları döngü kullanarak yazdırıyoruz.

HTML Agility Pack, bu temel işlemlerin yanı sıra daha gelişmiş özellikler sunar. Örneğin, HTML etiketlerini oluşturma, değiştirme veya silme yetenekleri, CSS seçicileriyle elemanları seçme, belgeye yeni içerik ekleme ve diğer HTML manipülasyonları gibi işlemleri gerçekleştirebilirsiniz.

Ayrıca, HTML Agility Pack’ı kullanırken hata yönetimi de önemlidir. Çünkü bazen HTML belgeleri düzgün bir biçimde oluşturulmamış olabilir ve bu durum hata fırlatmalarına neden olabilir. Bu nedenle, kodunuzda hata yakalama mekanizmalarını kullanmanız önemlidir.

Sonuç olarak, HTML Agility Pack, C# geliştiricilerinin HTML belgeleriyle etkileşim kurmalarını sağlayan güçlü bir kütüphanedir. Web scraping veya dinamik içerik yönetimi gibi görevlerde oldukça kullanışlıdır. Basit ve kolay kullanımıyla, C# programcılarına HTML belgeleri üzerinde kontrol ve esneklik sağlar.

HTML Agility Pack kullanarak yapabileceğiniz bazı örnekler:

• Belirli bir HTML etiketini bulma: HTML belgesindeki belirli bir etiketi seçmek istediğinizi düşünelim. Örneğin, tüm bağlantılarını seçmek için aşağıdaki gibi XPath ifadesini kullanabilirsiniz:

HtmlNodeCollection baglantilar = belge.DocumentNode.SelectNodes("//a");

• Belirli bir etiketin içeriğini değiştirme: Seçtiğiniz bir HTML etiketinin içeriğini değiştirmek isterseniz aşağıdaki gibi bir yöntem kullanabilirsiniz:

HtmlNode baslik = belge.DocumentNode.SelectSingleNode("//h1");
if (baslik != null)
{
   baslik.InnerHtml = "Yeni Başlık";
}

• Yeni bir HTML etiketi oluşturma: HTML Agility Pack ile yeni bir etiket oluşturmak için HtmlNode.CreateElement yöntemini kullanabilirsiniz. Örneğin, yeni bir etiketi oluşturmak için aşağıdaki gibi bir kod kullanabilirsiniz:

HtmlNode divEtiketi = HtmlNode.CreateElement("div");
divEtiketi.InnerHtml = "Yeni bir div etiketi";

HtmlNodeCollection elemanlar = belge.DocumentNode.SelectNodes(".classAdi");

• Belgeye yeni içerik ekleme: HTML belgesine yeni içerik eklemek için HtmlNode.AppendChild yöntemini kullanabilirsiniz. Örneğin, bir etiketi oluşturup belirli bir div etiketine eklemek için aşağıdaki gibi bir kod kullanabilirsiniz:

HtmlNode yeniParagraf = HtmlNode.CreateElement("p");
yeniParagraf.InnerHtml = "Yeni paragraf içeriği";
HtmlNode divEtiketi = belge.DocumentNode.SelectSingleNode("//div");
if (divEtiketi != null)
{
   divEtiketi.AppendChild(yeniParagraf);
}