DbCommandBuilder.GetInsertCommand Метод

Определение

Пространство имен:
System.Data.Common
Сборка:
System.Data.dll
Сборка:
netstandard.dll

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

Перегрузки

Имя Описание
GetInsertCommand()

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

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

Комментарии

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

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

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

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

GetInsertCommand()

Возвращает автоматически созданный 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 сначала создаются при вызовах или вызовах UpdateGetInsertCommandприложения.

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

Применяется к

GetInsertCommand(Boolean)

Возвращает автоматически созданный 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это возможно, создайте имена параметров, соответствующие именам столбцов. Значение if false, generate @p1, @p2and т. д.

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

DbCommand

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

Комментарии

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

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

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

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

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

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

  • Задано значение ParameterMarkerFormat .

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

Применяется к