This topic has not yet been rated - Rate this topic

DataBoundControl.GetData Method

Retrieves a DataSourceView object that the data-bound control uses to perform data operations.

Namespace:  System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)
protected virtual DataSourceView GetData()

Return Value

Type: System.Web.UI.DataSourceView
The DataSourceView that the data-bound control uses to perform data operations. If the DataMember property is set, a specific, named DataSourceView is returned; otherwise, the default DataSourceView is returned.
ExceptionCondition
InvalidOperationException

Both the DataSource and DataSourceID properties are set.

- or -

The DataMember property is set but a DataSourceView object by that name does not exist.

The GetData method retrieves a DataSourceView object from the associated data source control by calling the GetDataSource method. If the DataSource property is used to identify a data source, a default DataSourceView object is created.

The following code example demonstrates how the GetData method is called to retrieve the DataSourceView object from the associated data source control and the Select method is called to retrieve the data. This code example is part of a larger example provided for the DataBoundControl class.

protected override void PerformSelect() {            

   // Call OnDataBinding here if bound to a data source using the 
   // DataSource property (instead of a DataSourceID), because the 
   // databinding statement is evaluated before the call to GetData.        
    if (! IsBoundUsingDataSourceID) {
        OnDataBinding(EventArgs.Empty);
    }            

    // The GetData method retrieves the DataSourceView object from   
    // the IDataSource associated with the data-bound control.            
    GetData().Select(CreateDataSourceSelectArguments(), 
        OnDataSourceViewSelectCallback);

    // The PerformDataBinding method has completed.
    RequiresDataBinding = false;
    MarkAsDataBound();

    // Raise the DataBound event.
    OnDataBound(EventArgs.Empty);
}

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Did you find this helpful?
(1500 characters remaining)
© 2013 Microsoft. All rights reserved.