1 out of 19 rated this helpful - Rate this topic

DataGridView.DataMember Property

.NET Framework 2.0

Other Versions

Note: This property is new in the .NET Framework version 2.0.

Gets or sets the name of the list or table in the data source for which the DataGridView is displaying data.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

C++

public string DataMember { get; set; }

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

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

JScript

public function get DataMember () : String

public function set DataMember (value : String)

Property Value

The name of the table or list in the DataSource for which the DataGridView is displaying data. The default is Empty.

Exceptions

Exception type	Condition
Exception	An error occurred in the data source and either there is no handler for the DataError event or the handler has set the DataGridViewDataErrorEventArgs.ThrowException property to true. The exception object can typically be cast to type FormatException.

Remarks

This property is useful when binding to a data source that contains multiple lists or tables. You do not need to set this property when binding to a data source that contains a single list or table. For example, you can bind a DataGridView control to a DataSet that contains a single table without setting this property. If the DataSet contains multiple tables, however, you must set this property to the name of one of the tables.

Example

The following code example illustrates a common use for this property. In the example, a DataGridView control named customersDataGridView is bound to a DataSet named customersDataSet. This DataSet contains a table named "Customers". The DataMember property is set to the name of the table.

Platforms

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

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see System Requirements.

Version Information

.NET Framework

Supported in: 2.0

Reference

DataGridView Class
DataGridView Members
System.Windows.Forms Namespace
DataSource
DataSet

Other Resources

DataGridView Control (Windows Forms)

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD