DbCommandBuilder Klasa

Definicja

Przestrzeń nazw:

System.Data.Common

Zestawy:

netstandard.dll, System.Data.Common.dll

Źródło:

DBCommandBuilder.cs

Automatycznie generuje polecenia z jedną tabelą używane do uzgadniania zmian wprowadzonych DataSet w skojarzonej bazie danych. Jest to abstrakcyjna klasa, którą można dziedziczyć tylko.

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

Dziedziczenie

Object

MarshalByRefObject

Component

DbCommandBuilder

Pochodne

System.Data.Odbc.OdbcCommandBuilder

System.Data.OleDb.OleDbCommandBuilder

Uwagi

Klasa DbCommandBuilder jest udostępniana dla wygody składników zapisywania dostawców tworzących własne konstruktory poleceń. Dziedzicząc z tej klasy, deweloperzy mogą implementować zachowanie specyficzne dla dostawcy we własnym kodzie.

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

Obiekt DbCommandBuilder rejestruje się jako odbiornik zdarzeń RowUpdating za każdym razem, gdy ustawisz DataAdapter właściwość . Jednocześnie można skojarzyć tylko jeden DbDataAdapter obiekt lub DbCommandBuilder obiekt ze sobą.

Aby wygenerować instrukcje INSERT, UPDATE lub DELETE, DbCommandBuilder funkcja używa SelectCommand właściwości do automatycznego pobierania wymaganego zestawu metadanych. Jeśli zmienisz SelectCommand metadane po pobraniu metadanych (na przykład po pierwszej aktualizacji), należy wywołać metodę RefreshSchema w celu zaktualizowania metadanych.

Element SelectCommand musi również zwrócić co najmniej jeden klucz podstawowy lub unikatową kolumnę. Jeśli żaden nie istnieje, InvalidOperationException zostanie wygenerowany wyjątek, a polecenia nie zostaną wygenerowane.

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

Jeśli wywołasz Disposemetodę , element DbCommandBuilder nie jest skojarzony z elementem DbDataAdapter, a wygenerowane polecenia nie są już używane.

Konstruktory

Nazwa	Opis
DbCommandBuilder()	Inicjuje nowe wystąpienie klasy dziedziczonej DbCommandBuilder z klasy.

Właściwości

Nazwa	Opis
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 .
CatalogSeparator	Pobiera lub ustawia ciąg używany jako separator wykazu dla wystąpienia DbCommandBuilder klasy.
ConflictOption	Określa, które ConflictOption ma być używane przez .DbCommandBuilder
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DataAdapter	Pobiera lub ustawia DbDataAdapter obiekt, dla którego instrukcje Transact-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 elementu Component. (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.
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.
SchemaSeparator	Pobiera lub ustawia znak, który ma być używany dla separatora między identyfikatorem schematu a innymi identyfikatorami.
SetAllValues	Określa, czy wszystkie wartości kolumn w instrukcji aktualizacji są uwzględniane, czy tylko zmienione.
Site	Pobiera lub ustawia wartość ISite .Component (Odziedziczone po Component)

Metody

Nazwa	Opis
ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Umożliwia implementacji dostawcy DbCommandBuilder klasy obsługę dodatkowych właściwości parametrów.
Dispose()	Zwalnia wszystkie zasoby używane przez program Component. (Odziedziczone po Component)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez DbCommandBuilder program i opcjonalnie zwalnia zarządzane zasoby.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetDeleteCommand()	Pobiera automatycznie wygenerowany DbCommand obiekt wymagany do wykonania usuwania w źródle danych.
GetDeleteCommand(Boolean)	Pobiera automatycznie wygenerowany DbCommand obiekt wymagany do usunięcia w źródle danych, opcjonalnie przy użyciu kolumn dla nazw parametrów.
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetInsertCommand()	Pobiera automatycznie wygenerowany DbCommand obiekt wymagany do wykonywania wstawiania w źródle danych.
GetInsertCommand(Boolean)	Pobiera automatycznie wygenerowany DbCommand obiekt wymagany do wykonywania wstawiania w źródle danych, opcjonalnie przy użyciu kolumn dla nazw parametrów.
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ń.
GetParameterName(String)	Zwraca pełną nazwę parametru, biorąc pod uwagę nazwę parametru częściowego.
GetParameterPlaceholder(Int32)	Zwraca symbol zastępczy parametru w skojarzonej instrukcji SQL.
GetSchemaTable(DbCommand)	Zwraca tabelę schematu dla elementu DbCommandBuilder.
GetService(Type)	Zwraca obiekt reprezentujący usługę dostarczaną przez Component obiekt lub przez obiekt Container. (Odziedziczone po Component)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
GetUpdateCommand()	Pobiera automatycznie wygenerowany DbCommand obiekt wymagany do wykonywania aktualizacji w źródle danych.
GetUpdateCommand(Boolean)	Pobiera automatycznie wygenerowany DbCommand obiekt wymagany do wykonywania aktualizacji w źródle danych, opcjonalnie przy użyciu kolumn dla nazw parametrów.
InitializeCommand(DbCommand)	Resetuje CommandTimeoutwłaściwości , Transaction, CommandTypei UpdateRowSource w obiekcie DbCommand.
InitializeLifetimeService()	Przestarzałe. Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
MemberwiseClone(Boolean)	Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
QuoteIdentifier(String)	Biorąc pod uwagę identyfikator bez cudzysłowu w prawidłowym przypadku wykazu, zwraca poprawną postać cytowaną tego identyfikatora, w tym prawidłowo uciekając przed wszelkimi osadzonymi cudzysłowami w identyfikatorze.
RefreshSchema()	Czyści polecenia skojarzone z tym DbCommandBuilderelementem .
RowUpdatingHandler(RowUpdatingEventArgs)	Dodaje procedurę obsługi zdarzeń dla RowUpdating zdarzenia.
SetRowUpdatingHandler(DbDataAdapter)	Rejestruje element w DbCommandBuilder celu obsługi RowUpdating zdarzenia dla elementu DbDataAdapter.
ToString()	Zwraca wartość zawierającą String nazwę Component, jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
UnquoteIdentifier(String)	Biorąc pod uwagę identyfikator cytowany, zwraca poprawną, niekwotowaną formę tego identyfikatora, w tym prawidłowo un-escaping wszelkich osadzonych cudzysłowów w identyfikatorze.

Zdarzenia

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

Zobacz też

• Generowanie poleceń przez CommandBuilders
• Omówienie ADO.NET