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

XmlDataSourceView Class

 

Represents a tabular data source view on XML data for an XmlDataSource control.

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

System.Object
  System.Web.UI.DataSourceView
    System.Web.UI.WebControls.XmlDataSourceView

public sealed class XmlDataSourceView : DataSourceView

NameDescription
System_CAPS_pubmethodXmlDataSourceView(XmlDataSource, String)

Initializes a new named instance of the XmlDataSourceView class, and associates the specified XmlDataSource with it.

NameDescription
System_CAPS_pubpropertyCanDelete

Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports the ExecuteDelete operation.(Inherited from DataSourceView.)

System_CAPS_pubpropertyCanInsert

Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports the ExecuteInsert operation.(Inherited from DataSourceView.)

System_CAPS_pubpropertyCanPage

Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports paging through the data retrieved by the ExecuteSelect method.(Inherited from DataSourceView.)

System_CAPS_pubpropertyCanRetrieveTotalRowCount

Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports retrieving the total number of data rows, instead of the data.(Inherited from DataSourceView.)

System_CAPS_pubpropertyCanSort

Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports a sorted view on the underlying data source.(Inherited from DataSourceView.)

System_CAPS_pubpropertyCanUpdate

Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports the ExecuteUpdate operation.(Inherited from DataSourceView.)

System_CAPS_pubpropertyName

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

NameDescription
System_CAPS_pubmethodCanExecute(String)

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

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_pubmethodExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Executes the specified command.(Inherited from DataSourceView.)

System_CAPS_protmethodExecuteSelect(DataSourceSelectArguments)

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

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, DataSourceViewOperationCallback)

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

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_pubmethodSelect(DataSourceSelectArguments)

Retrieves a list of data rows from the underlying XML.

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_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.)

The XmlDataSource control can present its underlying data in both tabular and hierarchical format to Web server controls that bind to it. Controls such as GridView or DropDownList use the XmlDataSource to bind to XML data and present it in list or tabular form, while controls that derive from the HierarchicalDataBoundControl class, such as TreeView, bind to XML data and present it in hierarchical form.

The XmlDataSource creates each view type internally through different code paths. If the GetView method is called on the XmlDataSource, an XmlDataSourceView is created by the XmlDataSource. If the GetHierarchicalView method is called, an XmlHierarchicalDataSourceView is created. The XmlDataSourceView class is provided for Web server controls that derive from DataBoundControl and bind to lists and tabular data, while the XmlHierarchicalDataSourceView is provided for Web server controls that derive from HierarchicalDataBoundControl and bind to hierarchical data. Internally, all data-bound control methods call the Select method on whichever data source view object is returned.

Like all DataSourceView helper objects, the XmlDataSourceView defines the operations that the data source can perform with the underlying data. Because the XmlDataSourceView class only overrides the Select method, the associated XmlDataSource control does not support update, insert, or delete operations. Because the XmlDataSourceView class is sealed, you cannot extend the XmlDataSourceView class to add this functionality, but you can derive a data source control from XmlDataSource and a view from DataSourceView if you require additional functionality.

.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