SqlDataSourceView Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
SqlDataSource Поддерживает элемент управления и предоставляет интерфейс для элементов управления, привязанных к данным, для выполнения операций с данными SQL в реляционных базах данных.
public ref class SqlDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManagerpublic class SqlDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManagertype SqlDataSourceView = class
inherit DataSourceView
interface IStateManagerPublic Class SqlDataSourceView
Inherits DataSourceView
Implements IStateManager- Наследование
- Производный
- Реализации
Комментарии
Класс SqlDataSourceView предназначен в основном для использования элементами управления с привязкой к данным, а не как программируемый объект в коде страницы.
ASP.NET элементы управления источниками данных содержат один или несколько списков данных, представленных объектами представления источников данных. Класс SqlDataSourceView расширяет DataSourceView класс, определяет возможности SqlDataSource элемента управления, с которым он связан, и реализует основные функции данных для управления версиями данных. Класс SqlDataSourceView реализует функции данных для SqlDataSource элемента управления, включая Selectоперации, UpdateInsertDelete операции, сортировку, фильтрацию и управление параметрами, которые хранятся в состоянии представления.
SqlDataSourceView Хотя объект не предоставляется непосредственно разработчикам страницы элементом SqlDataSource управления, многие из его свойств являются. Основная операция, выполняемая представлением источника данных, — извлечение данных из базовой базы данных с помощью Select метода, который извлекает IEnumerable коллекцию элементов данных. Класс SqlDataSourceView реализует извлечение данных из реляционных баз данных с помощью запросов SQL. Запросы SQL можно параметризировать для повышения гибкости и безопасности. Следующие методы извлечения данных, свойства и события реализуются SqlDataSourceView и предоставляются непосредственно его SqlDataSource элементом управления разработчикам страниц и другим вызывающим объектам:
Свойство SelectCommand
Свойство SelectParameters
Событие Selecting
Событие Selected
Объект SqlDataSourceView поддерживает обновление данных в реляционной базе данных с помощью команд SQL. Команды SQL можно параметризировать для повышения гибкости и безопасности. Элементы управления, связанные с данными, такие как GridView и DetailsView, можно настроить для автоматического выполнения обновлений с помощью SqlDataSourceViewэлемента управления, а другие элементы управления не могут. Следующие методы обновления, свойства и события реализуются SqlDataSourceView и предоставляются непосредственно его SqlDataSource элементом управления разработчикам страниц и другим вызывающим объектам:
Свойство UpdateCommand
Свойство UpdateParameters
Событие Updating
Событие Updated
Поддерживает SqlDataSourceView вставку новых строк данных в реляционную базу данных. Команды SQL, указанные в свойстве InsertCommand , можно параметризовать для повышения гибкости и безопасности. Элементы управления с привязкой к данным, такие как GridView и DetailsView, можно настроить для автоматического вставки с помощью SqlDataSourceViewдругих элементов управления. Следующие методы вставки, свойства и события реализуются SqlDataSourceView и предоставляются непосредственно его SqlDataSource элементом управления разработчикам страниц и другим вызывающим объектам:
Свойство InsertCommand
Свойство InsertParameters
Событие Inserting
Событие Inserted
Объект SqlDataSourceView также поддерживает удаление данных из реляционной базы данных. Как и в других командах, команды SQL, указанные в свойстве DeleteCommand , могут быть параметризованы для повышения гибкости и безопасности. Элементы управления с привязкой к данным, такие как GridView и DetailsView, можно настроить для автоматического удаления с помощью SqlDataSourceViewдругих элементов управления. Следующие методы удаления, свойства и события реализуются SqlDataSourceView и предоставляются непосредственно его SqlDataSource элементом управления разработчикам страниц и другим вызывающим объектам:
Свойство DeleteCommand
Свойство DeleteParameters
Событие Deleting
Событие Deleted
Получение данных является более мощным, если предложение, используемое для фильтрации данных во время извлечения данных, является динамическим. Другими словами, sql-запрос со статическим предложением WHERE не так гибкий и мощный, как SQL-запрос, где значения в предложении WHERE привязаны к значениям, которые могут изменяться, например значения, отображаемые в элементах управления на странице веб-форм. Вместо перестроения SQL-запроса и настройки SelectCommand свойства на каждой загрузке страницы можно использовать FilterExpression и FilterParameters свойства для применения динамической фильтрации к извлечению данных. Эти свойства реализуются SqlDataSourceView и предоставляются непосредственно его SqlDataSource элементом управления для элементов управления с привязкой к данным и других вызывающих элементов.
Вы можете сортировать данные, полученные с SqlDataSource помощью элемента управления, добавив предложение ORDER BY, которое приводит к тому, что база данных выполняет порядок при извлечении данных или упорядочиваете данные в памяти после получения. Вы можете указать выражение SqlDataSourceView сортировкиDataSourceSelectArguments, задав SortExpression свойство объекта, переданного методуSelect. Синтаксис свойства совпадает с синтаксисом свойства SortExpressionDataView.Sort . При использовании хранимой процедуры для получения данных можно также использовать SortParameterName свойство для указания параметра, используемого специально для сортировки результатов вызова хранимой процедуры.
Если несколько пользователей могут одновременно изменять базу данных, существует вероятность конфликта параллелизма. Элемент SqlDataSource управления имеет элементы управления параллелизмом через SqlDataSource.ConflictDetection свойство. Функциональные возможности реализованы в свойстве SqlDataSourceView.ConflictDetection .
Как и многие другие элементы управления веб-сервера, SqlDataSourceView реализует IStateManager интерфейс и использует состояние просмотра для отслеживания состояния страницы. IsTrackingViewState Реализации и свойства, LoadViewStateSaveViewStateа также TrackViewState методы предоставляются для включения отслеживания состояния просмотра для элемента управления. Дополнительные сведения см. в ASP.NET обзоре управления состояниями.
Конструкторы
| Имя | Описание |
|---|---|
| SqlDataSourceView(SqlDataSource, String, HttpContext) |
Инициализирует новый экземпляр SqlDataSourceView класса, задающий указанный SqlDataSource элемент управления в качестве владельца текущего представления. |
Свойства
| Имя | Описание |
|---|---|
| CancelSelectOnNullParameter |
Возвращает или задает значение, указывающее, отменяется ли операция извлечения данных при оценке |
| CanDelete |
Возвращает значение, указывающее, поддерживает ли SqlDataSourceView объект, связанный с текущим SqlDataSource элементом управления, операцию удаления. |
| CanInsert |
Возвращает значение, указывающее, поддерживает ли SqlDataSourceView объект, связанный с текущим SqlDataSource элементом управления, операцию вставки. |
| CanPage |
Возвращает значение, указывающее, поддерживает ли SqlDataSourceView объект, связанный с текущим SqlDataSource элементом управления, разбиение по страницам извлеченных данных. |
| CanRetrieveTotalRowCount |
Возвращает значение, указывающее, поддерживает ли SqlDataSourceView объект, связанный с текущим SqlDataSource элементом управления, получение общего количества строк данных в дополнение к набору данных. |
| CanSort |
Возвращает значение, указывающее, поддерживает ли SqlDataSourceView объект, связанный с текущим SqlDataSource элементом управления, отсортированное представление на извлеченных данных. |
| CanUpdate |
Возвращает значение, указывающее, поддерживает ли SqlDataSourceView объект, связанный с текущим SqlDataSource элементом управления, операцию обновления. |
| ConflictDetection |
Возвращает или задает значение, указывающее, как SqlDataSource элемент управления выполняет обновления и удаляет данные в строке в базовой базе данных во время операции. |
| DeleteCommand |
Возвращает или задает строку SQL, которая SqlDataSourceView используется для удаления данных из базовой базы данных. |
| DeleteCommandType |
Возвращает или задает значение, указывающее, является ли текст в DeleteCommand свойстве инструкцией SQL или именем хранимой процедуры. |
| DeleteParameters |
Возвращает коллекцию параметров, содержащую параметры, используемые свойством DeleteCommand . |
| Events |
Возвращает список делегатов обработчика событий для представления источника данных. (Унаследовано от DataSourceView) |
| FilterExpression |
Возвращает или задает выражение фильтрации, применяемое при вызове Select метода. |
| FilterParameters |
Возвращает коллекцию параметров, связанных с заполнителями параметров в строке FilterExpression . |
| InsertCommand |
Возвращает или задает строку SQL, которую SqlDataSourceView объект использует для вставки данных в базовую базу данных. |
| InsertCommandType |
Возвращает или задает значение, указывающее, является ли текст в InsertCommand свойстве инструкцией SQL или именем хранимой процедуры. |
| InsertParameters |
Возвращает коллекцию параметров, содержащую параметры, используемые свойством InsertCommand . |
| IsTrackingViewState |
Возвращает значение, указывающее, сохраняет ли SqlDataSourceView объект изменения в состоянии представления. |
| Name |
Возвращает имя представления источника данных. (Унаследовано от DataSourceView) |
| OldValuesParameterFormatString |
Возвращает или задает строку формата, которая применяется к именам всех параметров, передаваемых в Delete метод или Update метод. |
| ParameterPrefix |
Возвращает строку, используемую для префикса заполнителя параметра в параметризованном SQL-запросе. |
| SelectCommand |
Возвращает или задает строку SQL, которую SqlDataSourceView объект использует для извлечения данных из базовой базы данных. |
| SelectCommandType |
Возвращает или задает значение, указывающее, является ли текст в SelectCommand свойстве SQL-запросом или именем хранимой процедуры. |
| SelectParameters |
Возвращает коллекцию параметров, содержащую параметры, используемые свойством SelectCommand . |
| SortParameterName |
Возвращает или задает имя параметра хранимой процедуры, который используется для сортировки извлеченных данных при выполнении извлечения данных с помощью хранимой процедуры. |
| UpdateCommand |
Возвращает или задает строку SQL, которую SqlDataSourceView объект использует для обновления данных в базовой базе данных. |
| UpdateCommandType |
Возвращает или задает значение, указывающее, является ли текст в UpdateCommand свойстве инструкцией SQL или именем хранимой процедуры. |
| UpdateParameters |
Возвращает коллекцию параметров, содержащую параметры, используемые свойством UpdateCommand . |
Методы
| Имя | Описание |
|---|---|
| CanExecute(String) |
Определяет, может ли выполняться указанная команда. (Унаследовано от DataSourceView) |
| Delete(IDictionary, IDictionary, DataSourceViewOperationCallback) |
Выполняет асинхронную операцию удаления в списке данных, которые DataSourceView представляет объект. (Унаследовано от DataSourceView) |
| Delete(IDictionary, IDictionary) |
Выполняет операцию удаления с помощью DeleteCommand строки SQL, всех параметров, указанных в DeleteParameters коллекции, и значений, содержащихся в указанных |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback) |
Выполняет указанную команду. (Унаследовано от DataSourceView) |
| ExecuteCommand(String, IDictionary, IDictionary) |
Выполняет указанную команду. (Унаследовано от DataSourceView) |
| ExecuteDelete(IDictionary, IDictionary) |
Выполняет операцию удаления с помощью DeleteCommand строки SQL, всех параметров, указанных в DeleteParameters коллекции, и значений, содержащихся в указанных |
| ExecuteInsert(IDictionary) |
Выполняет операцию вставки с помощью InsertCommand строки SQL, всех параметров, указанных в InsertParameters коллекции, и значений, содержащихся в указанной |
| ExecuteSelect(DataSourceSelectArguments) |
Извлекает данные из базовой базы данных с помощью SelectCommand строки SQL и всех параметров, входящих в коллекцию SelectParameters . |
| ExecuteUpdate(IDictionary, IDictionary, IDictionary) |
Выполняет операцию обновления с помощью UpdateCommand строки SQL, всех параметров, входящих в UpdateParameters коллекцию, и значений, содержащихся в указанных |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| Insert(IDictionary, DataSourceViewOperationCallback) |
Выполняет асинхронную операцию вставки в списке данных, которые DataSourceView представляет объект. (Унаследовано от DataSourceView) |
| Insert(IDictionary) |
Выполняет операцию вставки с помощью InsertCommand строки SQL, всех параметров, указанных в InsertParameters коллекции, и значений, содержащихся в указанной |
| LoadViewState(Object) |
Восстанавливает ранее сохраненное состояние представления для представления источника данных. |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| OnDataSourceViewChanged(EventArgs) |
Вызывает событие DataSourceViewChanged. (Унаследовано от DataSourceView) |
| OnDeleted(SqlDataSourceStatusEventArgs) |
Deleted Вызывает событие после SqlDataSource завершения операции удаления элемента управления. |
| OnDeleting(SqlDataSourceCommandEventArgs) |
Deleting Вызывает событие, прежде чем SqlDataSource элемент управления пытается выполнить операцию удаления. |
| OnFiltering(SqlDataSourceFilteringEventArgs) |
Filtering Вызывает событие, прежде чем SqlDataSource элемент управления фильтрует результаты операции выбора. |
| OnInserted(SqlDataSourceStatusEventArgs) |
Inserted Вызывает событие после SqlDataSource завершения операции вставки элемента управления. |
| OnInserting(SqlDataSourceCommandEventArgs) |
Inserting Вызывает событие, прежде чем SqlDataSource элемент управления пытается выполнить операцию вставки. |
| OnSelected(SqlDataSourceStatusEventArgs) |
Selected Вызывает событие после SqlDataSource завершения операции извлечения данных элементом управления. |
| OnSelecting(SqlDataSourceSelectingEventArgs) |
Selecting Вызывает событие перед SqlDataSource попыткой элемента управления выполнить операцию извлечения данных. |
| OnUpdated(SqlDataSourceStatusEventArgs) |
Updated Вызывает событие после SqlDataSource завершения операции обновления элемента управления. |
| OnUpdating(SqlDataSourceCommandEventArgs) |
Updating Вызывает событие перед SqlDataSource попыткой элемента управления выполнить операцию обновления. |
| RaiseUnsupportedCapabilityError(DataSourceCapabilities) |
Сравнивает возможности, запрашиваемые для ExecuteSelect(DataSourceSelectArguments) операции, с теми, которые поддерживает представление и вызывается методом RaiseUnsupportedCapabilitiesError(DataSourceView) . |
| SaveViewState() |
Сохраняет изменения состояния представления для SqlDataSourceView элемента управления с момента размещения страницы на сервере. |
| Select(DataSourceSelectArguments, DataSourceViewSelectCallback) |
Возвращает список данных асинхронно из базового хранилища данных. (Унаследовано от DataSourceView) |
| Select(DataSourceSelectArguments) |
Извлекает данные из базовой базы данных с помощью SelectCommand строки SQL и всех параметров, входящих в коллекцию SelectParameters . |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |
| TrackViewState() |
Вызывает SqlDataSourceView отслеживание изменений в состоянии представления, чтобы изменения могли храниться в объекте StateBag для элемента управления и сохраняться между запросами на одну и ту же страницу. |
| Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback) |
Выполняет асинхронную операцию обновления в списке данных, которые DataSourceView представляет объект. (Унаследовано от DataSourceView) |
| Update(IDictionary, IDictionary, IDictionary) |
Выполняет операцию обновления с помощью UpdateCommand строки SQL, всех параметров, входящих в UpdateParameters коллекцию, и значений, содержащихся в указанных |
События
| Имя | Описание |
|---|---|
| DataSourceViewChanged |
Происходит при изменении представления источника данных. (Унаследовано от DataSourceView) |
| Deleted |
Происходит при завершении операции удаления. |
| Deleting |
Происходит перед операцией удаления. |
| Filtering |
Происходит перед операцией фильтра. |
| Inserted |
Происходит при завершении операции вставки. |
| Inserting |
Происходит перед операцией вставки. |
| Selected |
Происходит при завершении операции извлечения данных. |
| Selecting |
Происходит перед операцией извлечения данных. |
| Updated |
Происходит при завершении операции обновления. |
| Updating |
Происходит перед операцией обновления. |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| IStateManager.IsTrackingViewState |
Описание этого элемента см. в разделе IsTrackingViewState. |
| IStateManager.LoadViewState(Object) |
Описание этого элемента см. в разделе LoadViewState(Object). |
| IStateManager.SaveViewState() |
Описание этого элемента см. в разделе SaveViewState(). |
| IStateManager.TrackViewState() |
Описание этого элемента см. в разделе TrackViewState(). |
