SqlCommandBuilder.GetInsertCommand Метод

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

System.Data.SqlClient.notsupported.cs

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand();

public System.Data.SqlClient.SqlCommand GetInsertCommand();

member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand () As SqlCommand

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

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

Комментарии

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

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

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

Дополнительные сведения см. в статье Создание команд с помощью классов CommandBuilder.

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

• Подключение и извлечение данных в ADO.NET
• Использование поставщика данных .NET Framework для SQL Server
• Общие сведения об ADO.NET

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

System.Data.SqlClient.notsupported.cs

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.SqlClient.SqlCommand GetInsertCommand(bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Параметры

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

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

Комментарии

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

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

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

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

• Возвращенный ParameterNameMaxLength из вызова метода GetSchema и найденный в DataSourceInformation коллекции, и его длина равна или больше созданного имени параметра.

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

• Указан ParameterMarkerFormat возвращаемый из вызова метода GetSchema и найденный DataSourceInformation в коллекции.

Дополнительные сведения см. в статье Создание команд с помощью классов CommandBuilder.

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

• Подключение и извлечение данных в ADO.NET
• Использование поставщика данных .NET Framework для SQL Server
• Общие сведения об ADO.NET