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