DbCommandBuilder.GetInsertCommand Метод

Определение

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

System.Data.Common

Сборка:

System.Data.Common.dll

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

Перегрузки

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

Комментарии

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

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

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

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

GetInsertCommand()

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

DBCommandBuilder.cs

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

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

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

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

Public Function GetInsertCommand () As DbCommand

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

DbCommand

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

Комментарии

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

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

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

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

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

GetInsertCommand(Boolean)

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

DBCommandBuilder.cs

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

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

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

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

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommand

Параметры

useColumnsForParameterNames

Boolean

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

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

DbCommand

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

Комментарии

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

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

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

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

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

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

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

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

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