.NET ヘルプ

C# String.Format（開発者向けの動作方法）

公開済み 2024年8月11日

共有:

C#プログラミングの多様性の中で、効果的な文字列操作は明確で動的な出力を表示するための基礎となります。 String.Format メソッドは強力なツールとして現れ、開発者に文字列をフォーマットするための多用途で表現力豊かな手段を提供します。 String.Formatメソッドを適切に使用し、C#でカスタムフォーマット文字列を作成するには、Microsoftの公式.NETドキュメントサイトのドキュメントを参照してください：[String.Format メソッド**](https://learn.microsoft.com/en-us/dotnet/api/system.string.format?view=net-8.0).

この包括的なガイドでは、String Format の複雑さ、その構文、使用方法、およびC#における文字列フォーマットを効率的に向上させる方法について探ります。

基本を理解する:

String.Formatとは何ですか？

その核心には、String.Format はプレースホルダーを対応する値と置き換えることによって文字列をフォーマットするように設計されたメソッドです。このメソッドはC#のSystem.Stringクラスの一部であり、整ったカスタマイズ可能な文字列を作成する上で重要な役割を果たします。

文字列の書式設定の構文

String Formatメソッドの構文は、プレースホルダーを含むフォーマットアイテムを使用し、その後に置換される値を続けます。以下は基本的な例です:

string formattedString = string.Format("Hello, {0}! Today is {1}.", "John", DateTime.Now.DayOfWeek);

string formattedString = string.Format("Hello, {0}! Today is {1}.", "John", DateTime.Now.DayOfWeek);

Dim formattedString As String = String.Format("Hello, {0}! Today is {1}.", "John", DateTime.Now.DayOfWeek)

VB C#

この例では、である。{0} とである。{1} はプレースホルダーであり、その後に続く引数(「John」とDateTime.Now.DayOfWeek)定型書式文字列のこれらのプレースホルダーを置き換えます。

数値および日付/時刻の書式設定

String.Format の強力な機能の一つは、特定のパターンに従って数値や日付/時刻の値をフォーマットできる点です。例えば：

decimal price = 19.95m; 
DateTime currentDate = DateTime.Now;

string formattedNumeric = string.Format("Price: {0:C}", price);
string formattedDate = string.Format("Today's date: {0:yyyy-MM-dd}", currentDate);

decimal price = 19.95m; 
DateTime currentDate = DateTime.Now;

string formattedNumeric = string.Format("Price: {0:C}", price);
string formattedDate = string.Format("Today's date: {0:yyyy-MM-dd}", currentDate);

Dim price As Decimal = 19.95D
Dim currentDate As DateTime = DateTime.Now

Dim formattedNumeric As String = String.Format("Price: {0:C}", price)
Dim formattedDate As String = String.Format("Today's date: {0:yyyy-MM-dd}", currentDate)

VB C#

このスニペットでは、**{以下の内容を日本語に翻訳しました：

IronPDF for .NETの使い方

IronPDF for .NETは、PDFファイルの生成、編集、読み取り、変換を可能にする強力なライブラリです。このライブラリを使用すると、C#やVB.NETなどの.NET言語でPDF操作を簡単に行うことができます。

主要機能:

PDFの生成: HTML、ASPX、MVCからPDFドキュメントを生成することができます。
PDFの編集: テキスト、画像、ページをPDFに追加または削除できます。
PDFの読み取り: PDFからテキストや画像を抽出できます。
PDFへの変換: 各種ファイル形式を簡単にPDFに変換できます。

サンプルコード:

var Renderer = new IronPdf.ChromePdfRenderer();
var PDF = Renderer.RenderHtmlAsPdf("Hello World");
PDF.SaveAs("example.pdf");

var Renderer = new IronPdf.ChromePdfRenderer();
var PDF = Renderer.RenderHtmlAsPdf("Hello World");
PDF.SaveAs("example.pdf");

Dim Renderer = New IronPdf.ChromePdfRenderer()
Dim PDF = Renderer.RenderHtmlAsPdf("Hello World")
PDF.SaveAs("example.pdf")

VB C#

IronOCR for .NETの概要

IronOCR for .NETは、OCR（文字認識）技術を使用して画像やPDFからテキストを抽出するライブラリです。高精度の認識エンジンを備え、さまざまなフォーマットをサポートしています。

主要機能:

画像からのテキスト抽出: JPG、PNGなどの画像形式をサポート。
PDFからのテキスト抽出: スキャンしたPDFからもテキストを抽出可能。
多言語サポート: 日本語を含む複数の言語を認識します。

サンプルコード:

var Ocr = new IronOcr.AutoOcr();
var Result = Ocr.Read("image.png");
Console.WriteLine(Result.Text);

var Ocr = new IronOcr.AutoOcr();
var Result = Ocr.Read("image.png");
Console.WriteLine(Result.Text);

Dim Ocr = New IronOcr.AutoOcr()
Dim Result = Ocr.Read("image.png")
Console.WriteLine(Result.Text)

VB C#

IronXL for .NETの特徴

IronXL for .NETは、Excelファイルの生成、読み取り、編集を行うためのライブラリです。これにより、プログラムから直接Excelを操作することができます。

主要機能:

Excelの生成: 新しいExcelファイルを作成しデータを入力可能。
Excelの編集: 既存のExcelファイルにデータを追加、更新可能。
Excelの読み取り: Excelファイルからセルの値や範囲を読み取ります。

サンプルコード:

using IronXL;
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var sheet = workbook.CreateWorkSheet("SampleSheet");
sheet["A1"].Value = "Hello World";
workbook.SaveAs("example.xlsx");

using IronXL;
var workbook = WorkBook.Create(ExcelFileFormat.XLSX);
var sheet = workbook.CreateWorkSheet("SampleSheet");
sheet["A1"].Value = "Hello World";
workbook.SaveAs("example.xlsx");

Imports IronXL
Private workbook = WorkBook.Create(ExcelFileFormat.XLSX)
Private sheet = workbook.CreateWorkSheet("SampleSheet")
Private sheet("A1").Value = "Hello World"
workbook.SaveAs("example.xlsx")

VB C#

これらの強力なライブラリを使用することで、開発者は迅速かつ効率的にPDF、画像、Excelファイルを操作することができます。詳しくは公式サイトをご覧ください。

以上が翻訳内容です。技術用語やライブラリ名はそのままにしていますので、適切に理解できるはずです。}は数値を通貨としてフォーマットし、{0:yyyy-MM-dd}**指定されたパターンに従って日付をフォーマットします。

数値インデックスを持つ複数の形式項目

C#では、string.Formatメソッドを使用することで、開発者はフォーマット文字列内に数値インデックスをプレースホルダーとして使用できます。これは、対応する値を特定の順序で挿入するのに役立ちます。

string formattedNamed = string.Format("Hello, {0}! Your age is {1}.", "Alice", 30);

string formattedNamed = string.Format("Hello, {0}! Your age is {1}.", "Alice", 30);

Dim formattedNamed As String = String.Format("Hello, {0}! Your age is {1}.", "Alice", 30)

VB C#

ここでは、である。{0} とである。{1} は数値プレースホルダーであり、値は string.Format メソッドに渡された引数の順序で提供されます。

C# では、数値インデックスのように string.Format メソッドで名前付きプレースホルダーをサポートしていません。名前付きのプレースホルダーが必要な場合は、文字列補間や外部ライブラリによって提供される他の方法を使用するべきです。以下は文字列補間式の例です：

文字列補間式

C# 6.0で導入された文字列補間は、開発者が文字列リテラル内に直接式を使用できるようにし、コードの可読性を高め、引数の順序を変更する際のエラーのリスクを減らします。

var name = "Alice";
var age = 30;
string formattedNamed = $"Hello, {name}! Your age is {age}.";

var name = "Alice";
var age = 30;
string formattedNamed = $"Hello, {name}! Your age is {age}.";

Dim name = "Alice"
Dim age = 30
Dim formattedNamed As String = $"Hello, {name}! Your age is {age}."

VB C#

この例では、である。{名前} と**である。{年齢}文字列内で直接評価され、値はそれぞれの変数によって提供されます。

配置と間隔

String.Format は、フォーマットされた値の整列と間隔を正確に制御します。アイテムのフォーマットに配置と幅の指定を追加することで、開発者は整然とした出力を作成することができます。 C#でのスペーシング制御は、String.Formatを使用して挿入する文字列の幅を指定することにより、先行または後続のスペースを正確に制御できます。たとえば、販売レポートで製品名と価格を整列させることを考慮してください。

string[] products = { "Laptop", "Printer", "Headphones" };
decimal[] prices = { 1200.50m, 349.99m, 99.95m };

Console.WriteLine(String.Format("{0,-15} {1,-10}\n", "Product", "Price"));

for (int index = 0; index < products.Length; index++)
{
    string formattedProduct = String.Format("{0,-15} {1,-10:C}", products[index], prices[index]);
    Console.WriteLine(formattedProduct);
}

string[] products = { "Laptop", "Printer", "Headphones" };
decimal[] prices = { 1200.50m, 349.99m, 99.95m };

Console.WriteLine(String.Format("{0,-15} {1,-10}\n", "Product", "Price"));

for (int index = 0; index < products.Length; index++)
{
    string formattedProduct = String.Format("{0,-15} {1,-10:C}", products[index], prices[index]);
    Console.WriteLine(formattedProduct);
}

Imports Microsoft.VisualBasic

Dim products() As String = { "Laptop", "Printer", "Headphones" }
Dim prices() As Decimal = { 1200.50D, 349.99D, 99.95D }

Console.WriteLine(String.Format("{0,-15} {1,-10}" & vbLf, "Product", "Price"))

For index As Integer = 0 To products.Length - 1
	Dim formattedProduct As String = String.Format("{0,-15} {1,-10:C}", products(index), prices(index))
	Console.WriteLine(formattedProduct)
Next index

VB C#

この例では、{0、-15} とである。{1, -10}「Product」と「Price」ラベルの幅を制御するフォーマットは、左揃えを保証し、前後にスペースを含むことができます。ループは製品名と価格でテーブルを埋め、その結果として間隔を正確に制御したきれいにフォーマットされた販売レポートを作成します。これらの幅パラメータを調整することで、表示されるデータの整列と間隔を効果的に管理できます。

三項演算子による条件付き書式設定

String.Formatを使った三項演算子の利用により、特定の条件に基づいた条件付きフォーマットが可能になります。例えば:

int temperature = 25;
string weatherForecast = string.Format("The weather is {0}.", temperature > 20 ? "warm" : "cool");

int temperature = 25;
string weatherForecast = string.Format("The weather is {0}.", temperature > 20 ? "warm" : "cool");

Dim temperature As Integer = 25
Dim weatherForecast As String = String.Format("The weather is {0}.",If(temperature > 20, "warm", "cool"))

VB C#

以下では、天気の説明は気温に基づいて変わります。

複合書式設定

C#でオブジェクトの表示を改善するために、「複合書式文字列」とも呼ばれる書式文字列を取り入れて、文字列表現を制御します。たとえば、{0:d

(Note: Since "0:d" is a technical term and its format is essential, it remains unchanged in Japanese.)}記法はリスト内の最初のオブジェクトに "d" フォーマット指定子を適用します。フォーマット済み文字列やコンポジットフォーマッティング機能の文脈では、これらのフォーマット指定子は数値、小数点、日時、およびカスタムタイプをどのように表示するかを指示します。

以下のように、複合フォーマット文字列と文字列補間を組み合わせた単一オブジェクトと2つのフォーマットアイテムの例です:

string formattedDateTime = $"It is now {DateTime.Now:d} at {DateTime.Now:t}"; Console.WriteLine(formattedDateTime); // Output similar to: 'It is now 4/10/2015 at 10:04 AM'

string formattedDateTime = $"It is now {DateTime.Now:d} at {DateTime.Now:t}"; Console.WriteLine(formattedDateTime); // Output similar to: 'It is now 4/10/2015 at 10:04 AM'

Dim formattedDateTime As String = $"It is now {DateTime.Now:d} at {DateTime.Now:t}"
Console.WriteLine(formattedDateTime) ' Output similar to: 'It is now 4/10/2015 at 10:04 AM'

VB C#

このアプローチでは、オブジェクトの文字列表現を特定の形式にカスタマイズすることができ、より制御された視覚的に魅力的な出力を促進します。補間された文字列には変数が直接含まれており、よりクリーンな構文を提供します。

IronPDFの紹介

IronPDFウェブページ

IronPDFはC#のライブラリで、次のような機能を提供します。HTMLを使用したPDFドキュメントの作成。, **PDFファイルからのテキスト抽出、およびPDFでの改訂と履歴管理。. それは、C#アプリケーション内でPDFファイルを生成、修正、およびレンダリングするための包括的なツールセットを開発者に提供します。 IronPDFを使用すると、開発者は特定の要件に合わせた洗練された視覚的に魅力的なPDFドキュメントを作成できます。

IronPDFのインストール: クイックスタート

C#プロジェクトでIronPDFライブラリを利用し始めるには、簡単にIronPdf NuGetパッケージをインストールできます。次のコマンドをパッケージマネージャーコンソールで使用してください:

Install-Package IronPdf

Install-Package IronPdf

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'Install-Package IronPdf

VB C#

または、NuGetパッケージマネージャーで「IronPDF」を検索し、そこからインストールすることもできます。

C# String.Format の多様性

C#のString.Formatメソッドは、フォーマットされた文字列を作成する際の多用途性で有名です。それは、開発者がフォーマット文字列の中にプレースホルダーを定義し、対応する値と置き換えることを可能にし、文字列出力に対する正確な制御を提供します。数値、日付/時刻情報を整形し、テキストを整列する機能によって、String.Formatは明瞭で構造化されたテキスト・コンテンツを作成するための不可欠なツールとなります。

IronPDFとのString.Formatの統合

String.Format をIronPDFに統合する際、答えは明確に「はい」です。 String.Format によって提供されるフォーマット機能は、IronPDFの機能を使用してPDFドキュメントに組み込まれるコンテンツを動的に生成するために利用できます。

以下の簡単な例を考えてみましょう:

using IronPdf;

class PdfGenerator
{
    public static void GeneratePdf(string customerName, decimal totalAmount)
    {
        // Format the content dynamically using String.Format
        string formattedContent = string.Format("Thank you, {0}, for your purchase! Your total amount is: {1:C}.", customerName, totalAmount);

        // Create a new PDF document using IronPDF
        var pdfDocument = new ChromePdfRenderer();

        // Add the dynamically formatted content to the PDF
        pdfDocument.RenderHtmlAsPdf(formattedContent).SaveAs("Invoice.pdf");
    }
}

public class Program{
    public static void main(string[] args)
    {
        PdfGenerator obj = new PdfGenerator();
    obj.GeneratePdf("John Doe", "1204.23");
    }
}

using IronPdf;

class PdfGenerator
{
    public static void GeneratePdf(string customerName, decimal totalAmount)
    {
        // Format the content dynamically using String.Format
        string formattedContent = string.Format("Thank you, {0}, for your purchase! Your total amount is: {1:C}.", customerName, totalAmount);

        // Create a new PDF document using IronPDF
        var pdfDocument = new ChromePdfRenderer();

        // Add the dynamically formatted content to the PDF
        pdfDocument.RenderHtmlAsPdf(formattedContent).SaveAs("Invoice.pdf");
    }
}

public class Program{
    public static void main(string[] args)
    {
        PdfGenerator obj = new PdfGenerator();
    obj.GeneratePdf("John Doe", "1204.23");
    }
}

Imports IronPdf

Friend Class PdfGenerator
	Public Shared Sub GeneratePdf(ByVal customerName As String, ByVal totalAmount As Decimal)
		' Format the content dynamically using String.Format
		Dim formattedContent As String = String.Format("Thank you, {0}, for your purchase! Your total amount is: {1:C}.", customerName, totalAmount)

		' Create a new PDF document using IronPDF
		Dim pdfDocument = New ChromePdfRenderer()

		' Add the dynamically formatted content to the PDF
		pdfDocument.RenderHtmlAsPdf(formattedContent).SaveAs("Invoice.pdf")
	End Sub
End Class

Public Class Program
	Public Shared Sub main(ByVal args() As String)
		Dim obj As New PdfGenerator()
	obj.GeneratePdf("John Doe", "1204.23")
	End Sub
End Class

VB C#

この例では、String.Format メソッドを使用して、顧客の請求書にパーソナライズされたメッセージを動的に生成します。フォーマットされたコンテンツは、IronPDF の ChromePdfRenderer 機能を使用して PDF ドキュメントに組み込まれます。

前述のコード例から出力されたPDF

HTML文字列表現を使用してPDFを作成する方法について詳しくは、以下のリンクをご参照ください。**IronPDFドキュメントページ

結論

結論として、String.FormatはC#プログラミングにおいて頼りになる存在であり、開発者に対してフォーマットされた文字列を作成するための強力なメカニズムを提供します。数値、日付/時刻情報、またはカスタマイズされたパターンに対処する場合、String.Formatは多用途で効率的なソリューションを提供します。 C#開発の広大な世界を進む中で、String.Formatを使った文字列のフォーマットの技術を習得することは、アプリケーションにおいて明確で動的かつ視覚的に魅力的な出力を作成する能力を間違いなく向上させるでしょう。

開発者はString.Formatの強力なフォーマット機能を活用してコンテンツを動的に作成し、それをIronPDFを使用してPDFドキュメントにシームレスに統合できます。この協力的なアプローチにより、開発者は高度にカスタマイズされた視覚的に魅力的なPDFを生成できるようになり、ドキュメント生成の能力に一層の洗練さを加えることができます。

IronPDFは**IronPDFの全機能を無料でお試しいただけます。商用モードと同様に、その完全な機能をテストするため。しかし、あなたにはIronPDFのライセンス試用期間が終了した後。

< 以前
C# LINQ Join クエリ構文（開発者向けの動作方法）

次へ >
C# 属性 (開発者向けの動作方法)