OleDbCommandBuilder Clase
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í.
Genera de manera automática comandos de tabla única utilizados para conciliar los cambios realizados en un objeto DataSet con la base de datos asociada. Esta clase no puede heredarse.
public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilderpublic ref class OleDbCommandBuilder sealed : System::ComponentModel::Componentpublic sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilderpublic sealed class OleDbCommandBuilder : System.ComponentModel.Componenttype OleDbCommandBuilder = class
inherit DbCommandBuildertype OleDbCommandBuilder = class
inherit ComponentPublic NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilderPublic NotInheritable Class OleDbCommandBuilder
Inherits Component- Herencia
- Herencia
Ejemplos
En el OleDbCommandejemplo siguiente se usa , junto OleDbDataAdapter con y OleDbConnection, para seleccionar filas de un origen de datos. En el ejemplo se pasa un objeto inicializado DataSet, una cadena de conexión, una cadena de consulta que es una instrucción SELECT de SQL y una cadena que es el nombre de la tabla de origen de datos. A continuación, el ejemplo crea un OleDbCommandBuilder.
public static DataSet UpdateRows(string connectionString,
string queryString, string tableName)
{
DataSet dataSet = new DataSet();
using (OleDbConnection connection = new OleDbConnection(connectionString))
{
OleDbDataAdapter adapter = new OleDbDataAdapter();
adapter.SelectCommand = new OleDbCommand(queryString, connection);
OleDbCommandBuilder cb = new OleDbCommandBuilder(adapter);
connection.Open();
adapter.Fill(dataSet, tableName);
//code to modify data in DataSet here
cb.GetDeleteCommand();
//Without the OleDbCommandBuilder this line would fail
adapter.Update(dataSet, tableName);
connection.Close();
}
return dataSet;
}
Public Shared Function UpdateRows(ByVal connectionString As String, _
ByVal queryString As String, ByVal tableName As String) As DataSet
Dim dataSet As New DataSet()
Using connection As New OleDbConnection(connectionString)
Dim adapter As New OleDbDataAdapter()
adapter.SelectCommand = New OleDbCommand(queryString, connection)
Dim builder As New OleDbCommandBuilder(adapter)
connection.Open()
adapter.Fill(dataSet, tableName)
' Code to modify data in DataSet here
builder.GetUpdateCommand()
' Without the OleDbCommandBuilder this line would fail.
adapter.Update(dataSet, tableName)
End Using
Return dataSet
End Function
Comentarios
OleDbDataAdapter 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 OleDbCommandBuilder objeto para generar automáticamente instrucciones SQL para actualizaciones de tabla única si establece la SelectCommand propiedad de OleDbDataAdapter. A continuación, las instrucciones SQL adicionales que no establezca se generan mediante .OleDbCommandBuilder
Se OleDbCommandBuilder registra como un agente de escucha para RowUpdating los eventos siempre que se establece la DataAdapter propiedad . Solo se puede asociar uno OleDbDataAdapter o OleDbCommandBuilder un objeto entre sí a la vez.
Para generar instrucciones INSERT, UPDATE o DELETE, usa OleDbCommandBuilder la SelectCommand propiedad para recuperar automáticamente un conjunto necesario de metadatos. Si cambia SelectCommand después de recuperar los metadatos, como después de la primera actualización, debe llamar al RefreshSchema método para actualizar los metadatos.
OleDbCommandBuilder también usa las Connectionpropiedades , CommandTimeouty Transaction a las que hace referencia .SelectCommand El usuario debe llamar a RefreshSchema si se modifican una o varias 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 OleDbCommandBuilder elemento se desasocia de OleDbDataAdaptery los comandos generados ya no se usan.
Constructores
| OleDbCommandBuilder() |
Inicializa una nueva instancia de la clase OleDbCommandBuilder. |
| OleDbCommandBuilder(OleDbDataAdapter) |
Inicializa una nueva instancia de la clase OleDbCommandBuilder con el objeto OleDbDataAdapter asociado. |
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. (Heredado de DbCommandBuilder) |
| CatalogSeparator |
Obtiene o establece una cadena que se usa como separador de catálogo para una instancia de la clase DbCommandBuilder. (Heredado de DbCommandBuilder) |
| ConflictOption |
Especifica qué ConflictOption va a utilizar DbCommandBuilder. (Heredado de DbCommandBuilder) |
| Container |
Obtiene la interfaz IContainer que contiene la clase Component. (Heredado de Component) |
| DataAdapter |
Obtiene o establece un objeto OleDbDataAdapter para el que se generan instrucciones SQL automáticamente. |
| 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. |
| 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. (Heredado de DbCommandBuilder) |
| 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. |
| 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. (Heredado de DbCommandBuilder) |
| SchemaSeparator |
Obtiene o establece el carácter que se va a utilizar para el separador entre el identificador de esquema y cualquier otro identificador. (Heredado de DbCommandBuilder) |
| SetAllValues |
Especifica si en una instrucción de actualización se incluyen todos los valores de columna o sólo los que han cambiado. (Heredado de DbCommandBuilder) |
| 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. (Heredado de DbCommandBuilder) |
| 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) |
| DeriveParameters(OleDbCommand) |
Recupera información de parámetro del procedimiento almacenado especificado en OleDbCommand y rellena la colección de Parameters del objeto OleDbCommand especificado. |
| 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. (Heredado de DbCommandBuilder) |
| Dispose(Boolean) |
Libera los recursos no administrados que usa Component y, de forma opcional, libera los recursos administrados. (Heredado de Component) |
| Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
| GetDeleteCommand() |
Obtiene el objeto OleDbCommand generado automáticamente que es necesario para realizar eliminaciones en el origen de datos. |
| GetDeleteCommand(Boolean) |
Obtiene el objeto OleDbCommand generado automáticamente que es necesario para realizar eliminaciones en el origen de datos. |
| GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
| GetInsertCommand() |
Obtiene el objeto OleDbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos. |
| GetInsertCommand(Boolean) |
Obtiene el objeto OleDbCommand generado automáticamente que es necesario para realizar inserciones en el origen de datos. |
| 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 |
| GetParameterName(String) |
Devuelve el nombre completo del parámetro, a partir de su nombre parcial. (Heredado de DbCommandBuilder) |
| GetParameterPlaceholder(Int32) |
Devuelve el marcador de posición para el parámetro en la instrucción SQL asociada. (Heredado de DbCommandBuilder) |
| GetSchemaTable(DbCommand) |
Devuelve la tabla de esquema para DbCommandBuilder. (Heredado de 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 OleDbCommand generado automáticamente que es necesario para realizar actualizaciones en el origen de datos. |
| GetUpdateCommand(Boolean) |
Obtiene el objeto OleDbCommand 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. (Heredado de DbCommandBuilder) |
| 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 del entrecomillado de ese identificador. Incluye una secuencia de escape correcta de las comillas incrustadas que pueda haber en el identificador. |
| QuoteIdentifier(String, OleDbConnection) |
Dado un identificador sin comillas en el caso de un catálogo correcto, devuelve el formato correcto del entrecomillado de ese identificador. Incluye una secuencia de escape correcta de las comillas incrustadas que pueda haber en el identificador. |
| RefreshSchema() |
Borra los comandos asociados a este OleDbCommandBuilder. |
| RefreshSchema() |
Borra los comandos asociados a este DbCommandBuilder. (Heredado de DbCommandBuilder) |
| RowUpdatingHandler(RowUpdatingEventArgs) |
Agrega un controlador de eventos para el evento RowUpdating. (Heredado de DbCommandBuilder) |
| SetRowUpdatingHandler(DbDataAdapter) |
Registra el objeto DbCommandBuilder para controlar el evento RowUpdating de un objeto DbDataAdapter. (Heredado de DbCommandBuilder) |
| 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 in identificador entre comillas, devuelve el formato correcto sin comillas de ese identificador. Incluye una secuencia sin escape correcta de las comillas incrustadas que pueda haber en el identificador. |
| UnquoteIdentifier(String, OleDbConnection) |
Dado in identificador entre comillas, devuelve el formato correcto sin comillas de ese identificador. Incluye una secuencia sin escape correcta de las comillas incrustadas que pueda haber en el identificador. |
Eventos
| Disposed |
Tiene lugar cuando una llamada elimina el componente mediante una llamada al método Dispose(). (Heredado de Component) |
Se aplica a
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de