String.Format Method.NET Framework

String.Format Method

.NET Framework 4.5 Other Versions 19 out of 45 rated this helpful - Rate this topic
Replaces each format item in a specified string with the text equivalent of a corresponding object's value.
This member is overloaded. For complete information about this member, including syntax, usage, and examples, click a name in the overload list.
Overload List
Name Description
Public method Static member Format(String, Object) Replaces one or more format items in a specified string with the string representation of a specified object.
Public method Static member Format(String, Object[]) Replaces the format item in a specified string with the string representation of a corresponding object in a specified array.
Public method Static member Format(IFormatProvider, String, Object[]) Replaces the format items in a specified string with the string representations of corresponding objects in a specified array. A parameter supplies culture-specific formatting information.
Public method Static member Format(String, Object, Object) Replaces the format items in a specified string with the string representation of two specified objects.
Public method Static member Format(String, Object, Object, Object) Replaces the format items in a specified string with the string representation of three specified objects.
Top
Remarks
In this section:
Overloaded method syntax
Parameters
Return value
Exceptions
Which method do I call?
The Format method in brief
The Format item
How arguments are formatted
Format items that have the same index
Formatting and culture
Custom formatting operations
Examples:
Formatting a single argument
Formatting two arguments
Formatting three arguments
Formatting more than three arguments
Culture-sensitive formatting
A custom formatting operation
An intercept provider and Roman numeral formatter
Version information
String.Format Q & A
Overloaded method syntax
For additional guidance on choosing an overload, see Which method do I call?
String String.Format(String format , Object arg0 )
Replaces the format items with the string representation of a specified object (example).
String String.Format(String format , Object arg0 , Object arg1 )
Replaces the format items with the string representation of two specified objects (example).
String String.Format(String format , Object arg0 , Object arg1 , Object arg2 )
Replaces the format items with the string representation of three specified objects (example).
String String.Format(String format , params Object[] args )
Replaces the format items with the string representations of corresponding objects in a specified array (example).
String String.Format(IFormatProvider provider , String format , params Object[] args )
Replaces the format items with the string representation of corresponding objects in a specified array, and uses the specified culture-specific formatting information (example) or custom formatting information (example).
Parameters
This is a complete list of parameters for the Format method; see the overload syntax above for the parameters used by each overload. Only the format parameter is used by all overloads.
Parameter
Type
Description
s
String
A composite format string that includes one or more format items (see The format item).
arg0
String
The first or only object to format.
arg1
String
The second object to format.
arg2
String
The third object to format.
args
String []
Zero or more objects to format, supplied either in a comma-delimited list or as an array.
provider
IFormatProvider
An object that supplies custom or culture-specific formatting information.
Return value
Type: String
A copy of format in which the format items have been replaced by the string representations of the corresponding arguments.
Exceptions
Exception
Condition
Thrown by
ArgumentNullException
format is null.
All overloads.
FormatException
format is invalid.
-or-
The index of a format item is less than zero, or greater than or equal to the number of arguments in the arguments list.
All overloads.
Which method do I call?
To
Call
Format one or more objects by using the conventions of the current culture.
Except for the overload that includes a provider parameter, all Format overloads include a String parameter followed by one or more object parameters. Because of this, you do not have to determine which Format overload you intend to call. Your language compiler will select the appropriate overload from among the overloads that don't have a provider parameter, based on your argument list. For example, if your argument list has five arguments, the compiler will call the Format(String, Object[]) method.
Format one or more objects by using the conventions of a specific culture.
Format(IFormatProvider, String, Object[])
Perform a custom formatting operation either with an ICustomFormatter implementation or an IFormattable implementation.
Format(IFormatProvider, String, Object[])
The Format method in brief
Each overload of the Format method uses the composite formatting feature to include zero-based indexed placeholders, called format items, in a composite format string. At run time, each format item is replaced with the string representation of the corresponding argument in a parameter list. If the value of the argument is null, the format item is replaced with String.Empty. For example, the following call to the Format(String, Object, Object, Object) method includes a format string with three format items, {0}, {1}, and {2}, and an argument list with three items.
C#C++VB
DateTime dat = new DateTime(2012, 1, 17, 9, 30, 0);
string city = "Chicago";
int temp = -16;
string output = String.Format("At {0} in {1}, the temperature was {2} degrees.",
dat, city, temp);
Console.WriteLine(output);
// The example displays the following output:
// At 1/17/2012 9:30:00 AM in Chicago, the temperature was -16 degrees.
The format item
A format item has this syntax:
{ index[,alignment][ :formatString] }
Brackets denote optional elements. The opening and closing braces are required. (To include a literal opening or closing brace in the format string, see the "Escaping Braces" section in the Composite Formatting article.)
For example, a format item to format a currency value might appears like this:
C#C++VB
String.Format("{0,-10:C}", 126347.89m);
A format item has the following elements:
index
The zero-based index of the argument whose string representation is to be included at this position in the string. If this argument is null, an empty string will be included at this position in the string.
alignment
Optional. A signed integer that indicates the total length of the field into which the argument is inserted and whether it is right-aligned (a positive integer) or left-aligned (a negative integer). If you omit alignment, the string representation of the corresponding argument is inserted in a field with no leading or trailing spaces.
formatString
Optional. A string that specifies the format of the corresponding argument's result string. If you omit formatString, the corresponding argument's parameterless ToString method is called to produce its string representation. If you specify formatString, the argument referenced by the format item must implement the IFormattable interface. Types that support format strings include:
All integral and floating-point types. (See Standard Numeric Format Strings and Custom Numeric Format Strings.)
DateTime and DateTimeOffset. (See Standard Date and Time Format Strings and Custom Date and Time Format Strings.)
All enumeration types. (See Enumeration Format Strings.)
TimeSpan values. (See Standard TimeSpan Format Strings and Custom TimeSpan Format Strings.)
GUIDs. (See the Guid.ToString(String) method.)
However, note that any custom type can implement IFormattable or extend an existing type's IFormattable implementation.
The following example uses the alignment and formatString arguments to produce formatted output.
C#C++VB
using System;

public class Example
{
public static void Main()
{
// Create array of 5-tuples with population data for three U.S. cities, 1940-1950.
Tuple[] cities =
{ Tuple.Create("Los Angeles", new DateTime(1940, 1, 1), 1504277,
new DateTime(1950, 1, 1), 1970358),
Tuple.Create("New York", new DateTime(1940, 1, 1), 7454995,
new DateTime(1950, 1, 1), 7891957),
Tuple.Create("Chicago", new DateTime(1940, 1, 1), 3396808,
new DateTime(1950, 1, 1), 3620962),
Tuple.Create("Detroit", new DateTime(1940, 1, 1), 1623452,
new DateTime(1950, 1, 1), 1849568) };

// Display header
string header = String.Format("{0,-12}{1,8}{2,12}{1,8}{2,12}{3,14}
",
"City", "Year", "Population", "Change (%)");
Console.WriteLine(header);
string output;
foreach (var city in cities) {
output = String.Format("{0,-12}{1,8:yyyy}{2,12:N0}{3,8:yyyy}{4,12:N0}{5,14:P1}",
city.Item1, city.Item2, city.Item3, city.Item4, city.Item5,
(city.Item5 - city.Item3)/ (double)city.Item3);
Console.WriteLine(output);
}
}
}
// The example displays the following output:
// City Year Population Year Population Change (%)
//
// Los Angeles 1940 1,504,277 1950 1,970,358 31.0 %
// New York 1940 7,454,995 1950 7,891,957 5.9 %
// Chicago 1940 3,396,808 1950 3,620,962 6.6 %
// Detroit 1940 1,623,452 1950 1,849,568 13.9 %
How arguments are formatted
Format items are processed sequentially from the beginning of the string. Each format item has an index that corresponds to an object in the method's argume

Kết quả (Việt) 1:

Phương pháp moneyvalue.NET framework 4.5 khác Phiên bản 19 ra khỏi 45 xếp này hữu ích - đánh giá chủ đề nàyThay thế mỗi mục định dạng trong một chuỗi cụ thể bằng văn bản tương đương với giá trị của một đối tượng tương ứng.Thành viên này quá tải. Cho các thông tin đầy đủ về thành viên này, trong đó có cú pháp, sử dụng, và các ví dụ, nhấp vào tên trong danh sách quá tải.Tình trạng quá tải danh sách Tên mô tảKhu vực phương pháp tĩnh thành viên Format(String, Object) thay thế một hoặc nhiều khoản mục định dạng trong một chuỗi cụ thể với chuỗi đại diện của một đối tượng cụ thể.Khu vực phương pháp tĩnh thành viên định dạng (String, Object[]) thay thế các mục định dạng trong một chuỗi cụ thể với chuỗi đại diện của một tương ứng đối tượng trong một mảng được chỉ định.Khu vực phương pháp tĩnh thành viên định dạng (IFormatProvider, Chuỗi, Object[]) thay thế các mục định dạng trong một chuỗi cụ thể với các chuỗi đại diện của tương ứng các đối tượng trong một mảng được chỉ định. Một tham số cung cấp thông tin định dạng văn hóa cụ thể.Khu vực phương pháp tĩnh thành viên Format(String, Object, Object) thay thế các định dạng ghi trong một chuỗi cụ thể với chuỗi đại diện của các đối tượng được chỉ định hai.Khu vực phương pháp tĩnh thành viên Format(String, Object, Object, Object) thay thế các định dạng ghi trong một chuỗi cụ thể với chuỗi đại diện của ba các đối tượng được chỉ định.Đầu trangNhận xétTrong phần này:Quá tải phương pháp cú pháp Tham sốGiá trị trả lạiTrường hợp ngoại lệTôi gọi phương pháp?Phương pháp định dạng trong khuôn khổMục định dạngLàm thế nào đối số được định dạngĐịnh dạng mục có cùng một chỉ mụcĐịnh dạng và văn hóaTuỳ định dạng hoạt độngVí dụ: Định dạng một đối số duy nhất Định dạng hai đối số Định dạng ba đối số Định dạng hơn ba đối số Nhạy cảm văn hóa định dạng Một hoạt động định dạng tùy chỉnh Một nhà cung cấp đánh chặn và định dạng chữ số La MãPhiên bản thông tinMoneyvalue Q & AQuá tải phương pháp cú phápĐể thêm hướng dẫn về việc lựa chọn một tình trạng quá tải, hãy xem phương pháp làm tôi gọi?Chuỗi moneyvalue (chuỗi định dạng, đối tượng arg0)Thay thế các mục định dạng với chuỗi đại diện của một đối tượng cụ thể (ví dụ).Chuỗi moneyvalue (chuỗi định dạng, đối tượng arg0, đối tượng arg1)Thay thế các mục định dạng với chuỗi đại diện của hai đối tượng cụ thể (ví dụ).Chuỗi moneyvalue (chuỗi định dạng, đối tượng arg0, đối tượng đối_số1, đối_số2 đối tượng)Thay thế các mục định dạng với chuỗi đại diện của ba đối tượng cụ thể (ví dụ).Chuỗi moneyvalue (chuỗi định dạng, args [] params đối tượng)Thay thế các mục định dạng với các chuỗi đại diện của các đối tượng tương ứng trong một mảng được chỉ định (ví dụ).Chuỗi moneyvalue (nhà cung cấp IFormatProvider, Chuỗi định dạng, args [] params đối tượng)Thay thế các mục định dạng với chuỗi đại diện của các đối tượng tương ứng trong một mảng được chỉ định, và sử dụng được chỉ định thông tin định dạng văn hóa cụ thể (ví dụ) hoặc thông tin định dạng tùy chỉnh (ví dụ).Tham sốĐây là một danh sách đầy đủ của các tham số cho các phương pháp định dạng; Xem cú pháp quá tải ở trên cho các tham số được sử dụng bởi mỗi tình trạng quá tải. Chỉ có các tham số định dạng được sử dụng bởi tất cả overloads.Tham sốLoạiMô tảsChuỗiMột chuỗi định dạng tổng hợp bao gồm một hoặc nhiều định dạng mặt hàng (xem mục định dạng).arg0ChuỗiĐầu tiên hoặc chỉ đối tượng để định dạng.arg1ChuỗiĐối tượng thứ hai để định dạng.đối_số2ChuỗiĐối tượng thứ ba để định dạng.argsString]Các đối tượng số không hay nhiều để định dạng, được cung cấp trong một danh sách phân cách bằng dấu phẩy hoặc như là một mảng.nhà cung cấpIFormatProviderMột đối tượng nguồn cung cấp thông tin định dạng tuỳ chỉnh hoặc văn hóa cụ thể.Giá trị trả lạiLoại: ChuỗiMột bản sao của định dạng mà trong đó các định dạng đã được thay thế bởi các chuỗi đại diện của các đối số tương ứng.Trường hợp ngoại lệNgoại lệĐiều kiệnNém bởiArgumentNullExceptionđịnh dạng là không.Tất cả overloads.FormatExceptionđịnh dạng không hợp lệ.- hoặc -Chỉ số của một định dạng mục là nhỏ hơn 0, hoặc lớn hơn hoặc bằng số lượng đối số trong danh sách đối số.Tất cả overloads.Tôi gọi phương pháp?ĐểCuộc gọiĐịnh dạng một hoặc nhiều đối tượng bằng cách sử dụng quy tắc của các nền văn hóa hiện hành.Ngoại trừ sự quá tải bao gồm một tham số nhà cung cấp, tất cả định dạng overloads bao gồm một tham số chuỗi theo sau bởi một hoặc nhiều đối tượng tham số. Bởi vì điều này, bạn không cần phải xác định tình trạng quá tải định dạng mà bạn muốn gọi. Trình biên dịch ngôn ngữ của bạn sẽ chọn tình trạng quá tải thích hợp trong số overloads mà không có một tham số nhà cung cấp, dựa trên danh sách đối số của bạn. Ví dụ, nếu danh sách đối số của bạn có 5 đối số, trình biên dịch sẽ gọi cho các định dạng (String, Object[]) phương pháp.Định dạng một hoặc nhiều đối tượng bằng cách sử dụng quy tắc của một nền văn hóa cụ thể.Định dạng (IFormatProvider, Chuỗi, Object[])Thực hiện một thao tác định dạng tùy chỉnh hoặc với một ICustomFormatter thực hiện hoặc thực hiện một IFormattable.Định dạng (IFormatProvider, Chuỗi, Object[])Phương pháp định dạng trong khuôn khổMỗi tình trạng quá tải của các phương pháp định dạng sử dụng tính năng định dạng tổng hợp bao gồm Zero phần giữ chỗ được lập chỉ mục, gọi là định dạng mục, trong một chuỗi định dạng tổng hợp. Tại thời gian chạy, mỗi mục định dạng được thay thế bằng chuỗi đại diện của các đối số tương ứng trong một danh sách tham số. Nếu giá trị của các đối số null, mục định dạng được thay thế bằng String.Empty. Ví dụ, các cuộc gọi sau đây để các phương pháp định dạng (String, đối tượng, đối tượng, đối tượng) bao gồm một chuỗi định dạng với ba định dạng mục, {0}, {1}, và (2), và một danh sách đối số với ba bài.C# C ++ BBDateTime dat = mới DateTime (2012, 1, 17, 9, 30, 0); thành phố chuỗi = "Chicago";int temp = -16;Chuỗi sản lượng = moneyvalue ("Tại {0} trong {1}, nhiệt độ đã là {2} độ.", dat, thành phố, tạm thời);Console.WriteLine(output);Ví dụ hiển thị đầu ra sau đây: Lúc 20/01/2012 09:30:00: 00 ở Chicago, nhiệt độ đã là-16 độ. Mục định dạngMột định dạng mục có cú pháp này:{chỉ số [, sắp xếp] [: formatString]}Dấu ngoặc biểu thị yếu tố tùy chọn. Khai mạc và bế mạc niềng răng được yêu cầu. (Để bao gồm một chữ mở hoặc đóng cửa đôi trong chuỗi định dạng, hãy xem phần "Thoát niềng răng" trong bài viết định dạng hỗn hợp.)Ví dụ, một định dạng mục để định dạng một giá trị tiền tệ có thể xuất hiện như thế này:C# C ++ BBMoneyvalue ("{0,-10:C}", 126347.89 m); Một định dạng mục có các yếu tố sau:chỉ sốChỉ số Zero của các đối số có chuỗi đại diện là để bao gồm vào vị trí này trong chuỗi. Nếu đối số này là không, một chuỗi rỗng sẽ được bao gồm vào vị trí này trong chuỗi.liên kếtTùy chọn. Một số nguyên đã ký cho biết tổng chiều dài của lĩnh vực mà các đối số được đưa vào và cho dù nó quyền liên kết (một số nguyên dương) hoặc trái liên kết (một số nguyên tiêu cực). Nếu bạn bỏ qua chỉnh, Chuỗi đại diện của các đối số tương ứng được đưa vào trong một lĩnh vực với không gian hàng đầu hoặc dấu.formatStringTùy chọn. Một chuỗi chỉ định định dạng của chuỗi kết quả đối số tương ứng. Nếu bạn bỏ qua formatString, các đối số tương ứng parameterless ToString phương pháp được gọi là để tạo ra chuỗi đại diện của nó. Nếu bạn chỉ định formatString, các đối số tham chiếu của định dạng mục phải thực hiện giao diện IFormattable. Các loại hỗ trợ định dạng dây bao gồm:Tất cả không thể tách rời và floating-point loại. (Xem định dạng số chuẩn dây và dạng số tùy chỉnh dây.)DateTime và DateTimeOffset. (Xem ngày tiêu chuẩn và định dạng thời gian dây và tùy chỉnh ngày và thời gian định dạng dây.)Tất cả các loại điều tra. (Xem liệt kê định dạng dây.)Giá trị TimeSpan. (Xem định dạng chuẩn TimeSpan dây và tùy chỉnh thời định dạng dây.)GUID. (Xem phương pháp Guid.ToString(String).)Tuy nhiên, lưu ý rằng bất kỳ loại tùy chỉnh có thể thực hiện IFormattable hoặc mở rộng loại hiện có một IFormattable thực hiện.Ví dụ sau sử dụng các đối số liên kết và formatString để sản xuất định dạng đầu ra.C# C ++ BBbằng cách sử dụng hệ thống;công cộng lớp ví dụ{ khu vực Main() tĩnh void { Tạo mảng của 5-tuples với dữ liệu dân số cho ba các thành phố của Mỹ, năm 1940-1950. TupleCác thành phố [] = {Tuple.Create ("Los Angeles", mới DateTime (1940, 1, 1), 1504277, DateTime mới (1950, 1, 1), 1970358), Tuple.Create ("New York", mới DateTime (1940, 1, 1), 7454995, DateTime mới (1950, 1, 1), 7891957), Tuple.Create ("Chicago", mới DateTime (1940, 1, 1), 3396808, DateTime mới (1950, 1, 1), 3620962), Tuple.Create ("Detroit", mới DateTime (1940, 1, 1), 1623452, DateTime mới (1950, 1, 1), 1849568)}; Hiển thị tiêu đề Chuỗi tiêu đề = moneyvalue ("{0, -12} {1.8} {2,12} {1.8} {2,12} {3,14}
", "Thành phố", "Năm", "Dân", "thay đổi (%)"); Console.WriteLine(header); Chuỗi sản lượng; foreach (var thành phố tại các thành phố) {} sản lượng = moneyvalue ("{0, -12} {1, 8:yyyy} {2, 12:N0} {3, 8:yyyy} {4, 12:N0} {5, 14:P1}", thành phố.Item1, thành phố.Item2, thành phố.Item3, thành phố.Item4, thành phố.Item5, (thành phố.Item5 - thành phố.Item3) / (đôi) thành phố.Item3); Console.WriteLine(output); } }}Ví dụ hiển thị đầu ra sau đây: Dân số năm thành phố năm dân số thay đổi (%) // Los Angeles năm 1940 1,504,277 1950 1,970,358 31.0% New York năm 1940 7,454,995 1950 7,891,957 5,9% Chicago năm 1940 3,396,808 1950 3,620,962 6,6% Detroit 1940 1,623,452 1950 1,849,568 13,9%Làm thế nào đối số được định dạngĐịnh dạng mặt hàng được xử lý tuần tự từ sự khởi đầu của chuỗi. Mỗi mục định dạng có một chỉ số tương ứng với một đối tượng trong các phương pháp argume

Kết quả (Việt) 2:

String.Format Phương pháp .NET Framework 4.5 phiên bản khác 19 trong tổng số 45 đánh giá hữu ích này - Tỷ lệ chủ đề này . Thay thế mỗi mục định dạng trong một chuỗi quy định với giá trị tương đương văn bản của một đối tượng tương ứng của thành viên này bị quá tải. Để biết thông tin đầy đủ về thành viên này, bao gồm cú pháp, cách sử dụng, và ví dụ, nhấn vào tên trong danh sách tình trạng quá tải. Danh sách Overload Tên Mô tả phương pháp công cộng Format thành viên tĩnh (String, Object) Thay thế một hoặc định dạng nhiều mặt hàng trong một chuỗi quy định với chuỗi đại diện của một đối tượng quy định. phương pháp công cộng Format thành viên tĩnh (String, Object []) Thay thế mục định dạng trong một chuỗi quy định với chuỗi đại diện của một đối tượng tương ứng trong một mảng được chỉ định. phương pháp công cộng Format thành viên tĩnh (IFormatProvider, String, Object []) Thay thế các mục định dạng trong một chuỗi quy định với cơ quan đại diện chuỗi của các đối tượng tương ứng trong một mảng được chỉ định. Một nguồn cung cấp thông tin định dạng tham số nền văn hóa cụ thể. phương pháp công cộng Format thành viên tĩnh (String, Object, Object) Thay thế các mục định dạng trong một chuỗi quy định với chuỗi đại diện của hai đối tượng quy định. phương pháp công cộng Format thành viên tĩnh (String, Object, Object, Object) Thay thế các mục định dạng trong một chuỗi quy định với chuỗi đại diện của ba đối tượng quy định. Lên Bình luận Trong phần này: Quá tải phương thức cú pháp thông số Quay trở lại giá trị ngoại lệ ? Những phương pháp nào tôi gọi Phương pháp Format trong ngắn Mục Format thế nào đối số được định dạng Định dạng các mặt hàng có cùng chỉ số định dạng và văn hóa định dạng tùy chỉnh hoạt động Ví dụ: Định dạng một đối số duy nhất định dạng hai đối số định dạng ba đối số Định dạng hơn ba đối số Văn hóa nhạy cảm định dạng Một hoạt động định dạng tùy chỉnh Một nhà cung cấp đánh chặn và định dạng chữ số La Mã Phiên bản thông tin String.Format Q & A cú pháp phương pháp quá tải Đối với hướng dẫn bổ sung về việc lựa chọn một tình trạng quá tải, xem phương pháp nào tôi gọi? Chuỗi String.Format (String định dạng, đối tượng arg0) Thay thế các mục định dạng với chuỗi đại diện của một đối tượng nào đó (ví dụ). Chuỗi Chuỗi .Format (định dạng String, Object arg0, arg1 Object) Thay thế các mục định dạng với chuỗi đại diện của hai đối tượng quy định (ví dụ). Chuỗi String.Format (định dạng String, Object arg0, Object arg1, arg2 Object) Thay thế các mục định dạng với chuỗi đại diện của ba đối tượng quy định (ví dụ). Chuỗi String.Format (định dạng String, params Object [] args) Thay thế các mục định dạng với cơ quan đại diện chuỗi của các đối tượng tương ứng trong một mảng được chỉ định (ví dụ). Chuỗi String.Format (IFormatProvider nhà cung cấp, định dạng String, params Object [] args) Thay thế các mục định dạng với chuỗi đại diện của các đối tượng tương ứng trong một mảng được chỉ định, và sử dụng các thông tin quy định văn hóa cụ thể định dạng (ví dụ) hoặc định dạng tùy chỉnh thông tin (ví dụ). Các thông số này là một danh sách đầy đủ của các thông số cho các phương pháp định dạng; thấy cú pháp quá tải trên các thông số được sử dụng bởi mỗi quá tải. Chỉ có các tham số định dạng được sử dụng bởi tất cả các quá tải. Thông số Loại Mô tả của chuỗi Một chuỗi định dạng hỗn hợp, bao gồm một hoặc nhiều mục định dạng (xem Mục định dạng). arg0 Chuỗi Các đối tượng đầu tiên hoặc chỉ để định dạng. arg1 Chuỗi Các đối tượng thứ hai để định dạng . arg2 Chuỗi Các đối tượng thứ ba để định dạng. args String [] Zero hoặc nhiều đối tượng để định dạng, cung cấp, hoặc trong một danh sách dấu phẩy phân cách hoặc như là một mảng. cung cấp IFormatProvider Một đối tượng cung cấp tùy chỉnh hoặc nền văn hóa cụ thể thông tin định dạng. Quay trở lại giá trị Loại : String . Một bản sao của định dạng, trong đó các mặt hàng định dạng đã được thay thế bởi cơ quan đại diện chuỗi của các đối số tương ứng ngoại lệ ngoại lệ Điều kiện Bị đẩy bởi ArgumentNullException . định dạng là null . Tất cả các quá tải FormatException định dạng không hợp lệ. -HOẶC- Chỉ số của một mục định dạng là nhỏ hơn không, hoặc lớn hơn hoặc bằng số lượng các đối số trong danh sách đối số. Tất cả các quá tải. Những phương pháp nào tôi gọi? Để Gọi Format một hoặc nhiều đối tượng bằng cách sử dụng các công ước của nền văn hóa hiện nay. Ngoại trừ sự quá tải mà bao gồm một tham số nhà cung cấp, tất cả các quá tải định dạng bao gồm một tham số String theo sau là một hoặc nhiều tham số đối tượng. Bởi vì điều này, bạn không cần phải xác định tình trạng quá tải Format bạn có ý định gọi. Biên dịch ngôn ngữ của bạn sẽ chọn quá tải thích hợp trong số các quá tải mà không có một tham số nhà cung cấp, dựa trên danh sách đối số của bạn. Ví dụ, nếu danh sách đối số của bạn có năm tranh luận, trình biên dịch sẽ gọi Format (String, Object []) phương pháp. Format một hoặc nhiều đối tượng bằng cách sử dụng các công ước của một nền văn hóa cụ thể. Format (IFormatProvider, String, Object []) Thực hiện một hoạt động định dạng tùy chỉnh hoặc với một ICustomFormatter thực hiện hoặc thực hiện một IFormattable. Format (IFormatProvider, String, Object []) Phương pháp Định dạng trong ngắn Mỗi quá tải của các phương pháp định dạng sử dụng các tính năng định dạng hỗn hợp bao gồm placeholders lập chỉ mục không dựa trên, được gọi là mục định dạng, trong một chuỗi định dạng composite. Tại thời gian chạy, mỗi mục định dạng được thay thế bằng chuỗi đại diện của đối số tương ứng trong danh sách tham số. Nếu giá trị của các đối số là null, mục định dạng được thay thế bằng String.Empty. Ví dụ, các cuộc gọi sau đây để định dạng (String, Object, Object, Object) phương pháp bao gồm một chuỗi định dạng với ba mục định dạng, {0}, {1} và {2}, và một danh sách đối với ba mặt hàng. C # C ++ VB DateTime dat = DateTime mới (2012, 1, 17, 9, 30, 0); chuỗi thành phố = "Chicago"; int temp = -16; sản lượng string = String.Format ("Tại {0} trong . {1}, nhiệt độ là {2} độ ", dat, thành phố, temp); Console.WriteLine (đầu ra); // Ví dụ hiển thị các kết quả như sau: // Tại 2012/01/17 09:30:00 AM tại Chicago, nhiệt độ là -16 độ. Các mục định dạng Một mục định dạng có cú pháp sau: {chỉ số [, alignment] [: formatString]} Chân đế biểu thị các yếu tố tùy chọn. Việc mở và đóng niềng răng được yêu cầu. (Để bao gồm một lỗ đen hoặc dây đeo đóng cửa trong chuỗi định dạng, xem "Thoát Niềng răng" phần trong bài viết định dạng Composite.) Ví dụ, một mục định dạng để định dạng một sức mạnh giá trị đồng tiền xuất hiện như thế này: C # C ++ VB String.Format ("{0, -10: C}", 126347.89m); Một mục định dạng có các yếu tố sau: chỉ số Chỉ số không dựa trên các đối số có chuỗi đại diện là để được bao gồm ở vị trí này trong chuỗi. Nếu lập luận này là vô giá trị, một chuỗi rỗng sẽ được đưa vào vị trí này trong chuỗi. liên kết Tùy chọn. Một số nguyên ký cho biết tổng chiều dài của các lĩnh vực mà trong đó đối số được đưa vào và cho dù đó là phải liên kết (một số nguyên dương) hoặc canh trái (một số nguyên âm). Nếu bạn bỏ qua sự liên kết, các chuỗi đại diện của đối số tương ứng sẽ được chèn trong một lĩnh vực không có khoảng trống đầu hoặc cuối. formatString Tùy chọn. Một chuỗi mà chỉ rõ định dạng của chuỗi kết quả đối số tương ứng của. Nếu bạn bỏ qua formatString, phương pháp parameterless ToString đối số tương ứng được gọi là để sản xuất chuỗi đại diện của nó. Nếu bạn chỉ định formatString, tham số tham chiếu bởi mục định dạng phải thực hiện giao diện IFormattable. Loại có hỗ trợ định dạng chuỗi bao gồm: Tất cả các loại tách rời và dấu chấm động. (Xem định dạng tiêu chuẩn Numeric Format Strings và tùy chỉnh Numeric Strings.) DateTime và DateTimeOffset. (Xem Tiêu chuẩn ngày và Format Thời gian Strings và Custom Ngày và Format Thời gian Strings.) Tất cả các loại điều tra. (Xem Format Enumeration Strings.) giá trị TimeSpan. (Xem định dạng tiêu chuẩn TimeSpan Strings và Format tùy chỉnh TimeSpan Strings.) GUID. (Xem Guid.ToString (String) phương pháp.) Tuy nhiên, lưu ý rằng bất kỳ loại tùy chỉnh có thể thực hiện IFormattable hoặc gia hạn thực hiện IFormattable một loại hiện có của. Ví dụ sau đây sử dụng các đối số liên kết và formatString để sản xuất định dạng đầu ra. C # C ++ VB using System; public class Example { public static void Main () { . // Tạo mảng của 5 bộ dữ liệu với dữ liệu dân số cho ba thành phố của Mỹ, 1940-1950 Tuple






































































































































[] Thành phố =
{Tuple.Create ("Los Angeles", DateTime mới (1940, 1, 1), 1.504.277,
DateTime mới (1950, 1, 1), 1.970.358),
Tuple.Create ("New York", mới DateTime (1940, 1, 1), 7.454.995,
DateTime mới (1950, 1, 1), 7.891.957),
Tuple.Create ("Chicago", DateTime mới (1940, 1, 1), 3.396.808,
DateTime mới (1950, 1, 1), 3.620.962),
Tuple.Create ("Detroit", DateTime mới (1940, 1, 1), 1.623.452,
DateTime mới (1950, 1, 1), 1.849.568)}; // Hiển thị tiêu đề tiêu đề string = String.Format ("{0, -12} {1,8} {2,12} {1,8} {2,12} {3,14} n", "Thành phố", "Năm", "dân số", " Thay đổi (%) "); Console.WriteLine (header); sản lượng string; foreach (var thành phố ở các thành phố) { output = String.Format ("{0, -12} {1,8: yyyy} {2,12: N0} {3,8: yyyy} {4,12: N0} {5,14: P1} ", city.Item1, city.Item2, city.Item3, city.Item4, city.Item5, (city.Item5 - city.Item3) / (double) city.Item3); Console.WriteLine (đầu ra); } } } // Ví dụ hiển thị các kết quả như sau: // Thành phố Năm Dân số năm biến động dân số (%) // // Los Angeles 1940 1.504.277 1950 1.970.358 31,0% // New York 1940 7.454.995 1950 7.891.957 5,9% // Chicago 1940 3.396.808 1950 3.620.962 6,6% // Detroit 1940 1.623.452 1950 1.849.568 13,9% như thế nào đối số được định dạng Định dạng các mặt hàng được chế biến theo tuần tự từ đầu của chuỗi. Mỗi mục định dạng có một chỉ số tương ứng với một đối tượng trong argume của phương pháp