OleDbCommandBuilder.GetUpdateCommand Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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()
- Origem:
- OleDbCommandBuilder.cs
- Origem:
- OleDbCommandBuilder.cs
- Origem:
- OleDbCommandBuilder.cs
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
member this.GetUpdateCommand : unit -> System.Data.OleDb.OleDbCommand
Public Function GetUpdateCommand () As OleDbCommand
Retornos
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
Aplica-se a
GetUpdateCommand(Boolean)
- Origem:
- OleDbCommandBuilder.cs
- Origem:
- OleDbCommandBuilder.cs
- Origem:
- OleDbCommandBuilder.cs
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
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
, @p2
e 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.