ObjectDataSourceView Class
TOC
Collapse the table of content
Expand the table of content

ObjectDataSourceView Class

 

Supports the ObjectDataSource control and provides an interface for data-bound controls to perform data operations with business and data objects.

Namespace:   System.Web.UI.WebControls
Assembly:  System.Web (in System.Web.dll)

System.Object
  System.Web.UI.DataSourceView
    System.Web.UI.WebControls.ObjectDataSourceView

public class ObjectDataSourceView : DataSourceView, IStateManager

NameDescription
System_CAPS_pubmethodObjectDataSourceView(ObjectDataSource, String, HttpContext)

Initializes a new instance of the ObjectDataSourceView class.

NameDescription
System_CAPS_pubpropertyCanDelete

Gets a value indicating whether the ObjectDataSourceView object that is associated with the current ObjectDataSource control supports the delete operation.(Overrides DataSourceView.CanDelete.)

System_CAPS_pubpropertyCanInsert

Gets a value indicating whether the ObjectDataSourceView object that is associated with the current ObjectDataSource control supports the insert operation.(Overrides DataSourceView.CanInsert.)

System_CAPS_pubpropertyCanPage

Gets a value indicating whether the ObjectDataSourceView object that is associated with the current ObjectDataSource control supports paging through the retrieved data.(Overrides DataSourceView.CanPage.)

System_CAPS_pubpropertyCanRetrieveTotalRowCount

Gets a value indicating whether the ObjectDataSourceView object that is associated with the current ObjectDataSource control supports retrieving the total number of data rows, in addition to the set of data.(Overrides DataSourceView.CanRetrieveTotalRowCount.)

System_CAPS_pubpropertyCanSort

Gets a value indicating whether the ObjectDataSourceView object that is associated with the current ObjectDataSource control supports a sorted view on the underlying data source.(Overrides DataSourceView.CanSort.)

System_CAPS_pubpropertyCanUpdate

Gets a value indicating whether the ObjectDataSourceView object that is associated with the current ObjectDataSource control supports the update operation.(Overrides DataSourceView.CanUpdate.)

System_CAPS_pubpropertyConflictDetection

Gets or sets a value that determines how the ObjectDataSource control performs updates and deletes when data in a row in the underlying data storage changes during the time of the operation.

System_CAPS_pubpropertyConvertNullToDBNull

Gets or sets a value indicating whether Parameter values that are passed to an update, insert, or delete operation are automatically converted from null to the Value value.

System_CAPS_pubpropertyDataObjectTypeName

Gets or sets the name of a class that the ObjectDataSource control uses for a parameter in a data operation. The ObjectDataSource control uses the specified class instead of the Parameter objects that are in the various parameters collections.

System_CAPS_pubpropertyDeleteMethod

Gets or sets the name of the method or function that the ObjectDataSourceView object invokes to delete data.

System_CAPS_pubpropertyDeleteParameters

Gets the parameters collection that contains the parameters that are used by the DeleteMethod method.

System_CAPS_pubpropertyEnablePaging

Gets or sets a value indicating whether the data source control supports paging through the set of data that it retrieves.

System_CAPS_protpropertyEvents

Gets a list of event-handler delegates for the data source view.(Inherited from DataSourceView.)

System_CAPS_pubpropertyFilterExpression

Gets or sets a filtering expression that is applied when the business object method that is identified by the SelectMethod property is called.

System_CAPS_pubpropertyFilterParameters

Gets a collection of parameters that are associated with any parameter placeholders that are in the FilterExpression string.

System_CAPS_pubpropertyInsertMethod

Gets or sets the name of the method or function that the ObjectDataSourceView object invokes to insert data.

System_CAPS_pubpropertyInsertParameters

Gets the parameters collection that contains the parameters that are used by the InsertMethod method.

System_CAPS_protpropertyIsTrackingViewState

Gets a value indicating whether the ObjectDataSourceView object is saving changes to its view state.

System_CAPS_pubpropertyMaximumRowsParameterName

Gets or sets the name of the data retrieval method parameter that is used to indicate the number of records to retrieve for data source paging support.

System_CAPS_pubpropertyName

Gets the name of the data source view.(Inherited from DataSourceView.)

System_CAPS_pubpropertyOldValuesParameterFormatString

Gets or sets a format string to apply to the names of the parameters for original values that are passed to the Delete or Update methods.

System_CAPS_pubpropertyParsingCulture

Gets a or sets a value that indicates what culture information is used when converting string values to actual property types in order to construct an object of the type indicated by DataObjectTypeName.

System_CAPS_pubpropertySelectCountMethod

Gets or sets the name of the method or function that the ObjectDataSourceView control invokes to retrieve a row count.

System_CAPS_pubpropertySelectMethod

Gets or sets the name of the method or function that the ObjectDataSourceView control invokes to retrieve data.

System_CAPS_pubpropertySelectParameters

Gets the parameters collection containing the parameters that are used by the SelectMethod method.

System_CAPS_pubpropertySortParameterName

Gets or sets the name of the data retrieval method parameter that is used to specify a sort expression for data source sorting support.

System_CAPS_pubpropertyStartRowIndexParameterName

Gets or sets the name of the data retrieval method parameter that is used to indicate the integer index of the first record to retrieve from the results set for data source paging support.

System_CAPS_pubpropertyTypeName

Gets or sets the name of the class that the ObjectDataSource control represents.

System_CAPS_pubpropertyUpdateMethod

Gets or sets the name of the method or function that the ObjectDataSourceView object invokes to update data.

System_CAPS_pubpropertyUpdateParameters

Gets the parameters collection containing the parameters that are used by the UpdateMethod method.

NameDescription
System_CAPS_pubmethodCanExecute(String)

Determines whether the specified command can be executed.(Inherited from DataSourceView.)

System_CAPS_pubmethodDelete(IDictionary, IDictionary)

Performs a delete operation by calling the business object method that is identified by the DeleteMethod property using the specified keys and oldValues collections.

System_CAPS_pubmethodDelete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Performs an asynchronous delete operation on the list of data that the DataSourceView object represents.(Inherited from DataSourceView.)

System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodExecuteCommand(String, IDictionary, IDictionary)

Executes the specified command.(Inherited from DataSourceView.)

System_CAPS_pubmethodExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Executes the specified command.(Inherited from DataSourceView.)

System_CAPS_protmethodExecuteDelete(IDictionary, IDictionary)

Performs a delete operation using the DeleteMethod method and the specified keys and oldValues collection.(Overrides DataSourceView.ExecuteDelete(IDictionary, IDictionary).)

System_CAPS_protmethodExecuteInsert(IDictionary)

Performs an insert operation by calling the business object method that is identified by the InsertMethod property using the specified values collection.(Overrides DataSourceView.ExecuteInsert(IDictionary).)

System_CAPS_protmethodExecuteSelect(DataSourceSelectArguments)

Retrieves data from the object that is identified by the TypeName property by calling the method that is identified by the SelectMethod property and passing any values in the SelectParameters collection.(Overrides DataSourceView.ExecuteSelect(DataSourceSelectArguments).)

System_CAPS_protmethodExecuteUpdate(IDictionary, IDictionary, IDictionary)

Performs an update operation by calling the method that is identified by the UpdateMethod property and using any parameters that are supplied in the keys, values, or oldValues collections.(Overrides DataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary).)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_pubmethodInsert(IDictionary)

Performs an insert operation by calling the business object method that is identified by the InsertMethod property using the specified values collection.

System_CAPS_pubmethodInsert(IDictionary, DataSourceViewOperationCallback)

Performs an asynchronous insert operation on the list of data that the DataSourceView object represents.(Inherited from DataSourceView.)

System_CAPS_protmethodLoadViewState(Object)

Restores previously saved view state for the data source view.

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_protmethodOnDataSourceViewChanged(EventArgs)

Raises the DataSourceViewChanged event.(Inherited from DataSourceView.)

System_CAPS_protmethodOnDeleted(ObjectDataSourceStatusEventArgs)

Raises the Deleted event after the ObjectDataSourceView object has completed a delete operation.

System_CAPS_protmethodOnDeleting(ObjectDataSourceMethodEventArgs)

Raises the Deleting event before the ObjectDataSourceView object attempts a delete operation.

System_CAPS_protmethodOnFiltering(ObjectDataSourceFilteringEventArgs)

Raises the Filtering event before the ObjectDataSourceView object attempts a filtering operation.

System_CAPS_protmethodOnInserted(ObjectDataSourceStatusEventArgs)

Raises the Inserted event after the ObjectDataSourceView object has completed an insert operation.

System_CAPS_protmethodOnInserting(ObjectDataSourceMethodEventArgs)

Raises the Inserting event before the ObjectDataSourceView object attempts an insert operation.

System_CAPS_protmethodOnObjectCreated(ObjectDataSourceEventArgs)

Raises the ObjectCreated event after the ObjectDataSourceView creates an instance of the object that is identified by the TypeName property.

System_CAPS_protmethodOnObjectCreating(ObjectDataSourceEventArgs)

Raises the ObjectCreating event before the ObjectDataSourceView object creates an instance of a business object to perform a data operation.

System_CAPS_protmethodOnObjectDisposing(ObjectDataSourceDisposingEventArgs)

Raises the ObjectDisposing event before the ObjectDataSourceView object discards an instantiated type.

System_CAPS_protmethodOnSelected(ObjectDataSourceStatusEventArgs)

Raises the Selected event after the ObjectDataSourceView object has completed a data retrieval operation.

System_CAPS_protmethodOnSelecting(ObjectDataSourceSelectingEventArgs)

Raises the Selecting event before the ObjectDataSourceView object attempts a data retrieval operation.

System_CAPS_protmethodOnUpdated(ObjectDataSourceStatusEventArgs)

Raises the Updated event after the ObjectDataSourceView object has completed an update operation.

System_CAPS_protmethodOnUpdating(ObjectDataSourceMethodEventArgs)

Raises the Updating event before the ObjectDataSourceView object attempts an update operation.

System_CAPS_protmethodRaiseUnsupportedCapabilityError(DataSourceCapabilities)

Called by the RaiseUnsupportedCapabilitiesError method to compare the capabilities requested for an ExecuteSelect operation against those that the view supports.(Inherited from DataSourceView.)

System_CAPS_protmethodSaveViewState()

Saves the changes to the view state for the ObjectDataSourceView object since the time when the page was posted back to the server.

System_CAPS_pubmethodSelect(DataSourceSelectArguments)

Retrieves data from the object that is identified by the TypeName property by calling the method that is identified by the SelectMethod property and passing any values in the SelectParameters collection.

System_CAPS_pubmethodSelect(DataSourceSelectArguments, DataSourceViewSelectCallback)

Gets a list of data asynchronously from the underlying data storage.(Inherited from DataSourceView.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

System_CAPS_protmethodTrackViewState()

Causes the ObjectDataSourceView object to track changes to its view state so that the changes can be stored in the ViewState object for the control and persisted across requests for the same page.

System_CAPS_pubmethodUpdate(IDictionary, IDictionary, IDictionary)

Performs an update operation by calling the method that is identified by the UpdateMethod property and using any parameters that are supplied in the keys, values, or oldValues collections.

System_CAPS_pubmethodUpdate(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

Performs an asynchronous update operation on the list of data that the DataSourceView object represents.(Inherited from DataSourceView.)

NameDescription
System_CAPS_pubeventDataSourceViewChanged

Occurs when the data source view has changed.(Inherited from DataSourceView.)

System_CAPS_pubeventDeleted

Occurs when a Delete operation has completed.

System_CAPS_pubeventDeleting

Occurs before a Delete operation.

System_CAPS_pubeventFiltering

Occurs before a filter operation.

System_CAPS_pubeventInserted

Occurs when an Insert operation has completed.

System_CAPS_pubeventInserting

Occurs before an Insert operation.

System_CAPS_pubeventObjectCreated

Occurs after the ObjectDataSourceView object creates an instance of the type that is identified by the TypeName property.

System_CAPS_pubeventObjectCreating

Occurs before the ObjectDataSourceView object creates an instance of the type that is identified by the TypeName property.

System_CAPS_pubeventObjectDisposing

Occurs when the ObjectDataSourceView object discards an instance of an object that it has created.

System_CAPS_pubeventSelected

Occurs when a data retrieval operation has completed.

System_CAPS_pubeventSelecting

Occurs before a data retrieval operation.

System_CAPS_pubeventUpdated

Occurs when an Update operation has completed.

System_CAPS_pubeventUpdating

Occurs before an Update operation.

NameDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.LoadViewState(Object)

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see IStateManager.LoadViewState.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.SaveViewState()

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see IStateManager.SaveViewState.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStateManager.TrackViewState()

This API supports the product infrastructure and is not intended to be used directly from your code. For a description of this member, see IStateManager.TrackViewState.

System_CAPS_pubinterfaceSystem_CAPS_privpropertyIStateManager.IsTrackingViewState

For a description of this member, see IsTrackingViewState.

The ObjectDataSourceView class is intended primarily to be used by data-bound controls, and not as a programmable object in page code.

The ObjectDataSourceView class implements the data functionality for the ObjectDataSource control, including the Select, Update, Delete, and Insert operations, sorting, filtering, and management of settings kept in view state.

A ObjectDataSourceView object is created for each instance of the ObjectDataSource class at run time. Calls to data operations of the instance of the ObjectDataSource class are handled by the instance of the ObjectDataSourceView object. Page developers do not access the instance of the ObjectDataSourceView class directly. Control developers can create custom data controls by extending the ObjectDataSource and ObjectDataSourceView classes.

The ObjectDataSourceView class performs data operations by calling methods on business or data objects using reflection. At run time, the ObjectDataSource control creates an instance of the type that is identified by the TypeName property, and then calls the appropriate method for the data operation. The instantiated object is not cached in memory by the ObjectDataSourceView. The object is created and destroyed for every data method call. If the method is static (Shared in Visual Basic), an instance is not created but the data operation method is still called.

The ObjectDataSourceView is not directly exposed to page developers by the ObjectDataSource control. Instead, the properties and methods of the ObjectDataSourceView are accessed through the ObjectDataSource. For example, the DeleteMethod of ObjectDataSourceView property is set by setting the DeleteMethod property of the ObjectDataSource.

The most basic operation that a data source view performs is data retrieval from the underlying data storage using the Select method, which retrieves an IEnumerable collection of data items. The following data retrieval methods, properties, and events are implemented by the ObjectDataSourceView object and exposed directly by its ObjectDataSource control to page developers and other callers:

The ObjectDataSourceView object supports data updates by calling a business or data object method that is identified by the UpdateMethod property. Data-bound controls that automatically perform updates, such as the GridView and DetailsView controls, pass their parameters in an IOrderedDictionary interface to the ObjectDataSourceView and the view object merges these parameters with any parameters that are found in the UpdateParameters collection.

The following update methods, properties, and events are implemented by the ObjectDataSourceView and exposed directly by its ObjectDataSource control to page developers and other callers:

The ObjectDataSourceView object supports inserting new rows of data by calling a business or data object method that is identified by the InsertMethod property. Data-bound controls that automatically perform inserts, such as the GridView and DetailsView, pass their parameters in an IOrderedDictionary interface to the ObjectDataSourceView and the view object merges these parameters with any parameters that are found in the InsertParameters collection.

The following insert methods, properties, and events are implemented by the ObjectDataSourceView and exposed directly by its ObjectDataSource control to page developers and other callers:

The ObjectDataSourceView object supports deleting data by calling a business or data object method that is identified by the DeleteMethod property. Data-bound controls that automatically perform deletes, such as the GridView and DetailsView, pass their parameters in an IOrderedDictionary interface to the ObjectDataSourceView and the view object merges these parameters with any parameters that are found in the DeleteParameters collection. The following delete methods, properties, and events are implemented by the ObjectDataSourceView and exposed directly by its ObjectDataSource control to page developers and other callers:

Data retrieval is more powerful when you can filter the data dynamically. Filtering is supported only by the ObjectDataSource control if the Select method returns a DataTable or DataSet object. You can use the FilterExpression and FilterParameters properties to apply dynamic filtering to data retrieval. These properties are implemented by the ObjectDataSourceView object and exposed directly by its ObjectDataSource control to data-bound controls and other callers.

You can sort the data that you retrieve with the ObjectDataSource by ordering the data in memory after it is retrieved. Sorting is supported only by the ObjectDataSource control if the Select method returns a DataTable or DataSet. The CanSort property always returns true, because the ObjectDataSourceView cannot determine what type is returned by the Select method without calling the method. The SortExpression property syntax is the same as for a DataView.Sort property.

The ObjectDataSourceView implements the IStateManager interface and uses view state to track its state across page requests. Implementation of the LoadViewState, SaveViewState, and TrackViewState methods are provided to enable view state tracking for the control. For more information, see ASP.NET State Management Overview.

.NET Framework
Available since 2.0

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show:
© 2016 Microsoft