DbCommandBuilder.GetUpdateCommand Метод

Определение

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

System.Data.Common

Сборка:

System.Data.Common.dll

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

Перегрузки

GetUpdateCommand()	Возвращает автоматически созданный объект DbCommand, который требуется для выполнения операций обновления в источнике данных.
GetUpdateCommand(Boolean)	Возвращает автоматически созданный объект DbCommand, который требуется для выполнения операций обновления в источнике данных (дополнительно могут использоваться столбцы для определения имен параметров).

Комментарии

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

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

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

Поведение по умолчанию при создании имен параметров заключается в использовании @p1, @p2и т. д. для различных параметров. Если перегруженная версия GetUpdateCommand позволяет указать такое поведение, можно вызвать DbCommandBuilder создание параметров на основе имен столбцов.

GetUpdateCommand()

Исходный код:

DBCommandBuilder.cs

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

public:
 System::Data::Common::DbCommand ^ GetUpdateCommand();

public System.Data.Common.DbCommand GetUpdateCommand ();

member this.GetUpdateCommand : unit -> System.Data.Common.DbCommand

Public Function GetUpdateCommand () As DbCommand

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

DbCommand

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

Комментарии

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

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

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

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

• Создание команд с помощью CommandBuilders
• Общие сведения об ADO.NET

GetUpdateCommand(Boolean)

Исходный код:

DBCommandBuilder.cs

Возвращает автоматически созданный объект DbCommand, который требуется для выполнения операций обновления в источнике данных (дополнительно могут использоваться столбцы для определения имен параметров).

public:
 System::Data::Common::DbCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

public System.Data.Common.DbCommand GetUpdateCommand (bool useColumnsForParameterNames);

member this.GetUpdateCommand : bool -> System.Data.Common.DbCommand

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As DbCommand

Параметры

useColumnsForParameterNames

Boolean

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

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

DbCommand

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

Комментарии

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

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

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

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

• Указан ParameterNameMaxLength , и его длина равна или больше имени созданного параметра.

• Имя созданного параметра соответствует критериям, указанным в регулярном ParameterNamePattern выражении.

• Указан ParameterMarkerFormat объект .

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

• Создание команд с помощью CommandBuilders
• Общие сведения об ADO.NET