Dataformatstring属性を設定する(詳細)
DataFormatString プロパティはデータの表示形式を設定するプロパティです。これは、Label や GridView、DataList などの各種データコントロールで使用できます。
データに日付、数値、通貨などの形式を指定するには、DataFormatString プロパティを使用します。このプロパティは、.NET の標準形式仕様に従う形式文字列をパラメータとして受け取ります。
次に一般的な書式文字列の例をいくつか示します。
日付の形式:
- 「d」: 3/15/2021 のような短い日付形式
- 「D」 長い日付形式(例:2021年3月15日)
- 「yyyy-MM-dd」: 2021-03-15 のような日付書式をカスタマイズします。
数字フォーマット:
- 「N」:1,234.00のように千単位に区切り記号を付ける数字の書式
- 「C」: 通貨の形式で、例: 1,234.00 ドル
- 「P」:パーセント形式、例えば 12.34%
生まれつきの形で
- 「0.00」:小数第2位まで表示
- 「###-###-####」: 123-456-7890のようなカスタム電話フォーマット
DataFormatString プロパティを使用する例:
<asp:Label ID="lblDate" runat="server" Text='<%# Bind("Date", "{0:d}") %>'></asp:Label>
<asp:Label ID="lblAmount" runat="server" Text='<%# Bind("Amount", "{0:C}") %>'></asp:Label>
上記サンプルでは、データをバインドするためにBindメソッドが使用され、DataFormatStringプロパティはそれぞれ日付と金額を短い日付と通貨形式にフォーマットするために「{0:d}」および「{0:C}」に設定されています。
注意事項:
- DataFormatStringプロパティはデータの表示にしか利用できず、データの入力には使用できません。
- DataFormatString 属性はバインド式(<%# Bind() %> など)に対してのみ使用することができ、プレーンテキストに対しては使用できません。
- DataFormatString プロパティは、Label、Literal、GridView の BoundField など、バインドされたデータを表示するコントロールに対してのみ有効です。