SqlCommandBuilder.GetInsertCommand Método

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

Retornos

O objeto gerado SqlCommand automaticamente necessário para executar inserções.

Comentários

Um aplicativo pode usar o GetInsertCommand método para fins informativos ou de solução de problemas porque retorna o SqlCommand objeto a ser executado.

Você também pode usar GetInsertCommand como base de um comando modificado. Por exemplo, você pode chamar GetInsertCommand e modificar o CommandTimeout valor e, em seguida, defini-lo explicitamente no SqlDataAdapter.

Depois que a instrução Transact-SQL for gerada pela primeira vez, o aplicativo deverá chamar explicitamente RefreshSchema se alterar a instrução de alguma forma. Caso contrário, ainda GetInsertCommand usará informações da instrução anterior, que podem não estar corretas. As instruções Transact-SQL são geradas pela primeira vez quando o aplicativo chama Update ou GetInsertCommand.

Para obter mais informações, confira Gerar comandos com CommandBuilders.

Confira também

• Conectando e recuperando dados no ADO.NET
• Usando o provedor de dados do .NET Framework para SQL Server
• Visão geral do ADO.NET

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

Parâmetros

Retornos

O objeto gerado SqlCommand automaticamente que é necessário para executar inserções.

Comentários

Um aplicativo pode usar o GetInsertCommand método para fins informativos ou de solução de problemas porque retorna o SqlCommand objeto a ser executado.

Você também pode usar GetInsertCommand como base de um comando modificado. Por exemplo, você pode chamar GetInsertCommand e modificar o CommandTimeout valor e, em seguida, defini-lo explicitamente no SqlDataAdapter.

Depois que a instrução Transact-SQL for gerada pela primeira vez, o aplicativo deverá chamar explicitamente RefreshSchema se alterar a instrução de alguma forma. Caso contrário, ainda GetInsertCommand usará informações da instrução anterior, que podem não estar corretas. As instruções Transact-SQL são geradas pela primeira vez quando o aplicativo chama Update ou GetInsertCommand.

O comportamento padrão, ao gerar nomes de parâmetro, é usar @p1, @p2e assim por diante para os vários parâmetros. Passar true para o useColumnsForParameterNames parâmetro permite forçar a OleDbCommandBuilder geração de parâmetros com base nos nomes das colunas. Isso só será bem-sucedido se as seguintes condições forem atendidas:

• O ParameterNameMaxLength retornado da chamada do método GetSchema e encontrado na DataSourceInformation coleção foi especificado e seu comprimento é igual ou maior que o nome do parâmetro gerado.

• O nome do parâmetro gerado atende aos critérios especificados na ParameterNamePattern chamada do método GetSchema retornada e encontrado na expressão regular da DataSourceInformation coleção.

• Um ParameterMarkerFormat retornado da chamada do método GetSchema e encontrado na DataSourceInformation coleção é especificado.

Para obter mais informações, confira Gerar comandos com CommandBuilders.

Confira também

• Conectando e recuperando dados no ADO.NET
• Usando o provedor de dados do .NET Framework para SQL Server
• Visão geral do ADO.NET