C# String Equals (Comment ça fonctionne pour les développeurs)

Qu'est-ce que string.Equals en C# ?

La méthode C string equals, connue en C# sous le nom de string.Equals, est utilisée pour comparer le contenu de deux paramètres représentant soit des chaînes soit d'autres objets compatibles. Vous pouvez passer soit des valeurs de chaîne simples, soit un objet de type qui sera converti en chaîne lors de la comparaison. Contrairement à l'opérateur ==, qui est sucre syntaxique pour equals chaine, utiliser string.Equals explicitement vous permet de :

• Spécifier des règles de comparaison (telles que la comparaison sensible à la casse ou insensible à la culture).

• Éviter la confusion avec les opérateurs surchargés.

• Améliorer la lisibilité dans la logique conditionnelle.

Dans le .NET Framework, la signature de la méthode ressemble souvent à :

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)

Ici, public bool indique que la valeur de retour sera toujours true ou false selon le résultat de la comparaison.

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)

Comment cela fonctionne avec IronPDF

IronPDF est une puissante bibliothèque PDF .NET qui vous permet de rechercher, extraire et manipuler du texte dans des documents PDF. En utilisant string.Equals, vous pouvez :

• Comparer la valeur de chaîne extraite à une valeur connue.

• Vérifier les champs de métadonnées comme le titre, l'auteur et les mots-clés.

• Éditer conditionnellement vos documents PDF, vous permettant d'ajouter des annotations, des surlignages ou des filigranes basés sur les résultats de comparaison de chaînes.

Parcourons les exemples suivants où string.Equals s'avère utile dans les workflows IronPDF.

Exemple 1 : Comparer le texte extrait avec string.Equals

Imaginez que vous scannez une facture PDF et souhaitez valider si elle inclut un nom d'entreprise spécifique. Voici un exemple démontrant comment éviter les pièges courants comme l'exception de référence null et comment la méthode vérifie l'égalité de manière robuste.

L'exemple suivant utilisera ce PDF :

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

Remarque : La méthode retourne une valeur booléenne indiquant si les deux objets chaîne contiennent la même valeur.

Exemple 2 : Valider les métadonnées PDF en utilisant string.Equals

Les fichiers PDF contiennent souvent des métadonnées comme le titre, l'auteur et le sujet. IronPDF peut être utilisé pour lire ces propriétés, rendant facile leur inspection et leur comparaison.

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

Cette méthode est particulièrement utile dans les systèmes où la validation basée sur les métadonnées empêche le traitement de fichiers qui ne sont pas une chaîne ou des fichiers invalides.

Sortie

Exemple 3 : Ajouter un filigrane basé sur la correspondance de texte

Vous pouvez vouloir filigraner automatiquement les documents PDF qui contiennent certains mots-clés. Voici comment faire cela :

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

En utilisant string.Equals, nous pouvons vérifier si le document PDF d'entrée contient le texte le marquant comme brouillon, et si c'est le cas, le programme appliquera notre filigrane "DRAFT" sur le document et le sauvegardera.

Sortie

Meilleures pratiques pour l'utilisation de string.Equals avec IronPDF

• Spécifiez toujours une StringComparison, cela évite les bugs dus aux différences de culture ou de casse.

• Utilisez Trim() ou Normalize() lors de la comparaison de texte saisi par l'utilisateur ou extrait.

• Pour les grands documents, extrayez uniquement la page ou le segment nécessaire pour réduire la surcharge.

• Combinez string.Equals avec Regex ou Contains pour des stratégies de correspondance de chaînes hybrides.

Pourquoi IronPDF facilite les choses

IronPDF simplifie la façon dont les développeurs interagissent avec les PDF. Combinée avec string.Equals de C#, elle vous permet de créer des workflows PDF dynamiques et intelligents sans code répétitif ou outils tiers.

Plongée approfondie dans les options StringComparison

Lors de la comparaison de chaînes en C#, le choix de l'option StringComparison peut avoir un impact significatif sur le comportement et les performances de vos comparaisons. Voici un aperçu rapide des options les plus couramment utilisées :

• Ordinal : Effectue une comparaison rapide, octet par octet, sensible à la casse et insensible à la culture. Idéal pour les correspondances exactes où la culture n'a pas d'importance.

• OrdinalIgnoreCase : Identique à ci-dessus mais ignore les différences de casse. Idéal pour les scénarios tels que l'extraction de texte PDF où des incohérences de casse peuvent se produire.

• CurrentCulture : Prend en compte les règles culturelles de l'environnement où le code s'exécute. Utile lorsque vous comparez du texte destiné aux utilisateurs qui doit respecter les normes linguistiques locales. Tenez compte de la culture actuelle, utile pour la comparaison de chaînes localisées.

• CurrentCultureIgnoreCase : Identique à ci-dessus mais ignore la casse.

• InvariantCulture et InvariantCultureIgnoreCase : Fournissent une comparaison cohérente à travers les cultures, ce qui est crucial pour l'égalité des chaînes dans les applications mondialisées.

Choisir l'option correcte garantit que vos comparaisons de chaînes se comportent de manière prévisible. Pour le texte PDF extrait via IronPDF, OrdinalIgnoreCase est souvent le meilleur choix, équilibrant performance et convivialité.

Considérations de performance pour les grands documents PDF

Gérer efficacement les grands PDF est essentiel pour maintenir des applications réactives. Voici quelques conseils :

• Extrayez le texte de pages spécifiques plutôt que de l'ensemble du fichier.

• Mémorisez le texte extrait lorsque vous traitez plusieurs fois le même document.

• Utilisez string.Equals pour des vérifications d'égalité exactes et Contains pour des correspondances de sous-chaînes, en évitant les opérations d'expressions régulières coûteuses autant que possible.

• Utilisez un traitement asynchrone ou la parallélisation pour gérer plusieurs PDF simultanément.

• Nettoyez et normalisez les chaînes (chaîne str1, chaîne str2) avant la comparaison pour éviter les discordances causées par des caractères invisibles ou de formatage.

La mise en œuvre de ces techniques aide vos workflows PDF à évoluer de manière fluide tout en maintenant des comparaisons précises.

Conseils de gestion d'erreurs et de débogage

Pour éviter les problèmes d'exécution et assurer la fiabilité :

• Protégez-vous contre les valeurs nulles pour éviter l'exception de null référence en vérifiant si l'objet obj ou les chaînes sont null avant comparaison.

• Journalisez le contenu extrait pour vérifier ce que la méthode retourne lors de l'exécution.

• Utilisez Trim() et la normalisation pour gérer les espaces traînants et les caractères Unicode spéciaux.

• Incluez une gestion des exceptions autour du chargement de PDF et de l'extraction de texte.

• Écrivez des tests unitaires qui couvrent divers scénarios d'entrée, y compris les comparaisons sensibles à la casse et insensibles à la casse.

Conclusion

C# string.Equals est une méthode simple mais puissante qui devient encore plus efficace lorsqu'elle est utilisée avec les fonctionnalités robustes de IronPDF. Que vous vérifiiez les métadonnées, validiez du texte extrait ou appliquiez une logique conditionnelle, cette combinaison vous donne un contrôle total sur vos workflows d'automatisation PDF dans .NET.

🔗 Commencez avec IronPDF dès aujourd'hui

Prêt à commencer à construire des workflows PDF intelligents avec C# ? Téléchargez le package NuGet IronPDF et explorez toute la puissance de la génération, de l'édition et de l'extraction PDF .NET.

👉 Essayez IronPDF gratuitement avec la version d'essai.