AutoGeneratedFieldProperties.DataField プロパティ

.NET Framework クラス ライブラリ リファレンス

AutoGeneratedFieldProperties.DataField プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

AutoGeneratedField オブジェクトにバインドされたフィールドの名前を取得または設定します。

名前空間: System.Web.UI.WebControls
アセンブリ: System.Web (system.web.dll 内)
構文

Visual Basic (宣言)

Public Property DataField As
 String

Visual Basic (使用法)

Dim instance As AutoGeneratedFieldProperties
Dim value As String

value = instance.DataField

instance.DataField = value

C#

public string DataField { get;
 set; }

C++

public:
property String^ DataField {
    String^ get ();
    void set (String^ value);
}

J#

/** @property */
public String get_DataField ()

/** @property */
public void set_DataField (String value)

JScript

public function get DataField
 () : String

public function set DataField
 (value : String)

プロパティ値
AutoGeneratedField にバインドされたフィールドの名前。既定値は空の文字列 ("") です。このプロパティが設定されていないことを示します。

解説

DataField プロパティを使用して、AutoGeneratedField オブジェクトにバインドするデータ フィールドの名前を指定します。AutoGeneratedField オブジェクトは、Type プロパティに基づいて、自動的に該当するコントロールに値を表示します。たとえば、Boolean 値はチェック ボックス コントロールに表示され、String 値はプレーンテキストで表示されます。

使用例

DataField プロパティを使用して、AutoGeneratedField オブジェクトの DataField プロパティに設定する値を決定する方法を次のコード例に示します。

Visual Basic

Imports System.ComponentModel
Imports System.Web.UI
Imports System.Web.UI.WebControls
Imports System.Security.Permissions
Imports System.Web

Namespace Samples.AspNet.VB.Controls

    <AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal),
 AspNetHostingPermission(SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)>
 Public Class SimpleCustomControl
        Inherits System.Web.UI.WebControls.DetailsView

        Protected Overrides Function
 CreateAutoGeneratedRow(ByVal fieldProperties As
 AutoGeneratedFieldProperties) As AutoGeneratedField

            ' Create an AutoGeneratedField object.
            Dim field As New
 AutoGeneratedField(fieldProperties.DataField)

            ' Set the properties of the AutoGeneratedField using
            ' the values from the AutoGeneratedFieldProperties 
            ' object contained in the fieldProperties parameter.
            CType(field, IStateManager).TrackViewState()
            field.HeaderText = fieldProperties.Name
            field.SortExpression = fieldProperties.Name
            field.ReadOnly = fieldProperties.IsReadOnly
            field.DataType = fieldProperties.Type

            Return field

        End Function

    End Class

End Namespace

C#

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Text;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Security.Permissions;
using System.Web;

namespace Samples.AspNet.CS.Controls
{
      
    [AspNetHostingPermission(SecurityAction.Demand, Level=AspNetHostingPermissionLevel.Minimal)]
    [AspNetHostingPermission(SecurityAction.InheritanceDemand, Level=AspNetHostingPermissionLevel.Minimal)]
    public class SimpleCustomControl : DetailsView
    {

        protected override AutoGeneratedField CreateAutoGeneratedRow(AutoGeneratedFieldProperties
 fieldProperties) 
        {

            // Create an AutoGeneratedField object.
            AutoGeneratedField field = new AutoGeneratedField(fieldProperties.DataField);

            // Set the properties of the AutoGeneratedField using
            // the values from the AutoGeneratedFieldProperties 
            // object contained in the fieldProperties parameter.
            ((IStateManager)field).TrackViewState();
            field.HeaderText = fieldProperties.Name;
            field.SortExpression = fieldProperties.Name;
            field.ReadOnly = fieldProperties.IsReadOnly;
            field.DataType = fieldProperties.Type;

            return field;
        }
        
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
AutoGeneratedFieldProperties クラス
AutoGeneratedFieldProperties メンバ
System.Web.UI.WebControls 名前空間
BoundField.DataField
Name