SqlCommandBuilder.GetInsertCommand Метод

Определение

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

System.Data.SqlClient

Сборка:

System.Data.SqlClient.dll

Пакет:

System.Data.SqlClient v4.9.0

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

Перегрузки

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

Комментарии

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

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

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

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

GetInsertCommand()

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

System.Data.SqlClient.notsupported.cs

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

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

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

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

Public Function GetInsertCommand () As SqlCommand

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

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

GetInsertCommand(Boolean)

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

System.Data.SqlClient.notsupported.cs

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

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

Параметры

useColumnsForParameterNames

Boolean

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

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

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