SqlCommandBuilder.GetDeleteCommand 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.
Sobrecargas
GetDeleteCommand() |
Obtém o objeto SqlCommand gerado automaticamente necessário para executar exclusões no banco de dados. |
GetDeleteCommand(Boolean) |
Obtém o objeto SqlCommand gerado automaticamente necessário para executar exclusões no banco de dados. |
GetDeleteCommand()
Obtém o objeto SqlCommand gerado automaticamente necessário para executar exclusões no banco de dados.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetDeleteCommand();
public Microsoft.Data.SqlClient.SqlCommand GetDeleteCommand ();
member this.GetDeleteCommand : unit -> Microsoft.Data.SqlClient.SqlCommand
override this.GetDeleteCommand : unit -> Microsoft.Data.SqlClient.SqlCommand
Public Function GetDeleteCommand () As SqlCommand
Retornos
O objeto SqlCommand gerado automaticamente necessário para executar exclusões.
Comentários
Um aplicativo pode usar o GetDeleteCommand método para fins informativos ou de solução de problemas porque retorna o SqlCommand objeto a ser executado.
Você também pode usar GetDeleteCommand como base de um comando modificado. Por exemplo, você pode chamar GetDeleteCommand e modificar o CommandTimeout valor e definir explicitamente isso no SqlDataAdapter.
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 GetDeleteCommand 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 GetDeleteCommand.
Para obter mais informações, confira Gerar comandos com CommandBuilders.
Aplica-se a
GetDeleteCommand(Boolean)
Obtém o objeto SqlCommand gerado automaticamente necessário para executar exclusões no banco de dados.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetDeleteCommand(bool useColumnsForParameterNames);
public Microsoft.Data.SqlClient.SqlCommand GetDeleteCommand (bool useColumnsForParameterNames);
member this.GetDeleteCommand : bool -> Microsoft.Data.SqlClient.SqlCommand
override this.GetDeleteCommand : bool -> Microsoft.Data.SqlClient.SqlCommand
Public Function GetDeleteCommand (useColumnsForParameterNames As Boolean) As SqlCommand
Parâmetros
- useColumnsForParameterNames
- Boolean
Se true
, gere nomes de parâmetro correspondentes a nomes de coluna, se possível. Se false
, gerar @p1
, @p2
e assim por diante.
Retornos
O objeto SqlCommand gerado automaticamente necessário para executar exclusões.
Comentários
Um aplicativo pode usar o GetDeleteCommand método para fins informativos ou de solução de problemas porque retorna o SqlCommand objeto a ser executado.
Você também pode usar GetDeleteCommand como base de um comando modificado. Por exemplo, você pode chamar GetDeleteCommand e modificar o CommandTimeout valor e definir explicitamente isso no SqlDataAdapter.
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 GetDeleteCommand 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 GetDeleteCommand.
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 retornado da chamada do método GetSchema e encontrado na DataSourceInformation coleção 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 no ParameterNamePattern retornado da chamada do método GetSchema e encontrado na expressão regular da DataSourceInformation coleção.
Um ParameterMarkerFormat retornado da chamada do método GetSchema e encontrado na DataSourceInformation coleção é especificado.
Para obter mais informações, confira Gerar comandos com CommandBuilders.