OleDbCommandBuilder Clase

Definición

Espacio de nombres:

System.Data.OleDb

Ensamblado:

System.Data.OleDb.dll

Paquete:

System.Data.OleDb v11.0.0-preview.2.26159.112

Source:

OleDbCommandBuilder.cs

Genera automáticamente comandos de tabla única que se usan para conciliar los cambios realizados en una DataSet con la base de datos asociada. Esta clase no puede heredarse.

public ref class OleDbCommandBuilder sealed : System::Data::Common::DbCommandBuilder

public sealed class OleDbCommandBuilder : System.Data.Common.DbCommandBuilder

type OleDbCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OleDbCommandBuilder
Inherits DbCommandBuilder

Herencia

Object

MarshalByRefObject

Component

DbCommandBuilder

OleDbCommandBuilder

Ejemplos

En el OleDbCommandejemplo siguiente se usa , junto OleDbDataAdapter y OleDbConnection, para seleccionar filas de un origen de datos. El ejemplo se pasa a una cadena de conexión inicializada 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

No OleDbDataAdapter 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 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 agente de escucha para RowUpdating eventos cada vez que se establece la DataAdapter propiedad . Solo 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 propiedades , CommandTimeouty Transaction a las Connectionque hace referencia .SelectCommand El usuario debe llamar RefreshSchema a 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, se OleDbCommandBuilder desasocia de OleDbDataAdaptery los comandos generados ya no se usan.

Constructores

Nombre	Description
OleDbCommandBuilder()	Inicializa una nueva instancia de la clase OleDbCommandBuilder.
OleDbCommandBuilder(OleDbDataAdapter)	Inicializa una nueva instancia de la OleDbCommandBuilder clase con el objeto asociado OleDbDataAdapter .

Propiedades

Nombre	Description
DataAdapter	Obtiene o establece un OleDbDataAdapter objeto para el que se generan automáticamente instrucciones SQL.

Métodos

Nombre	Description
DeriveParameters(OleDbCommand)	Recupera información de parámetros del procedimiento almacenado especificado en OleDbCommand y rellena la Parameters colección del objeto especificado OleDbCommand .
GetDeleteCommand()	Obtiene el objeto generado OleDbCommand automáticamente necesario para realizar eliminaciones en el origen de datos.
GetDeleteCommand(Boolean)	Obtiene el objeto generado OleDbCommand automáticamente necesario para realizar eliminaciones en el origen de datos.
GetInsertCommand()	Obtiene el objeto generado OleDbCommand automáticamente necesario para realizar inserciones en el origen de datos.
GetInsertCommand(Boolean)	Obtiene el objeto generado OleDbCommand automáticamente necesario para realizar inserciones en el origen de datos.
GetUpdateCommand()	Obtiene el objeto generado OleDbCommand automáticamente necesario para realizar actualizaciones en el origen de datos.
GetUpdateCommand(Boolean)	Obtiene el objeto generado OleDbCommand automáticamente necesario para realizar actualizaciones en el origen de datos, opcionalmente mediante columnas para los nombres de parámetro.
QuoteIdentifier(String, OleDbConnection)	Dado un identificador sin comillas en el caso de catálogo correcto, devuelve la forma de comillas correcta de ese identificador. Esto incluye el escape correcto de las comillas incrustadas en el identificador.
QuoteIdentifier(String)	Dado un identificador sin comillas en el caso de catálogo correcto, devuelve la forma de comillas correcta de ese identificador. Esto incluye el escape correcto de las comillas incrustadas en el identificador.
UnquoteIdentifier(String, OleDbConnection)	Dado un identificador entre comillas, devuelve la forma correcta sin comillas de ese identificador. Esto incluye un escape correcto de las comillas incrustadas en el identificador.
UnquoteIdentifier(String)	Dado un identificador entre comillas, devuelve la forma correcta sin comillas de ese identificador. Esto incluye un escape correcto de las comillas incrustadas en el identificador.

Consulte también

• Generación de comandos con CommandBuilders