Partilhar via


DbCommandBuilder.GetInsertCommand Método

Definição

Obtém o objeto DbCommand gerado automaticamente necessário para realizar inserções na fonte de dados.

Sobrecargas

GetInsertCommand()

Obtém o objeto DbCommand gerado automaticamente necessário para realizar inserções na fonte de dados.

GetInsertCommand(Boolean)

Obtém o objeto DbCommand gerado automaticamente necessário para realizar inserções na fonte de dados, opcionalmente usando colunas para nomes de parâmetros.

Comentários

Um aplicativo pode usar o GetInsertCommand método para fins informativos ou de solução de problemas porque retorna o texto do DbCommand objeto a ser executado.

Você também pode usar GetInsertCommand como base de um comando modificado. Por exemplo, você pode chamar GetInsertCommand e modificar o texto do comando e, em seguida, defini-lo explicitamente no DbDataAdapter.

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 GetInsertCommand 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 GetInsertCommand.

O comportamento padrão, ao gerar nomes de parâmetro, é usar @p1, @p2e assim por diante para os vários parâmetros. Se a versão sobrecarregada de GetInsertCommand permitir que você especifique esse comportamento, poderá fazer com que o DbCommandBuilder gere parâmetros com base nos nomes das colunas.

GetInsertCommand()

Origem:
DBCommandBuilder.cs
Origem:
DBCommandBuilder.cs
Origem:
DBCommandBuilder.cs

Obtém o objeto DbCommand gerado automaticamente necessário para realizar inserções na fonte de dados.

public:
 System::Data::Common::DbCommand ^ GetInsertCommand();
public System.Data.Common.DbCommand GetInsertCommand ();
member this.GetInsertCommand : unit -> System.Data.Common.DbCommand
Public Function GetInsertCommand () As DbCommand

Retornos

O objeto DbCommand gerado automaticamente necessário para executar inserções.

Comentários

Um aplicativo pode usar o GetInsertCommand método para fins informativos ou de solução de problemas porque retorna o texto do DbCommand objeto a ser executado.

Você também pode usar GetInsertCommand como base de um comando modificado. Por exemplo, você pode chamar GetInsertCommand e modificar o texto do comando e, em seguida, defini-lo explicitamente no DbDataAdapter.

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 GetInsertCommand 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 GetInsertCommand.

Confira também

Aplica-se a

GetInsertCommand(Boolean)

Origem:
DBCommandBuilder.cs
Origem:
DBCommandBuilder.cs
Origem:
DBCommandBuilder.cs

Obtém o objeto DbCommand gerado automaticamente necessário para realizar inserções na fonte de dados, opcionalmente usando colunas para nomes de parâmetros.

public:
 System::Data::Common::DbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);
public System.Data.Common.DbCommand GetInsertCommand (bool useColumnsForParameterNames);
member this.GetInsertCommand : bool -> System.Data.Common.DbCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommand

Parâmetros

useColumnsForParameterNames
Boolean

Se true, gerar nomes de parâmetro correspondentes a nomes de coluna, se possível. Se false, gerar @p1, @p2 e assim por diante.

Retornos

O objeto DbCommand gerado automaticamente necessário para executar inserções.

Comentários

Um aplicativo pode usar o GetInsertCommand método para fins informativos ou de solução de problemas porque retorna o texto do DbCommand objeto a ser executado.

Você também pode usar GetInsertCommand como base de um comando modificado. Por exemplo, você pode chamar GetInsertCommand e modificar o texto do comando e, em seguida, defini-lo explicitamente no DbDataAdapter.

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 GetInsertCommand 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 GetInsertCommand.

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 DbCommandBuilder a gerar parâmetros com base nos nomes das colunas. A geração dos parâmetros com base em nomes de coluna só terá êxito se as seguintes condições forem atendidas:

Confira também

Aplica-se a