DbCommandBuilder.GetUpdateCommand Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém o objeto gerado DbCommand automaticamente necessário para realizar atualizações na fonte de dados.
Sobrecargas
| Name | Description |
|---|---|
| GetUpdateCommand() |
Obtém o objeto gerado DbCommand automaticamente necessário para realizar atualizações na fonte de dados. |
| GetUpdateCommand(Boolean) |
Obtém o objeto gerado DbCommand automaticamente necessário para realizar atualizações na fonte de dados, optativamente usando colunas para nomes de parâmetros. |
Observações
Uma aplicação pode usar o GetUpdateCommand método para fins informativos ou de resolução de problemas porque devolve o DbCommand objeto a ser executado.
Também podes usar GetUpdateCommand como base para um comando modificado. Por exemplo, pode chamar GetUpdateCommand e modificar o texto do comando, e depois definir explicitamente isso no DbDataAdapter.
Depois de a instrução SQL ser gerada pela primeira vez, a aplicação deve chamar RefreshSchema explicitamente se alterar a instrução de alguma forma. Caso contrário, continuarão GetUpdateCommand a usar informações da declaração anterior, que podem não estar corretas. As instruções SQL são geradas pela primeira vez quando a aplicação chama Update ou GetUpdateCommand.
O comportamento padrão, ao gerar nomes de parâmetros, é usar @p1, @p2, e assim sucessivamente para os vários parâmetros. Se a versão sobrecarregada de GetUpdateCommand permitir especificar este comportamento, pode fazer com que o DbCommandBuilder gere parâmetros com base nos nomes das colunas em vez disso.
GetUpdateCommand()
Obtém o objeto gerado DbCommand automaticamente necessário para realizar atualizações na fonte de dados.
public:
System::Data::Common::DbCommand ^ GetUpdateCommand();
public System.Data.Common.DbCommand GetUpdateCommand();
member this.GetUpdateCommand : unit -> System.Data.Common.DbCommand
Public Function GetUpdateCommand () As DbCommand
Devoluções
O objeto gerado DbCommand automaticamente necessário para realizar atualizações.
Observações
Uma aplicação pode usar o GetUpdateCommand método para fins informativos ou de resolução de problemas porque devolve o DbCommand objeto a ser executado.
Também podes usar GetUpdateCommand como base para um comando modificado. Por exemplo, pode chamar GetUpdateCommand e modificar o texto do comando, e depois definir explicitamente isso no DbDataAdapter.
Depois de a instrução SQL ser gerada pela primeira vez, a aplicação deve chamar RefreshSchema explicitamente se alterar a instrução de alguma forma. Caso contrário, continuarão GetUpdateCommand a usar informações da declaração anterior, que podem não estar corretas. As instruções SQL são geradas pela primeira vez quando a aplicação chama Update ou GetUpdateCommand.
Ver também
Aplica-se a
GetUpdateCommand(Boolean)
Obtém o objeto gerado DbCommand automaticamente necessário para realizar atualizações na fonte de dados, optativamente usando colunas para nomes de parâmetros.
public:
System::Data::Common::DbCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);
public System.Data.Common.DbCommand GetUpdateCommand(bool useColumnsForParameterNames);
member this.GetUpdateCommand : bool -> System.Data.Common.DbCommand
Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As DbCommand
Parâmetros
- useColumnsForParameterNames
- Boolean
Se true, gerar nomes de parâmetros que correspondem aos nomes das colunas, se possível. Se false, gerar @p1, @p2, e assim sucessivamente.
Devoluções
O objeto gerado DbCommand automaticamente necessário para realizar atualizações.
Observações
Uma aplicação pode usar o GetUpdateCommand método para fins informativos ou de resolução de problemas porque devolve o DbCommand objeto a ser executado.
Também podes usar GetUpdateCommand como base para um comando modificado. Por exemplo, pode chamar GetUpdateCommand e modificar o texto do comando, e depois definir explicitamente isso no DbDataAdapter.
Depois de a instrução SQL ser gerada pela primeira vez, a aplicação deve chamar RefreshSchema explicitamente se alterar a instrução de alguma forma. Caso contrário, continuarão GetUpdateCommand a usar informações da declaração anterior, que podem não estar corretas. As instruções SQL são geradas pela primeira vez quando a aplicação chama Update ou GetUpdateCommand.
O comportamento padrão, ao gerar nomes de parâmetros, é usar @p1, @p2, e assim sucessivamente para os vários parâmetros. Passar true para o useColumnsForParameterNames parâmetro permite-te forçar DbCommandBuilder o a gerar parâmetros com base nos nomes das colunas. A geração dos parâmetros com base nos nomes das colunas só tem sucesso se forem cumpridas as seguintes condições:
O ParameterNameMaxLength foi especificado e o seu comprimento é igual ou superior ao nome do parâmetro gerado.
O nome do parâmetro gerado cumpre os critérios especificados na ParameterNamePattern expressão regular.
A ParameterMarkerFormat é especificado.