C# String.Format (Geliştiriciler için Nasıl Çalışır)

Temelleri Anlamak:

// 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 example demonstrating basic placeholder usage
Dim formattedString As String = String.Format("Hello, {0}! Today is {1}.", "John", DateTime.Now.DayOfWeek)

Sayısal ve Tarih/Zaman Biçimlendirme

String.Format'ın güçlü özelliklerinden biri, sayısal ve tarih/zaman değerlerini belirli kalıplara göre biçimlendirme yeteneğidir. Örneğin:

// 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

' Formatting numeric and date/time values
Dim price As Decimal = 19.95D
Dim currentDate As DateTime = DateTime.Now

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

Bu kod parçasında, {0:C} sayısal değeri para birimi olarak, {0:yyyy-MM-dd} tarihi ise belirtilen kalıba göre biçimlendirir.

Sayı İndeksli Birden Fazla Biçim Öğesi

C#'ta string.Format yöntemi, geliştiricilerin bir format dizesi içinde sayı indeksli yer tutucular kullanmasına olanak tanır. Bu, belirli bir sırada karşılık gelen değerlerin eklenmesine yardımcı olur.

// 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);

' Demonstrating multiple format items with numerical indices
Dim formattedNamed As String = String.Format("Hello, {0}! Your age is {1}.", "Alice", 30)

Burada, {0} ve {1} sayı yer tutucuları olup, değerler string.Format yöntemine geçen argümanların sırasına göre sağlanır.

C#, yukarıda gösterilen sayı indeksleri gibi string.Format yönteminde isimlendirilmiş yer tutucuları desteklemez. İsimlendirilmiş yer tutuculara ihtiyaçınız varsa, dizgi ara ekleme veya harici kitaplıklar tarafından sağlanan diğer yöntemleri kullanmalısınız. İşte dizgi ara ekleme ifadelerine bir örnek:

// 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 interpolation example demonstrating direct variable use
Dim name = "Alice"
Dim age = 30
Dim formattedNamed As String = $"Hello, {name}! Your age is {age}."

Hizalama ve Boşluk

String.Format, biçimlendirilmiş değerlerin hizalaması ve boşluğu üzerinde hassas kontrol sağlar. Biçim öğelerine hizalama ve genişlik özellikleri ekleyerek, geliştiriciler düzgün hizalanmış çıktı oluşturabilirler. C#'ta String.Format ile boşluğu kontrol etmek, eklenen dizelerin genişliğini belirtmeyi ve bu sayede ön boşluklar veya son boşluklar üzerinde hassas kontrol sağlamayı içerir. Örneğin, bir satış raporunda ürün adlarını ve fiyatları hizalamayı düşünün:

// 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);
}

Imports Microsoft.VisualBasic

' Using String.Format for aligning product names and prices
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

Bu örnekte, {0,-15} ve {1,-10} biçimlendirme "Ürün" ve "Fiyat" etiketlerinin genişliğini kontrol eder, sola hizalama sağlar ve ön veya son boşluklara izin verir. Döngü daha sonra ürün adları ve fiyatları tabloya ekler, boşluk üzerinde hassas kontrol ile düzgün biçimlendirilmiş bir satış raporu oluşturur. Bu genişlik parametrelerini ayarlamak, görüntülenen verilerin hizalamasını ve boşluğunu etkili bir şekilde yönetmenizi sağlar.

Koşullu Biçimlendirme Ternary Operatör ile

String.Format içinde ternary operatörü kullanarak belirli kriterlere dayalı koşullu biçimlendirme sağlanabilir. Örneğin:

// 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");

' Using ternary operator for conditional formatting
Dim temperature As Integer = 25
Dim weatherForecast As String = String.Format("The weather is {0}.",If(temperature > 20, "warm", "cool"))

Burada, hava durumu açıklaması sıcaklığa göre değişir.

Bileşik Biçimlendirme

C#'ta nesnelerin gösterimini ince ayarlamak için, aynı zamanda "bileşik format dizisi" olarak da bilinen bir format dizesi ekleyin. Örneğin, {0:d} notasyonu, listedeki ilk nesneye "d" format belirticisini uygular. Formatlanmış dizge veya bileşik format özelliği bağlamında, bu format belirticileri, sayısal, ondalık nokta, tarih ve zaman ve özel türler de dahil olmak üzere çeşitli türlerin nasıl sunulacağını yönlendirir.

İşte tek bir nesne ve iki biçim öğesi içeren bir örnek, bileşik format dizeleri ve dizgi ara eklemeyi birleştiriyor:

// 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'

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

Bu yaklaşımda, nesnelerin dize gösterimi belirli formatlara göre özelleştirilebilir, daha kontrollü ve görsel olarak çekici bir çıktı kolaylaştırılır. Ara eklenen dize değişkenleri doğrudan içerir, daha temiz bir sözdizimi sağlar.

IronPDF'i Tanıtma

IronPDF, HTML kullanarak PDF belgeleri oluşturmayı, PDF dosyalarından metin çıkarmayı ve PDF'lerde gözden geçirme ve tarih yönetimi kolaylaştıran bir C# kütüphanesidir. Geliştiricilere C# uygulamalarında PDF dosyaları oluşturmak, değiştirmek ve render etmek için kapsamlı bir araç seti sağlar. IronPDF ile geliştiriciler, kendilerine özgü gereksinimlere göre uyarlanmış, sofistike ve görsel olarak çekici PDF belgeleri oluşturabilir.

# Install the IronPdf NuGet package
Install-Package IronPdf

# Install the IronPdf NuGet package
Install-Package IronPdf

String.Format'ın IronPDF ile Entegrasyonu

String.Format'ı IronPDF ile entegre etme konusu gündeme geldiğinde, yanıt kesin bir evettir. String.Format tarafından sağlanan biçimlendirme yetenekleri, dinamik olarak oluşturulan içeriğin daha sonra IronPDF'nin özellikleri ile PDF belgesine eklenmesi için kullanılabilir.

Basit bir örneği ele alalım:

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);
    }
}

Imports IronPdf

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

Public Class Program
	' Main method to execute PDF generation
	Public Shared Sub Main(ByVal args() As String)
		PdfGenerator.GeneratePdf("John Doe", 1204.23D)
	End Sub
End Class

Bu örnekte, String.Format yöntemi, bir müşterinin faturasına özel olarak oluşturulmuş bir mesajı dinamik olarak oluşturmak için kullanılır. Biçimlendirilmiş içerik, daha sonra IronPDF'nin ChromePdfRenderer fonksiyonelliği kullanılarak bir PDF belgesine dahil edilir.

HTML Dize temsili ile PDF oluşturma hakkında daha ayrıntılı bilgi için lütfen IronPDF dökümantasyonu sayfasına başvurun.

Sonuç

Sonuç olarak, String.Format C# programlamasında sağlam bir temel olarak durur, geliştiricilere biçimlendirilmiş dizeler oluşturmak için güçlü bir mekanizma sunar. İster sayısal değerlerle, ister tarih/zaman bilgileri, ister özel desenlerle uğraşın, String.Format çok yönlü ve verimli bir çözüm sunar. C# geliştiriminin geniş dünyasında gezinirken, String.Format ile dize biçimlendirme sanatında ustalaşmak, uygulamalarınızda net, dinamik ve görsel olarak çekici çıktılar oluşturma yeteneğinizi kesinlikle artıracaktır.

Geliştiriciler, içeriği dinamik bir şekilde oluşturmak için String.Format'ın güçlü biçimlendirme özelliklerinden yararlanabilir ve bu daha sonra IronPDF kullanılarak kesintisiz bir şekilde PDF belgelerine entegre edilebilir. Bu işbirlikçi yaklaşım, geliştiricilerin belgelerinin oluşturma yeteneklerine zarafet katacak şekilde oldukça özelleştirilmiş ve görsel olarak çekici PDF'ler üretmelerine olanak tanır.

IronPDF, tam işlevselliğini ticari modda olduğu gibi test etmek için IronPDF'nin tüm özelliklerinin ücretsiz deneme sürümünü sunar. Bununla birlikte, deneme süresi aştığında IronPDF için bir lisansa ihtiyaçınız olacak.