OleDbCommandBuilder.GetInsertCommand Метод

Определение

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

System.Data.OleDb

Сборка:

System.Data.OleDb.dll

Пакет:

System.Data.OleDb v8.0.0

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

Перегрузки

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

Комментарии

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

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

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

GetInsertCommand()

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

OleDbCommandBuilder.cs

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

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand();

public System.Data.OleDb.OleDbCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand () As OleDbCommand

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

OleDbCommand

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

Комментарии

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

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

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

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

• Создание команд с помощью построителей CommandBuilder

GetInsertCommand(Boolean)

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

OleDbCommandBuilder.cs

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

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.OleDb.OleDbCommand GetInsertCommand (bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OleDbCommand

Параметры

useColumnsForParameterNames

Boolean

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

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

OleDbCommand

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

Комментарии

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

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

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

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

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

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

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

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

• Создание команд с помощью построителей CommandBuilder