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

string.Equals nedir C# dilinde?

C dizisi eşitleme yöntemi, C#'ta string.Equals olarak bilinir ve ya dizgeleri ya da başka uyumlu nesneleri temsil eden iki parametrenin içeriklerini karşılaştırmak için kullanılır. Sade dize değerleri veya karşılaştırma sırasında dizgisye dönüştürülecek bir tür nesne geçirebilirsiniz. string.Equals kullanarak == operatöründen farklı olarak, eşit dize için ayrıntı sayısına rağmen, şu konularda netlik sağlar:

• Karşılaştırma kurallarını belirtin (örneğin, büyük/küçük harf duyarlı karşılaştırma veya kültür duyarsız karşılaştırma gibi).

• Aşırı yüklenen işleçlerle karışıklığı önleyin.

• Koşullu mantıkta okunabilirliği iyileştirin.

.NET Framework'te, yöntem imzası genellikle şu şekilde görünür:

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 dönüştürme döneceği değerin, karşılaştırma sonucuna bağlı olarak her zaman doğru veya yanlış olacağını belirtir.

T[72] ### Temel Söz Dizimi

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)

Bu yöntem iki parametre alır: karşılaştırılacak iki dize ya da dize nesneleri ve opsiyonel olarak gerçekleştirilecek karşılaştırmanın türü. Gönderilen değer bir booleandır. Karşılaştırma kurallarına göre iki argüman eşitse bu yöntem true döner, aksi halde false döner.

StringComparison seçeneklerini kullanarak iki dizeyi karşılaştırabilirsiniz:

• Ordinal (ikili karşılaştırma, büyük-küçük harf duyarlı karşılaştırma)

• OrdinalIgnoreCase (büyük-küçük harf duyarsız karşılaştırma)

• GeçerliKültür

• DeğişmezKültürBüyükKüçükHarfDuyarsız

IronPDF ile Nasıl Çalışır

IronPDF, PDF belgelerinde metin arama, çıkarma ve manipulasyon yapabilen güçlü bir .NET PDF kütüphanesidir. string.Equals kullanarak:

• Çıkartılmış dizi değerini bilinen bir değere karşılaştırabilirsiniz.

• Başlık, yazar ve anahtar kelimeler gibi meta veri alanlarını kontrol edebilirsiniz.

• PDF belgelerinizi koşullu olarak düzenleyin, böylece string karşılaştırma sonuçlarına göre açıklamalar, vurgular veya filigranlar ekleyebilirsiniz.

string.Equals'un IronıPDF iş akışında faydalı olduğu örnekler üzerinden geçelim.

Örnek 1: Çıkartılan Metni string.Equals ile Karşılaştırın

PDF faturasının taratıldığını ve belirli bir şirket adını içerip içermediğini doğrulamak istediğinizi hayal edin. Null referans istisnası gibi yaygın hata tuzaklarından kaçınmayı ve bu yöntemin eşitliği nasıl güçlü bir şekilde denetlediğini gösteren bir örnek gösterilecektir.

Aşağıda 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: Bu yöntem, iki dize nesnesinin aynı değeri içerip içermediğini belirten bir boole değerini döndürür.

Örnek 2: PDF Meta Verilerini Geçerli Kılma string.Equals Kullanarak

PDF dosyaları genellikle Başlık, Yazar ve Konu gibi meta veri alanları içerir. IronPDF bu özellikleri okuyabilmek için kullanılabilir hale getirilmiştir, bu da onları incelemeyi 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 yöntem, metin ya da geçerli olmayan dosyaların işlenmesini önleyen sistemlerde meta verilere dayanan geçerlilik kontrollerinin özellikle faydalıdır.

Çıktı

Örnek 3: Metin Eşleşmesine Dayanarak Filigran Ekleyin

Bazı anahtar kelimelere sahip olan PDF belgelerine otomatik olarak filigran eklemek isteyebilirsiniz. Bunun nasıl yapılacağını gösteririz:

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 belgesi taslak olarak işaretlenmiş metne sahip olup olmadığını kontrol ederiz ve durum buysa program 'DRAFT' filigranımızı belgeye uygular ve onu kaydeder.

Çıktı

IronPDF ile string.Equals Kullanımının En İyi Uygulamaları

• Her zaman bir StringComparison belirtin, bu kültür veya büyük-küçük harf farklılıklarından kaynaklanan hatalardan sakınır.

• Kullanıcıdan girilen veya çıkarılan metinlerle kıyaslarken Trim() ya da Normalize() kullanın.

• Büyük belgeler için, genel işlemlerden tasarruf etmek için yalnızca gerekli sayfayı veya segmenti çıkarın.

• Karnımız string.Equals kullanarak Regex ya da Contains ile hybrid bir dizge karşılaştırma stratejisi oluşturun.

IronPDF Kolaylaştırarak Neden İyidir

IronPDF, geliştiricilerin PDF'lerle etkileşimini hızlandırır. C#'in string.Equals ile birleştiğinde, ön hazırlık veya üçüncü taraf araçları olmadan dinamik, akıllı PDF iş akışları oluşturmanızı sağlar.

StringComparison Seçeneklerine Derinlemesine Bakış

C#'da dizeleri karşılaştırırken, StringComparison seçeneğinin seçimi karşılaştırmalarınızın davranışını ve performansını büyük ölçüde etkileyebilir. İşte en sık kullanılan seçeneklerin kısa bir özeti:

• Ordinal: Büyük/küçük harfe duyarlı ve kültüre duyarsız hızlı, bayt bazlı bir karşılaştırma yapar. Kültürün önemli olmadığı kesin eşleşmeler için en iyisidir.

• OrdinalIgnoreCase: Yukarıdaki ile aynıdır ancak büyük/küçük harf farklılıklarını göz ardı eder. Büyük/küçük harf tutarsızlıklarının ortaya çıkabileceği PDF metin çıkarımı gibi 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ılara yönelik metinlerin karşılaştırılmasında faydalıdır. Mevcut kültürü dikkate alarak, yerelleştirilmiş dize karşılaştırması için faydalıdır.

• CurrentCultureIgnoreCase: Yukarıdaki ile aynıdır ancak büyük/küçük harfi dikkate almaz.

• InvariantCulture ve InvariantCultureIgnoreCase: Kültürler arası tutarlı bir karşılaştırma sağlayarak, küreselleşmiş uygulamalarda string eşitliği için kritik öneme sahiptir.

Doğru seçeneği seçmek, dizelerinizin beklenildiği şekilde çalıştığından emin olur. IronPDF aracılığıyla çıkarılan PDF metinleri için, OrdinalIgnoreCase genellikle performans ve kullanılabilirlik için en iyi seçimdir.

Büyük PDF Belgeleri için Performans Dikkate Alınması Gerekenler

Büyük PDF'leri verimli şekilde işlemek, yanıt veren uygulamaları devam ettirmenin anahtarıdır. İşte bazı ipuçları:

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

• Aynı belge birçok kez işlenirken çıkarılan metni önbelleğe alın.

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

• Aynı anda birden çok PDF'yi işlemek için asenkron işlem veya paralel işlem kullanın.

• Görünmez karakterler veya biçimlendirme hatalarından kaynaklanan yanlış uyuşmazlıkları önlemek için dizeleri karşılaştırmadan önce temizleyin ve normalize edin (string str1, string str2).

Bu tekniklerin uygulanması, PDF iş akışlarınızın zarif bir şekilde ölçeklenmesine yardımcı olurken karşılaştırmaları doğru tutar.

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

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

• Nesne obj veya dizelerin karşılaştırmadan önce null olup olmadığını kontrol ederek null referans istisnasını önlemek için null değerlere karşı koruma sağlar.

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

• Son boşlukları ve özel Unicode karakterlerini işlemek için Trim() ve normalliği kullanın.

• PDF yükleme ve metin çıkarma etrafında istisna işleme ekleyin.

• Büyük/küçük harf duyarlı ve duyarsız karşılaştırmaları 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 da etkili hale gelen basit ama güçlü bir yöntemdir. İster meta verileri doğruluyor olun, ister çıkarılan metinleri onaylıyor olun, ister koşullu mantık uygulayın, bu kombinasyon size .NET'teki PDF otomasyon iş akışları üzerinde tam kontrol sağlar.

🔗 Bugün IronPDF ile Başlayın

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

👉 Ücretsiz deneme ile IronPDF'yi ücretsiz deneyin.