Exportar (0) Imprimir
Expandir todo

SqlCommandBuilder.GetInsertCommand (Método) (Boolean)

Nota: este método es nuevo en la versión 2.0 de .NET Framework.

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

Espacio de nombres: System.Data.SqlClient
Ensamblado: System.Data (en system.data.dll)

public SqlCommand GetInsertCommand (
	bool useColumnsForParameterNames
)
public SqlCommand GetInsertCommand (
	boolean useColumnsForParameterNames
)
public function GetInsertCommand (
	useColumnsForParameterNames : boolean
) : SqlCommand

Parámetros

useColumnsForParameterNames

Si es true, hay que generar nombres de parámetro que coincidan con los nombres de columna, si es posible. Si es false, se debe generar @p1, @p2, etc.

Valor devuelto

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

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

Además, se puede utilizar el método GetInsertCommand como base de un comando modificado. Por ejemplo, se puede llamar a GetInsertCommand y modificar el valor de CommandTimeout y, a continuación, establecerlo de manera explícita en SqlDataAdapter.

Después de generar una instrucción de Transact-SQL por primera vez, la aplicación debe llamar explícitamente a RefreshSchema si se cambia la instrucción de alguna forma. De lo contrario, GetInsertCommand seguirá utilizando la información de la instrucción anterior, que puede no ser correcta. Las instrucciones de Transact-SQL se generan, en primer lugar, cuando la aplicación llama a Update o a GetInsertCommand.

Al generar nombres de parámetro, el comportamiento predeterminado es utilizar @p1, @p2, etc. para los distintos parámetros. En cambio, pasar true en el parámetro useColumnsForParameterNames permite forzar que OleDbCommandBuilder genere parámetros basándose en los nombres de columna. Sólo se realiza correctamente si se cumplen las siguientes condiciones:

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

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

  • Se ha especificado un campo ParameterMarkerFormat que devuelve la llamada al método GetSchema y que se encuentra en la colección de DataSourceInformation.

Para obtener más información, vea Generar comandos automáticamente.

Windows 98, Windows 2000 SP4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0

Adiciones de comunidad

AGREGAR
Mostrar:
© 2014 Microsoft