SqlCommandBuilder.GetUpdateCommand Метод

Определение

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

Microsoft.Data.SqlClient

Сборка:

Microsoft.Data.SqlClient.dll

Пакет:

Microsoft.Data.SqlClient v5.2.0

Перегрузки

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

GetUpdateCommand()

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

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

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

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

Public Function GetUpdateCommand () As SqlCommand

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

SqlCommand

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

Комментарии

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

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

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

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

GetUpdateCommand(Boolean)

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

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

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

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

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Параметры

useColumnsForParameterNames

Boolean

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

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

SqlCommand

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

Комментарии

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

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

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

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

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

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

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

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