LinqDataSourceView 类

定义

命名空间:

System.Web.UI.WebControls

程序集:

System.Web.Extensions.dll

支持 LinqDataSource 控件并提供一个接口，使数据绑定控件可以执行 LINQ 数据操作。

public ref class LinqDataSourceView : System::Web::UI::WebControls::ContextDataSourceView

public class LinqDataSourceView : System.Web.UI.WebControls.ContextDataSourceView

type LinqDataSourceView = class
    inherit ContextDataSourceView

Public Class LinqDataSourceView
Inherits ContextDataSourceView

继承

Object

DataSourceView

QueryableDataSourceView

ContextDataSourceView

LinqDataSourceView

注解

类 LinqDataSourceView 主要用于数据绑定控件，而不是页面代码中的可编程对象。 页面开发人员通常使用 LinqDataSource 控件来与数据交互。

ASP.NET 数据源控件包含一个或多个数据列表，由数据源视图对象表示。 类 LinqDataSourceView 扩展类 DataSourceView 。 它定义与之关联的控件的功能 LinqDataSource ，并实现数据源控件的基本数据功能。 类LinqDataSourceView实现 、SelectUpdate、Insert 和 Delete 操作。 它还实现在视图状态中保留的排序、筛选和管理设置。

LinqDataSourceView尽管 对象不会直接向页面开发人员公开，但其许多属性和方法都可以通过 LinqDataSource 控件进行访问。 控件 LinqDataSourceView 实现以下数据检索方法和事件，并通过关联的 LinqDataSource 控件向页面开发人员和其他调用方公开它们：

• Select 属性。

• 事件 Selecting 。

• 事件 Selected 。

• Update 方法。

• 事件 Updating 。

• 事件 Updated 。

• Insert 方法。

• 事件 Inserting 。

• 事件 Inserted 。

• Delete 方法。

• 事件 Deleting 。

• 事件 Deleted 。

可以通过添加 OrderBy 子句对使用 LinqDataSource 控件检索的数据进行排序。 可以通过设置SortExpression传递给 Select 方法的 DataSourceSelectArguments 对象的 属性来LinqDataSourceView为 实例提供排序表达式。 属性的 SortExpression 语法与 属性的语法 DataView.Sort 相同。

控件 LinqDataSourceView 实现 接口， IStateManager 并使用视图状态跨页面请求跟踪其状态。 IsTrackingViewState提供 属性和 LoadViewState、 SaveViewState和 TrackViewState 方法的实现，以便为控件启用视图状态跟踪。 有关详细信息，请参阅 ASP.NET 状态管理概述。

构造函数

LinqDataSourceView(LinqDataSource, String, HttpContext)

初始化 LinqDataSourceView 类的新实例，将指定的 LinqDataSource 控件设置为当前视图的所有者。

属性

AutoGenerateOrderByClause	获取或设置一个值，该值指示与当前 QueryableDataSourceView 控件关联的 QueryableDataSource 对象是否创建动态 OrderBy 子句。 (继承自 QueryableDataSourceView)
AutoGenerateWhereClause	获取或设置一个值，该值指示与当前 QueryableDataSourceView 控件关联的 QueryableDataSource 对象是否创建动态 Where 子句。 (继承自 QueryableDataSourceView)
AutoPage	获取或设置一个值，该值指示与当前 QueryableDataSourceView 控件关联的 QueryableDataSource 对象默认情况下是否支持分页。 (继承自 QueryableDataSourceView)
AutoSort	获取或设置一个值，该值指示与当前 QueryableDataSourceView 控件关联的 QueryableDataSource 对象默认情况下是否支持排序。 (继承自 QueryableDataSourceView)
CanDelete	获取一个值，该值指示与当前 LinqDataSourceView 控件关联的 LinqDataSource 对象是否支持删除操作。
CanInsert	获取一个值，该值指示与当前 LinqDataSourceView 控件关联的 LinqDataSource 对象是否支持插入操作。
CanPage	获取一个值，该值指示与当前 LinqDataSource 控件相关联的 LinqDataSourceView 对象是否支持对检索数据进行分页。
CanRetrieveTotalRowCount	获取一个值，该值指示与当前 LinqDataSource 控件相关联的LinqDataSourceView 对象除支持检索数据外，是否还支持检索数据行的总数。
CanSort	获取一个值，该值指示与当前 LinqDataSource 控件相关联的 LinqDataSourceView 对象是否支持对检索数据的排序视图。
CanUpdate	获取一个值，该值指示与当前 LinqDataSourceView 控件关联的 LinqDataSource 对象是否支持更新操作。
Context	获取或设置当前的数据上下文。 (继承自 ContextDataSourceView)
ContextType	获取数据上下文类的类型。
ContextTypeName	获取或设置数据上下文类的名称，该类包含 TableName 属性中指定的字段或属性。
DeleteParameters	获取集合，该集合包含在删除操作过程中所使用的参数。 (继承自 QueryableDataSourceView)
EnableDelete	获取或设置一个值，该值指示数据源视图是否支持删除行。
EnableInsert	获取或设置一个值，该值指示数据源视图是否支持添加新行。
EnableObjectTracking	获取或设置一个值，该值指示是否跟踪对数据上下文对象所做的更改。
EnableUpdate	获取或设置一个值，该值指示数据源视图是否支持更新行。
EntitySet	获取或设置对象，该对象包含要检索的数据的值。 (继承自 ContextDataSourceView)
EntitySetName	获取或设置数据上下文类中的属性或字段的名称，该数据上下文类表示一个数据集合。 (继承自 ContextDataSourceView)
EntitySetType	获取或设置为插入、删除或更新操作创建的对象的名称。 (继承自 ContextDataSourceView)
EntityType	获取或设置为插入、删除或更新操作创建的对象。 (继承自 ContextDataSourceView)
EntityTypeName	获取或设置为插入、删除或更新操作创建的对象的名称。 (继承自 ContextDataSourceView)
Events	获取数据源视图的事件处理程序委托的列表。 (继承自 DataSourceView)
GroupBy	获取或设置一个或多个属性名称，用于在选择操作过程中对数据进行分组。 (继承自 QueryableDataSourceView)
GroupByParameters	获取一个参数集合，其中的参数值用于在选择操作过程中创建 GroupBy 子句。 (继承自 QueryableDataSourceView)
InsertParameters	获取在插入操作过程中使用的参数的集合。 (继承自 QueryableDataSourceView)
IsTrackingViewState	获取一个值，该值指示 QueryableDataSourceView 对象是否正将更改保存到其视图状态。 (继承自 QueryableDataSourceView)
Name	获取数据源视图的名称。 (继承自 DataSourceView)
OrderBy	获取或设置一个或多个属性名称，这些属性用于在选择操作过程中对数据进行排序。 (继承自 QueryableDataSourceView)
OrderByParameters	获取用于在选择操作过程中对数据进行排序的参数的集合。 (继承自 QueryableDataSourceView)
OrderGroupsBy	获取或设置属性的名称，这些属性用于在选择操作过程中对分组的数据进行排序。 (继承自 QueryableDataSourceView)
OrderGroupsByParameters	获取用于创建 OrderGroupsBy 子句的参数的集合。 (继承自 QueryableDataSourceView)
SelectNew	获取或设置属性和计算值，它们包含在检索到的数据中。 (继承自 QueryableDataSourceView)
SelectNewParameters	获取在数据检索操作过程中使用的参数的集合。 (继承自 QueryableDataSourceView)
StoreOriginalValuesInViewState	获取或设置一个值，该值指示当启用删除或更新操作时将来自选择操作的原始值存储在视图状态中。
TableName	获取或设置包含数据集合的数据上下文类的属性或字段的名称。
UpdateParameters	获取在更新操作过程中使用的参数的集合。 (继承自 QueryableDataSourceView)
Where	获取或设置一个值，该值指定要将行包含在检索到的数据中所必须满足的条件。 (继承自 QueryableDataSourceView)
WhereParameters	获取用于创建 Where 子句的参数的集合。 (继承自 QueryableDataSourceView)

方法

BuildDeleteObject(IDictionary, IDictionary, IDictionary<String,Exception>)	创建要用于删除操作的对象。 (继承自 QueryableDataSourceView)
BuildInsertObject(IDictionary, IDictionary<String,Exception>)	通过使用要插入的值和要在操作失败时显示的错误消息，创建要用于插入操作的对象。 (继承自 QueryableDataSourceView)
BuildQuery(DataSourceSelectArguments)	使用数据源的 Select 参数创建一个 Select 查询表达式。 (继承自 QueryableDataSourceView)
BuildUpdateObjects(IDictionary, IDictionary, IDictionary, IDictionary<String,Exception>)	通过使用指定值创建要用于更新操作的对象。 (继承自 QueryableDataSourceView)
CanExecute(String)	确定是否能执行指定命令。 (继承自 DataSourceView)
ClearOriginalValues()	清除原始值。 (继承自 QueryableDataSourceView)
CreateContext(DataSourceOperation)	使用指定的数据源操作创建数据上下文类型的实例。
CreateContext(Type)	创建数据上下文类型的实例。
CreateQueryContext(DataSourceSelectArguments)	创建查询上下文对象的实例，该对象包含计算所得的参数集合。 (继承自 QueryableDataSourceView)
Delete(IDictionary, IDictionary)	执行删除操作。 (继承自 QueryableDataSourceView)
Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)	对 DataSourceView 对象所表示的数据列表执行异步删除操作。 (继承自 DataSourceView)
DeleteDataObject(Object, Object, Object)	从表中删除数据对象。
DeleteObject(Object)	从表中删除数据对象。
DisposeContext()	在执行操作之后释放上下文。 (继承自 ContextDataSourceView)
DisposeContext(Object)	释放数据上下文。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
ExecuteCommand(String, IDictionary, IDictionary)	执行指定的命令。 (继承自 DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	执行指定的命令。 (继承自 DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	通过使用指定键和旧值执行删除操作。
ExecuteInsert(IDictionary)	通过使用集合中指定的值执行插入操作。
ExecutePaging(IQueryable, QueryContext)	使用来自 QueryContext 对象的 QueryableDataSource 对象执行分页。 (继承自 QueryableDataSourceView)
ExecuteQuery(IQueryable, QueryContext)	对 IQueryable<T> 对象执行查询、排序或分页操作。 (继承自 QueryableDataSourceView)
ExecuteQueryExpressions(IQueryable, QueryContext)	通过使用 IQueryable 对象和 QueryContext 对象执行查询表达式。 (继承自 QueryableDataSourceView)
ExecuteSelect(DataSourceSelectArguments)	执行数据检索操作。
ExecuteSorting(IQueryable, QueryContext)	执行排序操作。 (继承自 QueryableDataSourceView)
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	执行更新操作。
GetDataObjectType(Type)	检索要用于删除、插入和更新操作的数据对象的类型。 (继承自 ContextDataSourceView)
GetEntitySetType()	以属性、字段或数据上下文的形式检索实体集。 (继承自 ContextDataSourceView)
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetOriginalValues(IDictionary)	检索在 Select 操作过程中存储的指定键的原始值。 (继承自 QueryableDataSourceView)
GetSource(QueryContext)	返回要应用查询的数据源。
GetTableMemberInfo(Type)	检索有关数据集合的元数据。
GetType()	获取当前实例的 Type。 (继承自 Object)
HandleValidationErrors(IDictionary<String,Exception>, DataSourceOperation)	处理数据对象创建过程中的数据操作失败时发生的任何异常。
Insert(IDictionary)	对 QueryableDataSourceView 对象所表示的数据项执行异步插入操作。 (继承自 QueryableDataSourceView)
Insert(IDictionary, DataSourceViewOperationCallback)	对 DataSourceView 对象所表示的数据列表执行异步插入操作。 (继承自 DataSourceView)
InsertDataObject(Object, Object, Object)	将一个数据对象插入表中。
InsertObject(Object)	将数据对象插入 LinqDataSourceView 对象。
LoadViewState(Object)	还原数据源视图的以前保存的视图状态。 (继承自 QueryableDataSourceView)
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnContextCreated(LinqDataSourceStatusEventArgs)	引发 ContextCreated 事件。
OnContextCreating(LinqDataSourceContextEventArgs)	引发 ContextCreating 事件。
OnContextDisposing(LinqDataSourceDisposeEventArgs)	引发 ContextDisposing 事件。
OnDataSourceViewChanged(EventArgs)	引发 DataSourceViewChanged 事件。 (继承自 DataSourceView)
OnDeleted(LinqDataSourceStatusEventArgs)	引发 Deleted 事件。
OnDeleting(LinqDataSourceDeleteEventArgs)	引发 Deleting 事件。
OnException(DynamicValidatorEventArgs)	在数据操作失败时，引发 Exception 事件。
OnInserted(LinqDataSourceStatusEventArgs)	Inserted 控件完成插入操作后引发 LinqDataSource 事件。
OnInserting(LinqDataSourceInsertEventArgs)	引发 Inserting 事件。
OnQueryCreated(QueryCreatedEventArgs)	在 QueryCreated 控件创建一个 QueryableDataSource 对象后引发 IQueryable 事件。 (继承自 QueryableDataSourceView)
OnQueryParametersChanged(Object, EventArgs)	调用 RaiseViewChanged() 方法。 (继承自 QueryableDataSourceView)
OnSelected(LinqDataSourceStatusEventArgs)	Selected 控件完成数据检索操作后引发 LinqDataSource 事件。
OnSelecting(LinqDataSourceSelectEventArgs)	在 Selecting 控件执行数据检索操作之前引发 LinqDataSource 事件。
OnUpdated(LinqDataSourceStatusEventArgs)	Updated 控件完成更新操作后引发 LinqDataSource 事件。
OnUpdating(LinqDataSourceUpdateEventArgs)	在 Updating 控件执行更新操作之前引发 LinqDataSource 事件。
RaiseUnsupportedCapabilityError(DataSourceCapabilities)	由 RaiseUnsupportedCapabilitiesError(DataSourceView) 方法调用，用于将 ExecuteSelect(DataSourceSelectArguments) 操作所请求的功能与视图所支持的功能进行比较。 (继承自 DataSourceView)
RaiseViewChanged()	调用 OnDataSourceViewChanged(EventArgs) 方法。 (继承自 QueryableDataSourceView)
ResetDataObject(Object, Object)	将包含数据的对象重置为其原始状态。
SaveViewState()	保存自将页传递到服务器时起 QueryableDataSourceView 对象的视图状态更改。 (继承自 QueryableDataSourceView)
Select(DataSourceSelectArguments)	从数据源中检索数据。
Select(DataSourceSelectArguments, DataSourceViewSelectCallback)	从基础数据存储中异步获取数据列表。 (继承自 DataSourceView)
StoreOriginalValues(IList)	将来自 Select 操作的原始值存储在控件的视图状态中。
StoreOriginalValues(IList, Func<PropertyDescriptor,Boolean>)	在启用了删除或更新操作时，将来自选择操作的原始值存储在控件的视图状态中。 (继承自 QueryableDataSourceView)
ToString()	返回表示当前对象的字符串。 (继承自 Object)
TrackViewState()	导致跟踪对服务器控件所做的视图状态更改，以便将这些更改存储到服务器控件的状态中。 (继承自 QueryableDataSourceView)
Update(IDictionary, IDictionary, IDictionary)	执行更新操作。 (继承自 QueryableDataSourceView)
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	对 DataSourceView 对象所表示的数据列表执行异步更新操作。 (继承自 DataSourceView)
UpdateDataObject(Object, Object, Object, Object)	更新数据对象。
UpdateObject(Object, Object)	更新数据对象。
ValidateContextType(Type, Boolean)	检查数据上下文类是否是从 DataContext 派生的。
ValidateDeleteSupported(IDictionary, IDictionary)	验证是否存在执行删除操作的条件。
ValidateEditSupported()	验证是否存在执行编辑操作的条件。
ValidateInsertSupported(IDictionary)	验证是否存在执行插入操作的条件。
ValidateTableType(Type, Boolean)	检查表示数据表的类的类型是否为泛型类型。
ValidateUpdateSupported(IDictionary, IDictionary, IDictionary)	验证是否存在执行更新操作的条件。

事件

ContextCreated	在创建上下文类型对象的实例后发生。
ContextCreating	在创建上下文类型对象实例前发生。
ContextDisposing	在释放上下文类型对象前发生。
DataSourceViewChanged	在数据源视图更改时发生。 (继承自 DataSourceView)
Deleted	完成删除操作后发生。
Deleting	执行删除操作前发生。
Inserted	完成插入操作后发生。
Inserting	执行插入操作前发生。
QueryCreated	在创建查询时发生。 (继承自 QueryableDataSourceView)
Selected	在数据检索操作完成后发生。
Selecting	执行数据检索操作前发生。
Updated	完成更新操作后发生。
Updating	执行更新操作前发生。

显式接口实现

IStateManager.IsTrackingViewState	当由类实现时，获取一个值，该值指示服务器控件是否正在跟踪其视图状态更改。 (继承自 QueryableDataSourceView)
IStateManager.LoadViewState(Object)	当由类实现时，加载服务器控件以前保存的控件视图状态。 (继承自 QueryableDataSourceView)
IStateManager.SaveViewState()	当由类实现时，将服务器控件的视图状态更改保存到对象。 (继承自 QueryableDataSourceView)
IStateManager.TrackViewState()	当由类实现时，获取一个值，该值指示服务器控件是否正在跟踪其视图状态更改。 (继承自 QueryableDataSourceView)