C# String Equals (Geliştiriciler için Nasıl Çalışır)

C#'da string.Equals nedir?

C dizi eşitliği metodu, C#'da string.Equals olarak bilinir, dizeleri veya diğer uyumlu nesneleri temsil eden iki parametrenin içeriğini karşılaştırmak için kullanılır. Düz dize değerleri geçirebilir veya karşılaştırma sırasında dizeye çevrilecek bir tip nesnesi geçirebilirsiniz. Eşitlik dizesi için sözdizimsel şeker olan == operatöründen farklı olarak, string.Equals kullanmak şu avantajları sunar:

• Karşılaştırma kurallarını belirleyin (örneğin, büyük-küçük harf duyarlılığı veya kültür duyarsızlığı gibi).

• Aşırı yüklenmiş operatörlerle kafanın karışmasını önle.

• Koşullu mantıkta okunabilirliği artır.

.NET Framework'te metot imzası genellikle şu şekildedir:

public bool Equals(string value, StringComparison comparisonType)

public bool Equals(string value, StringComparison comparisonType)

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'public bool Equals(string value, StringComparison comparisonType)

Burada, public bool, karşılaştırma sonucuna bağlı olarak değerin her zaman true veya false olacağını gösterir.

string.Equals(str1, str2)
string.Equals(str1, str2, StringComparison.OrdinalIgnoreCase)

string.Equals(str1, str2)
string.Equals(str1, str2, StringComparison.OrdinalIgnoreCase)

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'string.Equals(str1, str2) string.Equals(str1, str2, StringComparison.OrdinalIgnoreCase)

IronPDF İle Nasıl Çalışır

IronPDF, PDF belgeleri içinde metin arama, çıkarma ve manipüle etmenizi sağlayan güçlü bir .NET PDF kütüphanesidir. string.Equals kullanarak:

• Çıkartılan dize değerini bilinen bir değerle karşılaştır.

• Başlık, yazar ve anahtar kelimeler gibi meta verileri kontrol edin.

• Koşullu PDF belgelerinizi düzenleyin, dize karşılaştırma sonuçlarına göre açıklamalar, vurgular veya filigranlar ekleyin.

string.Equals'in IronPDF çalışma akışları içinde kullanıldığı örnekleri inceleyelim.

Örnek 1: Çıkartılan Metni string.Equals İle Karşılaştırma

Bir PDF faturasını taradığınızı ve belirli bir şirket adını içerip içermediğini doğrulamak istediğinizi düşünün. Dizin null referans hatası gibi yaygın tuzaklardan nasıl kaçınıldığını ve metodun eşitlik kontrolünün ne kadar güçlü olduğunu gösteren bir örnek burada.

Aşağıdaki örnekte bu PDF kullanılacaktır:

using IronPdf;
using IronPdf.Editing;

class Program
{
    public static void Main(string[] args)
    {
        var pdf = new IronPdf.PdfDocument("invoice.pdf");
        string extractedText = pdf.ExtractAllText();

        var lines = extractedText.Split(new[] { '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);

        foreach (var line in lines)
        {
            if (string.Equals(line.Trim(), "Acme Corporation", StringComparison.OrdinalIgnoreCase))
            {
                Console.WriteLine("Exact match found: Acme Corporation");
            }
        }

    }
}

using IronPdf;
using IronPdf.Editing;

class Program
{
    public static void Main(string[] args)
    {
        var pdf = new IronPdf.PdfDocument("invoice.pdf");
        string extractedText = pdf.ExtractAllText();

        var lines = extractedText.Split(new[] { '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);

        foreach (var line in lines)
        {
            if (string.Equals(line.Trim(), "Acme Corporation", StringComparison.OrdinalIgnoreCase))
            {
                Console.WriteLine("Exact match found: Acme Corporation");
            }
        }

    }
}

Imports Microsoft.VisualBasic
Imports IronPdf
Imports IronPdf.Editing

Friend Class Program
	Public Shared Sub Main(ByVal args() As String)
		Dim pdf = New IronPdf.PdfDocument("invoice.pdf")
		Dim extractedText As String = pdf.ExtractAllText()

		Dim lines = extractedText.Split( { ControlChars.Cr, ControlChars.Lf }, StringSplitOptions.RemoveEmptyEntries)

		For Each line In lines
			If String.Equals(line.Trim(), "Acme Corporation", StringComparison.OrdinalIgnoreCase) Then
				Console.WriteLine("Exact match found: Acme Corporation")
			End If
		Next line

	End Sub
End Class

Not: Metot, iki dize nesnesinin aynı değeri içerip içermediğini gösteren bir boolean değeri döndürür.

Örnek 2: PDF Meta Verilerini string.Equals İle Doğrulama

PDF dosyaları genellikle meta verileri alanlarını içerir, örneğin Başlık, Yazar ve Konu gibi. IronPDF, bu özellikleri okumak için kullanılabilir, bu da onları denetlemeyi ve karşılaştırmayı kolaylaştırır.

using IronPdf;

var pdf = new IronPdf.PdfDocument("invoice.pdf");

string author = pdf.MetaData.Author;

if (string.Equals(author, "Iron Software", StringComparison.InvariantCulture))
{
    Console.WriteLine("Invoice was issued by Iron Software.");
}

using IronPdf;

var pdf = new IronPdf.PdfDocument("invoice.pdf");

string author = pdf.MetaData.Author;

if (string.Equals(author, "Iron Software", StringComparison.InvariantCulture))
{
    Console.WriteLine("Invoice was issued by Iron Software.");
}

Imports IronPdf

Private pdf = New IronPdf.PdfDocument("invoice.pdf")

Private author As String = pdf.MetaData.Author

If String.Equals(author, "Iron Software", StringComparison.InvariantCulture) Then
	Console.WriteLine("Invoice was issued by Iron Software.")
End If

Bu metod, meta verilere dayalı doğrulamanın bir dizgi ya da geçersiz dosyaların işlenmesini önlediği sistemlerde özellikle kullanışlıdır.

Çıktı

Örnek 3: Metin Eşleşmesi Temeline Dayalı Filigran Ekleme

Bazı anahtar kelimeler içeren PDF belgelerine otomatik olarak filigran eklemek isteyebilirsiniz. Bunu nasıl yapacağınız buradadır:

using IronPdf;
using IronPdf.Editing;

License.LicenseKey = "IRONSUITE.WRITERS.21046-907F5E67CC-AHYQW6L-RCHLPMRJMU4G-SET72XAF2JNY-LQK45E5JPLGW-XOLPVBEBLHV7-2LHKZRWUZWMO-5LNIZSPF4BM6-UHUH4R-T4MMJ4MEIYSQEA-DEPLOYMENT.TRIAL-LDG2MK.TRIAL.EXPIRES.16.NOV.2025";

var pdf = new IronPdf.PdfDocument("invoice.pdf");
string content = pdf.ExtractAllText();

var lines = content.Split(new[] { '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);

foreach (var line in lines)
{
    if (string.Equals(line.Trim(), "DRAFT", StringComparison.OrdinalIgnoreCase))
    {
        Console.WriteLine("The document is a draft.");

        // Corrected HTML and CSS
        string watermark = @"<div style='color:red; font-size:72px; font-weight:bold;'>DRAFT</div>";

        pdf.ApplyWatermark(watermark, rotation: 45, opacity: 70,
            verticalAlignment: VerticalAlignment.Middle,
            horizontalAlignment: HorizontalAlignment.Center);

        pdf.SaveAs("watermarked_invoice.pdf");
    }
}

using IronPdf;
using IronPdf.Editing;

License.LicenseKey = "IRONSUITE.WRITERS.21046-907F5E67CC-AHYQW6L-RCHLPMRJMU4G-SET72XAF2JNY-LQK45E5JPLGW-XOLPVBEBLHV7-2LHKZRWUZWMO-5LNIZSPF4BM6-UHUH4R-T4MMJ4MEIYSQEA-DEPLOYMENT.TRIAL-LDG2MK.TRIAL.EXPIRES.16.NOV.2025";

var pdf = new IronPdf.PdfDocument("invoice.pdf");
string content = pdf.ExtractAllText();

var lines = content.Split(new[] { '\r', '\n' }, StringSplitOptions.RemoveEmptyEntries);

foreach (var line in lines)
{
    if (string.Equals(line.Trim(), "DRAFT", StringComparison.OrdinalIgnoreCase))
    {
        Console.WriteLine("The document is a draft.");

        // Corrected HTML and CSS
        string watermark = @"<div style='color:red; font-size:72px; font-weight:bold;'>DRAFT</div>";

        pdf.ApplyWatermark(watermark, rotation: 45, opacity: 70,
            verticalAlignment: VerticalAlignment.Middle,
            horizontalAlignment: HorizontalAlignment.Center);

        pdf.SaveAs("watermarked_invoice.pdf");
    }
}

Imports Microsoft.VisualBasic
Imports IronPdf
Imports IronPdf.Editing

License.LicenseKey = "IRONSUITE.WRITERS.21046-907F5E67CC-AHYQW6L-RCHLPMRJMU4G-SET72XAF2JNY-LQK45E5JPLGW-XOLPVBEBLHV7-2LHKZRWUZWMO-5LNIZSPF4BM6-UHUH4R-T4MMJ4MEIYSQEA-DEPLOYMENT.TRIAL-LDG2MK.TRIAL.EXPIRES.16.NOV.2025"

Dim pdf = New IronPdf.PdfDocument("invoice.pdf")
Dim content As String = pdf.ExtractAllText()

Dim lines = content.Split( { ControlChars.Cr, ControlChars.Lf }, StringSplitOptions.RemoveEmptyEntries)

For Each line In lines
	If String.Equals(line.Trim(), "DRAFT", StringComparison.OrdinalIgnoreCase) Then
		Console.WriteLine("The document is a draft.")

		' Corrected HTML and CSS
		Dim watermark As String = "<div style='color:red; font-size:72px; font-weight:bold;'>DRAFT</div>"

		pdf.ApplyWatermark(watermark, rotation:= 45, opacity:= 70, verticalAlignment:= VerticalAlignment.Middle, horizontalAlignment:= HorizontalAlignment.Center)

		pdf.SaveAs("watermarked_invoice.pdf")
	End If
Next line

string.Equals kullanarak, girdi PDF belgesinin onu taslak olarak işaret edip etmediğini kontrol edebiliriz ve eğer içerdiği belirlenirse, programımız belgeye "DRAFT" filigranını uygulayacak ve kaydedecek.

Çıktı

string.Equals'i IronPDF ile Kullanma İçin En İyi Yöntemler

• Her zaman bir StringComparison belirtin, bu kültür veya büyük-küçük harf farklarından kaynaklı hataları önler.

• Karşılaştırma yaparken kullanıcı girişi veya çıkarılan metin için Trim() veya Normalize() kullan.

• Büyük belgeler için, gerekenden sadece sayfa veya segmenti çıkartarak ağırlığı azalt.

• Hibrit dize eşleşme stratejileri için string.Equals'i Regex veya Contains ile birleştirin.

IronPDF'nin Bunu Kolaylaştırması

IronPDF, geliştiricilerin PDF'lerle etkileşimini kolaylaştırır. C#'ın string.Equals'i ile birleştiğinde, dinamik, zeki PDF çalışma akışları kurmanıza olanak tanır; genellikle ayırıcı kod ya da üçüncü taraf araçları gerekmeden.

StringComparison Seçenekleri Derinlemesine

C#'da dizgi karsilastirilarak, StringComparison seçeneklerinin secimi karsilastirma davranisi ve performansi uzerinde buyuk bir etkiye sahip olabilir. İşte en yaygın kullanılan seçeneklerin hızlı bir özeti:

• Ordinal: Büyük/küçük harf duyarlı ve kültürden bağımsız hızlı bir şekilde bayt-bayt karşılaştırma yapar. Kültürün önemli olmadığı kesin eşleşmeler için en iyisi.

• OrdinalIgnoreCase: Yukarıdaki ile aynıdır ancak büyük/küçük harf farklarını yok sayar. PDF metin çıkarımı gibi büyük/küçük harf tutarsızlıklarının olabileceği senaryolar için idealdir.

• CurrentCulture: Kodun çalıştığı ortamın kültürel kurallarını dikkate alır. Yerel dil normlarına saygı göstermesi gereken kullanıcıya yönelik metinleri karşılaştırırken kullanışlıdır. Şu anki kültürü göz önünde bulundurun, yerelleştirilmiş dize karşılaştırmaları için kullanışlıdır.

• CurrentCultureIgnoreCase: Yukarıdaki ile aynıdır ancak büyük/küçük harf farklarını yok sayar.

• InvariantCulture ve InvariantCultureIgnoreCase: Kültürler arası tutarlı bir karşılaştırma sunarak, küreselleşmiş uygulamalarda dize eşitliği için önemlidir.

Doğru seçeneği seçmek, dize karşılaştırmalarınızın öngörülebilir şekilde davranmasını sağlar. IronPDF ile çıkarılan PDF metni için, OrdinalIgnoreCase genellikle performans ve kullanılabilirlik dengesini sağlamak için en iyi seçenektir.

Geniş PDF belgelere yönelik Performans Hususları

Büyük PDF'lerle etkili bir şekilde başa çıkmak, hızlı uygulamaları sürdürebilmenin anahtarıdır. İşte birkaç ipucu:

• Tüm dosya yerine belirli sayfalardan metin çıkarın.

• Aynı belgeyi birden fazla defa işlerken çıkarılan metni ön belleğe alın.

• Net eşitlik kontrolleri için string.Equals ve alt dize eşleştirmeleri için Contains kullanın, mümkün olduğunda pahalı regex işlemlerinden kaçının.

• Birden fazla PDF ile eşzamanlı olarak başa çıkmak için eşzamanlı işleme veya paralelleştirme kullanın.

• Görünmez karakterler veya biçimlendirme nedeniyle yanlış eşleşmeleri önlemek için karşılaştırmadan önce dizeleri temizleyin ve normalleştirin (string str1, string str2).

Bu teknikleri uygulamak, PDF iş akışlarınızın ölçeklenmesini sağlarken karşılaştırmaların doğru kalmasına yardımcı olur.

Hata Yönetimi ve Hata Ayıklama İpuçları

Çalışma zamanı sorunlarından kaçınmak ve güvenilirliği sağlamak için:

• Karşılaştırmadan önce object obj veya dizeler null olup olmadığını kontrol ederek null değerleri önleyin.

• Çalışma zamanı sırasında metodun ne döndüğünü doğrulamak için çıkarılan içeriği kaydedin.

• Trim() ve normalleştirme kullanarak fazladan boşlukları ve özel Unicode karakterlerini yönetin.

• PDF yükleme ve metin çıkarımı etrafında istisna yönetimi dahil edin.

• Büyük/küçük harf duyarlı ve büyük/küçük harf duyarsız karşılaştırmaları da içeren çeşitli giriş senaryolarını kapsayan birim testleri yazın.

Son Düşünceler

C# string.Equals, IronPDF'nin sağlam PDF özellikleri ile kullanıldığında daha etkili hale gelen basit ama güçlü bir yöntemdir. IronPDF ile meta verileri doğrularken, çıkarılan metni doğrularken veya koşullu lojik uygularken, bu kombinasyon size .NET'teki PDF otomasyon iş akışlarınız üzerinde tam kontrol sağlar.

🔗 Bugün IronPDF ile Başlayın

C# ile zeki PDF iş akışları geliştirmeye hazır mısınız? IronPDF NuGet paketini indirin ve .NET PDF oluşturma, düzenleme ve çıkarımının tüm gücünü keşfedin.

👉 Ücretsiz deneme sürümüyle IronPDF'yi ücretsiz deneyin.