SqlCommandBuilder.GetInsertCommand Метод

Определение

Получает автоматически созданный объект SqlCommand, который требуется для выполнения операций вставки в базе данных.

Перегрузки

GetInsertCommand()

Получает автоматически созданный объект SqlCommand, который требуется для выполнения операций вставки в базу данных.

GetInsertCommand(Boolean)

Получает автоматически созданный объект SqlCommand, который требуется для выполнения операций вставки в базе данных.

Комментарии

Приложение может использовать метод для информационных GetInsertCommand целей или устранения неполадок, так как оно возвращает SqlCommand объект для выполнения.

Вы также можете использовать GetInsertCommand в качестве основы для измененной команды. Например, можно вызвать GetInsertCommand и изменить CommandTimeout значение, а затем явно задать его в SqlDataAdapter.

После создания инструкции Transact-SQL приложение должно явно вызвать RefreshSchema , если оно каким-либо образом изменяет инструкцию. В противном случае объект по-прежнему GetInsertCommand будет использовать сведения из предыдущей инструкции, которая может быть неправильной. Инструкции Transact-SQL сначала создаются, когда приложение вызывает Update или GetInsertCommand.

Дополнительные сведения см. в статье Создание команд с помощью классов CommandBuilder.

GetInsertCommand()

Получает автоматически созданный объект SqlCommand, который требуется для выполнения операций вставки в базу данных.

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand();
public System.Data.SqlClient.SqlCommand GetInsertCommand ();
member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand
override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand
Public Function GetInsertCommand () As SqlCommand

Возвращаемое значение

Автоматически созданный объект SqlCommand, необходимый для выполнения операций вставки.

Комментарии

Приложение может использовать метод для информационных GetInsertCommand целей или устранения неполадок, так как оно возвращает SqlCommand объект для выполнения.

Вы также можете использовать GetInsertCommand в качестве основы для измененной команды. Например, можно вызвать GetInsertCommand и изменить CommandTimeout значение, а затем явно задать его в SqlDataAdapter.

После создания инструкции Transact-SQL приложение должно явно вызвать RefreshSchema , если оно каким-либо образом изменяет инструкцию. В противном случае объект по-прежнему GetInsertCommand будет использовать сведения из предыдущей инструкции, которая может быть неправильной. Инструкции Transact-SQL сначала создаются, когда приложение вызывает Update или GetInsertCommand.

Дополнительные сведения см. в статье Создание команд с помощью классов CommandBuilder.

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

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

GetInsertCommand(Boolean)

Получает автоматически созданный объект SqlCommand, который требуется для выполнения операций вставки в базе данных.

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);
public System.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);
override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Параметры

useColumnsForParameterNames
Boolean

Если значением является true, создаются имена параметров, совпадающие с именами столбцов, если это возможно. Если значение равно false, создаются @p1, @p2 и т. д.

Возвращаемое значение

Автоматически созданный объект SqlCommand, необходимый для выполнения операции вставки.

Комментарии

Приложение может использовать метод для информационных GetInsertCommand целей или устранения неполадок, так как оно возвращает SqlCommand объект для выполнения.

Вы также можете использовать GetInsertCommand в качестве основы для измененной команды. Например, можно вызвать GetInsertCommand и изменить CommandTimeout значение, а затем явно задать его в SqlDataAdapter.

После создания инструкции Transact-SQL приложение должно явно вызвать RefreshSchema , если оно каким-либо образом изменяет инструкцию. В противном случае объект по-прежнему GetInsertCommand будет использовать сведения из предыдущей инструкции, которая может быть неправильной. Инструкции Transact-SQL сначала создаются, когда приложение вызывает Update или GetInsertCommand.

Поведение по умолчанию при создании имен параметров заключается в использовании @p1, @p2и т. д. для различных параметров. Передача true для useColumnsForParameterNames параметра позволяет принудительно OleDbCommandBuilder создать параметры на основе имен столбцов. Это выполняется, только если выполняются следующие условия:

  • Объект , ParameterNameMaxLength возвращенный из вызова метода GetSchema и найденный DataSourceInformation в коллекции, указан, а его длина равна или больше имени созданного параметра.

  • Имя созданного параметра соответствует критериям, заданным в объекте ParameterNamePattern , возвращенном из вызова метода GetSchema и найденном в регулярном DataSourceInformation выражении коллекции.

  • Указан объект , ParameterMarkerFormat возвращенный из вызова метода GetSchema и найденный DataSourceInformation в коллекции.

Дополнительные сведения см. в статье Создание команд с помощью классов CommandBuilder.

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

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