SqlCommandBuilder.GetDeleteCommand Método

Definição

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Pacote:

Microsoft.Data.SqlClient v5.2.0

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 ();

override this.GetDeleteCommand : unit -> Microsoft.Data.SqlClient.SqlCommand

Public Function GetDeleteCommand () As SqlCommand

Retornos

SqlCommand

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.

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);

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

SqlCommand

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, @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 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.