OleDbCommandBuilder Osztály

Definíció

Névtér:

System.Data.OleDb

Szerelvény:

System.Data.OleDb.dll

Csomag:

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

Forrás:

OleDbCommandBuilder.cs

Automatikusan létrehoz egytáblás parancsokat, amelyek a társított adatbázis módosításainak DataSet egyeztetésére szolgálnak. Ez az osztály nem örökölhető.

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

Öröklődés

Object

MarshalByRefObject

Component

DbCommandBuilder

OleDbCommandBuilder

Példák

Az alábbi példa a sorok adatforrásból való kiválasztására használja a OleDbCommandmentén OleDbDataAdapter és OleDbConnectiona mellette lévő elemet. A példa egy inicializált DataSet, egy kapcsolati karakterlánc, egy SQL SELECT utasítást tartalmazó lekérdezési sztring és egy adatforrástábla nevét tartalmazó sztring. A példa ezután létrehoz egy 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

Megjegyzések

A OleDbDataAdapter rendszer nem hozza létre automatikusan azokat az SQL-utasításokat, amelyek a társított adatforrás módosításainak DataSet egyeztetéséhez szükségesek. Létrehozhat azonban egy OleDbCommandBuilder objektumot, amely automatikusan létrehoz SQL-utasításokat az egytáblás frissítésekhez, ha beállítja a SelectCommand tulajdonságot.OleDbDataAdapter Ezután a nem beállított további SQL-utasításokat a rendszer létrehozza.OleDbCommandBuilder

A OleDbCommandBuilder tulajdonság beállításakor a rendszer figyelőként regisztrálja magát az RowUpdating eseményekhezDataAdapter. Egyszerre csak egyet OleDbDataAdapter vagy OleDbCommandBuilder objektumot társíthat egymáshoz.

AZ INSERT, UPDATE vagy DELETE utasítások létrehozásához a OleDbCommandBuilderSelectCommand tulajdonság használatával automatikusan lekéri a szükséges metaadatokat. Ha módosítja a SelectCommand metaadatok lekérése után, például az első frissítés után, hívja meg a RefreshSchema metódust a metaadatok frissítéséhez.

Az OleDbCommandBuilder is használja a Connection, CommandTimeoutés Transaction a tulajdonságok által SelectCommandhivatkozott. A felhasználónak fel kell hívnia RefreshSchema , ha egy vagy több tulajdonság módosult, vagy ha a SelectCommand rendszer lecserélte magát. Ellenkező esetben a InsertCommand, UpdateCommandés DeleteCommand a tulajdonságok megőrzik a korábbi értékeket.

Ha meghívja Dispose, a rendszer nem társítja a OleDbCommandBuilder parancsot, OleDbDataAdapterés a generált parancsok már nem lesznek használatban.

Konstruktorok

Name	Description
OleDbCommandBuilder()	Inicializálja a OleDbCommandBuilder osztály új példányát.
OleDbCommandBuilder(OleDbDataAdapter)	Inicializálja az osztály új példányát OleDbCommandBuilder a társított objektummal OleDbDataAdapter .

Tulajdonságok

Name	Description
DataAdapter	Lekéri vagy beállít egy OleDbDataAdapter objektumot, amelyhez az SQL-utasítások automatikusan létrejönnek.

Metódusok

Name	Description
DeriveParameters(OleDbCommand)	Lekéri a paraméteradatokat a megadott OleDbCommand tárolt eljárásból, és feltölti a Parameters megadott OleDbCommand objektum gyűjteményét.
GetDeleteCommand()	Lekéri az adatforrás törléséhez szükséges automatikusan létrehozott OleDbCommand objektumot.
GetDeleteCommand(Boolean)	Lekéri az adatforrás törléséhez szükséges automatikusan létrehozott OleDbCommand objektumot.
GetInsertCommand()	Lekéri az adatforrásba történő beszúráshoz szükséges automatikusan létrehozott OleDbCommand objektumot.
GetInsertCommand(Boolean)	Lekéri az adatforrásba történő beszúráshoz szükséges automatikusan létrehozott OleDbCommand objektumot.
GetUpdateCommand()	Lekéri az adatforrásban a frissítések végrehajtásához szükséges automatikusan létrehozott OleDbCommand objektumot.
GetUpdateCommand(Boolean)	Lekéri az adatforrásban a frissítések végrehajtásához szükséges automatikusan létrehozott OleDbCommand objektumot, opcionálisan a paraméternevek oszlopait használva.
QuoteIdentifier(String, OleDbConnection)	Ha a katalógus helyes esetében nem kvótált azonosítót ad vissza, az azonosító helyes idézett formáját adja vissza. Ez magában foglalja az azonosítóban lévő beágyazott idézőjelek helyes menekülését.
QuoteIdentifier(String)	Ha a katalógus helyes esetében nem kvótált azonosítót ad vissza, az azonosító helyes idézett formáját adja vissza. Ez magában foglalja az azonosítóban lévő beágyazott idézőjelek helyes menekülését.
UnquoteIdentifier(String, OleDbConnection)	Idézett azonosító esetén az azonosító helyes, nem kvótált formáját adja vissza. Ez magában foglalja az azonosítóban lévő beágyazott idézőjelek megfelelő feloldását.
UnquoteIdentifier(String)	Idézett azonosító esetén az azonosító helyes, nem kvótált formáját adja vissza. Ez magában foglalja az azonosítóban lévő beágyazott idézőjelek megfelelő feloldását.

Lásd még

• Parancsok létrehozása CommandBuilders használatával