DbCommandBuilder Clase

Definición

Espacio de nombres:

System.Data.Common

Ensamblado:

System.Data.Common.dll

Source:

DBCommandBuilder.cs

Genera automáticamente comandos de tabla única que se utilizan para conciliar los cambios realizados en un objeto DataSet con la base de datos asociada. Es una clase abstracta que sólo se puede heredar.

public ref class DbCommandBuilder abstract : System::ComponentModel::Component

public abstract class DbCommandBuilder : System.ComponentModel.Component

type DbCommandBuilder = class
    inherit Component

Public MustInherit Class DbCommandBuilder
Inherits Component

Herencia

Object

MarshalByRefObject

Component

DbCommandBuilder

Derivado

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

System.Data.SqlClient.SqlCommandBuilder

Comentarios

La DbCommandBuilder clase se proporciona para la comodidad de los escritores de proveedores que crean sus propios generadores de comandos. Al heredar de esta clase, los desarrolladores pueden implementar un comportamiento específico del proveedor en su propio código.

DbDataAdapter no genera automáticamente las instrucciones SQL necesarias para conciliar los cambios realizados en un DataSet con el origen de datos asociado. Sin embargo, puede crear un DbCommandBuilder objeto para generar automáticamente instrucciones SQL para actualizaciones de tabla única si establece la SelectCommand propiedad de DbDataAdapter. A continuación, las instrucciones SQL adicionales que no establezca se generan mediante .DbCommandBuilder

Se DbCommandBuilder registra como un agente de escucha para RowUpdating los eventos siempre que se establece la DataAdapter propiedad . Solo se puede asociar uno DbDataAdapter o DbCommandBuilder un objeto entre sí a la vez.

Para generar instrucciones INSERT, UPDATE o DELETE, usa DbCommandBuilder la SelectCommand propiedad para recuperar automáticamente un conjunto necesario de metadatos. Si cambia una SelectCommand vez recuperados los metadatos (por ejemplo, después de la primera actualización), debe llamar al RefreshSchema método para actualizar los metadatos.

SelectCommand también debe devolver como mínimo una clave principal o una columna única. Si no existe ninguna, se genera una InvalidOperationException excepción y no se generan los comandos.

DbCommandBuilder también usa las Connectionpropiedades , CommandTimeouty Transaction a las que hace referencia .SelectCommand El usuario debe llamar a RefreshSchema si se modifica alguna de estas propiedades o si se reemplaza el SelectCommand propio . De lo contrario, las InsertCommandpropiedades , UpdateCommandy DeleteCommand conservan sus valores anteriores.

Si llama a Dispose, el DbCommandBuilder elemento se desasocia de DbDataAdaptery los comandos generados ya no se usan.

Constructores

DbCommandBuilder()

Inicializa una nueva instancia de una clase que hereda de la clase DbCommandBuilder.

Propiedades

CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
CatalogLocation	Obtiene o establece el objeto CatalogLocation para una instancia de la clase DbCommandBuilder.
CatalogSeparator	Obtiene o establece una cadena que se usa como separador de catálogo para una instancia de la clase DbCommandBuilder.
ConflictOption	Especifica qué ConflictOption va a utilizar DbCommandBuilder.
Container	Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component)
DataAdapter	Obtiene o establece un objeto DbDataAdapter para el que se generan automáticamente instrucciones de Transact-SQL.
DesignMode	Obtiene un valor que indica si Component está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos asociados a Component. (Heredado de Component)
QuotePrefix	Obtiene o establece el carácter o los caracteres iniciales que se van a utilizar al especificar objetos de base de datos (por ejemplo, tablas o columnas), cuyos nombres contengan caracteres como espacios o símbolos (token) reservados.
QuoteSuffix	Obtiene o establece el carácter o los caracteres finales que se van a usar al especificar los objetos de base de datos (por ejemplo, tablas o columnas) cuyos nombres contienen caracteres como espacios o tokens reservados.
SchemaSeparator	Obtiene o establece el carácter que se va a utilizar para el separador entre el identificador de esquema y cualquier otro identificador.
SetAllValues	Especifica si en una instrucción de actualización se incluyen todos los valores de columna o sólo los que han cambiado.
Site	Obtiene o establece ISite de Component. (Heredado de Component)

Métodos

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Permite que la implementación del proveedor de la clase DbCommandBuilder controle propiedades de parámetro adicionales.
CreateObjRef(Type)	Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Heredado de MarshalByRefObject)
Dispose()	Libera todos los recursos que usa Component. (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados que usa DbCommandBuilder y, de forma opcional, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetDeleteCommand()	Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar eliminaciones en el origen de datos.
GetDeleteCommand(Boolean)	Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar eliminaciones en el origen de datos, utilizando opcionalmente columnas para los nombres de parámetro.
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
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.
GetLifetimeService()	Obsoletos. Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
GetParameterName(Int32)	Devuelve el nombre del parámetro especificado en el formato de @p#. Utilícelo al crear un generador de comandos personalizado.
GetParameterName(String)	Devuelve el nombre completo del parámetro, a partir de su nombre parcial.
GetParameterPlaceholder(Int32)	Devuelve el marcador de posición para el parámetro en la instrucción SQL asociada.
GetSchemaTable(DbCommand)	Devuelve la tabla de esquema para DbCommandBuilder.
GetService(Type)	Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetUpdateCommand()	Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar actualizaciones en el origen de datos.
GetUpdateCommand(Boolean)	Obtiene el objeto DbCommand generado automáticamente que es necesario para realizar actualizaciones en el origen de datos, utilizando opcionalmente columnas para los nombres de parámetro.
InitializeCommand(DbCommand)	Restablece las propiedades CommandTimeout, Transaction, CommandType y UpdateRowSource en el objeto DbCommand.
InitializeLifetimeService()	Obsoletos. Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Heredado de MarshalByRefObject)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto MarshalByRefObject actual. (Heredado de MarshalByRefObject)
QuoteIdentifier(String)	Dado un identificador sin comillas en el caso de un catálogo correcto, devuelve el formato correcto entrecomillado de ese identificador, incluyendo una secuencia de escape adecuada para las comillas incrustadas en el identificador.
RefreshSchema()	Borra los comandos asociados a este DbCommandBuilder.
RowUpdatingHandler(RowUpdatingEventArgs)	Agrega un controlador de eventos para el evento RowUpdating.
SetRowUpdatingHandler(DbDataAdapter)	Registra el objeto DbCommandBuilder para controlar el evento RowUpdating de un objeto DbDataAdapter.
ToString()	Devuelve una String que contiene el nombre del Component, si existe. Este método no se debe invalidar. (Heredado de Component)
UnquoteIdentifier(String)	Dado un identificador entre comillas, devuelve el formato correcto sin comillas de ese identificador, incluyendo una secuencia sin escape adecuada para las comillas incrustadas en el identificador.

Eventos

Disposed

Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component)

Consulte también

• Generación de comandos con objetos CommandBuilder
• Información general de ADO.NET