SqlCommandBuilder.GetUpdateCommand Método

Definición

Espacio de nombres:

System.Data.SqlClient

Ensamblado:

System.Data.SqlClient.dll

Paquete:

System.Data.SqlClient v4.9.0

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

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.

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, lo que podría no ser correcto. 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.

GetUpdateCommand()

Source:

System.Data.SqlClient.notsupported.cs

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

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

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

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

Public Function GetUpdateCommand () As SqlCommand

Devoluciones

SqlCommand

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, lo que podría no ser correcto. 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.

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

GetUpdateCommand(Boolean)

Source:

System.Data.SqlClient.notsupported.cs

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

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

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

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

Public Function GetUpdateCommand (useColumnsForParameterNames As Boolean) As SqlCommand

Pará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

SqlCommand

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, lo que podría no ser correcto. 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 la OleDbCommandBuilder 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:

• Objeto ParameterNameMaxLength devuelto de la llamada al método GetSchema y encontrado 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 la ParameterNamePattern devolución de la llamada al método GetSchema y se encuentra en la expresión regular de la DataSourceInformation colección.

• Se ParameterMarkerFormat ha devuelto 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 objetos CommandBuilder.

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