OleDbCommandBuilder.GetUpdateCommand Método

Definição

Namespace:

System.Data.OleDb

Assembly:

System.Data.OleDb.dll

Pacote:

System.Data.OleDb v9.0.0-rc.2.24473.5

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

Sobrecargas

GetUpdateCommand()	Obtém o objeto OleDbCommand gerado automaticamente necessário para realizar atualizações na fonte de dados.
GetUpdateCommand(Boolean)	Obtém o objeto OleDbCommand gerado automaticamente necessário para realizar atualizações na fonte de dados, opcionalmente usando colunas para nomes de parâmetros.

Comentários

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

Você também pode usar GetUpdateCommand como base de um comando modificado. Por exemplo, você pode chamar GetUpdateCommand e modificar o CommandTimeout valor e definir explicitamente isso no OleDbDataAdapter.

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

GetUpdateCommand()

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

public:
 System::Data::OleDb::OleDbCommand ^ GetUpdateCommand();

public System.Data.OleDb.OleDbCommand GetUpdateCommand ();

override this.GetUpdateCommand : unit -> System.Data.OleDb.OleDbCommand

Public Function GetUpdateCommand () As OleDbCommand

Retornos

OleDbCommand

O objeto OleDbCommand gerado automaticamente necessário para executar atualizações.

Comentários

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

Você também pode usar GetUpdateCommand como base de um comando modificado. Por exemplo, você pode chamar GetUpdateCommand e modificar o CommandTimeout valor e definir explicitamente isso no OleDbDataAdapter.

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

Confira também

• Gerando comandos com CommandBuilders

GetUpdateCommand(Boolean)

Obtém o objeto OleDbCommand gerado automaticamente necessário para realizar atualizações na fonte de dados, opcionalmente usando colunas para nomes de parâmetros.

public:
 System::Data::OleDb::OleDbCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);

public System.Data.OleDb.OleDbCommand GetUpdateCommand (bool useColumnsForParameterNames);

override this.GetUpdateCommand : bool -> System.Data.OleDb.OleDbCommand

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As OleDbCommand

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

OleDbCommand

O objeto OleDbCommand gerado automaticamente necessário para executar atualizações.

Comentários

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

Você também pode usar GetUpdateCommand como base de um comando modificado. Por exemplo, você pode chamar GetUpdateCommand e modificar o CommandTimeout valor e definir explicitamente isso no OleDbDataAdapter.

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

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:

• 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