Partilhar via


SqlCommandBuilder.GetInsertCommand Método

Definição

Obtém o objeto SqlCommand gerado automaticamente necessário para executar inserções no banco de dados.

Sobrecargas

GetInsertCommand()

Obtém o objeto SqlCommand gerado automaticamente necessário para executar inserções no banco de dados.

GetInsertCommand(Boolean)

Obtém o objeto SqlCommand gerado automaticamente necessário para executar inserções no banco de dados.

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 definir explicitamente isso no SqlDataAdapter.

Depois que a instrução Transact-SQL for gerada pela primeira vez, o aplicativo deverá chamar RefreshSchema explicitamente se alterar a instrução de alguma forma. Caso contrário, o GetInsertCommand ainda 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.

GetInsertCommand()

Obtém o objeto SqlCommand gerado automaticamente necessário para executar inserções no banco de dados.

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 SqlCommand gerado 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 definir explicitamente isso no SqlDataAdapter.

Depois que a instrução Transact-SQL for gerada pela primeira vez, o aplicativo deverá chamar RefreshSchema explicitamente se alterar a instrução de alguma forma. Caso contrário, o GetInsertCommand ainda 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

Aplica-se a

GetInsertCommand(Boolean)

Obtém o objeto SqlCommand gerado automaticamente necessário para executar inserções no banco de dados.

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

useColumnsForParameterNames
Boolean

Se true, gere nomes de parâmetro correspondentes a nomes de coluna, se possível. Se false, gerar @p1, @p2 e assim por diante.

Retornos

O objeto SqlCommand gerado 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 definir explicitamente isso no SqlDataAdapter.

Depois que a instrução Transact-SQL for gerada pela primeira vez, o aplicativo deverá chamar RefreshSchema explicitamente se alterar a instrução de alguma forma. Caso contrário, o GetInsertCommand ainda 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 que você force o OleDbCommandBuilder a gerar parâmetros com base nos nomes das colunas. Isso só terá êxito se as seguintes condições forem atendidas:

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

Confira também

Aplica-se a