SqlCommandBuilder Класс
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Автоматически создает однотабличные команды, используемые для выверки изменений, внесенных в DataSet, со связанной базой данных SQL Server. Этот класс не наследуется.
public ref class SqlCommandBuilder sealed : System::ComponentModel::Component
public ref class SqlCommandBuilder sealed : System::Data::Common::DbCommandBuilder
public sealed class SqlCommandBuilder : System.ComponentModel.Component
public sealed class SqlCommandBuilder : System.Data.Common.DbCommandBuilder
type SqlCommandBuilder = class
inherit Component
type SqlCommandBuilder = class
inherit DbCommandBuilder
Public NotInheritable Class SqlCommandBuilder
Inherits Component
Public NotInheritable Class SqlCommandBuilder
Inherits DbCommandBuilder
- Наследование
- Наследование
В следующем примере используются SqlCommand, вместе SqlDataAdapter и SqlConnectionдля выбора строк из источника данных. В примере передается строка подключения, строка запроса, которая является инструкцией Transact-SQL SELECT, и строка, которая является именем таблицы базы данных. Затем в этом примере создается SqlCommandBuilder.
public static DataSet SelectSqlRows(string connectionString,
string queryString, string tableName)
{
using (SqlConnection connection = new SqlConnection(connectionString))
{
SqlDataAdapter adapter = new SqlDataAdapter();
adapter.SelectCommand = new SqlCommand(queryString, connection);
SqlCommandBuilder builder = new SqlCommandBuilder(adapter);
connection.Open();
DataSet dataSet = new DataSet();
adapter.Fill(dataSet, tableName);
//code to modify data in DataSet here
builder.GetUpdateCommand();
//Without the SqlCommandBuilder this line would fail
adapter.Update(dataSet, tableName);
return dataSet;
}
}
Private Function SelectSqlRows(ByVal connectionString As String, _
ByVal queryString As String, ByVal tableName As String) As DataSet
Using connection As New SqlConnection(connectionString)
Dim adapter As New SqlDataAdapter()
adapter.SelectCommand = New SqlCommand(queryString, connection)
Dim builder As New SqlCommandBuilder(adapter)
connection.Open()
Dim dataSet As New DataSet()
adapter.Fill(dataSet, tableName)
' Code to modify data in DataSet here
builder.GetUpdateCommand()
' Without the SqlCommandBuilder this line would fail.
adapter.Update(dataSet, tableName)
Return dataSet
End Using
End Function
Не SqlDataAdapter создает автоматически инструкции Transact-SQL, необходимые для согласования изменений, внесенных в , со связанным экземпляром DataSet SQL Server. Однако можно создать объект для автоматического SqlCommandBuilder создания инструкций Transact-SQL для обновлений из одной таблицы, если задано SelectCommandSqlDataAdapterсвойство объекта . Затем все дополнительные инструкции Transact-SQL, которые не заданы, создаются SqlCommandBuilder.
Объект SqlCommandBuilder регистрирует себя в качестве прослушивателя для RowUpdating событий всякий раз, когда вы задаете DataAdapter свойство . Одновременно можно связать только один SqlDataAdapter объект или SqlCommandBuilder один объект.
Для создания инструкций SqlCommandBuilder INSERT, UPDATE или DELETE использует SelectCommand свойство для автоматического получения требуемого набора метаданных. При изменении SelectCommand после получения метаданных, например после первого обновления, необходимо вызвать RefreshSchema метод для обновления метаданных.
Свойство SelectCommand
должно также возвратить по крайней мере один столбец первичного ключа или столбец с атрибутом UNIQUE. Если они отсутствуют, создается исключение InvalidOperation , а команды не создаются.
также SqlCommandBuilder использует Connectionсвойства , и Transaction , CommandTimeoutна которые ссылается SelectCommand. Пользователь должен вызвать , RefreshSchema если одно или несколько из этих свойств были изменены, или если SelectCommand само свойство заменено. InsertCommandВ противном случае свойства , UpdateCommandи DeleteCommand сохраняют свои предыдущие значения.
При вызове DisposeSqlCommandBuilder метод отсоединяется от SqlDataAdapter, а созданные команды больше не используются.
Sql |
Инициализирует новый экземпляр класса SqlCommandBuilder. |
Sql |
Инициализирует новый экземпляр класса SqlCommandBuilder вместе со связанным объектом SqlDataAdapter. |
Can |
Возвращает значение, показывающее, может ли компонент вызывать событие. (Унаследовано от Component) |
Catalog |
Возвращает или задает CatalogLocation для экземпляра класса SqlCommandBuilder. |
Catalog |
Возвращает или задает строку, которую можно использовать в качестве разделителя каталогов для экземпляра класса SqlCommandBuilder. |
Conflict |
Указывает, какое значение типа ConflictOption должно использоваться объектом DbCommandBuilder. (Унаследовано от DbCommandBuilder) |
Container |
Возвращает объект IContainer, который содержит коллекцию Component. (Унаследовано от Component) |
Data |
Возвращает или задает объект SqlDataAdapter, для которого автоматически создаются инструкции Transact-SQL. |
Design |
Возвращает значение, указывающее, находится ли данный компонент Component в режиме конструктора в настоящее время. (Унаследовано от Component) |
Events |
Возвращает список обработчиков событий, которые прикреплены к этому объекту Component. (Унаследовано от Component) |
Quote |
Получает или задает начальный символ или символы, используемые для указания объектов базы данных SQL Server (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные токены. |
Quote |
Получает или задает конечный символ или символы, используемые для указания объектов базы данных SQL Server (например, таблиц или столбцов), имена которых содержат такие символы, как пробелы или зарезервированные токены. |
Schema |
Возвращает или задает символ, который используется в качестве разделителя между идентификатором схемы и остальными идентификаторами. |
Set |
Указывает, включены все значения столбца в инструкции UPDATE или только измененные значения. (Унаследовано от DbCommandBuilder) |
Site |
Получает или задает ISite объекта Component. (Унаследовано от Component) |
Apply |
Разрешает реализации поставщика класса DbCommandBuilder обрабатывать дополнительные свойства параметров. (Унаследовано от DbCommandBuilder) |
Create |
Создает объект, который содержит всю необходимую информацию для создания прокси-сервера, используемого для взаимодействия с удаленным объектом. (Унаследовано от MarshalByRefObject) |
Derive |
Извлекает сведения о параметрах из хранимой процедуры, указанной в объекте SqlCommand, и включает их в коллекцию параметров Parameters указанного объекта SqlCommand. |
Dispose() |
Освобождает все ресурсы, занятые модулем Component. (Унаследовано от Component) |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом Component, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от Component) |
Dispose(Boolean) |
Освобождает неуправляемые ресурсы, используемые объектом DbCommandBuilder, а при необходимости освобождает также управляемые ресурсы. (Унаследовано от DbCommandBuilder) |
Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
Get |
Получает автоматически созданный объект SqlCommand, который требуется для выполнения операций удаления в базе данных. |
Get |
Получает автоматически созданный объект SqlCommand, который требуется для выполнения операций удаления в базе данных. |
Get |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
Get |
Получает автоматически созданный объект SqlCommand, который требуется для выполнения операций вставки в базу данных. |
Get |
Получает автоматически созданный объект SqlCommand, который требуется для выполнения операций вставки в базе данных. |
Get |
Устаревшие..
Извлекает объект обслуживания во время существования, который управляет политикой времени существования данного экземпляра. (Унаследовано от MarshalByRefObject) |
Get |
Возвращает имя указанного параметра в формате |
Get |
Возвращает полное имя параметра при данном частичном имени параметра. (Унаследовано от DbCommandBuilder) |
Get |
Возвращает местозаполнитель для параметра в связанной инструкции SQL. (Унаследовано от DbCommandBuilder) |
Get |
Возвращает таблицу схемы для объекта DbCommandBuilder. (Унаследовано от DbCommandBuilder) |
Get |
Возвращает объект, представляющий службу, предоставляемую классом Component или классом Container. (Унаследовано от Component) |
Get |
Возвращает объект Type для текущего экземпляра. (Унаследовано от Object) |
Get |
Получает автоматически созданный объект SqlCommand, который требуется для выполнения обновлений базы данных. |
Get |
Получает автоматически созданный объект SqlCommand, который требуется для выполнения обновлений базы данных. |
Initialize |
Сбрасывает свойства CommandTimeout, Transaction, CommandType и UpdateRowSource в объекте DbCommand. (Унаследовано от DbCommandBuilder) |
Initialize |
Устаревшие..
Получает объект службы времени существования для управления политикой времени существования для этого экземпляра. (Унаследовано от MarshalByRefObject) |
Memberwise |
Создает неполную копию текущего объекта Object. (Унаследовано от Object) |
Memberwise |
Создает неполную копию текущего объекта MarshalByRefObject. (Унаследовано от MarshalByRefObject) |
Quote |
При заданном идентификаторе без кавычек в каталоге, набранном в правильном регистре, возвращает заключенный в кавычки идентификатор в корректной форме. При этом корректно исключаются встроенные в идентификатор кавычки. |
Refresh |
Очищает команды, связанные с данным построителем команд. |
Refresh |
Очищает команды, связанные с этим объектом DbCommandBuilder. (Унаследовано от DbCommandBuilder) |
Row |
Добавляет обработчик событий для события RowUpdating. (Унаследовано от DbCommandBuilder) |
Set |
Регистрирует объект DbCommandBuilder, чтобы обработать событие RowUpdating для объекта DbDataAdapter. (Унаследовано от DbCommandBuilder) |
To |
Возвращает объект String, содержащий имя Component, если оно есть. Этот метод не следует переопределять. (Унаследовано от Component) |
Unquote |
При заданном идентификаторе без кавычек в каталоге, набранном в правильном регистре, возвращает заключенный в кавычки идентификатор в корректной форме. При этом все кавычки, внедренные в идентификатор, корректно сохраняются. |
Disposed |
Возникает при удалении компонента путем вызова метода Dispose(). (Унаследовано от Component) |
Өнім | Нұсқалар |
---|---|
.NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
.NET Standard | 2.0 (package-provided) |
.NET кері байланысы
.NET — бастапқы коды ашық жоба. Пікір қалдыру үшін сілтемені таңдаңыз: