DataField プロパティ (Barcode)

データソースの、コントロールに連結するフィールドの名前を取得または設定します。

シンタックス

Visual Basic
C#

'宣言
 
Public Overrides NotOverridable Property DataField As String

public override string DataField {get; set;}

プロパティ値

連結するデータフィールドの名前。デフォルトは空の文字列で、コントロールは連結されません。

解説

DataFieldプロパティに DataSource 内に含まれるフィールドが設定されると、ActiveReportsは、そのフィールドのデータを各レコードからコントロールに連結します。レコードセットデータは、まず Value プロパティに保存されます。次に任意の出力形式に変換され、コントロールのテキストとして設定されます。

また、プロパティを設定するときに先頭に"="を付け、スクリプト表現を使用することで、DataFieldプロパティで計算を実行できます。つまり、計算した結果をフィールドに表示できます。たとえば、フィールドコントロールまたはグループセクションのデータフィールドを "=UnitPrice * Qty" または "=CompanyName.Trim()" のように設定できます（QtyおよびCompanyNameはレポートのFieldコレクションのメンバ）。

DataFieldプロパティでパラメータを使用する場合は、"=param:Parameter1"のように先頭に"="を付けてください。

XMLを使用するときは、DataFieldに有効なXpath表現を設定する必要があります。

使用例

VB.NET

Private Sub SectionReport1_ReportStart(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.ReportStart
    Me.TextBox2.DataField = "CustomerID"
End Sub

private void SectionReport1_ReportStart(object sender, System.EventArgs eArgs) 
{ 
    this.textBox2.DataField = "CustomerID"; 
}

DataFieldプロパティでパラメータを使用する場合

VB.NET

Private Sub SectionReport1_ReportStart(ByVal sender As Object, ByVal e As System.EventArgs) Handles MyBase.ReportStart
    Me.TextBox2.DataField = "CustomerID"
    Me.CheckBox1.DataField = "=param:Parameter1"
End Sub

private void SectionReport1_ReportStart(object sender, System.EventArgs eArgs) 
{ 
    this.textBox2.DataField = "CustomerID"; 
    this.checkBox1.DataField = "=param:Parameter1"; 
}

プラットフォーム

参照

Barcode クラス
 Barcode メンバ