DbCommandBuilder.GetInsertCommand Método

Definición

Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos.Gets the automatically generated DbCommand object required to perform insertions at the data source.

Sobrecargas

GetInsertCommand()

Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos.Gets the automatically generated DbCommand object required to perform insertions at the data source.

GetInsertCommand(Boolean)

Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos, utilizando opcionalmente columnas para los nombres de parámetro.Gets the automatically generated DbCommand object required to perform insertions at the data source, optionally using columns for parameter names.

Comentarios

Una aplicación puede utilizar el método GetInsertCommand para fines informativos o de solución de problemas, ya que devuelve el texto del DbCommand objeto que se va a ejecutar.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the DbCommand object to be executed.

También puede usar GetInsertCommand como base de un comando modificado.You can also use GetInsertCommand as the basis of a modified command. Por ejemplo, puede llamar a GetInsertCommand y modificar el texto del comando y, a continuación, establecerlo explícitamente en el DbDataAdapter.For example, you might call GetInsertCommand and modify command text, and then explicitly set that on the DbDataAdapter.

Una vez que se genera la instrucción SQL por primera vez, la aplicación debe llamar explícitamente a RefreshSchema si cambia la instrucción de cualquier manera.After the SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. De lo contrario, el GetInsertCommand seguirá usando información de la instrucción anterior, que podría no ser correcta.Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. Las instrucciones SQL se generan primero cuando la aplicación llama a Update o GetInsertCommand.The SQL statements are first generated either when the application calls Update or GetInsertCommand.

El comportamiento predeterminado, al generar nombres de parámetro, es usar @p1, @p2, etc. para los distintos parámetros.The default behavior, when generating parameter names, is to use @p1, @p2, and so on for the various parameters. Si la versión sobrecargada de GetInsertCommand le permite especificar este comportamiento, puede hacer que el DbCommandBuilder genere parámetros basados en los nombres de columna en su lugar.If the overloaded version of GetInsertCommand allows you to specify this behavior, you can cause the DbCommandBuilder to generate parameters based on the column names instead.

GetInsertCommand()

Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos.Gets the automatically generated DbCommand object required to perform insertions at the data source.

public:
 System::Data::Common::DbCommand ^ GetInsertCommand();
public System.Data.Common.DbCommand GetInsertCommand ();
member this.GetInsertCommand : unit -> System.Data.Common.DbCommand
Public Function GetInsertCommand () As DbCommand

Devoluciones

Objeto DbCommand generado automáticamente que es necesario para realizar inserciones.The automatically generated DbCommand object required to perform insertions.

Comentarios

Una aplicación puede utilizar el método GetInsertCommand para fines informativos o de solución de problemas, ya que devuelve el texto del DbCommand objeto que se va a ejecutar.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the DbCommand object to be executed.

También puede usar GetInsertCommand como base de un comando modificado.You can also use GetInsertCommand as the basis of a modified command. Por ejemplo, podría llamar a GetInsertCommand y modificar el texto del comando y, a continuación, establecerlo explícitamente en el DbDataAdapter.For example, you might call GetInsertCommand and modify the command text, and then explicitly set that on the DbDataAdapter.

Una vez que se genera la instrucción SQL por primera vez, la aplicación debe llamar explícitamente a RefreshSchema si cambia la instrucción de cualquier manera.After the SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. De lo contrario, el GetInsertCommand seguirá usando información de la instrucción anterior, que podría no ser correcta.Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. Las instrucciones SQL se generan primero cuando la aplicación llama a Update o GetInsertCommand.The SQL statements are first generated either when the application calls Update or GetInsertCommand.

Consulte también:

GetInsertCommand(Boolean)

Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos, utilizando opcionalmente columnas para los nombres de parámetro.Gets the automatically generated DbCommand object required to perform insertions at the data source, optionally using columns for parameter names.

public:
 System::Data::Common::DbCommand ^ GetInsertCommand(bool useColumnsForParameterNames);
public System.Data.Common.DbCommand GetInsertCommand (bool useColumnsForParameterNames);
member this.GetInsertCommand : bool -> System.Data.Common.DbCommand
Public Function GetInsertCommand (useColumnsForParameterNames As Boolean) As DbCommand

Parámetros

useColumnsForParameterNames
Boolean

Si es true, hay que generar nombres de parámetro que coincidan con los nombres de columna, si es posible.If true, generate parameter names matching column names, if possible. Si es false, genera @p1, @p2, etc.If false, generate @p1, @p2, and so on.

Devoluciones

Objeto DbCommand generado automáticamente que es necesario para realizar inserciones.The automatically generated DbCommand object required to perform insertions.

Comentarios

Una aplicación puede utilizar el método GetInsertCommand para fines informativos o de solución de problemas, ya que devuelve el texto del DbCommand objeto que se va a ejecutar.An application can use the GetInsertCommand method for informational or troubleshooting purposes because it returns the text of the DbCommand object to be executed.

También puede usar GetInsertCommand como base de un comando modificado.You can also use GetInsertCommand as the basis of a modified command. Por ejemplo, podría llamar a GetInsertCommand y modificar el texto del comando y, a continuación, establecerlo explícitamente en el DbDataAdapter.For example, you might call GetInsertCommand and modify the command text, and then explicitly set that on the DbDataAdapter.

Una vez que se genera la instrucción SQL por primera vez, la aplicación debe llamar explícitamente a RefreshSchema si cambia la instrucción de cualquier manera.After the SQL statement is first generated, the application must explicitly call RefreshSchema if it changes the statement in any way. De lo contrario, el GetInsertCommand seguirá usando información de la instrucción anterior, que podría no ser correcta.Otherwise, the GetInsertCommand will still be using information from the previous statement, which might not be correct. Las instrucciones SQL se generan primero cuando la aplicación llama a Update o GetInsertCommand.The SQL statements are first generated either when the application calls Update or GetInsertCommand.

El comportamiento predeterminado, al generar nombres de parámetro, es usar @p1, @p2, etc. para los distintos parámetros.The default behavior, when generating parameter names, is to use @p1, @p2, and so on for the various parameters. Pasar true del parámetro useColumnsForParameterNames permite forzar a la DbCommandBuilder a generar parámetros basados en los nombres de columna en su lugar.Passing true for the useColumnsForParameterNames parameter allows you to force the DbCommandBuilder to generate parameters based on the column names instead. La generación de los parámetros en función de los nombres de columna se realiza correctamente solo si se cumplen las condiciones siguientes:Generation of the parameters based on column names succeeds only if the following conditions are met:

Consulte también:

Se aplica a