DataGridViewRow.DataBoundItem Property

Definition

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

The data-bound Object.

Attributes

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

See also