ListControl.DataTextFormatString プロパティ

定義

リスト コントロールに連結されたデータの表示方法を制御するために使用する書式指定文字列を取得または設定します。

public:
 virtual property System::String ^ DataTextFormatString { System::String ^ get(); void set(System::String ^ value); };
public virtual string DataTextFormatString { get; set; }
[System.Web.UI.Themeable(false)]
public virtual string DataTextFormatString { get; set; }
member this.DataTextFormatString : string with get, set
[<System.Web.UI.Themeable(false)>]
member this.DataTextFormatString : string with get, set
Public Overridable Property DataTextFormatString As String

プロパティ値

コントロールに連結されたデータの書式指定文字列。 既定値は Empty です。

属性

注釈

プロパティを DataTextFormatString 使用して、リスト コントロール内の項目のカスタム表示形式を指定します。

データ書式指定文字列は、コロンで区切られた 2 つの部分で構成されます({ A : Bxx })。 たとえば、書式設定文字列 {0:F2} では、小数点以下 2 桁の固定小数点番号を表示するようにセルの書式を設定します。

注意

文字列全体を中かっこで囲んで、リテラル文字列ではなく書式指定文字列であることを示す必要があります。 中かっこの外側のテキストは、リテラル テキストとして表示されます。

コロン (A 一般的な例では) の前の値は、パラメーターの 0 から始まるリスト内のパラメーター インデックスを指定します。

注意

この値は、各セルに 1 つの値しかないため、0 にのみ設定できます。

コロン (B 一般的な例では) の後の文字は、値を表示する形式を指定します。 次の表に、一般的な形式を示します。

文字の書式設定 説明
C 数値を通貨形式で表示します。
D 数値を 10 進形式で表示します。
E 数値を指数 (指数) 形式で表示します。
F 数値を固定形式で表示します。
G 数値を一般的な形式で表示します。
N 数値を数値形式で表示します。
X 数値を 16 進数形式で表示します。

注意

書式文字では、 を除き X、大文字と小文字は区別されません。指定された大文字と小文字の区別で 16 進文字が表示されます。

書式文字の後の値 (xx 一般的な例では) は、表示する有効桁数または小数点以下の桁数を指定します。

次の表に、文字列と結果の書式設定の例を示します。 英語の標準設定を前提としています。

数値 書式設定文字列 結果
12345.6789 "{0:C}" $12,345.68
-12345.6789 "{0:C}" ($12,345.68)
12345 "{0:D}" 12345
12345 "{0:D8}" 00012345
12345.6789 "{0:E}" 1234568E+004
12345.6789 "{0:E10}" 1.2345678900E+004
12345.6789 "{0:F}" 12345.68
12345.6789 "{0:F0}" 12346
12345.6789 "{0:G}" 12345.6789
123456789 "{0:G7}" 1.234568E8
12345.6789 "{0:N}" 12,345.68
123456789 "{0:N4}" 123,456,789.0000
12345.6789 "Total: {0:C}" 合計: $12345.68

書式指定文字列の詳細については、「Formatting Types」(型の書式設定) を参照してください。

このプロパティの値はビューステートに格納されます。

このプロパティは、テーマまたはスタイル シート テーマによって設定することはできません。 詳細については、「テーマとスキン」と「ASP.NET」を参照してくださいThemeableAttribute

適用対象

こちらもご覧ください