C# DirectorySearcher Kullanımı 2024: Güncel Örnekler ve Adım Adım Rehber

 

Giriş

C# geliştiricileri için, veritabanlarından ve dizin yapısından veri almak sıklıkla karşılaşılan bir görevdir. Active Directory gibi büyük dizin servislerinden veri almak ise özellikle kurumsal uygulamaların ihtiyaç duyduğu önemli bir süreçtir. C# dilinde, bu tür dizin hizmetlerine erişimi kolaylaştırmak için "DirectorySearcher" sınıfı kullanılmaktadır. Bu makalede, C# DirectorySearcher'ın ne olduğunu, ne işe yaradığını ve nasıl kullanıldığını inceleyeceğiz.

DirectorySearcher Sınıfını Anlama

DirectorySearcher, C# programcılarının dizin hizmetlerine yönelik sorgular yapmasını sağlayan .NET Framework kütüphanesinde yer alan bir sınıftır. Bu sınıf, özellikle Active Directory gibi büyük ve karmaşık dizin yapılarında veri aramak için kullanılır. DirectorySearcher, System.DirectoryServices.dll içinde tanımlıdır ve System.DirectoryServices isim alanını içe aktararak kullanılabilir.

DirectorySearcher'ın Görevleri

DirectorySearcher sınıfının temel görevleri şunlardır:

1. Dizin Sorguları Yapmak: DirectorySearcher, belirli filtreler ve kriterlerle dizin hizmetlerine sorgular yaparak verileri alabilir.

2. Dizin Hiyerarşisinde Gezinmek: Bu sınıf, dizin yapısındaki nesneler arasında gezinerek belirli verilere erişmeyi sağlar.

3. Veri Eşleştirmek: DirectorySearcher, belirli kriterlere uygun olarak verileri eşleştirebilir ve geri döndürebilir.

4. Performans ve Optimizasyon: Büyük dizin yapılarında performansı artırmak için DirectorySearcher, sayfa boyutu ve arama kapsamı gibi özellikleri ayarlamak için kullanılabilir.

DirectorySearcher Sınıfının Özellikleri

1. Name: DirectorySearcher'ın arama yapacağı dizin yapısının adını veya yolunu belirler.

2. Asynchronous: Eğer bu özellik "true" olarak ayarlanırsa, arama işlemi asenkron olarak gerçekleştirilir.

3. AttributeScopeQuery: Bu özellik, bir nesnenin belirli niteliklerinin dikkate alınarak arama sorgusunun yapılmasını sağlar.

4. CacheResults: Bu özellik, arama sonuçlarının önbelleğe alınıp alınmayacağını belirler. Önbelleğe alma, sonuçları daha hızlı erişilebilir hale getirebilir.

5. ClientTimeout: Arama işleminin istemci tarafından zaman aşımına uğrayacağı süreyi belirler.

6. DerefAlias: Bu özellik, dizindeki aliasları (takma adlar) takip etme davranışını belirler.

7. ExtendedDN: Eğer bu özellik "true" olarak ayarlanırsa, sonuçlar genişletilmiş nesne adları (DN) olarak döndürülür.

8. Filter: DirectorySearcher'ın en önemli özelliklerinden biridir. Bu özellik, dizin nesnelerini filtrelemek için kullanılır. Filtre, LDAP (Lightweight Directory Access Protocol) filtre biçiminde belirtilir.

• (objectClass=*): Dizin içindeki tüm nesneleri seçer. Yani, "objectClass" niteliği boş olmayan tüm nesneleri döndürür.
• (objectClass=user): Sadece "objectClass" niteliği "user" olan kullanıcı nesnelerini seçer.
• (objectClass=group): Sadece "objectClass" niteliği "group" olan grup nesnelerini seçer.
• (objectCategory=person): "objectCategory" niteliği "person" olan kişisel nesneleri seçer.
• (cn=John Doe): "cn" (Common Name) niteliği "John Doe" olan nesneleri seçer.
• (&(objectClass=user)(department=HR)): Hem "objectClass" niteliği "user" olan hem de "department" niteliği "HR" olan kullanıcı nesnelerini seçer.
• (|(objectClass=user)(objectClass=group)): "objectClass" niteliği "user" veya "group" olan nesneleri seçer.
• (!(objectClass=computer)): "objectClass" niteliği "computer" olmayan nesneleri seçer

1. 
   

2. Modifiers: Bu özellik, arama sorgusuna ek olarak ek bilgiler eklemek için kullanılır.

3. PageSize: PageSize özelliği, tek bir sorguda döndürülecek maksimum nesne sayısını belirler.

4. PropertiesToLoad: Bu özellik, döndürülecek özelliklerin listesini belirler.

5. PropertyNamesOnly: Eğer bu özellik "true" olarak ayarlanırsa, sadece özellik adlarını içeren sonuçlar döndürülür.

6. ReferralChasing: Bu özellik, yönlendirmeleri (referrals) takip etme davranışını belirler.

7. SearchRoot: Aramanın başlayacağı dizin konumunu belirler.

8. SearchScope: SearchScope, dizin yapısında sorgunun nasıl gerçekleştirileceğini belirler.

9. SecurityMasks: Bu özellik, döndürülecek özelliklerin güvenlik maskelerini belirler.

10. ServerPageTimeLimit: ServerPageTimeLimit, dizin sunucusunun sayfa boyutu ile sorgulama süresini belirler.

11. ServerTimeLimit: ServerTimeLimit, dizin sunucusuyla iletişim kurma süresini belirler.

12. SizeLimit: Bu özellik, maksimum nesne sayısını belirler.

13. Sort: Bu özellik, sonuçların belirli özelliklere göre sıralanmasını sağlar.

• PropertyName: Sıralama yapılacak özelliğin adını belirtir. Örneğin, "cn" (Common Name) veya "samAccountName" gibi bir özelliği sıralamak için kullanılabilir.
• Direction: Sıralama yönünü belirtir ve iki değer alabilir:   Ascending (Artan): Sonuçları küçükten büyüğe doğru sıralar.
       Descending (Azalan): Sonuçları büyükten küçüğe doğru sıralar.

1. Tombstone: Eğer bu özellik "true" olarak ayarlanırsa, silinmiş nesneleri de arama sonuçlarına dahil eder.

DirectorySearcher sınıfının kullanışlı bazı özelliklerine göz atalım:

1. Filtre

DirectorySearcher'ın en önemli özelliklerinden biri "Filter" özelliğidir. Bu özellik, dizin nesnelerini filtrelemek için kullanılır. Filtre, LDAP (Lightweight Directory Access Protocol) filtre biçiminde belirtilir ve belirli kriterlere uyan nesneleri getirmek için kullanılır.

Örneğin, kullanıcıların sadece belirli bir birimdeki (OU) hesaplarını almak için filtre kullanılabilir.

2. Sayfa Boyutu (PageSize)

PageSize özelliği, tek bir sorguda döndürülecek maksimum nesne sayısını belirler. Büyük dizinlerde, tüm sonuçları tek seferde almak yerine sayfalara bölerek almak performans açısından daha verimlidir.

3. Arama Kökü (SearchRoot)

SearchRoot, sorgunun başlayacağı dizin konumunu belirler. Bu özellik, sorgunun hangi alt dizinden başlayacağını belirtmek için kullanılır.

4. Arama Kapsamı (SearchScope)

SearchScope, dizin yapısında sorgunun nasıl gerçekleştirileceğini belirler. DirectorySearcher, Base, OneLevel ve Subtree olmak üzere üç farklı arama kapsamını destekler.

5. Sunucu Zaman Sınırı (ServerTimeLimit)

ServerTimeLimit, dizin sunucusuyla iletişim kurma süresini belirler. Böylece, sorgu belirli bir süre sonra sonuçlanır ve beklenmedik uzun süreli sorgu işlemesinin önüne geçer.

DirectorySearcher Kullanımı

DirectorySearcher'ı kullanmak için aşağıdaki adımları izleyebiliriz:

1. DirectorySearcher nesnesini oluşturun ve sorgunun yapılacağı dizini belirtin.
2. Gerekirse, filtre, sayfa boyutu, arama kökü ve arama kapsamı gibi özellikleri ayarlayın.
3. Sorguyu gerçekleştirin ve sonuçları elde edin.
4. Elde edilen sonuçları işleyin ve istenen verileri kullanın.

5. DirectorySearcher Bütün Özellikleri

6. 
   

Sonuç

C# DirectorySearcher, büyük ve karmaşık dizin yapılarından veri almak için C# geliştiricilerinin kullandığı güçlü bir araçtır. Bu makalede, DirectorySearcher sınıfının ne olduğunu, nasıl kullanılacağını ve temel özelliklerini inceledik. Umarım, C# DirectorySearcher'ın işlevselliği ve kullanımı hakkında bilgi edinmenize yardımcı olmuşumdur.

Sıkça Sorulan Sorular (FAQs)

1. C# DirectorySearcher, sadece Active Directory'de mi çalışır?

   Hayır, DirectorySearcher, LDAP protokolü destekleyen diğer dizin hizmetlerinde de kullanılabilir.

2. DirectorySearcher filtresini nasıl oluşturabilirim?

   Filtre, LDAP filtre biçimine uygun olarak oluşturulmalıdır. Belirli özelliklere göre filtreleme yapılabilir.

3. DirectorySearcher, arama sonuçlarını nasıl sıralar?

   DirectorySearcher, varsayılan olarak sonuçları veri eşleşme önceliğine göre sıralar.

4. C# DirectorySearcher performansı nasıl artırabilirim?

   Büyük dizinlerde performansı artırmak için PageSize özelliğini ayarlayarak sayfalara bölerek veri almayı tercih edebilirsiniz.

5. DirectorySearcher, hangi C# sürümlerinde kullanılabilir?

   DirectorySearcher, .NET Framework'ün çeşitli sürümlerinde kullanılabilir ve C# ile uyumludur.

6. DirectorySearcher, hangi veri türlerini döndürebilir?

   DirectorySearcher, sorgular sonucunda DirectoryEntry nesnelerini döndürerek dizin nesnelerine erişimi sağlar.