.NET 幫助

C# 字串格式化（開發者使用說明）

發佈 2024年8月11日

在多樣化的 C# 程式設計中，有效的字符串操作是顯示清晰且動態輸出的基石。 String.Format 方法成為一個強大的工具，為開發人員提供了一種靈活且富有表現力的字串格式化手段。若要正確使用 String.Format 方法並在 C# 中創建自訂格式字符串，請參閱其在 Microsoft 官方 .NET 文件網站上的文檔：String.Format 方法.

在本綜合指南中，我們將探討字符串格式的複雜性、其語法、用法以及在C#中提升字符串格式化的高效方式。

了解基礎:

什麼是 String.Format？

在其核心，String.Format 是一種設計用來通過替換佔位符為相應值來格式化字串的方法。此方法屬於 C# 中的 System.String 類別，並在建立結構良好且可自定義的字串中發揮關鍵作用。

String.Format 的語法

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#

在此片段中，{0:C} 將數值格式化為貨幣，並且 {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} 格式控制「產品」和「價格」標籤的寬度，確保左對齊並允許使用前置或後置空格。然後，循環將產品名稱和價格填入表格，創建一個格式整齊的銷售報告，精確控制間距。調整這些寬度參數可以有效地管理顯示資料的對齊和間距。

使用三元運算符進行條件格式設定

在 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}符號將「d」格式說明符應用於清單中的第一個物件。在格式化字串或合成格式化功能的上下文中，這些格式說明符指導如何呈現各種類型，包括數值、小數點、日期和時間，以及自訂類型。

這是一個使用單一對象和兩個格式項的範例，結合了複合格式字串和字串插值：

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成為創建清晰和結構化文本內容的不可或缺的工具。

將 String.Format 與 IronPDF 結合使用

當談到將 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# 屬性（開發人員如何運作）