This documentation is archived and is not being maintained.

SqlCommandBuilder.GetInsertCommand Method

Gets the automatically generated SqlCommand object required to perform insertions on the database.

[Visual Basic]
Public Function GetInsertCommand() As SqlCommand
public SqlCommand GetInsertCommand();
public: SqlCommand* GetInsertCommand();
public function GetInsertCommand() : SqlCommand;

Return Value

The automatically generated SqlCommand object required to perform insertions.


An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the SqlCommand object to be executed.

You can also use GetInsertCommand as the basis of a modified command. For example, you might call GetInsertCommand and modify the CommandTimeout value, and then explicitly set that on the SqlDataAdapter.

After the Transact-SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. Otherwise, the GetInsertCommand will be still be using information from the previous statement, which might not be correct. The Transact-SQL statements are first generated either when the application calls Update or GetInsertCommand.

For more information, see Automatically Generated Commands.


Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, .NET Compact Framework

See Also

SqlCommandBuilder Class | SqlCommandBuilder Members | System.Data.SqlClient Namespace