SqlCommandBuilder.GetUpdateCommand 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í.
Sobrecargas
| GetUpdateCommand() |
Obtiene el objeto SqlCommand generado automáticamente que es necesario para realizar actualizaciones en la base de datos. |
| GetUpdateCommand(Boolean) |
Obtiene el objeto SqlCommand generado automáticamente que es necesario para realizar actualizaciones en la base de datos. |
GetUpdateCommand()
Obtiene el objeto SqlCommand generado automáticamente que es necesario para realizar actualizaciones en la base de datos.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand();public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand ();member this.GetUpdateCommand : unit -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetUpdateCommand : unit -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetUpdateCommand () As SqlCommandDevoluciones
Objeto SqlCommand generado automáticamente que es necesario para realizar actualizaciones.
Comentarios
Una aplicación puede usar el GetUpdateCommand método para fines informativos o de solución de problemas, ya que devuelve el SqlCommand objeto que se va a ejecutar.
También puede usar GetUpdateCommand como base de un comando modificado. Por ejemplo, puede llamar GetUpdateCommand 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 RefreshSchema explícitamente si cambia la instrucción de cualquier manera. De lo contrario, GetUpdateCommand seguirá usando información de la instrucción anterior, que podría no ser correcta. Las instrucciones Transact-SQL se generan por primera vez cuando la aplicación llama a Update o GetUpdateCommand.
Para obtener más información, vea Generar comandos con objetos CommandBuilder.
Se aplica a
GetUpdateCommand(Boolean)
Obtiene el objeto SqlCommand generado automáticamente que es necesario para realizar actualizaciones en la base de datos.
public:
Microsoft::Data::SqlClient::SqlCommand ^ GetUpdateCommand(bool useColumnsForParameterNames);public Microsoft.Data.SqlClient.SqlCommand GetUpdateCommand (bool useColumnsForParameterNames);member this.GetUpdateCommand : bool -> Microsoft.Data.SqlClient.SqlCommandoverride this.GetUpdateCommand : bool -> Microsoft.Data.SqlClient.SqlCommandPublic Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommandPará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 SqlCommand generado automáticamente que es necesario para realizar actualizaciones.
Comentarios
Una aplicación puede usar el GetUpdateCommand método para fines informativos o de solución de problemas, ya que devuelve el SqlCommand objeto que se va a ejecutar.
También puede usar GetUpdateCommand como base de un comando modificado. Por ejemplo, puede llamar GetUpdateCommand 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 RefreshSchema explícitamente si cambia la instrucción de cualquier manera. De lo contrario, GetUpdateCommand seguirá usando información de la instrucción anterior, que podría no ser correcta. Las instrucciones Transact-SQL se generan por primera vez cuando la aplicación llama a Update o GetUpdateCommand.
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 le permite forzar que OleDbCommandBuilder genere parámetros basados en los nombres de columna en su lugar. Esto solo se realiza correctamente si se cumplen las condiciones siguientes:
Se ParameterNameMaxLength ha especificado la devolución de la llamada al método GetSchema y que se encuentra en la DataSourceInformation colección 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 especifica un ParameterMarkerFormat valor devuelto por la llamada al método GetSchema y que se encuentra en la DataSourceInformation colección.
Para obtener más información, vea Generar comandos con objetos CommandBuilder.