DataGridViewRow.DataBoundItem Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the data-bound object that populated the row.

public:
 property System::Object ^ DataBoundItem { System::Object ^ get(); };

[System.ComponentModel.Browsable(false)]
public object DataBoundItem { get; }

[System.ComponentModel.Browsable(false)]
public object? DataBoundItem { get; }

[<System.ComponentModel.Browsable(false)>]
member this.DataBoundItem : obj

Public ReadOnly Property DataBoundItem As Object

Property Value

Object

The data-bound Object.

Attributes: BrowsableAttribute

Examples

The following code example demonstrates how to use the DataBoundItem property to access a business object bound to a row. This code example is part of a larger example provided in How to: Access Objects Bound to Windows Forms DataGridView Rows.

void invoiceButton_Click(object sender, EventArgs e)
{
    foreach (DataGridViewRow row in this.dataGridView1.SelectedRows)
    {
        Customer cust = row.DataBoundItem as Customer;
        if (cust != null)
        {
            cust.SendInvoice();
        }
    }
}

Private Sub InvoiceButton_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles InvoiceButton.Click

    For Each row As DataGridViewRow In Me.DataGridView1.SelectedRows

        Dim cust As Customer = TryCast(row.DataBoundItem, Customer)
        If cust IsNot Nothing Then
            cust.SendInvoice()
        End If

    Next

End Sub

Remarks

Accessing data-bound objects directly through row objects is useful when you do not have direct access to the data source containing the objects. It is also convenient when you want to manipulate objects bound to selected rows or to rows passed as arguments to event handlers.

Applies to

Jaa