KaxTabControl.DataValueField Property

KaxTabControlDataValueField Property

Gets or sets the field of the data source that provides the value of the tabs.

Namespace: Kettic.AspNet.Controls
Assembly: Kettic.AspNet.Controls (in Kettic.AspNet.Controls.dll) Version: 2014.4.1129.0 (2014.04.1129.0)

Syntax

C++

Copy

public override string DataValueField { get; set; }

Public Overrides Property DataValueField As String
	Get
	Set

public:
virtual property String^ DataValueField {
	String^ get () override;
	void set (String^ value) override;
}

abstract DataValueField : string with get, set
override DataValueField : string with get, set

Property Value

Type: String
A string that specifies the field of the data source that provides the value of the tabs. The default value is empty string.

Remarks

Use the DataValueField property to specify the field of the data source (in most cases the name of the database column) which provides the values for the Value property of databound tabs. The DataValueField property is taken into account only during data binding. If the DataValueField property is not set the Value property of databound tabs will have its default value - empty string.

Examples

The following example demonstrates how to use the DataValueField.

C++

Copy

DataTable data = new DataTable();
data.Columns.Add("MyText");
data.Columns.Add("MyValue");

data.Rows.Add(new object[] {"Tab Text 1", "Tab Value 1"});
data.Rows.Add(new object[] {"Tab Text 2", "Tab Value 2"});

KaxTabControl1.DataSource = data;
KaxTabControl1.DataTextField = "MyText";        //"MyText" column provides values for the Text property of databound tabs
KaxTabControl1.DataValueField = "MyValue";    //"MyValue" column provides values for the Value property of databound tabs
KaxTabControl1.DataBind();

Dim data As new DataTable();
data.Columns.Add("MyText")
data.Columns.Add("MyValue")

data.Rows.Add(New Object() {"Tab Text 1", "Tab Value 1"})
data.Rows.Add(New Object() {"Tab Text 2", "Tab Value 2"})

KaxTabControl1.DataSource = data
KaxTabControl1.DataTextField = "MyText"        '"MyText" column provides values for the Text property of databound tabs
KaxTabControl1.DataValueField = "MyValue"        '"MyValue" column provides values for the Value property of databound tabs
KaxTabControl1.DataBind()

Reference

KaxTabControl Class

Kettic.AspNet.Controls Namespace