DbCommandBuilder Klasa

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Źródło:

DBCommandBuilder.cs

Automatycznie generuje polecenia z jedną tabelą używane do uzgadniania zmian wprowadzonych w DataSet skojarzonej bazie danych. Jest to abstrakcyjna klasa, która może być dziedziczona 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

System.Data.SqlClient.SqlCommandBuilder

Uwagi

Klasa DbCommandBuilder jest udostępniana dla wygody składników zapisywania dostawców tworzących własne konstruktory poleceń. Dziedzicząc po tej klasie, 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 obiekcie ze skojarzonym źródłem 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 właściwość jest ustawiana DataAdapter . 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 metadane SelectCommand 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 z nich 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ę element SelectCommand. Użytkownik powinien wywołać RefreshSchema metodę , jeśli którakolwiek 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ą poprzednie wartości.

Jeśli wywołasz Disposemetodę , DbCommandBuilder element zostanie usunięty z DbDataAdapterklasy , a wygenerowane polecenia nie będą już używane.

Konstruktory

DbCommandBuilder()

Inicjuje nowe wystąpienie klasy dziedziczonej DbCommandBuilder z klasy .

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 .
CatalogSeparator	Pobiera lub ustawia ciąg używany jako separator wykazu dla wystąpienia DbCommandBuilder klasy.
ConflictOption	Określa, który ConflictOption ma być używany przez element DbCommandBuilder.
Container	Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DataAdapter	Pobiera lub ustawia DbDataAdapter obiekt, dla którego instrukcje języka 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 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.
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

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Umożliwia implementacji DbCommandBuilder dostawcy klasy obsługę dodatkowych właściwości parametrów.
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)
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.
Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetDeleteCommand()	Pobiera automatycznie wygenerowany DbCommand obiekt wymagany do usunięcia 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 wykonania 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, nadaną częściowej nazwie parametru.
GetParameterPlaceholder(Int32)	Zwraca symbol zastępczy parametru w skojarzonej instrukcji SQL.
GetSchemaTable(DbCommand)	Zwraca tabelę schematu dla elementu DbCommandBuilder.
GetService(Type)	Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetType()	Type Pobiera wartość 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 Objectelementu . (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 katalogu, zwraca poprawną postać cytowanego 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 .DbDataAdapter
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 cudzysłowu, zwraca poprawną, nieprzyznaną formę tego identyfikatora, w tym prawidłowo un-escaping 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
• Omówienie ADO.NET