DbCommandBuilder Clase

Definición

Espacio de nombres:

System.Data.Common

Ensamblados:

netstandard.dll, System.Data.Common.dll

Source:

DBCommandBuilder.cs

Genera automáticamente comandos de tabla única usados para conciliar los cambios realizados en una DataSet con la base de datos asociada. Se trata de una clase abstracta que solo 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

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.

No DbDataAdapter genera automáticamente las instrucciones SQL necesarias para conciliar los cambios realizados en un DataSet objeto 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 agente de escucha para RowUpdating eventos cada vez que se establece la DataAdapter propiedad . Solo 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 SelectCommand después de recuperar 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 propiedades , CommandTimeouty Transaction a las Connectionque hace referencia .SelectCommand El usuario debe llamar RefreshSchema a 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, se DbCommandBuilder desasocia de DbDataAdaptery los comandos generados ya no se usan.

Constructores

Nombre	Description
DbCommandBuilder()	Inicializa una nueva instancia de una clase que hereda de la DbCommandBuilder clase .

Propiedades

Nombre	Description
CanRaiseEvents	Obtiene un valor que indica si el componente puede generar un evento. (Heredado de Component)
CatalogLocation	Obtiene o establece el para CatalogLocation una instancia de la DbCommandBuilder clase .
CatalogSeparator	Obtiene o establece una cadena usada como separador de catálogo para una instancia de la DbCommandBuilder clase .
ConflictOption	Especifica cuál ConflictOption se va a usar en .DbCommandBuilder
Container	Obtiene el IContainer objeto que contiene el Componentobjeto . (Heredado de Component)
DataAdapter	Obtiene o establece un DbDataAdapter objeto para el que se generan automáticamente Transact-SQL instrucciones.
DesignMode	Obtiene un valor que indica si Component el objeto está actualmente en modo de diseño. (Heredado de Component)
Events	Obtiene la lista de controladores de eventos que están asociados a este Componentobjeto . (Heredado de Component)
QuotePrefix	Obtiene o establece el carácter inicial o los caracteres que se van a usar al especificar objetos de base de datos (por ejemplo, tablas o columnas) cuyos nombres contienen caracteres como espacios o tokens reservados.
QuoteSuffix	Obtiene o establece el carácter o los caracteres finales que se van a usar al especificar 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 usar para el separador entre el identificador de esquema y cualquier otro identificador.
SetAllValues	Especifica si todos los valores de columna de una instrucción update se incluyen o solo se cambian.
Site	Obtiene o establece el ISite objeto de .Component (Heredado de Component)

Métodos

Nombre	Description
ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Permite que la implementación del proveedor de la DbCommandBuilder clase controle las propiedades de parámetro adicionales.
Dispose()	Libera todos los recursos usados por .Component (Heredado de Component)
Dispose(Boolean)	Libera los recursos no administrados utilizados por DbCommandBuilder y, opcionalmente, libera los recursos administrados.
Equals(Object)	Determina si el objeto especificado es igual al objeto actual. (Heredado de Object)
GetDeleteCommand()	Obtiene el objeto generado DbCommand automáticamente necesario para realizar eliminaciones en el origen de datos.
GetDeleteCommand(Boolean)	Obtiene el objeto generado DbCommand automáticamente necesario para realizar eliminaciones en el origen de datos, opcionalmente mediante columnas para los nombres de parámetro.
GetHashCode()	Actúa como función hash predeterminada. (Heredado de Object)
GetInsertCommand()	Obtiene el objeto generado DbCommand automáticamente necesario para realizar inserciones en el origen de datos.
GetInsertCommand(Boolean)	Obtiene el objeto generado DbCommand automáticamente necesario para realizar inserciones en el origen de datos, opcionalmente mediante 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#. Use al compilar un generador de comandos personalizado.
GetParameterName(String)	Devuelve el nombre completo del parámetro, dado el nombre del parámetro parcial.
GetParameterPlaceholder(Int32)	Devuelve el marcador de posición del parámetro en la instrucción SQL asociada.
GetSchemaTable(DbCommand)	Devuelve la tabla de esquema para .DbCommandBuilder
GetService(Type)	Devuelve un objeto que representa un servicio proporcionado por Component o por su Container. (Heredado de Component)
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
GetUpdateCommand()	Obtiene el objeto generado DbCommand automáticamente necesario para realizar actualizaciones en el origen de datos.
GetUpdateCommand(Boolean)	Obtiene el objeto generado DbCommand automáticamente necesario para realizar actualizaciones en el origen de datos, opcionalmente mediante columnas para los nombres de parámetro.
InitializeCommand(DbCommand)	Restablece las CommandTimeoutpropiedades , Transaction, CommandTypey UpdateRowSource en .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 Objectactual. (Heredado de Object)
MemberwiseClone(Boolean)	Crea una copia superficial del objeto actual MarshalByRefObject . (Heredado de MarshalByRefObject)
QuoteIdentifier(String)	Dado un identificador sin comillas en el caso de catálogo correcto, devuelve la forma de comillas correcta de ese identificador, incluido el escape correcto de las comillas incrustadas en el identificador.
RefreshSchema()	Borra los comandos asociados a este DbCommandBuilderobjeto .
RowUpdatingHandler(RowUpdatingEventArgs)	Agrega un controlador de eventos para el RowUpdating evento.
SetRowUpdatingHandler(DbDataAdapter)	Registra para DbCommandBuilder controlar el RowUpdating evento de un DbDataAdapter.
ToString()	Devuelve un String objeto que contiene el nombre de Component, si existe. Este método no se debe invalidar. (Heredado de Component)
UnquoteIdentifier(String)	Dado un identificador entre comillas, devuelve la forma correcta sin comillas de ese identificador, incluida la separación correcta de las comillas incrustadas en el identificador.

Eventos

Nombre	Description
Disposed	Se produce cuando el componente se elimina mediante una llamada al Dispose() método . (Heredado de Component)

Consulte también

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