LinqDataSourceView Class (System.Web.UI.WebControls)

Switch View :

Classic

Lightweight

ScriptFree

Site Feedback

.NET Framework Class Library

LinqDataSourceView Class

Supports the LinqDataSource control and provides an interface for data-bound controls to perform LINQ data operations.

Inheritance Hierarchy

System.Object
  System.Web.UI.DataSourceView
    System.Web.UI.WebControls.QueryableDataSourceView
      System.Web.UI.WebControls.ContextDataSourceView
        System.Web.UI.WebControls.LinqDataSourceView

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

Syntax

Visual Basic

Public Class LinqDataSourceView _
	Inherits ContextDataSourceView

public class LinqDataSourceView : ContextDataSourceView

Visual C++

public ref class LinqDataSourceView : public ContextDataSourceView

type LinqDataSourceView =  
    class
        inherit ContextDataSourceView
    end

The LinqDataSourceView type exposes the following members.

Constructors

	Name	Description
	LinqDataSourceView	Initializes a new instance of the LinqDataSourceView class, setting the specified LinqDataSource control as the owner of the current view.

Top

Properties

	Name	Description
	AutoGenerateOrderByClause	Gets or sets a value that indicates whether the QueryableDataSourceView object that is associated with the current QueryableDataSource control creates a dynamic an OrderBy clause. (Inherited from QueryableDataSourceView.)
	AutoGenerateWhereClause	Gets or sets a value that indicates whether the QueryableDataSourceView object that is associated with the current QueryableDataSource control creates a dynamic Where clause. (Inherited from QueryableDataSourceView.)
	AutoPage	Gets or sets a value that indicates whether the QueryableDataSourceView object that is associated with the current QueryableDataSource control supports paging by default. (Inherited from QueryableDataSourceView.)
	AutoSort	Gets or sets a value that indicates whether the QueryableDataSourceView object that is associated with the current QueryableDataSource control supports sorting by default. (Inherited from QueryableDataSourceView.)
	CanDelete	Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports the delete operation. (Overrides QueryableDataSourceView.CanDelete.)
	CanInsert	Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports the insert operation. (Overrides QueryableDataSourceView.CanInsert.)
	CanPage	Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports paging of retrieved data. (Overrides QueryableDataSourceView.CanPage.)
	CanRetrieveTotalRowCount	Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports retrieving the total number of data rows, in addition to retrieving the data. (Overrides QueryableDataSourceView.CanRetrieveTotalRowCount.)
	CanSort	Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports a sorted view of the retrieved data. (Overrides QueryableDataSourceView.CanSort.)
	CanUpdate	Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports the update operation. (Overrides QueryableDataSourceView.CanUpdate.)
	Context	Gets or sets the current data context. (Inherited from ContextDataSourceView.)
	ContextType	Gets the type of the data context class. (Overrides ContextDataSourceView.ContextType.)
	ContextTypeName	Gets or sets the name of the data context class that contains the field or property specified in the TableName property. (Overrides ContextDataSourceView.ContextTypeName.)
	DeleteParameters	Gets the collection that contains the parameters that are used during a delete operation. (Inherited from QueryableDataSourceView.)
	EnableDelete	Gets or sets a value that indicates whether the data source view supports deleting rows.
	EnableInsert	Gets or sets a value that indicates whether the data source view supports adding new rows.
	EnableObjectTracking	Gets or sets a value that indicates whether changes to the data-context object are tracked.
	EnableUpdate	Gets or sets a value that indicates whether the data source view supports updating rows.
	EntitySet	Gets or sets the object that contains the value of the data to retrieve. (Inherited from ContextDataSourceView.)
	EntitySetName	Gets or sets the name of the property or field in the data-context class that represents a data collection. (Inherited from ContextDataSourceView.)
	EntitySetType	Gets or sets the name of the object that is created for an insert, delete, or update operation. (Inherited from ContextDataSourceView.)
	EntityType	Gets or sets the object that is created for an insert, delete, or update operation. (Inherited from ContextDataSourceView.)
	EntityTypeName	Gets or sets the name of the object that is created for an insert, delete, or update operation. (Inherited from ContextDataSourceView.)
	Events	Gets a list of event-handler delegates for the data source view. (Inherited from DataSourceView.)
	GroupBy	Gets or sets the name or names of the properties to use during the select operation for grouping data. (Inherited from QueryableDataSourceView.)
	GroupByParameters	Gets a collection of parameters whose values are used to create the GroupBy clause during the select operation. (Inherited from QueryableDataSourceView.)
	InsertParameters	Gets a collection of parameters that are used during the insert operation. (Inherited from QueryableDataSourceView.)
	IsTrackingViewState	Gets a value that indicates whether the QueryableDataSourceView object is saving changes to its view state. (Inherited from QueryableDataSourceView.)
	Name	Gets the name of the data source view. (Inherited from DataSourceView.)
	OrderBy	Gets or sets the name or names of the properties that are used during the select operation to sort data. (Inherited from QueryableDataSourceView.)
	OrderByParameters	Gets a collection of parameters that are used during the select operation to sort data. (Inherited from QueryableDataSourceView.)
	OrderGroupsBy	Gets or sets the names of the properties that are used during the select operation to sort grouped data. (Inherited from QueryableDataSourceView.)
	OrderGroupsByParameters	Gets a collection of parameters that are used to create the OrderGroupsBy clause. (Inherited from QueryableDataSourceView.)
	SelectNew	Gets or sets the properties and calculated values that are included in the retrieved data. (Inherited from QueryableDataSourceView.)
	SelectNewParameters	Gets the collection of parameters that are used during a data-retrieval operation. (Inherited from QueryableDataSourceView.)
	StoreOriginalValuesInViewState	Gets or sets a value that indicates that original values from the select operation will be stored in view state when delete or update operations are enabled.
	TableName	Gets or sets the name of a property or field of the data context class that contains the data collection.
	UpdateParameters	Gets the collection of parameters that are used during an update operation. (Inherited from QueryableDataSourceView.)
	Where	Gets or sets a value that specifies what conditions must be true for a row to be included in the retrieved data. (Inherited from QueryableDataSourceView.)
	WhereParameters	Gets a collection of parameters that are used to create a Where clause. (Inherited from QueryableDataSourceView.)

Top

Methods

	Name	Description
	BuildDeleteObject	Creates the objects to use for the delete operation. (Inherited from QueryableDataSourceView.)
	BuildInsertObject	Creates the objects to use for the insert operation by using the values to insert and the error message to display if the operation fails. (Inherited from QueryableDataSourceView.)
	BuildQuery	Creates a Select query expression by using the select arguments of the data source. (Inherited from QueryableDataSourceView.)
	BuildUpdateObjects	Creates the objects to use for the update operation by using the specified values. (Inherited from QueryableDataSourceView.)
	CanExecute	Determines whether the specified command can be executed. (Inherited from DataSourceView.)
	ClearOriginalValues	Clears the original values. (Inherited from QueryableDataSourceView.)
	CreateContext(DataSourceOperation)	Creates an instance of the data context type using the specified data source operation. (Overrides ContextDataSourceView.CreateContext(DataSourceOperation).)
	CreateContext(Type)	Creates an instance of the data context type.
	CreateQueryContext	Creates an instance of a query context object that contains the evaluated parameter collections. (Inherited from QueryableDataSourceView.)
	Delete(IDictionary, IDictionary)	Performs a delete operation. (Inherited from QueryableDataSourceView.)
	Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	Performs an asynchronous delete operation on the list of data that the DataSourceView object represents. (Inherited from DataSourceView.)
	DeleteDataObject	Deletes a data object from a table.
	DeleteObject	Deletes a data object from a table. (Overrides QueryableDataSourceView.DeleteObject(Object).)
	DisposeContext()	Disposes the context after an operation is performed. (Inherited from ContextDataSourceView.)
	DisposeContext(Object)	Disposes the data context. (Overrides ContextDataSourceView.DisposeContext(Object).)
	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	Performs a delete operation by using the specified keys and old values. (Overrides ContextDataSourceView.ExecuteDelete(IDictionary, IDictionary).)
	ExecuteInsert	Performs an insert operation by using the values specified in a collection. (Overrides ContextDataSourceView.ExecuteInsert(IDictionary).)
	ExecutePaging	Executes paging by using the QueryContext object from the QueryableDataSource object. (Inherited from QueryableDataSourceView.)
	ExecuteQuery	Performs a query, sort, or paging operation on the IQueryable<T> object. (Inherited from QueryableDataSourceView.)
	ExecuteQueryExpressions	Executes query expressions by using an IQueryable object and the QueryContext object. (Inherited from QueryableDataSourceView.)
	ExecuteSelect	Performs a data retrieval operation. (Overrides QueryableDataSourceView.ExecuteSelect(DataSourceSelectArguments).)
	ExecuteSorting	Performs a sorting operation. (Inherited from QueryableDataSourceView.)
	ExecuteUpdate	Performs an update operation. (Overrides ContextDataSourceView.ExecuteUpdate(IDictionary, IDictionary, IDictionary).)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetDataObjectType	Retrieves the type of data object to use for the delete, insert, and update operations. (Inherited from ContextDataSourceView.)
	GetEntitySetType	Retrieves the entity set as a property, field, or data context. (Inherited from ContextDataSourceView.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetOriginalValues	Retrieves the original values for the specified keys that were stored during the Select operation. (Inherited from QueryableDataSourceView.)
	GetSource	Returns the data source to apply a query to. (Overrides ContextDataSourceView.GetSource(QueryContext).)
	GetTableMemberInfo	Retrieves metadata about the data collection.
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	HandleValidationErrors	Handles any exceptions that occur when a data operation fails while a data object is being created. (Overrides QueryableDataSourceView.HandleValidationErrors(IDictionary<String, Exception>, DataSourceOperation).)
	Insert(IDictionary)	Performs an asynchronous insert operation on the data items that the QueryableDataSourceView object represents. (Inherited from QueryableDataSourceView.)
	Insert(IDictionary, DataSourceViewOperationCallback)	Performs an asynchronous insert operation on the list of data that the DataSourceView object represents. (Inherited from DataSourceView.)
	InsertDataObject	Inserts a data object into a table.
	InsertObject	Inserts a data object into a LinqDataSourceView object. (Overrides QueryableDataSourceView.InsertObject(Object).)
	LoadViewState	Restores the previously saved view state for the data source view. (Inherited from QueryableDataSourceView.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	OnContextCreated	Raises the ContextCreated event
	OnContextCreating	Raises the ContextCreating event.
	OnContextDisposing	Raises the ContextDisposing event.
	OnDataSourceViewChanged	Raises the DataSourceViewChanged event. (Inherited from DataSourceView.)
	OnDeleted	Raises the Deleted event.
	OnDeleting	Raises the Deleting event.
	OnException	Raises the Exception event when a data operation fails.
	OnInserted	Raises the Inserted event after the LinqDataSource control has completed an insert operation.
	OnInserting	Raises the Inserting event.
	OnQueryCreated	Raises the QueryCreated event after the QueryableDataSource control has created an IQueryable object. (Inherited from QueryableDataSourceView.)
	OnQueryParametersChanged	Calls the RaiseViewChanged method. (Inherited from QueryableDataSourceView.)
	OnSelected	Raises the Selected event after the LinqDataSource control has completed a data retrieval operation.
	OnSelecting	Raises the Selecting event before the LinqDataSource control performs a data-retrieval operation.
	OnUpdated	Raises the Updated event after the LinqDataSource control has completed an update operation.
	OnUpdating	Raises the Updating event before the LinqDataSource control performs an update operation.
	RaiseUnsupportedCapabilityError	Called by the RaiseUnsupportedCapabilitiesError method to compare the capabilities requested for an ExecuteSelect operation against those that the view supports. (Inherited from DataSourceView.)
	RaiseViewChanged	Calls the OnDataSourceViewChanged method. (Inherited from QueryableDataSourceView.)
	ResetDataObject	Resets the object that contains data to its original state.
	SaveViewState	Saves changes to view state for the QueryableDataSourceView object since the time that the page was posted to the server. (Inherited from QueryableDataSourceView.)
	Select(DataSourceSelectArguments)	Retrieves data from the data source.
	Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	Gets a list of data asynchronously from the underlying data storage. (Inherited from DataSourceView.)
	StoreOriginalValues(IList)	Stores the original values from the Select operation in the control's view state. (Overrides QueryableDataSourceView.StoreOriginalValues(IList).)
	StoreOriginalValues(IList, Func<PropertyDescriptor, Boolean>)	Stores the original values from the select operation in the control's view state when delete or update operations are enabled. (Inherited from QueryableDataSourceView.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)
	TrackViewState	Causes tracking of view-state changes to the server control so that they can be stored in the server control's state. (Inherited from QueryableDataSourceView.)
	Update(IDictionary, IDictionary, IDictionary)	Performs an update operation. (Inherited from QueryableDataSourceView.)
	Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Performs an asynchronous update operation on the list of data that the DataSourceView object represents. (Inherited from DataSourceView.)
	UpdateDataObject	Updates a data object.
	UpdateObject	Updates a data object. (Overrides QueryableDataSourceView.UpdateObject(Object, Object).)
	ValidateContextType	Checks whether the data context class derives from DataContext.
	ValidateDeleteSupported	Validates that the conditions exist to perform a delete operation.
	ValidateEditSupported	Validates that the conditions exist to perform an edit operation.
	ValidateInsertSupported	Validates that the conditions exist to perform an insert operation.
	ValidateTableType	Checks whether the type of the class that represents the data table is a generic type.
	ValidateUpdateSupported	Validates that the conditions exist to perform an update operation.

Top

Events

	Name	Description
	ContextCreated	Occurs after an instance of the context type object has been created.
	ContextCreating	Occurs before an instance of the context type object is created.
	ContextDisposing	Occurs before disposing the context type object.
	DataSourceViewChanged	Occurs when the data source view has changed. (Inherited from DataSourceView.)
	Deleted	Occurs when a delete operation has finished.
	Deleting	Occurs before a delete operation.
	Inserted	Occurs when an insert operation has finished.
	Inserting	Occurs before an insert operation.
	QueryCreated	Occurs when a query is created. (Inherited from QueryableDataSourceView.)
	Selected	Occurs when a data-retrieval operation has completed.
	Selecting	Occurs before a data-retrieval operation.
	Updated	Occurs when an update operation has finished.
	Updating	Occurs before an update operation.

Top

Explicit Interface Implementations

	Name	Description
	IStateManager.IsTrackingViewState	When implemented by a class, gets a value that indicates whether a server control is tracking its view-state changes. (Inherited from QueryableDataSourceView.)
	IStateManager.LoadViewState	When implemented by a class, loads the server control's previously saved view state for the control. (Inherited from QueryableDataSourceView.)
	IStateManager.SaveViewState	When implemented by a class, saves the changes to a server control's view state to an object. (Inherited from QueryableDataSourceView.)
	IStateManager.TrackViewState	When implemented by a class, gets a value that indicates whether a server control is tracking its view-state changes. (Inherited from QueryableDataSourceView.)

Top

Remarks

The LinqDataSourceView class is intended primarily to be used by data-bound controls, and not as a programmable object in page code. Page developers typically use the LinqDataSource control to interact with data.

ASP.NET data source controls contain one or more lists of data, represented by data source view objects. The LinqDataSourceView class extends the DataSourceView class. It defines the capabilities of the LinqDataSource control with which it is associated, and it implements the basic data functionality for the data source control. The LinqDataSourceView class implements the Select, Update, Insert, and Delete operations. It also implements sorting, filtering, and managing settings that are kept in view state.

Although the LinqDataSourceView object is not directly exposed to page developers, many of its properties and methods can be accessed through the LinqDataSource control. The LinqDataSourceView control implements the following data retrieval methods and events and exposes them to page developers and to other callers through the associated LinqDataSource control:

The Select property.
The Selecting event.
The Selected event.
The Update method.
The Updating event.
The Updated event.
The Insert method.
The Inserting event.
The Inserted event.
The Delete method.
The Deleting event.
The Deleted event.

You can sort the data that you retrieve with the LinqDataSource control by adding an OrderBy clause. You can provide a sort expression for the LinqDataSourceView instance by setting the SortExpression property of the DataSourceSelectArguments object that is passed to the Select method. The syntax for the SortExpression property is the same as the syntax for a DataView.Sort property.

The LinqDataSourceView control implements the IStateManager interface and uses view state to track its state across page requests. Implementations of the IsTrackingViewState() property and the LoadViewState(Object), SaveViewState(), and TrackViewState() methods are provided to enable view-state tracking for the control. For more information, see ASP.NET State Management Overview.

Version Information

.NET Framework

Supported in: 4, 3.5

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Thread Safety

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

Reference

System.Web.UI.WebControls Namespace

Other Resources

LinqDataSource Web Server Control Overview