SqlCommandBuilder.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 SqlCommand automaticamente necessário para realizar atualizações na base de dados.
Sobrecargas
| Name | Description |
|---|---|
| GetUpdateCommand() |
Obtém o objeto gerado SqlCommand automaticamente necessário para realizar atualizações na base de dados. |
| GetUpdateCommand(Boolean) |
Obtém o objeto gerado SqlCommand automaticamente necessário para realizar atualizações na base de dados. |
Observações
Uma aplicação pode usar o GetUpdateCommand método para fins informativos ou de resolução de problemas porque devolve o SqlCommand objeto a ser executado.
Também podes usar GetUpdateCommand como base para um comando modificado. Por exemplo, pode chamar GetUpdateCommand e modificar o CommandTimeout valor, e depois definir explicitamente isso no SqlDataAdapter.
Depois de a instrução Transact-SQL ser gerada pela primeira vez, a aplicação deve chamar explicitamente RefreshSchema 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 Transact-SQL são geradas pela primeira vez quando a aplicação chama Update ou GetUpdateCommand.
Para obter mais informações, consulte Gerando comandos com CommandBuilders.
GetUpdateCommand()
Obtém o objeto gerado SqlCommand automaticamente necessário para realizar atualizações na base de dados.
public:
System::Data::SqlClient::SqlCommand ^ GetUpdateCommand();
public System.Data.SqlClient.SqlCommand GetUpdateCommand();
member this.GetUpdateCommand : unit -> System.Data.SqlClient.SqlCommand
override this.GetUpdateCommand : unit -> System.Data.SqlClient.SqlCommand
Public Function GetUpdateCommand () As SqlCommand
Devoluções
O objeto gerado SqlCommand automaticamente que é 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 SqlCommand objeto a ser executado.
Também podes usar GetUpdateCommand como base para um comando modificado. Por exemplo, pode chamar GetUpdateCommand e modificar o CommandTimeout valor, e depois definir explicitamente isso no SqlDataAdapter.
Depois de a instrução Transact-SQL ser gerada pela primeira vez, a aplicação deve chamar explicitamente RefreshSchema 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 Transact-SQL são geradas pela primeira vez quando a aplicação chama Update ou GetUpdateCommand.
Para obter mais informações, consulte Gerando comandos com CommandBuilders.
Ver também
- Ligar e Recuperar Dados em ADO.NET
- Usando o Data Provider do .NET Framework para SQL Server
- Visão geral ADO.NET
Aplica-se a
GetUpdateCommand(Boolean)
Obtém o objeto gerado SqlCommand automaticamente necessário para realizar atualizações na base de dados.
public:
System::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);
public System.Data.SqlClient.SqlCommand GetUpdateCommand(bool useColumnsForParameterNames);
override this.GetUpdateCommand : bool -> System.Data.SqlClient.SqlCommand
Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand
Parâmetros
- useColumnsForParameterNames
- Boolean
Se true, gerar nomes de parâmetros que correspondam aos nomes das colunas, se possível. Se false, gerar @p1, @p2, e assim sucessivamente.
Devoluções
O objeto gerado SqlCommand 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 SqlCommand objeto a ser executado.
Também podes usar GetUpdateCommand como base para um comando modificado. Por exemplo, pode chamar GetUpdateCommand e modificar o CommandTimeout valor, e depois definir explicitamente isso no SqlDataAdapter.
Depois de a instrução Transact-SQL ser gerada pela primeira vez, a aplicação deve chamar explicitamente RefreshSchema 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 Transact-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 o OleDbCommandBuilder a gerar parâmetros com base nos nomes das colunas. Isto só tem sucesso se forem cumpridas as seguintes condições:
O ParameterNameMaxLength retorno da chamada de método GetSchema e encontrado na DataSourceInformation coleção 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 no ParameterNamePattern retorno da chamada ao método GetSchema e encontrado na DataSourceInformation expressão regular da coleção.
É especificado um ParameterMarkerFormat retorno da chamada ao método GetSchema e encontrado na DataSourceInformation coleção.
Para obter mais informações, consulte Gerando comandos com CommandBuilders.
Ver também
- Ligar e Recuperar Dados em ADO.NET
- Usando o Data Provider do .NET Framework para SQL Server
- Visão geral ADO.NET