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


SqlDataSourceView Класс

Определение

Поддерживает элемент управления 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
Наследование
SqlDataSourceView
Производный
Реализации

Комментарии

Класс SqlDataSourceView предназначен в основном для использования элементами управления с привязкой к данным, а не как программируемый объект в коде страницы.

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

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

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

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

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

Получение данных является более эффективным, если предложение, используемое для фильтрации данных во время извлечения данных, является динамическим. Другими словами, 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().

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

См. также раздел