DataField プロパティ

Cellのバインド先のデータソースフィールドの名前を取得または設定します。

構文

Visual Basic (宣言)
C#

Public Property DataField As String

public string DataField {get; set;}

プロパティ値

セルに関連付けられたデータソースフィールドの名前を表すSystem.String値。既定値はString.Emptyです。

解説

データソースをGcMultiRowコントロールにバインドする場合は、Templateを作成するときに、このプロパティにデータソースの列の名前を設定します。その後、GcMultiRowのGcMultiRow.DataSourceにデータソースを設定すると、DataFieldプロパティの値と一致する名前を持つデータソース列の内容がこのセルに表示されます。

使用例

次のサンプルコードは、このプロパティを使用してデータソースの特定の列にバインドする方法を示します。このサンプルコードは、GcMultiRow.DataSourceプロパティに示されている詳細なコード例の一部を抜粋したものです。

C#
Visual Basic

Template CreateDataBindingTamplate()
{
    TextBoxCell idCell = new TextBoxCell();

    // Binding a column of data source.
    // The value of DataField property should a exist column name in data source. 
    idCell.DataField = "ID";

    TextBoxCell nameCell = new TextBoxCell();
    nameCell.DataField = "Name";

    CheckBoxCell genderCell = new CheckBoxCell();
    genderCell.DataField = "Gender";

    Cell[] cells = new Cell[] { idCell, nameCell, genderCell };

    return Template.CreateGridTemplate(cells);
}

Private Function CreateDataBindingTamplate() As Template
    Dim idCell As New TextBoxCell()

    ' Binding a column of data source.
    ' The value of DataField property should a exist column name in data source. 
    idCell.DataField = "ID"

    Dim nameCell As New TextBoxCell()
    nameCell.DataField = "Name"

    Dim genderCell As New CheckBoxCell()
    genderCell.DataField = "Sex"

    Dim cells As Cell() = New Cell() {idCell, nameCell, genderCell}

    Return Template.CreateGridTemplate(cells)
End Function

参照

Cell クラス
 Cell メンバ