SqlCommandBuilder.GetInsertCommand Método

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.dll

Obtiene el objeto generado SqlCommand automáticamente que es necesario para realizar inserciones en la base de datos.

Sobrecargas

Nombre	Description
GetInsertCommand()	Obtiene el objeto generado SqlCommand automáticamente necesario para realizar inserciones en la base de datos.
GetInsertCommand(Boolean)	Obtiene el objeto generado SqlCommand automáticamente que es necesario para realizar inserciones en la base de datos.

Comentarios

Una aplicación puede usar el GetInsertCommand método para fines informativos o de solución de problemas porque devuelve el SqlCommand objeto que se va a ejecutar.

También puede usar GetInsertCommand como base de un comando modificado. Por ejemplo, puede llamar GetInsertCommand a y modificar el CommandTimeout valor y, a continuación, establecerlo explícitamente en .SqlDataAdapter

Una vez generada la instrucción Transact-SQL por primera vez, la aplicación debe llamar explícitamente a RefreshSchema si cambia la instrucción de alguna manera. De lo contrario, GetInsertCommand seguirá usando información de la instrucción anterior, lo que podría no ser correcto. Las instrucciones Transact-SQL se generan primero cuando la aplicación llama a Update o GetInsertCommand.

Para obtener más información, vea Generar comandos con CommandBuilders.

GetInsertCommand()

Obtiene el objeto generado SqlCommand automáticamente necesario para realizar inserciones en la base de datos.

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

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

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

Public Function GetInsertCommand () As SqlCommand

Devoluciones

SqlCommand

Objeto generado SqlCommand automáticamente necesario para realizar inserciones.

Comentarios

Una aplicación puede usar el GetInsertCommand método para fines informativos o de solución de problemas porque devuelve el SqlCommand objeto que se va a ejecutar.

También puede usar GetInsertCommand como base de un comando modificado. Por ejemplo, puede llamar GetInsertCommand a y modificar el CommandTimeout valor y, a continuación, establecerlo explícitamente en .SqlDataAdapter

Una vez generada la instrucción Transact-SQL por primera vez, la aplicación debe llamar explícitamente a RefreshSchema si cambia la instrucción de alguna manera. De lo contrario, GetInsertCommand seguirá usando información de la instrucción anterior, lo que podría no ser correcto. Las instrucciones Transact-SQL se generan primero cuando la aplicación llama a Update o GetInsertCommand.

Para obtener más información, vea Generar comandos con CommandBuilders.

Consulte también

• Conexión y recuperación de datos en ADO.NET
• Uso del proveedor de datos de .NET Framework para SQL Server
• Información general de ADO.NET

GetInsertCommand(Boolean)

Obtiene el objeto generado SqlCommand automáticamente que es necesario para realizar inserciones en la base de datos.

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

useColumnsForParameterNames

Boolean

Si truees , genere nombres de parámetro que coincidan con nombres de columna si es posible. Si falsees , genere @p1, @p2, etc.

Devoluciones

SqlCommand

Objeto generado SqlCommand automáticamente que es necesario para realizar inserciones.

Comentarios

Una aplicación puede usar el GetInsertCommand método para fines informativos o de solución de problemas porque devuelve el SqlCommand objeto que se va a ejecutar.

También puede usar GetInsertCommand como base de un comando modificado. Por ejemplo, puede llamar GetInsertCommand a y modificar el CommandTimeout valor y, a continuación, establecerlo explícitamente en .SqlDataAdapter

Una vez generada la instrucción Transact-SQL por primera vez, la aplicación debe llamar explícitamente a RefreshSchema si cambia la instrucción de alguna manera. De lo contrario, GetInsertCommand seguirá usando información de la instrucción anterior, lo que podría no ser correcto. Las instrucciones Transact-SQL se generan primero cuando la aplicación llama a Update o GetInsertCommand.

El comportamiento predeterminado, al generar nombres de parámetro, es usar @p1, @p2, etc. para los distintos parámetros. Pasar true para el useColumnsForParameterNames parámetro permite forzar OleDbCommandBuilder la generación de parámetros en función de los nombres de columna en su lugar. Esto solo se realiza correctamente si se cumplen las condiciones siguientes:

• El ParameterNameMaxLength devuelto desde la llamada al método GetSchema y que se encuentra en la DataSourceInformation colección se ha especificado y su longitud es igual o mayor que el nombre del parámetro generado.

• El nombre del parámetro generado cumple los criterios especificados en el ParameterNamePattern devuelto desde la llamada al método GetSchema y se encuentra en la expresión regular de la DataSourceInformation colección.

• Se ParameterMarkerFormat devuelve desde la llamada al método GetSchema y se encuentra en la DataSourceInformation colección.

Para obtener más información, vea Generar comandos con CommandBuilders.

Consulte también

• Conexión y recuperación de datos en ADO.NET
• Uso del proveedor de datos de .NET Framework para SQL Server
• Información general de ADO.NET