OleDbCommandBuilder Klasa

Definicja

Przestrzeń nazw:

System.Data.OleDb

Zestaw:

System.Data.OleDb.dll

Pakiet:

System.Data.OleDb v9.0.0-rc.2.24473.5

Źródło:

OleDbCommandBuilder.cs

Automatycznie generuje polecenia z jedną tabelą, które są używane do uzgadniania zmian wprowadzonych w DataSet skojarzonej bazie danych. Klasa ta nie może być dziedziczona.

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

Dziedziczenie

Object

MarshalByRefObject

Component

DbCommandBuilder

OleDbCommandBuilder

Przykłady

W poniższym przykładzie użyto OleDbCommandelementu , wzdłuż OleDbDataAdapter i OleDbConnection, aby wybrać wiersze ze źródła danych. Przykład jest przekazywany zainicjowany DataSet, parametry połączenia, ciąg zapytania, który jest instrukcją SQL SELECT, i ciąg, który jest nazwą tabeli źródła danych. W tym przykładzie zostanie utworzony element 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

Uwagi

Instrukcja OleDbDataAdapter SQL nie generuje automatycznie instrukcji SQL wymaganych do uzgadniania zmian wprowadzonych w DataSet skojarzonym źródle danych. Można jednak utworzyć OleDbCommandBuilder obiekt, aby automatycznie wygenerować instrukcje SQL dla aktualizacji pojedynczej OleDbDataAdaptertabeli, jeśli ustawisz SelectCommand właściwość . Następnie wszystkie dodatkowe instrukcje SQL, które nie zostały ustawione, są generowane przez OleDbCommandBuilderelement .

Właściwość OleDbCommandBuilder rejestruje się jako odbiornik dla RowUpdating zdarzeń za każdym razem, gdy właściwość zostanie ustawiona DataAdapter . Jednocześnie można skojarzyć tylko jeden OleDbDataAdapter obiekt lub OleDbCommandBuilder obiekt ze sobą.

Aby wygenerować instrukcje INSERT, UPDATE lub DELETE, OleDbCommandBuilder właściwość używa SelectCommand właściwości do automatycznego pobierania wymaganego zestawu metadanych. W przypadku zmiany SelectCommand po pobraniu metadanych, takich jak po pierwszej aktualizacji, należy wywołać RefreshSchema metodę w celu zaktualizowania metadanych.

Obiekt OleDbCommandBuilder używa Connectionrównież właściwości , CommandTimeouti Transaction , do których SelectCommandodwołuje się element . Użytkownik powinien wywołać metodę RefreshSchema , jeśli co najmniej jedna z tych właściwości zostanie zmodyfikowana lub jeśli SelectCommand sama zostanie zamieniona. InsertCommandW przeciwnym razie właściwości , UpdateCommandi DeleteCommand zachowują swoje poprzednie wartości.

Jeśli wywołasz metodę Dispose, OleDbCommandBuilder element jest rozłączony z elementem OleDbDataAdapter, a wygenerowane polecenia nie są już używane.

Konstruktory

OleDbCommandBuilder()	Inicjuje nowe wystąpienie klasy OleDbCommandBuilder.
OleDbCommandBuilder(OleDbDataAdapter)	Inicjuje OleDbCommandBuilder nowe wystąpienie klasy ze skojarzonym OleDbDataAdapter obiektem.

Właściwości

CanRaiseEvents	Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
CatalogLocation	Pobiera lub ustawia CatalogLocation dla wystąpienia DbCommandBuilder klasy . (Odziedziczone po DbCommandBuilder)
CatalogSeparator	Pobiera lub ustawia ciąg używany jako separator wykazu dla wystąpienia DbCommandBuilder klasy. (Odziedziczone po DbCommandBuilder)
ConflictOption	Określa, który ConflictOption ma być używany przez element DbCommandBuilder. (Odziedziczone po DbCommandBuilder)
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DataAdapter	Pobiera lub ustawia OleDbDataAdapter obiekt, dla którego instrukcje SQL są generowane automatycznie.
DesignMode	Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
QuotePrefix	Pobiera lub ustawia początkowy znak lub znaki do użycia podczas określania obiektów bazy danych (na przykład tabel lub kolumn), których nazwy zawierają znaki, takie jak spacje lub tokeny zarezerwowane. (Odziedziczone po DbCommandBuilder)
QuoteSuffix	Pobiera lub ustawia znak końcowy lub znaki do użycia podczas określania obiektów bazy danych (na przykład tabel lub kolumn), których nazwy zawierają znaki, takie jak spacje lub tokeny zarezerwowane. (Odziedziczone po DbCommandBuilder)
SchemaSeparator	Pobiera lub ustawia znak do użycia dla separatora między identyfikatorem schematu a innymi identyfikatorami. (Odziedziczone po DbCommandBuilder)
SetAllValues	Określa, czy wszystkie wartości kolumn w instrukcji aktualizacji są uwzględniane, czy tylko zmienione. (Odziedziczone po DbCommandBuilder)
Site	Pobiera lub ustawia ISite element .Component (Odziedziczone po Component)

Metody

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Umożliwia implementacji DbCommandBuilder dostawcy klasy obsługę dodatkowych właściwości parametrów. (Odziedziczone po DbCommandBuilder)
CreateObjRef(Type)	Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
DeriveParameters(OleDbCommand)	Pobiera informacje o parametrach z procedury składowanej określonej w obiekcie OleDbCommand i wypełnia Parameters kolekcję określonego OleDbCommand obiektu.
Dispose()	Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia zasoby niezarządzane używane przez element DbCommandBuilder i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DbCommandBuilder)
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetDeleteCommand()	Pobiera automatycznie wygenerowany OleDbCommand obiekt wymagany do wykonania usunięcia w źródle danych.
GetDeleteCommand(Boolean)	Pobiera automatycznie wygenerowany OleDbCommand obiekt wymagany do wykonania usunięcia w źródle danych.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetInsertCommand()	Pobiera automatycznie wygenerowany OleDbCommand obiekt wymagany do wykonywania wstawiania w źródle danych.
GetInsertCommand(Boolean)	Pobiera automatycznie wygenerowany OleDbCommand obiekt wymagany do wykonywania wstawiania w źródle danych.
GetLifetimeService()	Przestarzałe. Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetParameterName(Int32)	Zwraca nazwę określonego parametru w formacie @p#. Użyj polecenia podczas tworzenia niestandardowego konstruktora poleceń. (Odziedziczone po DbCommandBuilder)
GetParameterName(String)	Zwraca pełną nazwę parametru, przy użyciu częściowej nazwy parametru. (Odziedziczone po DbCommandBuilder)
GetParameterPlaceholder(Int32)	Zwraca symbol zastępczy parametru w skojarzonej instrukcji SQL. (Odziedziczone po DbCommandBuilder)
GetSchemaTable(DbCommand)	Zwraca tabelę schematu dla elementu DbCommandBuilder. (Odziedziczone po DbCommandBuilder)
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
GetUpdateCommand()	Pobiera automatycznie wygenerowany OleDbCommand obiekt wymagany do wykonywania aktualizacji w źródle danych.
GetUpdateCommand(Boolean)	Pobiera automatycznie wygenerowany OleDbCommand obiekt wymagany do wykonywania aktualizacji w źródle danych, opcjonalnie przy użyciu kolumn nazw parametrów.
InitializeCommand(DbCommand)	Resetuje CommandTimeoutwłaściwości , Transaction, CommandTypei UpdateRowSource w elemecie DbCommand. (Odziedziczone po DbCommandBuilder)
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia, aby kontrolować zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
QuoteIdentifier(String)	Biorąc pod uwagę niekwestionowany identyfikator w prawidłowym przypadku wykazu, zwraca poprawną postać cytowaną tego identyfikatora. Obejmuje to poprawne ucieczkę wszystkich osadzonych cudzysłowów w identyfikatorze.
QuoteIdentifier(String, OleDbConnection)	Biorąc pod uwagę niekwestionowany identyfikator w prawidłowym przypadku wykazu, zwraca poprawną postać cytowaną tego identyfikatora. Obejmuje to poprawne ucieczkę wszystkich osadzonych cudzysłowów w identyfikatorze.
RefreshSchema()	Czyści polecenia skojarzone z tym DbCommandBuilderelementem . (Odziedziczone po DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Dodaje procedurę obsługi zdarzeń RowUpdating dla zdarzenia. (Odziedziczone po DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Rejestruje element DbCommandBuilder w celu obsługi RowUpdating zdarzenia dla .DbDataAdapter (Odziedziczone po DbCommandBuilder)
ToString()	Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
UnquoteIdentifier(String)	Biorąc pod uwagę identyfikator cytowany, zwraca prawidłową niekwestionowaną formę tego identyfikatora. Obejmuje to poprawne usuwanie wszelkich osadzonych cudzysłowów w identyfikatorze.
UnquoteIdentifier(String, OleDbConnection)	Biorąc pod uwagę identyfikator cytowany, zwraca prawidłową niekwestionowaną formę tego identyfikatora. Obejmuje to poprawne usuwanie wszelkich osadzonych cudzysłowów w identyfikatorze.

Zdarzenia

Disposed

Występuje, gdy składnik jest usuwany przez wywołanie Dispose() metody . (Odziedziczone po Component)

Zobacz też

• Generowanie poleceń za pomocą CommandBuilders