LinqDataSourceView Класс

Определение

Поддерживает элемент управления LinqDataSource и предоставляет интерфейс для элементов управления с привязкой к данным для выполнения операций с данными LINQ.Supports the LinqDataSource control and provides an interface for data-bound controls to perform LINQ data operations.

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
Наследование
LinqDataSourceView

Комментарии

Класс LinqDataSourceView предназначен главным образом для использования элементами управления с привязкой к данным, а не как программируемый объект в коде страницы.The LinqDataSourceView class is intended primarily to be used by data-bound controls, and not as a programmable object in page code. Разработчики страниц обычно используют элемент управления LinqDataSource для взаимодействия с данными.Page developers typically use the LinqDataSource control to interact with data.

Элементы управления источниками данных ASP.NET содержат один или несколько списков данных, представленных объектами представления источников данных.ASP.NET data source controls contain one or more lists of data, represented by data source view objects. Класс LinqDataSourceView расширяет класс DataSourceView.The LinqDataSourceView class extends the DataSourceView class. Он определяет возможности элемента управления LinqDataSource, с которым он связан, и реализует базовые функциональные возможности данных для элемента управления источника данных.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. Класс LinqDataSourceView реализует операции Select, обновления, вставкии удаления .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.

Хотя объект LinqDataSourceView не предоставляется напрямую разработчикам страниц, доступ к многим его свойствам и методам можно получить с помощью элемента управления LinqDataSource.Although the LinqDataSourceView object is not directly exposed to page developers, many of its properties and methods can be accessed through the LinqDataSource control. Элемент управления LinqDataSourceView реализует следующие методы и события извлечения данных и предоставляет их разработчикам страниц и другим вызывающим объектам через связанный элемент управления LinqDataSource: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:

Данные, получаемые с помощью элемента управления LinqDataSource, можно отсортировать, добавив предложение OrderBy.You can sort the data that you retrieve with the LinqDataSource control by adding an OrderBy clause. Можно указать выражение сортировки для экземпляра LinqDataSourceView, задав свойство SortExpression объекта DataSourceSelectArguments, который передается в метод Select.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. Синтаксис для свойства SortExpression совпадает с синтаксисом для свойства DataView.Sort.The syntax for the SortExpression property is the same as the syntax for a DataView.Sort property.

Элемент управления LinqDataSourceView реализует интерфейс IStateManager и использует состояние представления для отслеживания состояния по запросам страниц.The LinqDataSourceView control implements the IStateManager interface and uses view state to track its state across page requests. Реализации свойств IsTrackingViewState и LoadViewState, SaveViewState и TrackViewState предоставляются для включения отслеживания состояния просмотра для элемента управления.Implementations of the IsTrackingViewState property and the LoadViewState, SaveViewState, and TrackViewState methods are provided to enable view-state tracking for the control. Дополнительные сведения см. в разделе Обзор управления состоянием ASP.NET.For more information, see ASP.NET State Management Overview.

Конструкторы

LinqDataSourceView(LinqDataSource, String, HttpContext)

Выполняет инициализацию нового экземпляра класса LinqDataSourceView с назначением указанного элемента управления LinqDataSource в качестве владельца текущего представления.Initializes a new instance of the LinqDataSourceView class, setting the specified LinqDataSource control as the owner of the current view.

Свойства

AutoGenerateOrderByClause

Получает или задает значение, показывающее, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, динамическое создание предложения OrderBy.Gets or sets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports dynamic creation of an OrderBy clause.

AutoGenerateWhereClause

Получает или задает значение, показывающее, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, динамическое создание предложения Where.Gets or sets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports dynamic creation of a Where clause.

AutoPage

Возвращает или задает значение, показывающее, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, автоматическое разбиение по страницам.Gets or sets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports automatic paging.

AutoSort

Возвращает или задает значение, показывающее, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, автоматическую сортировку.Gets or sets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports automatic sorting.

CanDelete

Возвращает значение, позволяющее определить, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, операцию удаления.Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports the delete operation.

CanInsert

Возвращает значение, позволяющее определить, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, операцию вставки.Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports the insert operation.

CanPage

Возвращает значение, указывающее, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, операцию разбиения полученных данных по страницам.Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports paging of retrieved data.

CanRetrieveTotalRowCount

Возвращает значение, позволяющее определить, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, получение общего количества строк данных в дополнение к извлечению данных.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.

CanSort

Возвращает значение, позволяющее определить, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, упорядоченное представление полученных данных.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.

CanUpdate

Возвращает значение, позволяющее определить, поддерживает ли объект LinqDataSourceView, связанный с текущим элементом управления LinqDataSource, операцию обновления.Gets a value that indicates whether the LinqDataSourceView object that is associated with the current LinqDataSource control supports the update operation.

ContextType

Возвращает тип класса контекста данных.Gets the type of the data context class.

ContextTypeName

Возвращает или задает имя класса контекста данных, который содержит поле или свойство, указанное в свойстве TableName.Gets or sets the name of the data context class that contains the field or property specified in the TableName property.

DeleteParameters

Возвращает коллекцию параметров, содержащую параметры, используемые во время операции удаления.Gets the parameters collection that contains the parameters that are used during a delete operation.

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.

Events

Возвращает список делегатов обработчиков событий представления источника данных.Gets a list of event-handler delegates for the data source view.

(Унаследовано от DataSourceView)
GroupBy

Возвращает или задает имя или имена свойств, которые используются во время операции выделения для группирования данных.Gets or sets the name or names of the properties to use during the select operation for grouping data.

GroupByParameters

Получает коллекцию параметров, чьи значения используются для создания предложения GroupBy в операции выбора.Gets a collection of parameters whose values are used to create the GroupBy clause during the select operation.

InsertParameters

Возвращает коллекцию параметров, которые используются во время операции вставки.Gets a collection of parameters that are used during the insert operation.

IsTrackingViewState

Возвращает значение, указывающее, сохраняет ли объект LinqDataSourceView изменения в состоянии просмотра.Gets a value that indicates whether the LinqDataSourceView object is saving changes to its view state.

Name

Возвращает имя представления источника данных.Gets the name of the data source view.

(Унаследовано от DataSourceView)
OrderBy

Возвращает или задает имя или имена свойств, которые используются во время операции выделения для сортировки данных.Gets or sets the name or names of the properties to use during the select operation for sorting data.

OrderByParameters

Получает коллекцию параметров, используемых для создания предложения OrderBy.Gets a collection of parameters that are used to create the OrderBy clause.

OrderGroupsBy

Возвращает или задает имена свойств, которые используются во время операции выделения для сортировки сгруппированных данных.Gets or sets the names of the properties to use during the select operation for sorting grouped data.

OrderGroupsByParameters

Получает коллекцию параметров, используемых для создания предложения OrderGroupsBy.Gets a collection of parameters that are used to create the OrderGroupsBy clause.

SelectNew

Возвращает или задает свойства и рассчитанные значение, которые включаются в извлеченные данные.Gets or sets the properties and calculated values that are included in the retrieved data.

SelectNewParameters

Возвращает коллекцию параметров, которые используются во время операции извлечения данных.Gets the collection of parameters that are used during a data-retrieval operation.

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.

Where

Возвращает или задает значение, которое указывает, что условия должны иметь значение true, чтобы запись могла включаться в извлеченные данные.Gets or sets a value that specifies what conditions must be true for a record to be included in the retrieved data.

WhereParameters

Получает коллекцию параметров, используемых для создания предложения Where.Gets a collection of parameters that are used to create the Where clause.

Методы

CanExecute(String)

Определяет, может ли быть выполнена указанная команда.Determines whether the specified command can be executed.

(Унаследовано от DataSourceView)
CreateContext(DataSourceOperation)

Создает экземпляр типа контекста данных, используя заданную операцию источника данных.Creates an instance of the data context type using the specified data source operation.

CreateContext(Type)

Создает экземпляр типа контекста данных.Creates an instance of the data context type.

Delete(IDictionary, IDictionary)

Выполняет операцию удаления.Performs a delete operation.

Delete(IDictionary, IDictionary, DataSourceViewOperationCallback)

Выполняет операцию асинхронного удаления в списке данных, представляющем объект DataSourceView.Performs an asynchronous delete operation on the list of data that the DataSourceView object represents.

(Унаследовано от DataSourceView)
DeleteDataObject(Object, Object, Object)

Удаляет объект данных из таблицы.Deletes a data object from a table.

DeleteObject(Object)

Удаляет объект данных из таблицы.Deletes a data object from a table.

DisposeContext(Object)

Удаляет контекст данных.Disposes the data context.

Equals(Object)

Определяет, равен ли заданный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
ExecuteCommand(String, IDictionary, IDictionary)

Выполняет указанную команду.Executes the specified command.

(Унаследовано от DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)

Выполняет указанную команду.Executes the specified command.

(Унаследовано от DataSourceView)
ExecuteDelete(IDictionary, IDictionary)

Выполняет операцию удаления с использованием указанных ключей и старых значений.Performs a delete operation by using the specified keys and old values.

ExecuteInsert(IDictionary)

Выполняет операцию вставки с использованием значений, указанных в коллекции.Performs an insert operation by using the values specified in a collection.

ExecuteSelect(DataSourceSelectArguments)

Выполняет операцию извлечения данных.Performs a data retrieval operation.

ExecuteUpdate(IDictionary, IDictionary, IDictionary)

Выполняет операцию обновления.Performs an update operation.

GetDataObjectType(Type)

Возвращает тип объекта данных, который используется в операциях удаления, вставки и обновления.Gets the data object type to use for delete, insert, and update operations.

GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetSource(QueryContext)

Возвращает источник данных, к которому необходимо применить запрос.Returns the data source to apply a query to.

GetTableMemberInfo(Type)

Извлекает метаданные о коллекции данных.Retrieves metadata about the data collection.

GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
HandleValidationErrors(IDictionary<String,Exception>, DataSourceOperation)

Обрабатывает любые исключения, возникающие при сбое операции с данными в процессе создания объекта данных.Handles any exceptions that occur when a data operation fails while a data object is being created.

Insert(IDictionary)

Выполняет операцию вставки.Performs an insert operation.

Insert(IDictionary, DataSourceViewOperationCallback)

Выполняет операцию асинхронной вставки по списку данных, представляющем объект DataSourceView.Performs an asynchronous insert operation on the list of data that the DataSourceView object represents.

(Унаследовано от DataSourceView)
InsertDataObject(Object, Object, Object)

Вставляет объект данных в таблицу.Inserts a data object into a table.

InsertObject(Object)

Вставляет объект данных в объект LinqDataSourceView.Inserts a data object into a LinqDataSourceView object.

LoadViewState(Object)

Восстанавливает сохраненное раннее состояние представления источника данных.Restores the previously saved view state for the data source view.

MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
OnContextCreated(LinqDataSourceStatusEventArgs)

Создает событие ContextCreated.Raises the ContextCreated event.

OnContextCreating(LinqDataSourceContextEventArgs)

Создает событие ContextCreating.Raises the ContextCreating event.

OnContextDisposing(LinqDataSourceDisposeEventArgs)

Вызывает событие ContextDisposing.Raises the ContextDisposing event.

OnDataSourceViewChanged(EventArgs)

Вызывает событие DataSourceViewChanged.Raises the DataSourceViewChanged event.

(Унаследовано от DataSourceView)
OnDeleted(LinqDataSourceStatusEventArgs)

Вызывает событие Deleted.Raises the Deleted event.

OnDeleting(LinqDataSourceDeleteEventArgs)

Вызывает событие Deleting.Raises the Deleting event.

OnException(DynamicValidatorEventArgs)

Генерирует событие Exception, когда операция с данными завершается неудачей.Raises the Exception event when a data operation fails.

OnInserted(LinqDataSourceStatusEventArgs)

Инициирует возникновение события Inserted после завершения операции вставки в элементе управления LinqDataSource.Raises the Inserted event after the LinqDataSource control has completed an insert operation.

OnInserting(LinqDataSourceInsertEventArgs)

Вызывает событие Inserting.Raises the Inserting event.

OnSelected(LinqDataSourceStatusEventArgs)

Вызывает событие Selected после завершения операции извлечения данных в элементе управления LinqDataSource.Raises the Selected event after the LinqDataSource control has completed a data retrieval operation.

OnSelecting(LinqDataSourceSelectEventArgs)

Вызывает событие Selecting, прежде чем элемент управления LinqDataSource выполняет операцию извлечения данных.Raises the Selecting event before the LinqDataSource control performs a data-retrieval operation.

OnUpdated(LinqDataSourceStatusEventArgs)

Вызывает событиеUpdated, после этого как элемент управления LinqDataSource завершил операцию обновления.Raises the Updated event after the LinqDataSource control has completed an update operation.

OnUpdating(LinqDataSourceUpdateEventArgs)

Вызывает событие Updating, прежде чем элемент управления LinqDataSource выполнил операцию обновления.Raises the Updating event before the LinqDataSource control performs an update operation.

RaiseUnsupportedCapabilityError(DataSourceCapabilities)

Вызванный методом RaiseUnsupportedCapabilitiesError(DataSourceView) для сравнения возможностей, запрошенных для операции ExecuteSelect(DataSourceSelectArguments), с возможностями, поддерживаемыми представлением.Called by the RaiseUnsupportedCapabilitiesError(DataSourceView) method to compare the capabilities requested for an ExecuteSelect(DataSourceSelectArguments) operation against those that the view supports.

(Унаследовано от DataSourceView)
ResetDataObject(Object, Object)

Сбрасывает объект, содержащий данные, до исходного состояния.Resets the object that contains data to its original state.

SaveViewState()

Сохраняет изменения состояния представления элемента управления LinqDataSourceView, произошедшие с момента отправки страницы обратно на сервер.Saves the changes to view state for the LinqDataSourceView control since the time that the page was posted back to the server.

Select(DataSourceSelectArguments)

Извлекает данные из источника данных.Retrieves data from the data source.

Select(DataSourceSelectArguments, DataSourceViewSelectCallback)

Асинхронно возвращает список данных из хранилища базовых данных.Gets a list of data asynchronously from the underlying data storage.

(Унаследовано от DataSourceView)
StoreOriginalValues(IList)

Хранит исходные значения операции Select в состоянии представления элемента управления.Stores the original values from the Select operation in the control's view state.

ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)
TrackViewState()

Отслеживает изменения состояния представления.Tracks view state changes.

Update(IDictionary, IDictionary, IDictionary)

Выполняет операцию обновления.Performs an update operation.

Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)

Выполняет операцию асинхронного обновления в списке данных, представляющем объект DataSourceView.Performs an asynchronous update operation on the list of data that the DataSourceView object represents.

(Унаследовано от DataSourceView)
UpdateDataObject(Object, Object, Object, Object)

Обновляет объект данных.Updates a data object.

UpdateObject(Object, Object)

Обновляет объект данных.Updates a data object.

ValidateContextType(Type, Boolean)

Проверяет, является ли класс контекста данных производным от класса DataContext.Checks whether the data context class derives from DataContext.

ValidateDeleteSupported(IDictionary, IDictionary)

Проверяет наличие условий для операции удаления.Validates that the conditions exist to perform a delete operation.

ValidateEditSupported()

Проверяет наличие условий для выполнения операции правки.Validates that the conditions exist to perform an edit operation.

ValidateInsertSupported(IDictionary)

Проверяет наличие условий для операции вставки.Validates that the conditions exist to perform an insert operation.

ValidateOrderByParameter(String, String)

Проверяет, что значение параметра OrderBy является допустимым именем поля для автоматически создаваемого предложения OrderBy.Validates that the OrderBy parameter value is a valid field name for the automatically generated OrderBy clause.

ValidateParameterName(String)

Проверяет действительность указанного имени параметра.Verifies that the provided parameter name is valid.

ValidateTableType(Type, Boolean)

Проверяет, является ли тип класса, представляющего таблицу данных, универсальным.Checks whether the type of the class that represents the data table is a generic type.

ValidateUpdateSupported(IDictionary, IDictionary, IDictionary)

Проверяет наличие условий для операции обновления.Validates that the conditions exist to perform an update operation.

События

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.

(Унаследовано от 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.

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.

Явные реализации интерфейса

IStateManager.IsTrackingViewState

Описание этого элемента см. в свойстве IsTrackingViewState.For a description of this member, see the IsTrackingViewState property.

IStateManager.LoadViewState(Object)

Описание этого члена см. в разделе LoadViewState(Object).For a description of this member, see LoadViewState(Object).

IStateManager.SaveViewState()

Описание этого элемента содержится в методе SaveViewState().For a description of this member, see the SaveViewState() method.

IStateManager.TrackViewState()

Описание этого элемента см. в методе IStateManagerTrackViewState.For a description of this member, see the IStateManagerTrackViewState method.

Применяется к