OracleCommandBuilder Klasa

Definicja

Przestrzeń nazw:

System.Data.OracleClient

Zestaw:

System.Data.OracleClient.dll

Przestroga

OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260

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

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

[System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)]
public sealed class OracleCommandBuilder : System.Data.Common.DbCommandBuilder

[<System.Obsolete("OracleCommandBuilder has been deprecated. http://go.microsoft.com/fwlink/?LinkID=144260", false)>]
type OracleCommandBuilder = class
    inherit DbCommandBuilder

Public NotInheritable Class OracleCommandBuilder
Inherits DbCommandBuilder

Dziedziczenie

Object

MarshalByRefObject

Component

DbCommandBuilder

OracleCommandBuilder

Atrybuty

ObsoleteAttribute

Przykłady

W poniższym przykładzie użyto elementów OracleCommand, wraz z elementami OracleDataAdapter i OracleConnection, aby wybrać wiersze z bazy 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 bazy danych. W tym przykładzie zostanie utworzony element OracleCommandBuilder.

Private Function SelectOracleRows(connection As String, queryString As String, tableName As String) As DataSet  

   Dim connection As New OracleConnection(connection)  
   Dim dataAdapter As New OracleDataAdapter()  
   Dim dataSet As DataSet = New DataSet  

   dataAdapter.SelectCommand = New OracleCommand(queryString, connection)  

   Dim cmdBuilder As OracleCommandBuilder = New OracleCommandBuilder(dataAdapter)  

   connection.Open()  
   dataAdapter.Fill(dataSet, tableName)  
      ' Code to modify data in DataSet here   
      ' Without the OracleCommandBuilder this line would fail.  
   dataAdapter.Update(dataSet, tableName)  
   connection.Close()  
End Function  

public static DataSet SelectOracleSrvRows(string myConnection, string mySelectQuery, string myTableName)  
{  
   OracleConnection myConn = new OracleConnection(myConnection);  
   OracleDataAdapter myDataAdapter = new OracleDataAdapter();  
   myDataAdapter.SelectCommand = new OracleCommand(mySelectQuery, myConn);  
   OracleCommandBuilder cb = new OracleCommandBuilder(myDataAdapter);  

   myConn.Open();  
   DataSet ds = new DataSet();  
   myDataAdapter.Fill(ds, myTableName);  

   //Code to modify data in DataSet goes here...  

   //Without the OracleCommandBuilder this line would fail.  
   myDataAdapter.Update(ds, myTableName);  
   myConn.Close();  
   return ds;  
}  

Uwagi

Ten typ jest przestarzały i zostanie usunięty w przyszłej wersji .NET Framework. Aby uzyskać więcej informacji, zobacz Oracle i ADO.NET.

Instrukcja OracleDataAdapter SQL nie generuje automatycznie instrukcji SQL wymaganych do uzgadniania zmian wprowadzonych w skojarzonej z bazą DataSet danych. Można jednak utworzyć OracleCommandBuilder obiekt, który generuje instrukcje SQL dla aktualizacji z jedną tabelą, ustawiając SelectCommand właściwość OracleDataAdapter. Następnie program OracleCommandBuilder generuje dodatkowe instrukcje SQL, które nie są ustawione.

Relacja między elementem a OracleDataAdapter odpowiadającym OracleCommandBuilder jej elementem jest zawsze jeden do jednego. Aby utworzyć tę korespondencję OracleDataAdapter , należy ustawić właściwość OracleCommandBuilder obiektu. Powoduje to zarejestrowanie OracleCommandBuilder się jako odbiornik, co powoduje wygenerowanie danych wyjściowych zdarzeń wpływających RowUpdating na element DataSet.

Aby wygenerować instrukcje INSERT, UPDATE lub DELETE, OracleCommandBuilder funkcja używa SelectCommand właściwości do pobierania wymaganego zestawu metadanych.

Obiekt OracleCommandBuilder używa Connectionrównież właściwości , i Transaction , do których odwołuje się element SelectCommand.

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

Konstruktory

OracleCommandBuilder()	Przestarzałe. Inicjuje nowe wystąpienie klasy OracleCommandBuilder.
OracleCommandBuilder(OracleDataAdapter)	Przestarzałe. Inicjuje OracleCommandBuilder nowe wystąpienie klasy ze skojarzonym OracleDataAdapter obiektem.

Właściwości

CanRaiseEvents	Przestarzałe. Pobiera wartość wskazującą, czy składnik może zgłosić zdarzenie. (Odziedziczone po Component)
CatalogLocation	Przestarzałe. Pobiera lub ustawia CatalogLocation dla wystąpienia DbCommandBuilder klasy .
CatalogSeparator	Przestarzałe. Pobiera lub ustawia ciąg używany jako separator wykazu dla wystąpienia DbCommandBuilder klasy.
ConflictOption	Przestarzałe. Określa, który ConflictOption ma być używany przez element DbCommandBuilder. (Odziedziczone po DbCommandBuilder)
Container	Przestarzałe. Pobiera element IContainer zawierający element Component. (Odziedziczone po Component)
DataAdapter	Przestarzałe. Pobiera lub ustawia OracleDataAdapter obiekt, dla którego ten OracleCommandBuilder obiekt będzie generować instrukcje SQL.
DesignMode	Przestarzałe. Pobiera wartość wskazującą, czy Component element jest obecnie w trybie projektowania. (Odziedziczone po Component)
Events	Przestarzałe. Pobiera listę programów obsługi zdarzeń dołączonych do tego Componentelementu . (Odziedziczone po Component)
QuotePrefix	Przestarzałe. 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	Przestarzałe. 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	Przestarzałe. Pobiera lub ustawia znak, który ma być używany dla separatora między identyfikatorem schematu a innymi identyfikatorami.
SetAllValues	Przestarzałe. Określa, czy wszystkie wartości kolumn w instrukcji aktualizacji są uwzględniane, czy tylko zmienione. (Odziedziczone po DbCommandBuilder)
Site	Przestarzałe. Pobiera lub ustawia wartość ISite .Component (Odziedziczone po Component)

Metody

ApplyParameterInfo(DbParameter, DataRow, StatementType, Boolean)	Przestarzałe. Umożliwia implementacji DbCommandBuilder dostawcy klasy obsługę dodatkowych właściwości parametrów. (Odziedziczone po DbCommandBuilder)
CreateObjRef(Type)	Przestarzałe. Tworzy obiekt zawierający wszystkie istotne informacje wymagane do wygenerowania serwera proxy używanego do komunikowania się z obiektem zdalnym. (Odziedziczone po MarshalByRefObject)
DeriveParameters(OracleCommand)	Przestarzałe. Pobiera informacje o parametrach z procedury składowanej określonej w OracleCommand obiekcie i wypełnia Parameters kolekcję określonego OracleCommand obiektu.
Dispose()	Przestarzałe. Zwalnia wszelkie zasoby używane przez element Component. (Odziedziczone po Component)
Dispose(Boolean)	Przestarzałe. Zwalnia zasoby niezarządzane używane przez element DbCommandBuilder i opcjonalnie zwalnia zasoby zarządzane. (Odziedziczone po DbCommandBuilder)
Equals(Object)	Przestarzałe. Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetDeleteCommand()	Przestarzałe. Pobiera automatycznie wygenerowany OracleCommand obiekt wymagany do usunięcia bazy danych.
GetDeleteCommand(Boolean)	Przestarzałe. Pobiera automatycznie wygenerowany OracleCommand obiekt wymagany do usunięcia bazy danych.
GetHashCode()	Przestarzałe. Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetInsertCommand()	Przestarzałe. Pobiera automatycznie wygenerowany OracleCommand obiekt wymagany do wykonania wstawiania do bazy danych.
GetInsertCommand(Boolean)	Przestarzałe. Pobiera automatycznie wygenerowany OracleCommand obiekt wymagany do wykonania wstawiania do bazy danych.
GetLifetimeService()	Pobiera bieżący obiekt usługi okresu istnienia, który kontroluje zasady okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
GetParameterName(Int32)	Przestarzałe. Zwraca nazwę określonego parametru w formacie @p#. Użyj polecenia podczas tworzenia niestandardowego konstruktora poleceń. (Odziedziczone po DbCommandBuilder)
GetParameterName(String)	Przestarzałe. Zwraca pełną nazwę parametru, nadaną częściowej nazwie parametru. (Odziedziczone po DbCommandBuilder)
GetParameterPlaceholder(Int32)	Przestarzałe. Zwraca symbol zastępczy parametru w skojarzonej instrukcji SQL. (Odziedziczone po DbCommandBuilder)
GetSchemaTable(DbCommand)	Przestarzałe. Zwraca tabelę schematu dla elementu DbCommandBuilder. (Odziedziczone po DbCommandBuilder)
GetService(Type)	Przestarzałe. Zwraca obiekt, który reprezentuje usługę dostarczaną przez Component obiekt lub przez element Container. (Odziedziczone po Component)
GetType()	Przestarzałe. Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
GetUpdateCommand()	Przestarzałe. Pobiera automatycznie wygenerowany OracleCommand obiekt wymagany do wykonywania aktualizacji bazy danych.
GetUpdateCommand(Boolean)	Przestarzałe. Pobiera automatycznie wygenerowany OracleCommand obiekt wymagany do wykonywania aktualizacji bazy danych.
InitializeCommand(DbCommand)	Przestarzałe. Resetuje CommandTimeoutwłaściwości , Transaction, CommandTypei UpdateRowSource w obiekcie DbCommand. (Odziedziczone po DbCommandBuilder)
InitializeLifetimeService()	Uzyskuje obiekt usługi okresu istnienia w celu kontrolowania zasad okresu istnienia dla tego wystąpienia. (Odziedziczone po MarshalByRefObject)
MemberwiseClone()	Przestarzałe. Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
MemberwiseClone(Boolean)	Przestarzałe. Tworzy płytkią kopię bieżącego MarshalByRefObject obiektu. (Odziedziczone po MarshalByRefObject)
QuoteIdentifier(String)	Przestarzałe. 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()	Przestarzałe. Czyści polecenia skojarzone z tym DbCommandBuilderelementem . (Odziedziczone po DbCommandBuilder)
RowUpdatingHandler(RowUpdatingEventArgs)	Przestarzałe. Dodaje procedurę obsługi zdarzeń dla RowUpdating zdarzenia. (Odziedziczone po DbCommandBuilder)
SetRowUpdatingHandler(DbDataAdapter)	Przestarzałe. Rejestruje element w DbCommandBuilder celu obsługi RowUpdating zdarzenia dla .DbDataAdapter (Odziedziczone po DbCommandBuilder)
ToString()	Przestarzałe. Zwraca wartość String zawierającą nazwę Componentobiektu , jeśli istnieje. Ta metoda nie powinna być zastępowana. (Odziedziczone po Component)
UnquoteIdentifier(String)	Przestarzałe. 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

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

Zobacz też

• Generowanie poleceń za pomocą CommandBuilders