.NET幫助

C#字符串等於（它如何對開發者起作用）

Name: IronPDF
Brand: Iron Software
Availability: InStock
Rating: 4.87 (307 reviews)

更新:2025年12月20日

在 C# 應用程式中處理 PDF 文件時，不論是檢查擷取的文字、驗證元資料或有條件地修改文件，比較字串都是一項出乎意料的工作。 C# 中的 string.Equals 方法提供了比較字串物件的精確方法，當與 IronPDF for .NET 結合時，它會成為您 PDF 自動化工具包中的強大工具。

在這篇文章中，我們將探討什麼是 string.Equals、為什麼它在 .NET 中很重要，以及您可以如何有效地將它與 IronPDF 搭配使用，IronPDF 是用於產生和操作的領先 .NET PDF 函式庫。

什麼是 C# 中的 string.Equals？

C# 的字串等值方法，在 C# 中稱為 string.Equals，用於比較代表字串或其他相容物件的兩個參數的內容。您可以傳輸純字串值或在比較過程中會轉換為字串的類型物件。與等於字串的語法糖的 == 運算符不同，使用 string.Equals 明確地允許您：

指定比較規則（例如大小寫敏感比較或不依文化的比較）。
避免混淆超載的運算符號。
提高條件邏輯的可讀性。

在 .NET Framework 中，方法簽章通常看起來像這樣：

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)

$vbLabelText $csharpLabel

在此，public bool 表示回傳值永遠為真或假，視比較結果而定。

基本語法

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)

$vbLabelText $csharpLabel

此方法需要兩個參數：要比較的兩個字串或字串物件，以及可選擇要執行的比較類型。回傳值為布林值。根據比較規則，如果兩個參數相等，該方法將返回 true，否則返回 false。

您可以使用不同的 StringComparison 選項來比較兩個字串，例如：

Ordinal (二進位比較，大小寫敏感比較)
OrdinalIgnoreCase（不區分大小寫比較）
CurrentCulture（目前文化）
InvariantCultureIgnoreCase

如何使用 IronPDF

IronPDF for .NET 是一款功能強大的 .NET PDF 函式庫，可讓您在 PDF 文件中搜尋、抽取和處理文字。透過使用 string.Equals，您可以

將擷取的字串值與已知值比較。
檢查元資料欄位，例如標題、作者和關鍵字。
有條件地編輯您的 PDF 文件，讓您可以根據字串比較結果加入註解、高亮部分或水印。

讓我們來看看以下的範例，string.Equals 在 IronPDF 的工作流程中被證明是有用的。

範例 1：使用 string.Equals 比較擷取的文字

想像您正在掃描 PDF 發票，並想要驗證其中是否包含特定的公司名稱。以下是一個範例，說明如何避免常見的陷阱，例如 null reference 異常，以及方法如何強健地檢查相等性。

以下範例將使用此 PDF：

!a href="/static-assets/pdf/blog/csharp-string-equals/csharp-string-equals-1.webp">Input 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

$vbLabelText $csharpLabel

注意：此方法會傳回一個布林值，表示兩個字串物件是否包含相同的值。

為何重要：

正如我們在以下輸出中所看到的，使用 string.Equals 與 StringComparison.OrdinalIgnoreCase 可確保 "ACME CORPORATION" 與 "Acme Corporation" 被視為相等 - 這在 OCR 或文字擷取的情境中非常重要，因為在這些情境中，區分大小寫的差異可能會導致不同的行為。

輸出

!a href="/static-assets/pdf/blog/csharp-string-equals/csharp-string-equals-2.webp">Console Output

範例 2：使用 string.Equals 驗證 PDF 元資料

PDF 檔案通常包含 metadata 欄位，例如標題、作者和主題。 IronPDF 能夠用來讀取這些屬性，方便檢查和比較。

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

$vbLabelText $csharpLabel

此方法對於以元資料為基礎的驗證可防止處理不是字串或無效檔案的系統特別有用。

輸出

!a href="/static-assets/pdf/blog/csharp-string-equals/csharp-string-equals-3.webp">Console Output

範例 3：根據文字匹配添加水印

您可能想要對包含特定關鍵字的 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");
    }
}

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

$vbLabelText $csharpLabel

透過使用 string.Equals，我們能夠檢查輸入的 PDF 文件是否包含標示為草稿的文字，如果是，程式就會在文件上套用我們的"DRAFT"水印並儲存。

輸出

!a href="/static-assets/pdf/blog/csharp-string-equals/csharp-string-equals-4.webp">Watermark output

在 IronPDF 中使用 string.Equals 的最佳做法。

請務必指定 StringComparison，這可避免因文化或大小寫不同而產生的錯誤。
比較使用者輸入或擷取的文字時，請使用 Trim() 或 Normalize()。
對於大型文件，請僅抽取必要的頁面或片段，以減少開銷。
將 string.Equals 與 Regex 或 Contains 結合，以獲得混合字串匹配策略。

為什麼 IronPDF 能夠輕而易舉？

IronPDF 簡化了開發人員與 PDF 互動的方式。結合 C# 的 string.Equals，讓您無需模板或第三方工具即可建立動態、智慧型的 PDF 工作流程。

IronPDF 的主要優點：

全文萃取與解析。
方便存取元資料。
使用原生 C# 邏輯進行條件操作。
不需要像 Adobe 或 MS Office 之類的外部依賴。

深入了解 StringComparison 選項。

在 C# 中比較字串時，StringComparison 選項的選擇會大大影響比較的行為和效能。以下是最常用選項的快速概覽：

Ordinal: 執行快速、逐字節的比較，對大小寫和文化不敏感。最適合用於文化不重要的精確匹配。
OrdinalIgnoreCase：與上述相同，但忽略大小寫的差異。非常適合用於 PDF 文字萃取等可能發生大小寫不一致的情況。
CurrentCulture：考量程式碼執行環境的文化規則。在比較應尊重當地語言規範的面向使用者文字時非常有用，對本地化字串比較很實用。
CurrentCultureIgnoreCase：與上述相同，但忽略大小寫。
InvariantCulture 和 InvariantCultureIgnoreCase: 提供一致的跨文化比較，這對全球化應用程式中的字串平等至關重要。

選擇正確的選項可確保您的字串比較行為可預測。對於透過 IronPDF 擷取的 PDF 文字，OrdinalIgnoreCase 通常是最佳的選擇，可平衡效能與可用性。

大型 PDF 文件的效能考量

有效率地處理大型 PDF 是維持回應式應用程式的關鍵。以下是一些提示：

從特定頁面擷取文字，而非整個檔案。
多次處理相同文件時，可快取擷取的文字。
使用 string.Equals 進行精確的相等檢查，並使用 Contains 進行子串匹配，盡可能避免昂貴的 regex 操作。
利用異步處理或平行化來同時處理多個 PDF。
在比較前先清理並規範化字串，以避免隱形字元或格式化所造成的錯誤不符。

實施這些技術有助於您的 PDF 工作流程在保持比較準確的同時，還能優雅地進行擴充。

錯誤處理與除錯技巧

要避免執行時的問題，並確保可靠性：

防範 null 值，在比較之前檢查物件 obj 或字串是否為 null，以防止 null 參照異常。
記錄擷取的內容，以驗證方法在執行時的回傳內容。
使用 Trim() 和規範化處理尾端空格和特殊的 Unicode 字元。
包括圍繞 PDF 載入和文字萃取的異常處理。
撰寫涵蓋各種輸入情況的單元測試，包括區分大小寫與不區分大小寫的比較。

最後的想法

C# string.Equals 是一種簡單但功能強大的方法，當與 IronPDF 的強大 PDF 功能一起使用時，它會變得更加有效。無論您是驗證元資料、驗證擷取的文字，或是套用條件邏輯，這個組合都能讓您在 .NET 中完全控制 PDF 自動化工作流程。

🔗 立即開始使用 IronPDF

準備好開始使用 C# 建立智慧型 PDF 工作流程了嗎？ 下載 IronPDF NuGet 套件，探索 .NET PDF 生成、編輯和提取的全部功能。

👉免費試用 IronPDF 。

常見問題

string.Equals 方法在 C# 中的用途是什麼？

C# 中的 string.Equals 方法用於比較字串物件是否相等。它提供了一種精確的方法來判斷兩個字串是否具有相同的值，這對於驗證元數據或 PDF 文檔中的提取文本等任務尤為重要。

IronPDF 如何增強 C# 應用程式中 string.Equals 的使用？

IronPDF 可以通過提供強大的 PDF 操作功能來增強 string.Equals 的使用，其中包括從 PDF 文檔中提取文本。這允許開發者將 string.Equals 用於比較和驗證作為 PDF 自動化任務一部分的提取文本。

為什麼字串比較在 PDF 文檔處理中很重要？

字串比較在 PDF 文檔處理中很重要，因為它可使開發者檢查提取的文本，驗證元數據，並根據特定的字串值有條件地修改文件，從而確保數據準確性並符合預期內容。

IronPDF 可以處理 PDF 中的元數據驗證嗎？

是的，IronPDF 可以處理 PDF 中的元數據驗證，允許開發者提取元數據並使用像 string.Equals 的方法來比較並驗證元數據是否符合指定標準。

IronPDF 中有哪些常見任務使用了 string.Equals？

在 IronPDF 中，常見任務包括檢查提取的文本是否符合標準，驗證 PDF 文件的元數據，以及在進一步處理之前確保文件中有特定字串出現。

雅各·梅勒

立即與工程團隊聯繫

技術長

雅各·梅勒（Jacob Mellor）是 Iron Software 的首席技術官，也是一位開創 C# PDF 技術的遠見卓識工程師。作為 Iron Software 核心程式碼庫的原始開發者，他自公司成立以來便塑造了產品架構，並與執行長卡梅隆·里明頓（Cameron Rimington）共同將公司發展為擁有 50 多名員工的企業，服務對象包括 NASA、特斯拉（Tesla）及全球政府機構。

雅各布於曼徹斯特大學（1998–2001）取得土木工程一等榮譽工程學士學位（BEng）。他在 1999 年於倫敦創立首家軟體公司，並於 2005 年開發出首批 .NET 元件，此後專注於解決微軟生態系統中的複雜問題。

其旗艦產品 IronPDF 與 Iron Suite .NET 函式庫在全球已累積超過 3,000 萬次 NuGet 安裝，其基礎程式碼持續驅動著全球廣泛使用的開發者工具。憑藉 25 年商業經驗與 41 年程式設計專業，雅各持續致力於推動企業級 C#、Java 及 Python PDF 技術的創新，同時指導新一代技術領導者。

更新 2026年2月20日

銜接 CLI 簡化與 .NET : 使用 Curl DotNet 與 IronPDF for .NET

Jacob Mellor 藉由 CurlDotNet 彌補了這方面的不足，CurlDotNet 是為了讓 .NET 生態系統能熟悉 cURL 而建立的函式庫。

更新 2025年12月20日

RandomNumberGenerator C#

使用RandomNumberGenerator C#類可以幫助將您的PDF生成和編輯項目提升至新水準

更新 2026年1月18日

C#開關模式匹配（對開發者來說是如何工作的）

當結合使用強大的PDF庫IronPDF時，開關模式匹配可以讓您構建更智能、更清晰的邏輯來進行文檔處理

RandomNumberGenerator C#

C#開關模式匹配（對開發者...

客戶亮點：

開發者焦點：

網路研討會：

立即開始 30天試用

C#字符串等於（它如何對開發者起作用）

什麼是 C# 中的 string.Equals？

基本語法

如何使用 IronPDF

範例 1：使用 string.Equals 比較擷取的文字

為何重要：

範例 2：使用 string.Equals 驗證 PDF 元資料

範例 3：根據文字匹配添加水印

在 IronPDF 中使用 string.Equals 的最佳做法。

為什麼 IronPDF 能夠輕而易舉？

IronPDF 的主要優點：

深入了解 StringComparison 選項。

大型 PDF 文件的效能考量

錯誤處理與除錯技巧

最後的想法

🔗 立即開始使用 IronPDF

常見問題

string.Equals 方法在 C# 中的用途是什麼？

IronPDF 如何增強 C# 應用程式中 string.Equals 的使用？

為什麼字串比較在 PDF 文檔處理中很重要？

IronPDF 可以處理 PDF 中的元數據驗證嗎？

IronPDF 中有哪些常見任務使用了 string.Equals？

鋼鐵支援團隊

立即開始 30天試用

C#字符串等於（它如何對開發者起作用）

什麼是 C# 中的 string.Equals？

基本語法

如何使用 IronPDF

範例 1：使用 string.Equals 比較擷取的文字

為何重要：

範例 2：使用 string.Equals 驗證 PDF 元資料

範例 3：根據文字匹配添加水印

在 IronPDF 中使用 string.Equals 的最佳做法。

為什麼 IronPDF 能夠輕而易舉？

IronPDF 的主要優點：

深入了解 StringComparison 選項。

大型 PDF 文件的效能考量

錯誤處理與除錯技巧

最後的想法

🔗 立即開始使用 IronPDF

常見問題

string.Equals 方法在 C# 中的用途是什麼？

IronPDF 如何增強 C# 應用程式中 string.Equals 的使用？

為什麼字串比較在 PDF 文檔處理中很重要？

IronPDF 可以處理 PDF 中的元數據驗證嗎？

IronPDF 中有哪些常見任務使用了 string.Equals？

相關文章

銜接 CLI 簡化與 .NET : 使用 Curl DotNet 與 IronPDF for .NET

RandomNumberGenerator C#

C#開關模式匹配（對開發者來說是如何工作的）

下一步：開始 30天試用

Thank You

下一步：開始 30天試用

Want to deploy IronSuite to a live project for FREE?

What’s included?

獲得全球數百萬工程師的信賴

鋼鐵支援團隊