DbCommandBuilder.GetInsertCommand 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 DbCommand automaticamente necessário para realizar inserções na fonte de dados.
Sobrecargas
| Name | Description |
|---|---|
| GetInsertCommand() |
Obtém o objeto gerado DbCommand automaticamente necessário para realizar inserções na fonte de dados. |
| GetInsertCommand(Boolean) |
Obtém o objeto gerado DbCommand automaticamente necessário para realizar inserções na fonte de dados, optativamente usando colunas para nomes de parâmetros. |
Observações
Uma aplicação pode usar o GetInsertCommand método para fins informativos ou de resolução de problemas porque devolve o texto do DbCommand objeto a ser executado.
Também podes usar GetInsertCommand como base para um comando modificado. Por exemplo, pode chamar GetInsertCommand e modificar o texto do comando, e depois definir explicitamente isso no DbDataAdapter.
Depois de a instrução SQL ser gerada pela primeira vez, a aplicação deve chamar RefreshSchema explicitamente se alterar a instrução de alguma forma. Caso contrário, continuarão GetInsertCommand a usar informações da declaração anterior, que podem não estar corretas. As instruções SQL são geradas pela primeira vez quando a aplicação chama Update ou GetInsertCommand.
O comportamento padrão, ao gerar nomes de parâmetros, é usar @p1, @p2, e assim sucessivamente para os vários parâmetros. Se a versão sobrecarregada de GetInsertCommand permitir especificar este comportamento, pode fazer com que o DbCommandBuilder gere parâmetros com base nos nomes das colunas em vez disso.
GetInsertCommand()
Obtém o objeto gerado DbCommand 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.DbCommandPublic Function GetInsertCommand () As DbCommandDevoluções
O objeto gerado DbCommand automaticamente necessário para realizar inserções.
Observações
Uma aplicação pode usar o GetInsertCommand método para fins informativos ou de resolução de problemas porque devolve o texto do DbCommand objeto a ser executado.
Também podes usar GetInsertCommand como base para um comando modificado. Por exemplo, pode chamar GetInsertCommand e modificar o texto do comando, e depois definir explicitamente isso no DbDataAdapter.
Depois de a instrução SQL ser gerada pela primeira vez, a aplicação deve chamar RefreshSchema explicitamente se alterar a instrução de alguma forma. Caso contrário, continuarão GetInsertCommand a usar informações da declaração anterior, que podem não estar corretas. As instruções SQL são geradas pela primeira vez quando a aplicação chama Update ou GetInsertCommand.
Ver também
Aplica-se a
GetInsertCommand(Boolean)
Obtém o objeto gerado DbCommand automaticamente necessário para realizar inserções na fonte de dados, optativamente 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.DbCommandPublic Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommandParâmetros
- useColumnsForParameterNames
- Boolean
Se true, gerar nomes de parâmetros que correspondem aos nomes das colunas, se possível. Se false, gerar @p1, @p2, e assim sucessivamente.
Devoluções
O objeto gerado DbCommand automaticamente necessário para realizar inserções.
Observações
Uma aplicação pode usar o GetInsertCommand método para fins informativos ou de resolução de problemas porque devolve o texto do DbCommand objeto a ser executado.
Também podes usar GetInsertCommand como base para um comando modificado. Por exemplo, pode chamar GetInsertCommand e modificar o texto do comando, e depois definir explicitamente isso no DbDataAdapter.
Depois de a instrução SQL ser gerada pela primeira vez, a aplicação deve chamar RefreshSchema explicitamente se alterar a instrução de alguma forma. Caso contrário, continuarão GetInsertCommand a usar informações da declaração anterior, que podem não estar corretas. As instruções SQL são geradas pela primeira vez quando a aplicação chama Update ou GetInsertCommand.
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 DbCommandBuilder o a gerar parâmetros com base nos nomes das colunas. A geração dos parâmetros com base nos nomes das colunas só tem sucesso se forem cumpridas as seguintes condições:
O ParameterNameMaxLength 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 na ParameterNamePattern expressão regular.
A ParameterMarkerFormat é especificado.