SqlDataSourceView Класс

Ссылка

Определение

Пространство имен:: System.Web.UI.WebControls

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Поддерживает элемент управления SqlDataSource и предоставляет интерфейс для элементов управления с привязкой к данным для выполнения операций с SQL-данными в реляционных базах данных.

public ref class SqlDataSourceView : System::Web::UI::DataSourceView, System::Web::UI::IStateManager

public class SqlDataSourceView : System.Web.UI.DataSourceView, System.Web.UI.IStateManager

type SqlDataSourceView = class
    inherit DataSourceView
    interface IStateManager

Public Class SqlDataSourceView
Inherits DataSourceView
Implements IStateManager

Наследование: Object

DataSourceView
SqlDataSourceView

Производный: System.Web.UI.WebControls.AccessDataSourceView

Реализации: IStateManager

ASP.NET элементы управления источником данных содержат один или несколько списков данных, представленных объектами представления источника данных. Класс SqlDataSourceView расширяет DataSourceView класс, определяет возможности SqlDataSource элемента управления, с которым он связан, и реализует основные функции данных для элемента управления источником данных. Класс SqlDataSourceView реализует функциональные возможности данных для SqlDataSource элемента управления, включая Selectоперации , Update, Insertи Delete , сортировку, фильтрацию и управление параметрами, которые хранятся в состоянии просмотра.

Несмотря на то, SqlDataSourceView что элемент управления напрямую не предоставляет разработчикам SqlDataSource страниц объект, многие из его свойств являются. Самая простая операция, выполняемая представлением источника данных, — получение данных из базовой базы данных с помощью Select метода , который извлекает коллекцию IEnumerable элементов данных. Класс SqlDataSourceView реализует получение данных из реляционных баз данных с помощью SQL-запросов. Sql-запросы можно параметризовать для повышения гибкости и безопасности. Следующие методы, свойства и события извлечения данных реализуются SqlDataSourceView и предоставляются непосредственно его SqlDataSource элементом управления разработчикам страниц и другим вызывающим объектам:

Свойство SelectCommand.
Свойство SelectParameters.
Событие Selecting
Событие Selected

Объект SqlDataSourceView поддерживает обновление данных в реляционной базе данных с помощью команд SQL. Команды SQL можно параметризовать для повышения гибкости и безопасности. Элементы управления с привязкой к данным, такие как и DetailsView, можно настроить для автоматического выполнения обновлений SqlDataSourceViewс помощью , в то время как GridView другие элементы управления не могут выполнять обновления. Следующие методы обновления, свойства и события реализуются SqlDataSourceView и предоставляются непосредственно его SqlDataSource элементом управления разработчикам страниц и другим вызывающим объектам:

Свойство UpdateCommand.
Свойство UpdateParameters.
Событие Updating
Событие Updated

поддерживает SqlDataSourceView вставку новых строк данных в реляционную базу данных. Команды SQL, указанные в свойстве InsertCommand , можно параметризовать для повышения гибкости и безопасности. Элементы управления с привязкой к данным, такие как и DetailsView, можно настроить для автоматического SqlDataSourceViewвыполнения вставок с помощью , в то время как GridView другие элементы управления — нет. Следующие методы вставки, свойства и события реализуются 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 задав SortExpression свойство DataSourceSelectArguments объекта, передаваемого Select в метод . Синтаксис свойства SortExpression аналогичен синтаксису DataView.Sort свойства . Если для получения данных используется хранимая процедура, можно также использовать SortParameterName свойство , чтобы указать параметр, который используется специально для сортировки результатов вызова хранимой процедуры.

Если несколько пользователей могут одновременно изменить базу данных, существует вероятность конфликта параллелизма. Элемент SqlDataSource управления управляет параллелизмом SqlDataSource.ConflictDetection через свойство . Функциональные возможности реализованы в свойстве SqlDataSourceView.ConflictDetection .

Как и многие другие серверные IStateManager веб-элементы управления, SqlDataSourceView класс реализует интерфейс и использует состояние представления для отслеживания его состояния в запросах страницы. IsTrackingViewState Реализации свойства и и LoadViewStateметодов , SaveViewStateи TrackViewState предоставляются для включения отслеживания состояния представления для элемента управления . Дополнительные сведения см . в разделе ASP.NET Общие сведения об управлении состоянием.

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

SqlDataSourceView(SqlDataSource, String, HttpContext)

Инициализирует новый экземпляр класса SqlDataSourceView с назначением указанного элемента управления SqlDataSource в качестве владельца текущего представления.

Свойства

CancelSelectOnNullParameter	Возвращает или задает значение, позволяющее определить, будет ли операция извлечения отменяться в случае равенства любого из параметров, содержащихся в коллекции SelectParameters, значению `null`.
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)	Выполняет операцию удаления, используя SQL-строку DeleteCommand, все параметры, заданные в коллекции DeleteParameters, и значения, содержащиеся в заданных коллекциях `keys` и `oldValues`.
Equals(Object)	Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object)
ExecuteCommand(String, IDictionary, IDictionary, DataSourceViewOperationCallback)	Выполняет указанную команду. (Унаследовано от DataSourceView)
ExecuteCommand(String, IDictionary, IDictionary)	Выполняет указанную команду. (Унаследовано от DataSourceView)
ExecuteDelete(IDictionary, IDictionary)	Выполняет операцию удаления, используя SQL-строку DeleteCommand, все параметры, заданные в коллекции DeleteParameters, и значения, содержащиеся в заданных коллекциях `keys` и `oldValues`.
ExecuteInsert(IDictionary)	Выполняет операцию вставки, используя SQL-строку InsertCommand, все параметры, заданные в коллекции InsertParameters, и значения, содержащиеся в заданной коллекции `values`.
ExecuteSelect(DataSourceSelectArguments)	Извлекает данные из основной базы данных, используя SQL-строку SelectCommand и параметры, содержащиеся в коллекции SelectParameters.
ExecuteUpdate(IDictionary, IDictionary, IDictionary)	Выполняет операцию обновления, используя SQL-строку UpdateCommand, все параметры, имеющиеся в коллекции UpdateParameters, и значения, содержащиеся в заданных коллекциях `keys`, `values` и `oldValues`.
GetHashCode()	Служит хэш-функцией по умолчанию. (Унаследовано от Object)
GetType()	Возвращает объект Type для текущего экземпляра. (Унаследовано от Object)
Insert(IDictionary, DataSourceViewOperationCallback)	Выполняет операцию асинхронной вставки по списку данных, представляющем объект DataSourceView. (Унаследовано от DataSourceView)
Insert(IDictionary)	Выполняет операцию вставки, используя SQL-строку InsertCommand, все параметры, заданные в коллекции InsertParameters, и значения, содержащиеся в заданной коллекции `values`.
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)	Извлекает данные из основной базы данных, используя SQL-строку SelectCommand и параметры, содержащиеся в коллекции SelectParameters.
ToString()	Возвращает строку, представляющую текущий объект. (Унаследовано от Object)
TrackViewState()	Инициирует отслеживание элементом управления SqlDataSourceView изменений в состоянии его представления, благодаря чему эти изменения можно сохранить для этого элемента в объекте StateBag и хранить их для всех запросов одной и той же страницы.
Update(IDictionary, IDictionary, IDictionary, DataSourceViewOperationCallback)	Выполняет операцию асинхронного обновления в списке данных, представляющем объект DataSourceView. (Унаследовано от DataSourceView)
Update(IDictionary, IDictionary, IDictionary)	Выполняет операцию обновления, используя SQL-строку UpdateCommand, все параметры, имеющиеся в коллекции UpdateParameters, и значения, содержащиеся в заданных коллекциях `keys`, `values` и `oldValues`.

События

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().

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

Поделиться через