XmlDataSourceView Class

Reference

Definition

Namespace:: System.Web.UI.WebControls

Assembly:: System.Web.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.

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

public ref class XmlDataSourceView sealed : System::Web::UI::DataSourceView

public sealed class XmlDataSourceView : System.Web.UI.DataSourceView

type XmlDataSourceView = class
    inherit DataSourceView

Public NotInheritable Class XmlDataSourceView
Inherits DataSourceView

Inheritance: Object

DataSourceView
XmlDataSourceView

Remarks

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.

Constructors

XmlDataSourceView(XmlDataSource, String)

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

Properties

CanDelete	Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports the ExecuteDelete(IDictionary, IDictionary) operation. (Inherited from DataSourceView)
CanInsert	Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports the ExecuteInsert(IDictionary) operation. (Inherited from DataSourceView)
CanPage	Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports paging through the data retrieved by the ExecuteSelect(DataSourceSelectArguments) method. (Inherited from DataSourceView)
CanRetrieveTotalRowCount	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)
CanSort	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)
CanUpdate	Gets a value indicating whether the DataSourceView object associated with the current DataSourceControl object supports the ExecuteUpdate(IDictionary, IDictionary, IDictionary) operation. (Inherited from DataSourceView)
Events	Gets a list of event-handler delegates for the data source view. (Inherited from DataSourceView)
Name	Gets the name of the data source view. (Inherited from DataSourceView)

Methods

CanExecute(String)	Determines whether the specified command can be executed. (Inherited from DataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Performs an asynchronous delete operation on the list of data that the DataSourceView object represents. (Inherited from DataSourceView)
Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
ExecuteCommand(String, IDictionary, IDictionary)	Executes the specified command. (Inherited from DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Executes the specified command. (Inherited from DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Performs a delete operation on the list of data that the DataSourceView object represents. (Inherited from DataSourceView)
ExecuteInsert(IDictionary)	Performs an insert operation on the list of data that the DataSourceView object represents. (Inherited from DataSourceView)
ExecuteSelect(DataSourceSelectArguments)	Gets a list of data from the underlying data storage. (Inherited from DataSourceView)
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Performs an update operation on the list of data that the DataSourceView object represents. (Inherited from DataSourceView)
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetType()	Gets the Type of the current instance. (Inherited from Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Performs an asynchronous insert operation on the list of data that the DataSourceView object represents. (Inherited from DataSourceView)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
OnDataSourceViewChanged(EventArgs)	Raises the DataSourceViewChanged event. (Inherited from DataSourceView)
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	Called by the RaiseUnsupportedCapabilitiesError(DataSourceView) method to compare the capabilities requested for an ExecuteSelect(DataSourceSelectArguments) operation against those that the view supports. (Inherited from DataSourceView)
Select(DataSourceSelectArguments)	Retrieves a list of data rows from the underlying XML.
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Gets a list of data asynchronously from the underlying data storage. (Inherited from DataSourceView)
ToString()	Returns a string that represents the current object. (Inherited from Object)
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Performs an asynchronous update operation on the list of data that the DataSourceView object represents. (Inherited from DataSourceView)

Events

DataSourceViewChanged

Occurs when the data source view has changed.

(Inherited from DataSourceView)

Applies to