DbCommandBuilder.GetInsertCommand 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.
Obtém o objeto gerado DbCommand automaticamente necessário para executar inserções na fonte de dados.
Sobrecargas
| Nome | Description |
|---|---|
| GetInsertCommand() |
Obtém o objeto gerado DbCommand automaticamente necessário para executar inserções na fonte de dados. |
| GetInsertCommand(Boolean) |
Obtém o objeto gerado DbCommand automaticamente necessário para executar inserções na fonte de dados, opcionalmente usando colunas para nomes de parâmetro. |
Comentários
Um aplicativo pode usar o GetInsertCommand método para fins informativos ou de solução de problemas porque retorna o texto do objeto a DbCommand 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 DbDataAdapterexplicitamente no .
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, ainda GetInsertCommand 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 GetInsertCommand sobrecarregada permitir que você especifique esse comportamento, poderá fazer com que os DbCommandBuilder parâmetros sejam gerados com base nos nomes das colunas.
GetInsertCommand()
Obtém o objeto gerado DbCommand automaticamente necessário para executar 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.DbCommandPublic Function GetInsertCommand () As DbCommandRetornos
O objeto gerado DbCommand 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 objeto a DbCommand 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, ainda GetInsertCommand 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)
Obtém o objeto gerado DbCommand automaticamente necessário para executar inserções na fonte de dados, opcionalmente usando colunas para nomes de parâmetro.
public:
System::Data::Common::DbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);public System.Data.Common.DbCommand GetInsertCommand(bool useColumnsForParameterNames);member this.GetInsertCommand : bool -> System.Data.Common.DbCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommandParâmetros
- useColumnsForParameterNames
- Boolean
Se true, gerar nomes de parâmetro correspondentes a nomes de coluna, se possível. Se false, gerar @p1, @p2e assim por diante.
Retornos
O objeto gerado DbCommand 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 objeto a DbCommand 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, ainda GetInsertCommand 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 forçar a DbCommandBuilder geração de 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:
O ParameterNameMaxLength 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 na ParameterNamePattern expressão regular.
Um ParameterMarkerFormat é especificado.