C# String.Format（開發者使用方法）

瞭解基礎知識：

// String.Format example demonstrating basic placeholder usage
string formattedString = string.Format("Hello, {0}! Today is {1}.", "John", DateTime.Now.DayOfWeek);

// String.Format example demonstrating basic placeholder usage
string formattedString = string.Format("Hello, {0}! Today is {1}.", "John", DateTime.Now.DayOfWeek);

數字和日期/時間格式化

String.Format 的強大功能之一，就是能夠根據特定模式來格式化數值和日期/時間值。 舉例來說

// Formatting numeric and date/time values
decimal price = 19.95m; 
DateTime currentDate = DateTime.Now;

string formattedNumeric = string.Format("Price: {0:C}", price); // Formats the numeric value as currency
string formattedDate = string.Format("Today's date: {0:yyyy-MM-dd}", currentDate); // Formats the date

// Formatting numeric and date/time values
decimal price = 19.95m; 
DateTime currentDate = DateTime.Now;

string formattedNumeric = string.Format("Price: {0:C}", price); // Formats the numeric value as currency
string formattedDate = string.Format("Today's date: {0:yyyy-MM-dd}", currentDate); // Formats the date

在此片段中，{0:C#} 將數值格式化為貨幣，而 {0:yyyy-MM-dd} 則根據指定的模式格式化日期。

具有數字索引的多重格式項目

在 C# 中，string.Format 方法允許開發人員在格式字串中使用數值索引作為占位符。 這有助於按照特定順序插入相應的值。

// Demonstrating multiple format items with numerical indices
string formattedNamed = string.Format("Hello, {0}! Your age is {1}.", "Alice", 30);

// Demonstrating multiple format items with numerical indices
string formattedNamed = string.Format("Hello, {0}! Your age is {1}.", "Alice", 30);

在此，{0} 和 {1}是數字占位符，而值是按照傳給 string.Format 方法的參數順序提供的。

C# 不支援字符串.Format 方法中的命名占位符，如上圖所示的數值索引。 如果您需要命名占位符，應使用字串插值或外部函式庫提供的其他方法。 以下是一個字串插值表達式的範例：

// String interpolation example demonstrating direct variable use
var name = "Alice";
var age = 30;
string formattedNamed = $"Hello, {name}! Your age is {age}.";

// String interpolation example demonstrating direct variable use
var name = "Alice";
var age = 30;
string formattedNamed = $"Hello, {name}! Your age is {age}.";

對齊方式和間距

String.Format 提供對格式化值的對齊和間距的精確控制。 透過在格式項目中加入對齊方式和寬度規格，開發人員可以建立整齊對齊的輸出。 在 C# 中使用 String.Format 控制間距涉及到指定插入字串的寬度，允許精確控制前方或後方的空格。 例如，考慮在銷售報告中對齊產品名稱和價格：

// Using String.Format for aligning product names and prices
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);
}

// Using String.Format for aligning product names and prices
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);
}

在這個範例中，{0,-15} 和 {1,-10}格式控制"Product"和"Price"標籤的寬度，確保左對齊，並允許前置或後置空格。 然後，迴圈會以產品名稱和價格填入表格，建立格式整齊的銷售報告，並精確控制間距。 調整這些寬度參數可讓您有效管理顯示資料的對齊方式和間距。

使用三元運算符進行條件格式化。

利用 String.Format 中的三元運算符允許根據特定條件進行條件格式化。 舉例來說

// Using ternary operator for conditional formatting
int temperature = 25;
string weatherForecast = string.Format("The weather is {0}.", temperature > 20 ? "warm" : "cool");

// Using ternary operator for conditional formatting
int temperature = 25;
string weatherForecast = string.Format("The weather is {0}.", temperature > 20 ? "warm" : "cool");

在此，天氣描述會根據溫度變化。

複合格式化

為了精煉 C# 中物件的顯示，請加入格式字串，也稱為"複合格式字串"，以控制字串的表示。 例如，使用 {0:d} 符號會將"d"格式指定符應用於清單中的第一個物件。在格式化字串或複合格式化功能的情況下，這些格式指定符會引導如何呈現各種類型，包括數值、小數點、日期和時間，以及自訂類型。

以下是一個單一物件和兩個格式項的範例，結合了複合格式字串和字串插值：

// Combining composite format strings and string interpolation
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'

// Combining composite format strings and string interpolation
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'

在此方法中，物件的字串表示可依特定格式量身訂做，以利於更有控制且視覺上更吸引人的輸出。 內插字串直接包含變數，提供更簡潔的語法。

介紹 IronPDF。

。

IronPDF 是一個 C# 函式庫，可協助 使用 HTML 建立 PDF 文件、從 PDF 檔案擷取文字，以及 PDF 中的修訂與歷史管理。 它為開發人員提供了一套全面的工具，以便在他們的 C# 應用程式中產生、修改和渲染 PDF 檔案。 有了 IronPDF，開發人員可以根據他們的特定需求，製作精緻且具視覺吸引力的 PDF 文件。

# Install the IronPdf NuGet package
Install-Package IronPdf

# Install the IronPdf NuGet package
Install-Package IronPdf

String.Format 與 IronPDF 的整合。

說到將 String.Format 與 IronPDF 整合，答案是肯定的。 可以利用 String.Format 提供的格式化功能來動態產生內容，然後再使用 IronPDF 的功能將這些內容納入 PDF 文件中。

讓我們考慮一個簡單的例子：

using IronPdf;

// Class to generate PDF with formatted content
class PdfGenerator
{
    // Method to generate a PDF for a customer's invoice
    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 and save it
        pdfDocument.RenderHtmlAsPdf(formattedContent).SaveAs("Invoice.pdf");
    }
}

public class Program
{
    // Main method to execute PDF generation
    public static void Main(string[] args)
    {
        PdfGenerator.GeneratePdf("John Doe", 1204.23m);
    }
}

using IronPdf;

// Class to generate PDF with formatted content
class PdfGenerator
{
    // Method to generate a PDF for a customer's invoice
    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 and save it
        pdfDocument.RenderHtmlAsPdf(formattedContent).SaveAs("Invoice.pdf");
    }
}

public class Program
{
    // Main method to execute PDF generation
    public static void Main(string[] args)
    {
        PdfGenerator.GeneratePdf("John Doe", 1204.23m);
    }
}

在這個範例中，我們使用 String.Format 方法來為客戶的發票動態產生個人化的訊息。格式化後的內容會使用 IronPDF 的 ChromePdfRenderer 功能納入 PDF 文件中。

！從之前的程式碼範例中輸出的 PDF

有關使用 HTML String 表示法建立 PDF 的詳細資訊，請參閱 IronPDF 文件 頁面。

結論

總而言之，String.Format 是 C# 程式設計中的中流砥柱，為開發人員提供了強大的機制，以製作格式化的字串。 無論是處理數值、日期/時間資訊或自訂模式，String.Format 都能提供多樣且有效率的解決方案。 當您在 C# 開發的廣闊領域中遨遊時，掌握使用 String.Format 來格式化字串的藝術，無疑會增強您在應用程式中建立清晰、動態且具視覺吸引力輸出的能力。

開發人員可以利用 String.Format 強大的格式化功能來動態製作內容，然後再使用 IronPDF 將其無縫整合至 PDF 文件中。 這種協同合作的方式讓開發人員能夠製作高度客製化且具視覺吸引力的 PDF，為他們的文件製作能力增添了一層複雜性。

IronPDF 提供免費試用 IronPDF 的完整功能，就像在商業模式下一樣，可以測試其完整功能。 但是，一旦超過試用期，您就需要IronPDF的授權。