OleDbCommandBuilder.GetInsertCommand Método

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand();

public System.Data.OleDb.OleDbCommand GetInsertCommand();

member this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommand

override this.GetInsertCommand : unit -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand () As OleDbCommand

Devoluções

O objeto gerado OleDbCommand 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 OleDbCommand objeto a ser executado.

Também podes usar GetInsertCommand como base para um comando modificado. Por exemplo, pode chamar GetInsertCommand e modificar o CommandTimeout valor, e depois definir explicitamente isso no OleDbDataAdapter.

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, o que pode não estar correto. As instruções SQL são geradas pela primeira vez quando a aplicação chama ou UpdateCommand ou GetInsertCommand.

Ver também

• Gerando comandos com CommandBuilders

public:
 System::Data::OleDb::OleDbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.OleDb.OleDbCommand GetInsertCommand(bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.OleDb.OleDbCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As OleDbCommand

Parâmetros

Devoluções

O objeto gerado OleDbCommand 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 OleDbCommand objeto a ser executado.

Também podes usar GetInsertCommand como base para um comando modificado. Por exemplo, pode chamar GetInsertCommand e modificar o CommandTimeout valor, e depois definir explicitamente isso no OleDbDataAdapter.

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, o que pode não estar correto. As instruções SQL são geradas pela primeira vez quando a aplicação chama ou UpdateCommand 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 o OleDbCommandBuilder a gerar parâmetros com base nos nomes das colunas. Isto 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.

Ver também

• Gerando comandos com CommandBuilders