OdbcCommandBuilder.GetInsertCommand Método

Definição

Namespace:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Pacote:

System.Data.Odbc v8.0.0

Obtém o objeto OdbcCommand gerado automaticamente necessário para realizar inserções na fonte de dados.

Sobrecargas

GetInsertCommand()	Obtém o objeto OdbcCommand gerado automaticamente necessário para realizar inserções na fonte de dados.
GetInsertCommand(Boolean)	Obtém o objeto OdbcCommand gerado automaticamente necessário para realizar inserções na fonte de dados.

Comentários

Você pode usar o GetInsertCommand método para fins informativos ou de solução de problemas porque ele retorna o OdbcCommand 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 OdbcDataAdapter.

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

GetInsertCommand()

Origem:

OdbcCommandBuilder.cs

Obtém o objeto OdbcCommand gerado automaticamente necessário para realizar inserções na fonte de dados.

public:
 System::Data::Odbc::OdbcCommand ^ GetInsertCommand();

public System.Data.Odbc.OdbcCommand GetInsertCommand ();

override this.GetInsertCommand : unit -> System.Data.Odbc.OdbcCommand

Public Function GetInsertCommand () As OdbcCommand

Retornos

OdbcCommand

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

Comentários

Você pode usar o GetInsertCommand método para fins informativos ou de solução de problemas porque ele retorna o OdbcCommand 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 OdbcDataAdapter.

Depois que a instrução SQL for gerada pela primeira vez, você deverá chamar RefreshSchema explicitamente se ela 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 SQL são geradas pela primeira vez quando o aplicativo chama Update ou GetInsertCommand.

Confira também

• Gerando comandos com CommandBuilders

GetInsertCommand(Boolean)

Origem:

OdbcCommandBuilder.cs

Obtém o objeto OdbcCommand gerado automaticamente necessário para realizar inserções na fonte de dados.

public:
 System::Data::Odbc::OdbcCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.Odbc.OdbcCommand GetInsertCommand (bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.Odbc.OdbcCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OdbcCommand

Parâmetros

useColumnsForParameterNames

Boolean

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

Retornos

OdbcCommand

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

Comentários

Você pode usar o GetInsertCommand método para fins informativos ou de solução de problemas porque ele retorna o OdbcCommand 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 OdbcDataAdapter.

Depois que a instrução SQL for gerada pela primeira vez, você deverá chamar RefreshSchema explicitamente se ela alterar a instrução de alguma forma. Caso contrário, o GetInsertCommand usará informações da instrução anterior, que podem não estar corretas. As instruções 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 o DbCommandBuilder a gerar parâmetros com base nos nomes de coluna. Isso só terá êxito se as seguintes condições forem atendidas:

• O ParameterNameMaxLength 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 expressão regular.

• Um ParameterMarkerFormat é especificado.

Confira também

• Gerando comandos com CommandBuilders