C# String Methods（開発者向けの仕組み）

主要機能

• HTML から PDF への変換: HTML コンテンツを完全にスタイル設定された PDF に簡単に変換できます。 *テキスト抽出:既存の PDF からテキストを抽出し、操作します。
• PDF 編集: PDF にテキスト、画像、注釈を追加したり、既存のコンテンツを更新したりします。 *デジタル署名: PDF に安全なデジタル署名を追加します。
• PDF/A コンプライアンス: PDF が厳格なアーカイブ標準を満たしていることを確認します。 *クロスプラットフォーム サポート: Windows、Linux、macOS の .NET Framework、.NET Core、.NET 5/6 で動作します。

IronPDFは、あらゆるPDFニーズを容易かつ効率的に処理するための包括的なツールセットを提供します。 今すぐ無料トライアルで強力な機能を探索し、PDFワークフローを効率化する方法を体験してください！

結合

結合は文字列を操作する際の最も基本的な操作の一つです。 C#では、複数の文字列を結合する方法がいくつかあり、最も一般的な方法は+演算子とString.Concat()です。

string text1 = "Hello";
string text2 = "World";
string result = text1 + " " + text2;  // Output: "Hello World"

string text1 = "Hello";
string text2 = "World";
string result = text1 + " " + text2;  // Output: "Hello World"

IronPDFを使用する際には、ドキュメント全体を作成するために文字列を結合したり、抽出されたコンテンツのテキストを操作したりする必要があります。 例えば、PDFドキュメントのヘッダーと本文を文字列として結合してからフォーマットを適用することができます。

var pdfText = "Header: " + extractedHeader + "\n" + "Body: " + extractedBody;

var pdfText = "Header: " + extractedHeader + "\n" + "Body: " + extractedBody;

これは、指定されたサブストリングを一つのまとまりのあるブロックにマージするための単純な文字列結合の方法を示しています。 後ほど見るように、このように結合された文字列を使用してPDF用の動的なコンテンツを構築することができます。

PDF出力:

PDF出力文字列

IronPDFを使用して新しいドキュメントを作成する際には、文字列のインデックス位置が、ヘッダーや本文などの要素がページ上に現れる位置を決定するために重要です。 このようにして、現在の文字列オブジェクトはレイアウトの決定に直接影響を与えることができます。

PDFにおけるテキストのフォーマット

テキストを抽出して操作した後で、新しいPDFに追加する前にフォーマットする必要があります。 IronPDFでは、RenderHtmlAsPdf変換機能を使用して、フォントスタイルやサイズ、位置などを設定することができ、C#の文字列メソッドを使用してフォーマットされたコンテンツを動的に生成できます。

例えば、HTMLタグを使用して文字列を結合することで、動的なヘッダーやボディコンテンツを作成できます。

string htmlContent = "<h1>" + headerText + "</h1>" + "<p>" + bodyText + "</p>";

string htmlContent = "<h1>" + headerText + "</h1>" + "<p>" + bodyText + "</p>";

このHTMLコンテンツは、IronPDFを使用してきちんとフォーマットされたPDFに変換することができます。

PdfDocument pdf = HtmlToPdf.ConvertHtmlString(htmlContent);
pdf.SaveAs("formattedDocument.pdf");

PdfDocument pdf = HtmlToPdf.ConvertHtmlString(htmlContent);
pdf.SaveAs("formattedDocument.pdf");

PDF出力:

このアプローチにより、動的に生成されたコンテンツでPDFを簡単に作成し、適切なテキストフォーマットを確保します。 動的コンテンツから新しい文字列を生成することにより、HTMLコンテンツのフォーマットされた文字列配列をIronPDFに渡し、PDF出力が要件に合致していることを確認します。

指定されたサブストリングの検索

多くの場合、文字列が指定されたサブストリングを含んでいるかどうかを確認する必要があります。 Contains()メソッドはこれに役立ち、指定された文字列が対象の文字列内に存在するかどうかに基づいてtrueまたはfalseを返します。

string documentText = "Invoice Number: 12345";
bool containsInvoiceNumber = documentText.Contains("Invoice Number");

string documentText = "Invoice Number: 12345";
bool containsInvoiceNumber = documentText.Contains("Invoice Number");

文字の指定位置の検索

文字列内で指定された文字を検索するためには、IndexOf()メソッドが特に便利です。 文字やサブストリングが文字列内で最初に現れる指定位置を返します。

string str = "Invoice Number: 12345";
int position = str.IndexOf('5'); // Returns the position of the first '5'

string str = "Invoice Number: 12345";
int position = str.IndexOf('5'); // Returns the position of the first '5'

これは、IronPDFを使用してPDF内のテキストから数字や日付などの動的データを抽出する際に便利です。

正規表現

より複雑なテキスト抽出のためには、正規表現（Regex）がパターンマッチングに強力なツールを提供します。 Regexを使用すると、非構造化データ内から、日付や請求書番号、電子メールアドレスなどの構造化データを抽出できます。

using System.Text.RegularExpressions;

string text = "Date: 02/11/2025";
Match match = Regex.Match(text, @"\d{2}/\d{2}/\d{4}");
if (match.Success)
{
    string date = match.Value;  // Output: "02/11/2025"
}

using System.Text.RegularExpressions;

string text = "Date: 02/11/2025";
Match match = Regex.Match(text, @"\d{2}/\d{2}/\d{4}");
if (match.Success)
{
    string date = match.Value;  // Output: "02/11/2025"
}

特に可変コンテンツを持つドキュメントや、キャプチャする必要がある特定のフォーマットには、正規表現が役立ちます。 IronPDFを使用して生のテキストを抽出し、正規表現と組み合わせることで、フォーム処理、データ検証、レポート作成などのタスクを自動化できます。

大文字列のためのStringBuilder

複数ページのコンテンツやデータ駆動型レポートのように大きなテキストブロックを扱う際には、通常の文字列結合の代わりにStringBuilderを使用する方が効率的です。 StringBuilderは、大量のテキストを追加または修正する必要がある場合に複数の中間文字列インスタンスを生成せずに済むように最適化されています。

StringBuilder sb = new StringBuilder();
sb.AppendLine("Header: " + headerText);
sb.AppendLine("Content: " + bodyText);
string finalText = sb.ToString();

StringBuilder sb = new StringBuilder();
sb.AppendLine("Header: " + headerText);
sb.AppendLine("Content: " + bodyText);
string finalText = sb.ToString();

IronPDFは大規模なPDFドキュメントを扱うことができ、ワークフローにStringBuilderを統合することで、PDF内の大規模なテキスト生成や操作時のパフォーマンスを向上させることができます。

文字列インスタンスがパターンに一致するかの確認

Equals()メソッドは、2つの文字列インスタンスが同じ値を持つかどうかをチェックします。 これは、PDFコンテンツ内での検証や比較に特に役立ちます。

string str1 = "Invoice";
string str2 = "Invoice";
bool isMatch = str1.Equals(str2); // Returns true as both have the same value

string str1 = "Invoice";
string str2 = "Invoice";
bool isMatch = str1.Equals(str2); // Returns true as both have the same value

IronPDFでは、抽出されたテキストを比較して、希望のフォーマットや値に一致していることを確認する際に適用できます。

Unicode文字の扱い

PDF内のテキストを操作する際には、指定されたUnicode文字を操作したり確認したりする必要があります。 IndexOf()メソッドは、文字列内の特定のユニコード文字の位置を見つけるためにも使用できます。

string unicodeStr = "Hello * World";
int unicodePosition = unicodeStr.IndexOf('*'); // Finds the position of the unicode character

string unicodeStr = "Hello * World";
int unicodePosition = unicodeStr.IndexOf('*'); // Finds the position of the unicode character

PDF出力

異なる言語や記号のテキストを扱う際に便利なのが、文字列をユニコード文字配列に変換することです。

char[] unicodeArray = "Hello * World".ToCharArray();

char[] unicodeArray = "Hello * World".ToCharArray();

これにより、特にさまざまな言語やフォーマットのPDFを扱う際の文字操作がより精密に行えます。

サブストリングの抽出と操作

文字列を操作する際のもう一つの強力な機能は、指定されたサブストリングを抽出する能力です。 Substring()メソッドを使用することで、指定されたインデックス位置から文字列の一部を選択できます。 これは、PDFコンテンツから意味のあるデータを抽出するために不可欠です。

string sentence = "Total: $45.00";
string totalAmount = sentence.Substring(7); // Extracts "$45.00"

string sentence = "Total: $45.00";
string totalAmount = sentence.Substring(7); // Extracts "$45.00"

この手法は、PDF内の請求書やあらゆる形式の構造化テキストを処理する際に役立ちます。

例: カスタム請求書PDFの作成

顧客の名前や住所、購入したアイテムなどの情報を動的に引き出して、請求書PDFを生成する必要があると想像してみてください。 各データをフォーマットし操作するためにさまざまな文字列メソッドを使用してから、最終的なPDFを生成します。

using IronPdf;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        // Sample customer data
        string customerName = "John Doe";
        string customerAddress = "123 Main Street, Springfield, IL 62701";
        string[] purchasedItems = { "Item 1 - $10.00", "Item 2 - $20.00", "Item 3 - $30.00" };

        // Start building the HTML content for the invoice
        StringBuilder invoiceContent = new StringBuilder();

        // Adding the header
        invoiceContent.AppendLine("<h1>Invoice</h1>");
        invoiceContent.AppendLine("<h2>Customer Details</h2>");
        invoiceContent.AppendLine("<p><strong>Name:</strong> " + customerName + "</p>");
        invoiceContent.AppendLine("<p><strong>Address:</strong> " + customerAddress + "</p>");

        // Adding the list of purchased items
        invoiceContent.AppendLine("<h3>Items Purchased</h3>");
        invoiceContent.AppendLine("<ul>");
        foreach (var item in purchasedItems)
        {
            invoiceContent.AppendLine("<li>" + item + "</li>");
        }
        invoiceContent.AppendLine("</ul>");

        // Calculate total cost (basic manipulation with string methods)
        double totalCost = 0;
        foreach (var item in purchasedItems)
        {
            string priceString = item.Substring(item.LastIndexOf('$') + 1);
            double price = Convert.ToDouble(priceString);
            totalCost += price;
        }

        // Adding total cost
        invoiceContent.AppendLine("<p><strong>Total Cost:</strong> $" + totalCost.ToString("F2") + "</p>");

        // Convert the HTML to PDF using IronPDF
        var pdf = HtmlToPdf.ConvertHtmlString(invoiceContent.ToString());

        // Save the generated PDF
        pdf.SaveAs("Invoice_Johndoe.pdf");
        Console.WriteLine("Invoice PDF generated successfully.");
    }
}

using IronPdf;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        // Sample customer data
        string customerName = "John Doe";
        string customerAddress = "123 Main Street, Springfield, IL 62701";
        string[] purchasedItems = { "Item 1 - $10.00", "Item 2 - $20.00", "Item 3 - $30.00" };

        // Start building the HTML content for the invoice
        StringBuilder invoiceContent = new StringBuilder();

        // Adding the header
        invoiceContent.AppendLine("<h1>Invoice</h1>");
        invoiceContent.AppendLine("<h2>Customer Details</h2>");
        invoiceContent.AppendLine("<p><strong>Name:</strong> " + customerName + "</p>");
        invoiceContent.AppendLine("<p><strong>Address:</strong> " + customerAddress + "</p>");

        // Adding the list of purchased items
        invoiceContent.AppendLine("<h3>Items Purchased</h3>");
        invoiceContent.AppendLine("<ul>");
        foreach (var item in purchasedItems)
        {
            invoiceContent.AppendLine("<li>" + item + "</li>");
        }
        invoiceContent.AppendLine("</ul>");

        // Calculate total cost (basic manipulation with string methods)
        double totalCost = 0;
        foreach (var item in purchasedItems)
        {
            string priceString = item.Substring(item.LastIndexOf('$') + 1);
            double price = Convert.ToDouble(priceString);
            totalCost += price;
        }

        // Adding total cost
        invoiceContent.AppendLine("<p><strong>Total Cost:</strong> $" + totalCost.ToString("F2") + "</p>");

        // Convert the HTML to PDF using IronPDF
        var pdf = HtmlToPdf.ConvertHtmlString(invoiceContent.ToString());

        // Save the generated PDF
        pdf.SaveAs("Invoice_Johndoe.pdf");
        Console.WriteLine("Invoice PDF generated successfully.");
    }
}

説明