SqlCommandBuilder.GetInsertCommand Método

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand();

public System.Data.SqlClient.SqlCommand GetInsertCommand();

member this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

override this.GetInsertCommand : unit -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand () As SqlCommand

Devoluções

O objeto gerado SqlCommand 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 SqlCommand 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 SqlDataAdapter.

Depois de a instrução Transact-SQL ser gerada pela primeira vez, a aplicação deve chamar explicitamente RefreshSchema 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 Transact-SQL são geradas pela primeira vez quando a aplicação chama Update ou GetInsertCommand.

Para obter mais informações, consulte Gerando comandos com CommandBuilders.

Ver também

• Ligar e Recuperar Dados em ADO.NET
• Usando o Data Provider do .NET Framework para SQL Server
• Visão geral ADO.NET

public:
 System::Data::SqlClient::SqlCommand ^ GetInsertCommand(bool useColumnsForParameterNames);

public System.Data.SqlClient.SqlCommand GetInsertCommand(bool useColumnsForParameterNames);

override this.GetInsertCommand : bool -> System.Data.SqlClient.SqlCommand

Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Parâmetros

Devoluções

O objeto gerado SqlCommand automaticamente que é 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 SqlCommand 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 SqlDataAdapter.

Depois de a instrução Transact-SQL ser gerada pela primeira vez, a aplicação deve chamar explicitamente RefreshSchema 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 Transact-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 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 retorno da chamada de método GetSchema e encontrado na DataSourceInformation coleção 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 no ParameterNamePattern retorno da chamada ao método GetSchema e encontrado na DataSourceInformation expressão regular da coleção.

• É especificado um ParameterMarkerFormat retorno da chamada ao método GetSchema e encontrado na DataSourceInformation coleção.

Para obter mais informações, consulte Gerando comandos com CommandBuilders.

Ver também

• Ligar e Recuperar Dados em ADO.NET
• Usando o Data Provider do .NET Framework para SQL Server
• Visão geral ADO.NET