ListControl.DataTextFormatString プロパティ

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

String

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

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

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

注意

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

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

注意

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

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

注意

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

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

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

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

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

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