DbCommandBuilder.GetInsertCommand Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos.
Sobrecargas
| GetInsertCommand() |
Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos. |
| 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. |
Comentarios
Una aplicación puede usar el GetInsertCommand método para fines informativos o de solución de problemas porque devuelve el texto del DbCommand 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 texto del comando y, a continuación, establecerlo explícitamente en .DbDataAdapter
Una vez generada la instrucción SQL por primera vez, la aplicación debe llamar RefreshSchema explícitamente si cambia la instrucción de cualquier manera. De lo contrario, GetInsertCommand seguirá usando información de la instrucción anterior, lo que podría no ser correcto. Las instrucciones 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. Si la versión sobrecargada de GetInsertCommand permite especificar este comportamiento, puede hacer DbCommandBuilder que genere parámetros basados en los nombres de columna en su lugar.
GetInsertCommand()
- Source:
- DBCommandBuilder.cs
- Source:
- DBCommandBuilder.cs
- Source:
- DBCommandBuilder.cs
Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos.
public:
System::Data::Common::DbCommand ^ GetInsertCommand();public System.Data.Common.DbCommand GetInsertCommand ();member this.GetInsertCommand : unit -> System.Data.Common.DbCommandPublic Function GetInsertCommand () As DbCommandDevoluciones
Objeto DbCommand generado 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 texto del DbCommand 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 texto del comando y, a continuación, establecerlo explícitamente en .DbDataAdapter
Una vez generada la instrucción SQL por primera vez, la aplicación debe llamar RefreshSchema explícitamente si cambia la instrucción de cualquier manera. De lo contrario, GetInsertCommand seguirá usando información de la instrucción anterior, lo que podría no ser correcto. Las instrucciones SQL se generan primero cuando la aplicación llama a Update o GetInsertCommand.
Consulte también
Se aplica a
GetInsertCommand(Boolean)
- Source:
- DBCommandBuilder.cs
- Source:
- DBCommandBuilder.cs
- Source:
- DBCommandBuilder.cs
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.
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
Si es true, hay que generar nombres de parámetro que coincidan con los nombres de columna, si es posible. Si es false, genera @p1, @p2, etc.
Devoluciones
Objeto DbCommand generado 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 texto del DbCommand 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 texto del comando y, a continuación, establecerlo explícitamente en .DbDataAdapter
Una vez generada la instrucción SQL por primera vez, la aplicación debe llamar RefreshSchema explícitamente si cambia la instrucción de cualquier manera. De lo contrario, GetInsertCommand seguirá usando información de la instrucción anterior, lo que podría no ser correcto. Las instrucciones 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 la DbCommandBuilder generación de parámetros en función de los nombres de columna en su lugar. La generación de los parámetros basados en nombres de columna solo se realiza correctamente si se cumplen las condiciones siguientes:
se ParameterNameMaxLength 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 la ParameterNamePattern expresión regular.
ParameterMarkerFormat Se especifica .
