SqlCommandBuilder.GetInsertCommand Метод

Определение

Пространство имен:

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Перегрузки

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

GetInsertCommand()

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

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand();

public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> Microsoft.Data.SqlClient.SqlCommand

Public Function GetInsertCommand () As SqlCommand

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

SqlCommand

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

Комментарии

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

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

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

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

GetInsertCommand(Boolean)

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

public:
 Microsoft::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public Microsoft.Data.SqlClient.SqlCommand GetInsertCommand (bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> Microsoft.Data.SqlClient.SqlCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Параметры

useColumnsForParameterNames

Boolean

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

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

SqlCommand

Автоматически созданный объект 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.